New-CMApplicationGroupDeployment
Создайте развертывание для группы приложений.
Синтаксис
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.