New-CMApplicationDeployment
Создайте развертывание приложения.
Синтаксис
New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-InputObject] <IResultObject>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-Id] <Int32>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-Name] <String>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет New-CMApplicationDeployment создает развертывание приложения. Дополнительные сведения см. в статье Развертывание приложений с помощью Configuration Manager.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Установка приложения
Эта команда создает новое развертывание для Visual Studio 2019 на рабочей станции разработчиков коллекции. Он устанавливает приложение и является обязательным. Доступная дата и крайний срок — это одно и то же время в прошлом, поэтому, как только клиент получает эту политику, он устанавливает приложение.
New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose Required
Параметры
-AllowRepairApp
Этот параметр используется для настройки параметра приложения восстановления при создании развертывания для приложения.
Тип: | Boolean |
Aliases: | AllowUserRepairApplication |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ApprovalRequired
Если для этого параметра задано значение $true
, администратор должен утвердить запрос для этого приложения на устройстве.
Тип: | Boolean |
Aliases: | AppRequiresApproval |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | 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: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DeadlineDateTime
Укажите объект DateTime для при назначении этого развертывания, также известного как крайний срок. Чтобы получить этот объект, используйте встроенный командлет Get-Date .
Используйте параметр -AvailableDateTime , чтобы указать , когда доступно развертывание.
Тип: | DateTime |
Aliases: | SupersedenceDeadlineDateTime |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DeployAction
Укажите действие развертывания для установки или удаления приложения. Если конкурирующие развертывания нацелены на одно и то же устройство, приоритет имеет действие Установить .
Тип: | DeployActionType |
Допустимые значения: | Install, Uninstall |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DeployPurpose
Укажите цель развертывания:
Available
: пользователь видит приложение в Центре программного обеспечения. Они могут установить его по требованию.Required
: клиент автоматически устанавливает приложение в соответствии с заданным расписанием. Если приложение не скрыто, пользователь может отслеживать состояние его развертывания. Они также могут использовать Центр программного обеспечения для установки приложения до наступления крайнего срока.
Тип: | DeployPurposeType |
Допустимые значения: | Available, Required |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisableContentDependencyDetection
Добавьте этот параметр, чтобы не распространять содержимое для зависимых приложений автоматически.
Тип: | SwitchParameter |
Aliases: | DisableDetectAssociatedContentDependencies |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DistributeCollectionName
Сайт распространяет содержимое в точки распространения, связанные с этим именем коллекции.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DistributeContent
Добавьте этот параметр, если сначала нужно распространить содержимое приложения.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DistributionPointGroupName
Чтобы распространить содержимое приложения, укажите имя группы точек распространения.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DistributionPointName
Чтобы распространить содержимое приложения, укажите имя точки распространения.
Тип: | String |
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 |
-GenerateScomAlertOnFailure
Указывает, следует ли создавать оповещение Operations Manager, если клиенту не удается установить приложение.
Тип: | Boolean |
Aliases: | RaiseMomAlertsOnFailure |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Id
Укажите идентификатор развертываемого приложения.
Тип: | Int32 |
Aliases: | CIId, CI_ID, ApplicationId |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Укажите объект приложения для развертывания. Чтобы получить этот объект, используйте командлет Get-CMApplication .
Тип: | IResultObject |
Aliases: | Application |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Name
Укажите имя развертываемого приложения.
Тип: | String |
Aliases: | LocalizedDisplayName, ApplicationName |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-OverrideServiceWindow
Указывает, выполняется ли развертывание, даже если оно запланировано за пределами периода обслуживания.
Период обслуживания — это указанный период времени, используемый для обслуживания и обновлений компьютера.
Если это значение равно $True
, Configuration Manager развертывает приложение, даже если запланированное время выходит за пределы периода обслуживания.
Если это значение равно $False
, Configuration Manager не развертывает приложение за пределами окна. Он ожидает развертывания в доступном окне.
Тип: | Boolean |
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 |
-RebootOutsideServiceWindow
Указывает, перезагружается ли компьютер за пределами периода обслуживания.
Период обслуживания — это указанный период времени, используемый для обслуживания и обновлений компьютера.
Если это значение равно , любая $True
требуемая перезагрузка выполняется без учета периодов обслуживания.
Если это значение равно $False
, компьютер не перезагружается за пределами периода обслуживания.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ReplaceToastNotificationWithDialog
Если на клиенте доступно необходимое программное обеспечение, задайте для этого параметра значение $true
, чтобы заменить всплывающие уведомления по умолчанию диалоговым окном. Значение по умолчанию равно false. Дополнительные сведения см. в разделе Замена всплывающих уведомлений диалоговым окном.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SendWakeupPacket
Указывает, следует ли отправлять пакет пробуждения компьютерам перед началом развертывания.
Если это значение равно $True
, Configuration Manager пытается вывести компьютер из спящего режима.
Если это значение равно $False
, оно не выводит компьютеры из спящего режима.
Для пробуждения компьютеров необходимо сначала настроить пробуждение по локальной сети.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Simulation
Добавьте этот параметр для создания имитации развертывания. Дополнительные сведения см. в разделе Имитация развертываний приложений с помощью Configuration Manager.
Тип: | SwitchParameter |
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 |
-UpdateSupersedence
Для доступного развертывания используйте этот параметр, чтобы указать крайний срок установки для обновления пользователей или устройств, на которых установлено замененное приложение. Используйте DeadlineDateTime , чтобы указать определенное время, в противном случае оно будет как можно скорее после AvailableDateTime.
Тип: | Boolean |
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: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object