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
Этот параметр используется для настройки параметра приложения восстановления при создании развертывания для приложения.
| Type: | Boolean |
| Aliases: | AllowUserRepairApplication |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationId
Указывает идентификатор приложения.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationName
Указывает имя приложения.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AutoCloseExecutable
Начиная с версии 2107 присвойте этому параметру значение $true , чтобы включить параметр развертывания приложения для поведения установки. Затем используйте командлет Add-CMDeploymentTypeInstallBehavior , чтобы добавить исполняемый файл, чтобы проверить, не выполняется ли установка успешно.
Присвойте этому параметру значение , $false чтобы отключить этот параметр в следующих ситуациях:
- При использовании командлета Remove-CMDeploymentTypeInstallBehavior для удаления всех исполняемых файлов
- Вы не хотите, чтобы развертывание проверялось на наличие запущенных исполняемых файлов.
| Type: | Boolean |
| Aliases: | AutoCloseExeOnInstallBehavior |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AvailableDateTime
Укажите объект DateTime , если это развертывание доступно. Чтобы получить этот объект, используйте встроенный командлет Get-Date .
Используйте DeadlineDateTime , чтобы указать назначение развертывания или крайний срок.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Collection
Укажите объект коллекции, в котором развертывается приложение. Чтобы получить этот объект, используйте командлет Get-CMCollection .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionId
Укажите идентификатор коллекции, в которой развертывается приложение. Например, "SMS00004".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
Укажите имя коллекции, в которой развертывается приложение.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Comment
Указывает необязательный комментарий для развертывания.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CreateAlertBaseOnPercentFailure
Указывает, следует ли создавать оповещение для определенной части приложений, которые не удалось развернуть. Чтобы указать процентное значение, используйте параметр FailParameterValue .
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CreateAlertBaseOnPercentSuccess
Указывает, следует ли создать оповещение для части приложений, которые успешно развертываются. Чтобы указать значение в процентах, используйте параметр SuccessParameterValue .
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeadlineDateTime
Укажите объект DateTime для при назначении этого развертывания, также известного как крайний срок. Чтобы получить этот объект, используйте встроенный командлет Get-Date .
Используйте параметр -AvailableDateTime , чтобы указать , когда доступно развертывание.
| Type: | DateTime |
| 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 |
-EnableMomAlert
Присвойте этому параметру значение , $true чтобы включить режим обслуживания System Center Operations Manager для этого развертывания.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSoftDeadline
Задайте для этого параметра значение , $true чтобы включить отложенное принудительное применение.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailParameterValue
Указывает процент неудачной установки приложения, которая вызывает оповещение.
Укажите целое число от 1 до 100.
Чтобы включить это оповещение, задайте для параметра CreatAlertBaseOnPercentFailure значение $True.
| Type: | Int32 |
| 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 |
-InputObject
Укажите объект развертывания приложения для настройки. Чтобы получить этот объект, используйте командлет Get-CMApplicationDeployment .
| Type: | IResultObject |
| Aliases: | Application, DeploymentSummary, Assignment |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OverrideServiceWindow
Указывает, выполняется ли развертывание, даже если оно запланировано за пределами периода обслуживания.
Период обслуживания — это указанный период времени, используемый для обслуживания и обновлений компьютера.
Если это значение равно $True, Configuration Manager развертывает приложение, даже если запланированное время выходит за пределы периода обслуживания.
Если это значение равно $False, Configuration Manager не развертывает приложение за пределами окна. Он ожидает развертывания в доступном окне.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
Указывает, следует ли включать фильтры записи для внедренных устройств.
Для значения $Trueустройство фиксирует изменения во время периода обслуживания. Для этого действия требуется перезагрузка.
Для значения $Falseустройство сохраняет изменения в наложении и фиксирует их позже.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PostponeDateTime
Если для параметра CreateAlertBaseOnPercentSuccess задано значение $true, используйте этот параметр, чтобы указать объект DateTime . Configuration Manager создает оповещение о развертывании, если пороговое значение ниже значения SuccessParameterValue после этой даты.
Чтобы получить этот объект, используйте встроенный командлет Get-Date .
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PreDeploy
Указывает, следует ли предварительно развернуть приложение на основном устройстве пользователя.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RaiseMomAlertsOnFailure
Указывает, следует ли создавать оповещение Operations Manager, если клиенту не удается установить приложение.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RebootOutsideServiceWindow
Указывает, перезагружается ли компьютер за пределами периода обслуживания.
Период обслуживания — это указанный период времени, используемый для обслуживания и обновлений компьютера.
Если это значение равно , любая $Trueтребуемая перезагрузка выполняется без учета периодов обслуживания.
Если это значение равно $False, компьютер не перезагружается за пределами периода обслуживания.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReplaceToastNotificationWithDialog
Если на клиенте доступно необходимое программное обеспечение, задайте для этого параметра значение $true , чтобы заменить всплывающие уведомления по умолчанию диалоговым окном. Значение по умолчанию равно false. Дополнительные сведения см. в разделе Замена всплывающих уведомлений диалоговым окном.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequireApproval
Если для этого параметра задано значение $true, администратор должен утвердить запрос для этого приложения на устройстве.
| Type: | Boolean |
| Aliases: | AppRequiresApproval |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SendWakeUpPacket
Указывает, следует ли отправлять пакет пробуждения компьютерам перед началом развертывания.
Если это значение равно $True, Configuration Manager пытается вывести компьютер из спящего режима.
Если это значение равно $False, оно не выводит компьютеры из спящего режима.
Для пробуждения компьютеров необходимо сначала настроить пробуждение по локальной сети.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SuccessParameterValue
Указывает процент успешной установки приложения, который вызывает оповещение.
Укажите целое число от 0 до 99.
Чтобы включить это оповещение, задайте для параметра CreateAlertBaseOnPercentSuccess значение $True.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeBaseOn
Указывает, какой часовой пояс следует использовать:
LocalTime: используйте местное время.UTC: используйте универсальное координированное время (UTC).
| Type: | TimeType |
| Accepted values: | LocalTime, Utc |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseMeteredNetwork
Указывает, следует ли разрешать клиентам загружать содержимое через лимитное подключение к Интернету после крайнего срока, что может повлечь дополнительные расходы.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserNotification
Указывает тип уведомления пользователя.
DisplayAll: отображается в Центре программного обеспечения и отображаются все уведомления.DisplaySoftwareCenterOnly: отображается в центре программного обеспечения и отображаются только уведомления о перезагрузке компьютера.HideAll: скрыть в центре программного обеспечения и все уведомления.
| Type: | UserNotificationType |
| Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_ApplicationAssignment класс WMI сервера.
Связанные ссылки
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по