New-CMTSStepConditionRegistry

작업 순서 단계에 대한 레지스트리 설정 조건을 만들 수 있습니다.

Syntax

New-CMTSStepConditionRegistry
   -RegistryKey <String>
   -RegistryOperator <VariableOperatorType>
   [-RegistryValueData <String>]
   [-RegistryValueName <String>]
   -RootKey <RegistryRootKeyType>
   [-ValueType <RegistryValueType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 __ 작업 순서 단계에 대한 레지스트리 설정 조건 개체를 만들 수 있습니다. 그런 다음 New-CMTSStep * _ 또는 _ Set-CMTSStep * _ cmdlet 중 하나를 _ Condition 또는 AddCondition 매개 변수와 함께 사용합니다. 예를 들어 Set-CMTSStepApplyDataImage입니다.

자세한 내용은 작업 순서 편집기 사용: 조건 을 참조하세요.

참고

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

예제

예 1

이 예제에서는 먼저 Configuration Manager 클라이언트 로그 수준을 검사하는 레지스트리 설정에 대한 조건 개체를 만듭니다.

그런 다음 Set-CMTSStepSetDynamicVariable cmdlet을 사용하여 이 조건 개체를 기본 OS 배포 작업 순서의 동적 변수 설정 단계에 추가합니다.

$root = "HKeyLocalMachine"
$key = "SOFTWARE\Microsoft\CCM\Logging\@Global"
$name = "LogLevel"
$type = "RegistryDWord"
$value = 1

$condition = New-CMTSStepConditionRegistry -RootKey $root -RegistryKey $key -RegistryOperator Equals -RegistryValueName $name -ValueType $type -RegistryValueData $value

$tsNameOsd = "Default OS deployment"
$tsStepNameDynVar = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsNameOsd -StepName $tsStepNameDynVar -AddCondition $condition

이 샘플 스크립트는 단계에서 다음 조건을 만듭니다.

Registry "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global\LogLevel" (REG_DWORD) equals "1"

매개 변수

-Confirm

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-RegistryKey

확인할 레지스트리 키 경로를 지정합니다. 예를 들어 HKeyLocalMachine RootKey를사용하여 레지스트리 키를 지정할 수 SOFTWARE\Microsoft\CCM 있습니다.

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

-RegistryOperator

이 매개 변수를 사용하여 레지스트리 값을 평가하는 작업 순서의 연산자를 지정합니다. 또는 값을 사용하는 경우 Exists NotExists RegistryValueData 매개 변수를 사용할 필요가 없습니다.

Type:VariableOperatorType
Accepted values:Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RegistryValueData

같은 비교 RegistryOperator를 사용하는 경우 이 매개 변수를 사용하여 평가할 Equals 값 데이터를 지정합니다. ValueType을 사용하여 레지스트리 유형을 지정합니다.

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

-RegistryValueName

확인할 레지스트리 값의 이름을 지정합니다. 이 매개 변수를 지정하지 않으면 조건은 지정된 RegistryKey의 (기본값) 값을 검사합니다.

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

-RootKey

확인할 레지스트리 루트 키를 지정합니다.

Type:RegistryRootKeyType
Accepted values:HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ValueType

확인할 레지스트리 값의 유형을 지정합니다. 이 매개 변수를 RegistryValueData와 함께 사용하여 값 데이터를 지정합니다.

Type:RegistryValueType
Accepted values:RegistrySZ, RegistryExpandSZ, RegistryDWord
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

입력

없음

출력

IResultObject

참고

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