Set-CMCollection

  • 참조
모듈:
ConfigurationManager

디바이스 또는 사용자 컬렉션을 구성합니다.

Syntax

Set-CMCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCollection
   -CollectionId <String>
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCollection
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 디바이스 또는 사용자 컬렉션을 구성합니다.

제한 컬렉션은 컬렉션의 멤버가 될 수 있는 리소스를 결정합니다. 예를 들어 All Systems 컬렉션을 제한 컬렉션으로 사용하는 경우 새 컬렉션은 Configuration Manager 계층 구조에 모든 디바이스를 포함할 수 있습니다.

멤버 자격 규칙을 사용하여 컬렉션에 리소스를 추가합니다. 컬렉션에 멤버를 추가하려면 cmdlet 중 하나를 사용하여 멤버 자격 규칙을 추가합니다. 예를 들면 다음과 같습니다.

기본 컬렉션을 구성할 수 없습니다. 대상으로 하는 모든 컬렉션에는 가 아닌 SMS사이트 코드로 시작하는 ID가 있어야 합니다.

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

참고

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

예제

예제 1: 컬렉션 이름 바꾸기

첫 번째 명령은 testUser 라는 컬렉션 개체를 가져오고 $userCollection 변수에 저장합니다.

두 번째 명령은 컬렉션의 이름을 업데이트합니다.

$userCollection = Get-CMCollection -Name "testUser"
Set-CMCollection -InputObject $userCollection -NewName "newTestUser"

매개 변수

-CollectionId

구성할 컬렉션의 ID를 지정합니다. 이 값은 CollectionID 속성(예: XYZ00012)입니다. 기본 컬렉션을 구성할 수 없으므로 이 값은 가 아닌 SMS사이트 코드로 시작합니다.

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

-Comment

이 컬렉션을 설명하고 식별할 선택적 주석을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

구성할 컬렉션 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection, Get-CMDeviceCollection 또는 Get-CMUserCollection cmdlet을 사용합니다.

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

-LimitingCollection

제한 컬렉션에 대한 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection, Get-CMDeviceCollection 또는 Get-CMUserCollection cmdlet을 사용합니다.

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

-LimitingCollectionId

제한 컬렉션의 ID를 지정합니다. 이 값은 CollectionID 속성(예 XYZ00012 : 또는 SMS00001)입니다.

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

-LimitingCollectionName

제한 컬렉션의 이름을 지정합니다.

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

-Name

구성할 컬렉션의 이름을 지정합니다.

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

-NewName

컬렉션의 새 이름을 지정합니다. 이 매개 변수를 사용하여 이름을 바꿉니다.

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

-PassThru

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

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

-RefreshSchedule

RefreshType 매개 변수를 또는 Both로 Periodic 설정하는 경우 이 매개 변수를 사용하여 일정을 설정합니다. 사이트에서 컬렉션 멤버 자격의 전체 업데이트를 실행할 때 일정 개체를 지정합니다. 이 개체를 얻으려면 New-CMSchedule cmdlet을 사용합니다.

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

-RefreshType

컬렉션 멤버 자격을 업데이트하는 방법을 지정합니다.

  • Manual(1): 관리자가 Configuration Manager 콘솔 또는 Invoke-CMCollectionUpdate cmdlet을 사용하여 멤버 자격 업데이트를 수동으로 트리거합니다.
  • Periodic (2): 사이트에서 일정에 따라 전체 업데이트를 수행합니다. 증분 업데이트는 사용하지 않습니다. 형식을 지정하지 않으면 이 값이 기본값입니다.
  • Continuous (4): 사이트는 정기적으로 새 리소스를 평가한 다음 새 멤버를 추가합니다. 이 형식을 증분 업데이트라고도 합니다. 일정에 따라 전체 업데이트를 수행하지 않습니다.
  • Both(6): 증분 업데이트와 일정에 따라 전체 업데이트를 모두 사용하는 및 Continuous의 조합 Periodic 입니다.

또는 Both를 지정 Periodic 하는 경우 RefreshSchedule 매개 변수를 사용하여 일정을 설정합니다.

참고

None 값(0)은 기능적으로 와 동일합니다Manual.

Type:CollectionRefreshType
Accepted values:None, Manual, Periodic, Continuous, Both
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VariablePriority

디바이스 컬렉션 변수의 우선 순위에 대해 1-9의 정수 값을 지정합니다. 1 는 가장 낮은 우선 순위이고 9 는 가장 높습니다.

디바이스 컬렉션에서 변수를 구성하려면 Set-CMDeviceCollectionVariable cmdlet을 사용합니다.

현재 변수 우선 순위를 보려면 Get-CMCollectionSetting cmdlet을 사용합니다.

Type:Int32
Aliases:DeviceCollectionVariablePrecedence
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