Поделиться через

New-CMApplicationGroupDeployment

  • Ссылка
Модуль:
ConfigurationManager

Создайте развертывание для группы приложений.

Синтаксис

New-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InputObject] <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Id] <Int32>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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>]

Описание

Создайте развертывание для группы приложений. Группа приложений содержит несколько приложений, и пользователи видят группу в Центре программного обеспечения как одну сущность. Дополнительные сведения см. в разделе Создание групп приложений.

Перед развертыванием группы приложений необходимо создать ее. Затем его можно развернуть в коллекции пользователей или устройств в виде одного развертывания.

Примечание.

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

Примеры

Пример 1

$collection = Get-CMCollection -Name "co1"

$distributionPointName = "dp1.contoso.com"

New-CMApplicationGroupDeployment -Id 16777536 -Collection $collection -DistributionPointName $distributionPointName -DistributeContent

Параметры

-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

Укажите идентификатор коллекции в качестве целевого объекта для развертывания этой группы приложений.

Тип: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

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

Тип:DeployPurposeType
Допустимые значения:Available, Required
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

-ForceWildcardHandling

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

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

-GenerateScomAlertOnFailure

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

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

-Id

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

Тип:Int32
Aliases:CIId, CI_ID, ApplicationGroupId
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

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

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

-Name

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

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

-OverrideServiceWindow

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

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

-PersistOnWriteFilterDevice

Используйте этот параметр для обработки фильтров записи для устройств Windows Embedded. Если для параметра задано значение $true, устройство фиксирует изменения в крайний срок или во время периода обслуживания. Для этого действия требуется перезагрузка. Если для параметра задано значение $false, устройство сохраняет изменения во временном наложении и фиксирует их позже.

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

-RebootOutsideServiceWindow

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

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

-SendWakeupPacket

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

Тип:Boolean
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:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject

Примечания

Этот командлет возвращает объект класса WMI SMS_ApplicationGroupAssignment.