다음을 통해 공유

Remove-CMDeviceCollectionVariable

  • 참조
모듈:
ConfigurationManager

디바이스 컬렉션 변수를 제거합니다.

구문

Remove-CMDeviceCollectionVariable
      -Collection <IResultObject>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionVariable
      -CollectionId <String>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionVariable
      -CollectionName <String>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

이 cmdlet을 사용하여 디바이스 컬렉션 변수를 제거합니다. 기본 컬렉션에는 변수가 있을 수 없습니다. 대상으로 하는 모든 컬렉션에는 가 아닌 SMS사이트 코드로 시작하는 ID가 있어야 합니다.

자세한 내용은 작업 순서 변수를 설정하는 방법을 참조하세요.

참고

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

예제

예제 1: 디바이스 컬렉션 변수 제거

첫 번째 명령은 Device 라는 디바이스 컬렉션 개체를 가져오고 $Collection 변수에 저장합니다.

두 번째 명령은 $Collection 변수에 저장된 디바이스 컬렉션에서 testTS라는 디바이스 컬렉션 변수를 제거합니다. Force 매개 변수를 지정하면 변수가 제거되기 전에 메시지가 표시되지 않음을 나타냅니다.

$Collection = Get-CMCollection -Name "Device"
Remove-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Force

예제 2: 디바이스 컬렉션에서 모든 변수 제거

이 예제에서는 먼저 Get-CMDeviceCollectionVariable cmdlet을 사용하여 디바이스 컬렉션 IT 서버 의 모든 변수를 가져와 서 vars 배열 변수에 개체를 저장합니다. 그런 다음 배열의 각 항목을 반복하고 이름으로 변수를 제거합니다.

Force 매개 변수는 각 변수를 제거하라는 메시지가 표시되지 않도록 사용됩니다.

$collName = "IT servers"
$vars = Get-CMDeviceCollectionVariable -CollectionName $collName

foreach ( $var in $vars ) {
  Remove-CMDeviceCollectionVariable -CollectionName $collName -VariableName $var -Force
}

VariableName 매개 변수는 와일드카드를 허용하지 않으므로 디바이스 컬렉션에서 모든 변수를 신속하게 지워야 하는 경우 이 프로세스를 사용합니다.

매개 변수

-Collection

해당 변수를 제거할 디바이스 컬렉션 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection 또는 Get-CMDeviceCollection cmdlet을 사용합니다.

형식:IResultObject
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-CollectionId

해당 변수를 제거할 디바이스 컬렉션의 ID를 지정합니다. 이 값은 CollectionID 속성(예: XYZ00012)입니다. 기본 컬렉션에서는 변수를 설정할 수 없으므로 이 값은 가 아닌 SMS사이트 코드로 시작합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CollectionName

해당 변수를 제거할 디바이스 컬렉션의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

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

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisableWildcardHandling

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

사용자 확인을 요청하지 않고 명령을 강제로 실행합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceWildcardHandling

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-VariableName

제거할 컬렉션 변수의 이름을 지정합니다. 이 매개 변수는 와일드카드 문자를 허용하지 않습니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

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

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object