Set-CMDeviceCollectionVariable

  • 참조
모듈:
ConfigurationManager

디바이스 컬렉션 변수를 구성합니다.

Syntax

Set-CMDeviceCollectionVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionId <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionName <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 디바이스 컬렉션 변수를 변경합니다.

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

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

참고

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

예제

예제 1: 변수 이름 변경

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

두 번째 명령은 컬렉션 변수 testTS 의 이름을 NewVariable로 변경합니다.

$Collection = Get-CMCollection -Name "Device"
Set-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -NewVariableName "NewVariable"

예제 2: 변수 값 변경

이 명령은 Device 컬렉션에서 testTS 변수의 값을 변경합니다. 새 변수 값을 12로 설정합니다.

Set-CMDeviceCollectionVariable -CollectionName "Device" -VariableName "testTS" -NewVariableValue 12

매개 변수

-CollectionId

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

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

-CollectionName

변수를 구성할 디바이스 컬렉션의 이름을 지정합니다.

Type:String
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

-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 cmdlet을 사용합니다.

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

-IsMask

변수 값이 숨겨져 있음을 나타내려면 이 매개 변수 $true 를 로 설정합니다. 마스킹된 값은 Configuration Manager 콘솔, WMI 클래스 SMS_CollectionVariableValue 속성 또는 작업 순서 로그 파일에 표시되지 않습니다. 작업 순서는 변수를 계속 사용할 수 있습니다.

변수가 숨겨지면 마스크를 해제할 수 없습니다. 변수 값을 마스킹하지만 마스킹하지 않으려면 변수를 삭제하고 다시 만들어야 합니다.

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

-NewVariableName

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

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

-NewVariableValue

컬렉션 변수에 대한 새 값을 지정합니다.

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

-VariableName

변경할 컬렉션 변수의 이름을 지정합니다.

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

참고

변수 우선 순위를 설정하려면 VariablePriority 매개 변수와 함께 Set-CMCollection cmdlet을 사용합니다. 현재 변수 우선 순위를 보려면 Get-CMCollectionSetting cmdlet을 사용합니다.