Set-CMApplicationDeployment

Ссылка

Модуль:: ConfigurationManager

Настройка развертывания приложения

Синтаксис

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   -InputObject <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationId <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationName <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-CMApplicationDeployment изменяет свойства развертывания приложения в Configuration Manager. Дополнительные сведения см. в статье Развертывание приложений с помощью Configuration Manager.

Чтобы указать развертывание приложения для изменения, укажите имя коллекции и приложение. Можно указать приложение по имени или идентификатору. Вы также можете использовать командлет Get-CMApplication , чтобы получить приложение для изменения.

Примечание.

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

Примеры

Пример 1. Изменение доступности и крайнего срока для развертывания приложения

Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)

Эта команда изменяет развертывание приложения для приложения с именем Track System 2011 для коллекции All Users. Команда указывает текущую дату доступности приложения. Он также настраивает крайний срок развертывания в течение 30 дней в будущем.

Параметры

-AllowRepairApp

Этот параметр используется для настройки параметра приложения восстановления при создании развертывания для приложения.

Тип:	Boolean
Aliases:	AllowUserRepairApplication
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ApplicationId

Указывает идентификатор приложения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ApplicationName

Указывает имя приложения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AutoCloseExecutable

Начиная с версии 2107 присвойте этому параметру значение $true , чтобы включить параметр развертывания приложения для поведения установки. Затем используйте командлет Add-CMDeploymentTypeInstallBehavior , чтобы добавить исполняемый файл, чтобы проверить, не выполняется ли установка успешно.

Присвойте этому параметру значение , $false чтобы отключить этот параметр в следующих ситуациях:

При использовании командлета Remove-CMDeploymentTypeInstallBehavior для удаления всех исполняемых файлов
Вы не хотите, чтобы развертывание проверялось на наличие запущенных исполняемых файлов.

Тип:	Boolean
Aliases:	AutoCloseExeOnInstallBehavior
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AvailableDateTime

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

Используйте DeadlineDateTime , чтобы указать назначение развертывания или крайний срок.

Тип:	DateTime
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Collection

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

Тип:	IResultObject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CollectionId

Укажите идентификатор коллекции, в которой развертывается приложение. Например, "SMS00004".

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CollectionName

Укажите имя коллекции, в которой развертывается приложение.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	True

-Comment

Указывает необязательный комментарий для развертывания.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

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

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CreateAlertBaseOnPercentFailure

Указывает, следует ли создать оповещение для определенной части приложений, которые не удалось развернуть. Чтобы указать процентное значение, используйте параметр FailParameterValue .

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CreateAlertBaseOnPercentSuccess

Указывает, следует ли создать оповещение для части приложений, которые успешно развертываются. Чтобы указать значение в процентах, используйте параметр SuccessParameterValue .

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DeadlineDateTime

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

Используйте параметр -AvailableDateTime , чтобы указать , когда доступно развертывание.

Тип:	DateTime
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableWildcardHandling

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableMomAlert

Присвойте этому параметру значение , $true чтобы включить режим обслуживания System Center Operations Manager для этого развертывания.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableSoftDeadline

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

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FailParameterValue

Указывает процент неудачной установки приложения, которая вызывает оповещение. Укажите целое число от 1 до 100. Чтобы включить это оповещение, задайте для параметра CreatAlertBaseOnPercentFailure значение $True.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceWildcardHandling

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

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

Тип:	IResultObject
Aliases:	Application, DeploymentSummary, Assignment
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-OverrideServiceWindow

Указывает, выполняется ли развертывание, даже если оно запланировано за пределами периода обслуживания. Период обслуживания — это указанный период времени, используемый для обслуживания и обновлений компьютера. Если это значение равно $True, Configuration Manager развертывает приложение, даже если запланированное время выходит за пределы периода обслуживания. Если это значение равно $False, Configuration Manager не развертывает приложение за пределами окна. Он ожидает развертывания в доступном окне.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PassThru

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PersistOnWriteFilterDevice

Указывает, следует ли включать фильтры записи для внедренных устройств. Для значения $Trueустройство фиксирует изменения во время периода обслуживания. Для этого действия требуется перезагрузка. Для значения $Falseустройство сохраняет изменения в наложении и фиксирует их позже.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PostponeDateTime

Если для параметра CreateAlertBaseOnPercentSuccess задано значение $true, используйте этот параметр, чтобы указать объект DateTime . Configuration Manager создает оповещение о развертывании, если пороговое значение ниже значения SuccessParameterValue после этой даты.

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

Тип:	DateTime
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PreDeploy

Указывает, следует ли предварительно развернуть приложение на основном устройстве пользователя.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RaiseMomAlertsOnFailure

Указывает, следует ли создавать оповещение Operations Manager, если клиенту не удается установить приложение.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RebootOutsideServiceWindow

Указывает, перезагружается ли компьютер за пределами периода обслуживания. Период обслуживания — это указанный период времени, используемый для обслуживания и обновлений компьютера. Если это значение равно , любая $Trueтребуемая перезагрузка выполняется без учета периодов обслуживания. Если это значение равно $False, компьютер не перезагружается за пределами периода обслуживания.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ReplaceToastNotificationWithDialog

Если на клиенте доступно необходимое программное обеспечение, задайте для этого параметра значение $true , чтобы заменить всплывающие уведомления по умолчанию диалоговым окном. Значение по умолчанию равно false. Дополнительные сведения см. в разделе Замена всплывающих уведомлений диалоговым окном.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RequireApproval

Если для этого параметра задано значение $true, администратор должен утвердить запрос для этого приложения на устройстве.

Тип:	Boolean
Aliases:	AppRequiresApproval
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SendWakeUpPacket

Указывает, следует ли отправлять пакет пробуждения компьютерам перед началом развертывания. Если это значение равно $True, Configuration Manager пытается вывести компьютер из спящего режима. Если это значение равно $False, оно не выводит компьютеры из спящего режима. Для пробуждения компьютеров необходимо сначала настроить пробуждение по локальной сети.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SuccessParameterValue

Указывает процент успешной установки приложения, который вызывает оповещение. Укажите целое число от 0 до 99. Чтобы включить это оповещение, задайте для параметра CreateAlertBaseOnPercentSuccess значение $True.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-TimeBaseOn

Указывает, какой часовой пояс следует использовать:

LocalTime: используйте местное время.
UTC: используйте универсальное координированное время (UTC).

Тип:	TimeType
Допустимые значения:	LocalTime, Utc
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UseMeteredNetwork

Указывает, следует ли разрешать клиентам загружать содержимое через лимитное подключение к Интернету после крайнего срока, что может повлечь дополнительные расходы.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UserNotification

Указывает тип уведомления пользователя.

DisplayAll: отображается в Центре программного обеспечения и отображаются все уведомления.
DisplaySoftwareCenterOnly: отображается в центре программного обеспечения и отображаются только уведомления о перезагрузке компьютера.
HideAll: скрыть в центре программного обеспечения и все уведомления.

Тип:	UserNotificationType
Допустимые значения:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

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

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject

Примечания

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

Обратная связь

Были ли сведения на этой странице полезными?