New-CMTSStepInstallApplication

  • Ссылка
Модуль:
ConfigurationManager

Создайте шаг Установки приложения , который можно добавить в последовательность задач.

Синтаксис

New-CMTSStepInstallApplication
   [-Application <IResultObject[]>]
   [-BaseVariableName <String>]
   [-ClearCache <Boolean>]
   [-ContinueOnInstallError]
   [-RetryCount <Int32>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Этот командлет создает новый объект шага установки приложения . Затем используйте командлет Add-CMTaskSequenceStep , чтобы добавить шаг в последовательность задач. Дополнительные сведения об этом шаге см. в разделе Сведения о шагах последовательности задач: Установка приложения.

Примечание.

Выполните командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1

В этом примере сначала возвращается объект приложения для центрального приложения и сохраняется в переменной $app .

В следующей строке создается объект для шага Установка приложения с помощью переменной $app .

Затем он получает объект последовательности задач и добавляет этот новый шаг в последовательность задач по индексу 11.

$app = Get-CMApplication -Name "Central app"

$step = New-CMTSStepInstallApplication -Name "Install Application" -Application $app

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

Параметры

-Application

Укажите один или несколько объектов приложения для установки. Чтобы получить этот объект, используйте командлет Get-CMApplication .

Type:IResultObject[]
Aliases:Applications
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BaseVariableName

Используйте этот параметр для установки приложений в соответствии со списком динамических переменных. Затем последовательность задач устанавливает приложения с этим именем базовой переменной. Дополнительные сведения см. в разделе Установка приложений в соответствии со списком динамических переменных.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearCache

Присвойте этому параметру значение , $true чтобы удалить содержимое приложения из кэша клиента после установки приложения. Это полезно на устройствах с небольшими жесткими дисками или при последовательной установке большого количества больших приложений.

Type:Boolean
Aliases:RemoveFromCache
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Condition

Укажите объект условия для использования на этом шаге. Чтобы получить этот объект, используйте один из командлетов условия последовательности задач. Например, Get-CMTSStepConditionVariable.

Type:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Перед запуском командлет запросит подтверждение.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnError

Добавьте этот параметр, чтобы включить параметр шага Продолжить при ошибке. Если этот параметр включен, если шаг завершается ошибкой, последовательность задач продолжается.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnInstallError

Добавьте этот параметр, чтобы продолжить установку других приложений в списке, если не удается установить приложение. Если этот параметр не указан и установка завершается сбоем, действие немедленно завершается.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Укажите необязательное описание для этого шага последовательности задач.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Disable

Добавьте этот параметр, чтобы отключить этот шаг последовательности задач.

Type:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Укажите имя для этого шага, чтобы определить его в последовательности задач.

Type:String
Aliases:StepName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RetryCount

Если одна из установок приложения неожиданно перезагружает компьютер, повторите этот шаг в течение того количества раз, которое вы указали с помощью этого параметра. По умолчанию шаг повторяется дважды. Укажите целочисленное значение от 1 до 5.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

None

Выходные данные

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_TaskSequence_InstallApplicationAction класс WMI сервера.