New-CMDeviceCollectionVariable
디바이스 컬렉션 변수를 만듭니다.
구문
New-CMDeviceCollectionVariable
-InputObject <IResultObject>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollectionVariable
-CollectionId <String>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollectionVariable
-CollectionName <String>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
이 cmdlet을 사용하여 디바이스 컬렉션 변수를 만듭니다. 디바이스 컬렉션 변수를 사용하여 컬렉션의 디바이스에서 사용할 사용자 지정 작업 순서 변수 및 관련 값을 정의할 수 있습니다. 작업 순서 변수는 작업 순서가 특정 컬렉션에 배포될 때 작업 순서의 단계를 구성하고 사용자 지정하는 메커니즘을 제공하는 이름 및 값 쌍 집합입니다.
기본 컬렉션에는 변수가 있을 수 없습니다. 대상으로 하는 모든 컬렉션에는 가 아닌 SMS사이트 코드로 시작하는 ID가 있어야 합니다.
자세한 내용은 작업 순서 변수를 설정하는 방법을 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 디바이스 컬렉션 변수 만들기
첫 번째 명령은 Device 라는 디바이스 컬렉션 개체를 가져오고 $Collection 변수에 저장합니다.
두 번째 명령은 $Collection 저장된 컬렉션 개체의 값 test001을 사용하여 testTS라는 컬렉션 변수를 만듭니다.
$Collection = Get-CMCollection -Name "Device"
New-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Value "test001"매개 변수
-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 |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
변수를 만들 디바이스 컬렉션 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection 또는 Get-CMDeviceCollection cmdlet을 사용합니다.
| 형식: | IResultObject |
| 별칭: | Collection |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-IsMask
변수 값이 숨겨져 있음을 나타내려면 이 매개 변수 $true 를 로 설정합니다. 마스킹된 값은 Configuration Manager 콘솔, WMI 클래스 SMS_CollectionVariableValue 속성 또는 작업 순서 로그 파일에 표시되지 않습니다. 작업 순서는 변수를 계속 사용할 수 있습니다.
변수가 숨겨지면 마스크를 해제할 수 없습니다. 변수 값을 마스킹하지만 마스킹하지 않으려면 변수를 삭제하고 다시 만들어야 합니다.
이 매개 변수를 포함하지 않으면 기본적으로 값이 마스킹되지 않습니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Value
컬렉션 변수의 값을 지정합니다.
| 형식: | String |
| 별칭: | VariableValue |
| 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
출력
IResultObject[]
IResultObject
참고
이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_CollectionSettings 서버 WMI 클래스를 참조하세요.