New-CMTSStepConditionRegistry
작업 순서 단계에 대한 레지스트리 설정 조건을 만듭니다.
구문
New-CMTSStepConditionRegistry
-RegistryKey <String>
-RegistryOperator <VariableOperatorType>
[-RegistryValueData <String>]
[-RegistryValueName <String>]
-RootKey <RegistryRootKeyType>
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
이 cmdlet을 사용하여 작업 순서 단계에 대한 레지스트리 설정 조건 개체를 만듭니다. 그런 다음 조건 또는 AddCondition 매개 변수와 함께 New-CMTSStep* 또는 Set-CMTSStep* cmdlet 중 하나를 사용합니다. 예를 들어 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을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | None |
필수: | 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 |
-RegistryKey
확인할 레지스트리 키 경로를 지정합니다. 예를 들어 RootKey를 HKeyLocalMachine
사용하여 레지스트리 키를 SOFTWARE\Microsoft\CCM
지정할 수 있습니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RegistryOperator
이 매개 변수를 사용하여 레지스트리 값을 평가할 작업 순서에 대한 연산자를 지정합니다. 또는 NotExists
값을 사용하는 Exists
경우 RegistryValueData 매개 변수를 사용할 필요가 없습니다.
형식: | VariableOperatorType |
허용되는 값: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RegistryValueData
와 같은 Equals
비교 RegistryOperator를 사용하는 경우 이 매개 변수를 사용하여 평가할 값 데이터를 지정합니다.
ValueType을 사용하여 레지스트리 유형을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RegistryValueName
확인할 레지스트리 값의 이름을 지정합니다. 이 매개 변수를 지정하지 않으면 조건은 지정된 RegistryKey의 (기본값) 값을 확인합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RootKey
확인할 레지스트리 루트 키를 지정합니다.
형식: | RegistryRootKeyType |
허용되는 값: | HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ValueType
확인할 레지스트리 값의 유형을 지정합니다. RegistryValueData와 함께 이 매개 변수를 사용하여 값 데이터를 지정합니다.
형식: | RegistryValueType |
허용되는 값: | RegistrySZ, RegistryExpandSZ, RegistryDWord |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
None
출력
IResultObject
참고
이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_TaskSequence_RegistryConditionExpression 서버 WMI 클래스를 참조하세요.