New-CMDeviceCollectionVariable

  • 참조
모듈:
ConfigurationManager

디바이스 컬렉션 변수를 만듭니다.

Syntax

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사이트 코드로 시작합니다.

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

-Value

컬렉션 변수의 값을 지정합니다.

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

출력

IResultObject[]

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_CollectionSettings 서버 WMI 클래스를 참조하세요.