Set-CMApplicationDeployment
Настройка развертывания приложения
Синтаксис
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 сервера.