New-CMDetectionClauseRegistryKeyValue
레지스트리 키 값에 대한 검색 방법 절을 생성합니다.
Syntax
New-CMDetectionClauseRegistryKeyValue
-ExpressionOperator <RegistryValueRuleExpressionOperator>
-Hive <RegistryRootKey>
[-Is64Bit]
-KeyName <String>
-PropertyType <SettingDataType>
-ValueName <String>
-ExpectedValue <String[]>
[-Value]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] New-CMDetectionClauseRegistryKeyValue
-Hive <RegistryRootKey>
[-Is64Bit]
-KeyName <String>
-PropertyType <SettingDataType>
-ValueName <String>
[-Existence]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Description
이 cmdlet을 사용하여 응용 프로그램의 검색 메서드에 절을 만들 수 있습니다. 이 절은 응용 프로그램의 존재를 나타내는 레지스트리 키 값에 대한 규칙입니다.
값 대신 레지스트리 키가 존재할지 검색하기 위해 New-CMDetectionClauseRegistryKey cmdlet을 사용합니다.
이 cmdlet을 사용한 후 배포 유형에 대해 Add- 또는 Set- cmdlet 중 하나를 사용 합니다. 이 검색 절 개체를 AddDetectionClause 또는 RemoveDetectionClause 매개 변수로 전달합니다.
검색 절을 그룹화하기 위해 배포 유형 cmdlet에서 GroupDetectionClauses 매개 변수를 사용합니다.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\> ). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 레지스트리 값의 존재 감지
이 예제에서는 현재 버전 값에 대해 Git가 Windows 만듭니다.
$regClause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName "SOFTWARE\GitForWindows" -PropertyType String -ValueName "CurrentVersion" -Existence
Set-CMMsiDeploymentType -ApplicationName "Git for Windows" -DeploymentTypeName "Install" -AddDetectionClause $regClause예제 2: 레지스트리의 버전 값 비교
이 예제에서는 레지스트리의 Microsoft 365 버전이 보다 크거나 같게 비교하는 절을 16.0.10730.20304 만듭니다.
$clause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName 'Software\Microsoft\Office\ClickToRun\Configuration' -PropertyType Version -ValueName 'VersionToReport' -Value -ExpectedValue '16.0.10730.20304' -ExpressionOperator GreaterEquals
Set-CMMsiDeploymentType -ApplicationName "Microsoft 365" -DeploymentTypeName "Install" -AddDetectionClause $clause매개 변수
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과결합할 수 있습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Existence
이 매개 변수를 추가할 때 이 응용 프로그램의 존재를 나타내기 위해 레지스트리 키 값이 대상 시스템에 있어야 합니다.
이 레지스트리 키 값의 데이터에 대한 규칙을 평가하는 대신 Value 매개 변수를 사용합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExpectedValue
Value 매개 변수를 추가할 때 PropertyType 및 ExpressionOperator와 함께 ExpectedValue를 사용합니다. **** 이러한 매개 변수를 사용하는 경우 레지스트리 키 값은 이 응용 프로그램의 존재를 나타내기 위해 규칙을 충족해야 합니다. 이 ExpectedValue 매개 변수는 레지스트리 키 값과 비교할 값을 지정합니다.
비교할 값은 지정한 PropertyType에 따라 다를 수 있습니다.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExpressionOperator
Value 매개 변수를 추가할 때 ExpressionOperator를 PropertyType 및 ExpectedValue와 함께 사용합니다. 이러한 매개 변수를 사용하는 경우 레지스트리 키 값은 이 응용 프로그램의 존재를 나타내기 위해 규칙을 충족해야 합니다. 이 ExpressionOperator 매개 변수는 레지스트리 키 값과 예상 값을 비교하는 연산자를 지정합니다.
버전 2010부터 매개 변수 유형이 RuleExpressionOperator에서 RegistryValueRuleExpressionOperator로 변경되었습니다.
| Type: | RegistryValueRuleExpressionOperator |
| Accepted values: | IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf, BeginsWith, NotBeginsWith, EndsWith, NotEndsWith, Contains, NotContains |
| 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 |
-Hive
키가 있는 레지스트리 hive를 지정합니다. KeyName 매개 변수를 사용하여 키 이름을 지정합니다. ValueName 매개 변수를 사용하여 레지스트리 키 값을 지정합니다.
예를 들어 다음 PowerShell 명령은 다음 매개 변수 값으로 변환합니다.
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion
| 매개 변수 | 값 |
|---|---|
| Hive | LocalMachine |
| KeyName | 'SOFTWARE\Microsoft\Windows NT\CurrentVersion' |
| ValueName | CurrentVersion |
| Type: | RegistryRootKey |
| Aliases: | RegistryHive |
| Accepted values: | ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Is64Bit
이 매개 변수를 추가하여 이 레지스트리 키가 64비트 시스템의 32비트 응용 프로그램과 연결됩니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-KeyName
이 응용 프로그램의 존재를 나타내기 위해 존재해야 하는 레지스트리 키의 이름을 지정합니다. Hive 매개 변수를 사용하여 이 키가 있는 레지스트리 hive를 지정합니다. ValueName 매개 변수를 사용하여 레지스트리 키 값을 지정합니다.
예를 들어 다음 PowerShell 명령은 다음 매개 변수 값으로 변환합니다.
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion
| 매개 변수 | 값 |
|---|---|
| Hive | LocalMachine |
| KeyName | 'SOFTWARE\Microsoft\Windows NT\CurrentVersion' |
| ValueName | CurrentVersion |
| Type: | String |
| Aliases: | RegistryKey |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PropertyType
Value 매개 변수를 추가할 때 PropertyType을 ExpressionOperator 및 ExpectedValue와 함께 사용합니다. 이러한 매개 변수를 사용하는 경우 레지스트리 키 값은 이 응용 프로그램의 존재를 나타내기 위해 규칙을 충족해야 합니다. 이 PropertyType 매개 변수는 레지스트리 키 값의 데이터 형식을 지정합니다.
예를 들어 이 매개 변수를 로 설정하면 Version ExpressionOperator를 IsEquals 로 설정하고 ExpectedValue를 로 설정할 수 1.48.1.0 있습니다. 그런 다음 이 규칙은 지정된 레지스트리 키 값의 버전이 같은지 검사합니다.
| Type: | SettingDataType |
| Accepted values: | Version, Integer, String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Value
Value 매개 변수를 추가할 때 레지스트리 키 값은 이 응용 프로그램의 존재를 나타내는 규칙을 충족해야 합니다. 이 매개 변수는 ExpectedValue, ExpressionOperator및 PropertyType 매개 변수와 함께 사용합니다.
규칙을 평가하는 대신 레지스트리 키 값이 있는지만 확인한 다음 Exist 매개 변수를 사용합니다.
| Type: | SwitchParameter |
| Aliases: | ValueRule |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ValueName
응용 프로그램의 존재를 나타내는 레지스트리 키 값을 지정합니다. Hive 매개 변수를 사용하여 레지스트리 하이브를 지정하고 KeyName을 사용하여 레지스트리 키를 지정합니다.
예를 들어 다음 PowerShell 명령은 다음 매개 변수 값으로 변환합니다.
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion
| 매개 변수 | 값 |
|---|---|
| Hive | LocalMachine |
| KeyName | 'SOFTWARE\Microsoft\Windows NT\CurrentVersion' |
| ValueName | CurrentVersion |
| Type: | String |
| Aliases: | RegistryValueName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
입력
없음
출력
System.Object