New-CMSettingDeployment
Развертывание объекта политики параметров в коллекции.
Синтаксис
New-CMSettingDeployment
[-CMSetting] <CMSettings>
[-Schedule <IResultObject>]
[-OverrideServiceWindows]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Описание
Развертывание объекта политики параметров в коллекции. Например, разверните политику управления BitLocker или политику управления приложениями в Microsoft Defender. Чтобы создать пользовательское расписание, используйте командлет New-CMSchedule . Чтобы получить коллекцию, используйте командлет Get-CMCollection .
Примеры
Пример 1. Развертывание объекта управления BitLocker для всех клиентов настольных компьютеров и серверов
В этом примере по имени возвращается объект параметров управления BitLocker и он сохраняется в переменной $setting . Затем он получает коллекцию по имени и сохраняет этот объект в переменной $collection . Он использует командлет New-CMSettingDeployment для развертывания объекта параметров управления BitLocker в этой коллекции.
$setting = Get-CMBlmSetting -Name "My BitLocker settings"
$collection = Get-CMCollection -Name "All Desktop and Server Clients"
New-CMSettingDeployment -CMSetting $setting -CollectionName $collection.NameПример 2. Развертывание параметра управления приложениями в Защитнике Windows с помощью настраиваемого расписания
В этом примере также создается пользовательское расписание с помощью командлета New-CMSchedule .
$setting = Get-CMWdacSetting -Name "My App Control settings"
$collection = Get-CMCollection -Name "All Desktop and Server Clients"
$sched = New-CMSchedule -Start ((Get-Date).AddDays(-30)).ToString() -RecurCount 7 -RecurInterval Minutes
$dep = New-CMSettingDeployment -CMSetting $setting -Collection $collection -Schedule $schedПараметры
-CMSetting
Укажите объект параметров для развертывания.
- Для управления BitLocker используйте командлеты Get-CMBlmSetting или New-CMBlmSetting .
- Для управления приложениями в Microsoft Defender используйте командлеты Get-CMWdacSetting или New-CMWdacSetting .
| Тип: | CMSettings |
| Position: | 1 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | 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 |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-OverrideServiceWindows
При добавлении этого параметра клиент может исправить параметры за пределами периода обслуживания.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Schedule
Укажите объект расписания для применения к развертыванию. Чтобы создать пользовательское расписание, используйте командлет New-CMSchedule .
| Тип: | IResultObject |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.PowerShell.Cmdlets.EP.SimplifiedSettings.CMSettings
Выходные данные
Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment