New-CMSettingDeployment

설정 정책 개체를 컬렉션에 배포합니다.

Syntax

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 변수에 저장합니다. 이 cmdlet은 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

배포할 설정 개체를 지정합니다.

Type:CMSettings
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Collection

컬렉션 개체를 배포 대상으로 지정합니다. 컬렉션을 얻습니다. Get-CMCollection cmdlet을 사용 합니다.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionId

컬렉션의 ID를 배포 대상으로 지정합니다.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

컬렉션 이름을 배포 대상으로 지정합니다.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과결합할 수 있습니다.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하며 예기치 않은 동작이 발생할 수 있습니다(권장하지 않음). DisableWildcardHandling과결합할 수 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-OverrideServiceWindows

이 매개 변수를 추가하면 클라이언트가 유지 관리 기간 외부의 설정을 재구성할 수 있습니다.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

배포에 적용할 일정 개체를 지정합니다. 사용자 지정 일정을 만들 경우 New-CMSchedule cmdlet을 사용 합니다.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

입력

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.EP.SimplifiedSettings.CMSettings

출력

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment