Add-CMDeviceCollectionExcludeMembershipRule

  • 참조
모듈:
ConfigurationManager

디바이스 컬렉션에 제외 멤버 자격 규칙을 추가합니다.

Syntax

Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 디바이스 컬렉션에 제외 멤버 자격 규칙을 추가합니다. 제외 멤버 자격 규칙은 규칙이 적용되는 디바이스 컬렉션에서 다른 컬렉션의 멤버를 제외합니다.

기본 컬렉션에는 멤버 자격 규칙을 추가할 수 없습니다. 대상으로 하는 모든 컬렉션에는 가 아닌 SMS사이트 코드로 시작하는 ID가 있어야 합니다. 기본 컬렉션을 제외할 수 있으므로 제외된 컬렉션의 ID는 로 SMS시작할 수 있습니다.

Configuration Manager 제외된 컬렉션의 멤버 자격이 변경되는 경우 일정에 따라 디바이스 컬렉션의 멤버 자격을 동적으로 업데이트합니다.

컬렉션에 제외 멤버 자격 규칙을 추가하면 리소스가 더 이상 디바이스 컬렉션의 멤버가 아닐 수 있습니다. 이 작업을 수행하면 소프트웨어 또는 구성 배포가 디바이스에 적용되지 않을 수 있습니다.

자세한 내용은 Configuration Manager 컬렉션을 만드는 방법을 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 디바이스 컬렉션에 제외 컬렉션 규칙 추가

이 명령은 디바이스 컬렉션 ID XYZ00012에서 ID SMSDM001이 있는 모든 모바일 디바이스 기본 컬렉션의 멤버를 제외합니다.

Add-CMDeviceCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "SMSDM001"

매개 변수

-CollectionId

규칙을 추가할 디바이스 컬렉션의 ID를 지정합니다. 이 값은 CollectionID 속성(예: XYZ00012)입니다. 기본 컬렉션에는 제외 멤버 자격 규칙이 없으므로 이 ID는 가 아닌 SMS사이트 코드로 시작합니다.

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

-CollectionName

규칙을 추가할 디바이스 컬렉션의 이름을 지정합니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeCollection

제외된 컬렉션에 대한 개체를 지정하여 규칙을 추가합니다. 이 개체를 얻으려면 Get-CMCollection 또는 Get-CMDeviceCollection cmdlet을 사용합니다.

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

-ExcludeCollectionId

제외된 컬렉션의 ID를 지정하여 규칙을 추가합니다. 이 값은 CollectionID 속성(예: XYZ00012)입니다. 기본 컬렉션을 제외할 수 있으므로 이 값은 사이트 코드 또는 SMS로 시작할 수 있습니다.

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

-ExcludeCollectionName

제외된 컬렉션의 이름을 지정하여 규칙을 추가합니다.

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

-InputObject

규칙을 추가할 디바이스 컬렉션에 대한 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection 또는 Get-CMDeviceCollection cmdlet을 사용합니다.

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object