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