New-CMSettingDeployment
컬렉션에 설정 정책 개체를 배포합니다.
구문
New-CMSettingDeployment
[-CMSetting] <CMSettings>
[-Schedule <IResultObject>]
[-OverrideServiceWindows]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Description
컬렉션에 설정 정책 개체를 배포합니다. 예를 들어 BitLocker 관리 정책 또는 Microsoft Defender 애플리케이션 제어 정책을 배포합니다. 사용자 지정 일정을 만들려면 New-CMSchedule cmdlet을 사용합니다. 컬렉션을 얻으려면 Get-CMCollection cmdlet을 사용합니다.
예제
예제 1: 모든 데스크톱 및 서버 클라이언트에 BitLocker 관리 개체 배포
이 예제에서는 이름으로 BitLocker 관리 설정 개체를 가져오고 해당 개체를 $setting 변수에 저장합니다. 그런 다음 이름으로 컬렉션을 가져오고 해당 개체를 $collection 변수에 저장합니다. New-CMSettingDeployment cmdlet을 사용하여 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 Defender 애플리케이션 제어 설정 배포
이 예제에서는 New-CMSchedule cmdlet을 사용하여 사용자 지정 일정을 만듭니다.
$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 cmdlet을 사용합니다.
- Microsoft Defender 애플리케이션 컨트롤의 경우 Get-CMWdacSetting 또는 New-CMWdacSetting cmdlet을 사용합니다.
| 형식: | CMSettings |
| Position: | 1 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Collection
컬렉션 개체를 배포의 대상으로 지정합니다. 컬렉션을 얻으려면 Get-CMCollection cmdlet을 사용합니다.
| 형식: | IResultObject |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CollectionId
컬렉션의 ID를 배포 대상으로 지정합니다.
| 형식: | 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 cmdlet을 사용합니다.
| 형식: | IResultObject |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
Microsoft.ConfigurationManagement.PowerShell.Cmdlets.EP.SimplifiedSettings.CMSettings
출력
Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment