New-CMDetectionClauseFile
파일에 대한 검색 방법 절을 만듭니다.
구문
New-CMDetectionClauseFile
-FileName <String>
-PropertyType <FileFolderProperty>
-ExpectedValue <String[]>
-ExpressionOperator <FileFolderRuleExpressionOperator>
[-Is64Bit]
-Path <String>
[-Value]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] New-CMDetectionClauseFile
-FileName <String>
[-Is64Bit]
-Path <String>
[-Existence]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Description
이 cmdlet을 사용하여 애플리케이션의 검색 메서드에 절을 만듭니다. 이 절은 애플리케이션의 존재를 나타내는 파일에 대한 규칙입니다.
파일 대신 폴더를 검색하려면 New-CMDetectionClauseDirectory cmdlet을 사용합니다.
이 cmdlet을 사용한 후 배포 유형에 추가 또는Set- cmdlet 중 하나를 사용합니다. 이 검색 절 개체를 AddDetectionClause 또는 RemoveDetectionClause 매개 변수에 전달합니다.
검색 절을 그룹화하려면 배포 유형 cmdlet에서 GroupDetectionClauses 매개 변수를 사용합니다.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 버전별 애플리케이션 검색
이 예제에서는 버전이 보다 크거나 같은 특정 폴더에서 애플리케이션 app.exe 검색합니다 1.0.0.
$clause = New-CMDetectionClauseFile -Path "C:\Program Files\Application" -FileName App.exe -Value -PropertyType Version -ExpressionOperator GreaterEquals -ExpectedValue "1.0.0"
Set-CMScriptDeploymentType -ApplicationName "CentralApp" -DeploymentTypeName "Scripted install" -AddDetectionClause $clause예제 2: MSI 앱 배포 유형에 대한 여러 절 만들기
이 예제에서는 두 개의 파일 절과 하나의 레지스트리 절을 만든 다음, 이를 사용하여 앱에 MSI 배포 유형을 추가합니다.
$cla1=New-CMDetectionClauseFile -FileName "filetest" -PropertyType Size -ExpectedValue 123 -ExpressionOperator IsEquals -Path "C:\" -Value -Is64Bit
$cla2=New-CMDetectionClauseFile -FileName "foldertest" -PropertyType DateCreated -ExpectedValue (Get-Date) -ExpressionOperator LessThan -Path "C:\" -Value
$cla3=New-CMDetectionClauseRegistryKey -Hive ClassesRoot -KeyName "aaa"
$logic1=$cla1.Setting.LogicalName
$logic2=$cla2.Setting.LogicalName
$logic3=$cla3.Setting.LogicalName
Add-CMMsiDeploymentType -AddDetectionClause $cla1,$cla2,$cla3 -ApplicationName "app" -DeploymentTypeName "dt" -InstallCommand "mycommand" -ContentLocation "\\server\sources\Orca.msi" -GroupDetectionClauses $logic1,$logic2 -DetectionClauseConnector {LogicalName=$logic2;Connector="or"},{LogicalName=$logic3;Connector="or"}매개 변수
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Existence
이 매개 변수를 추가할 때 이 애플리케이션의 존재를 나타내려면 파일이 대상 시스템에 있어야 합니다.
단순히 존재하는 대신 이 파일의 속성에 대한 규칙을 평가하려면 Value 매개 변수를 사용합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ExpectedValue
Value 매개 변수를 추가하면 PropertyType 및 ExpressionOperator와 함께 ExpectedValue를 사용합니다. 이러한 매개 변수를 사용하는 경우 파일은 이 애플리케이션의 존재를 나타내기 위해 규칙을 충족해야 합니다. 이 ExpectedValue 매개 변수는 파일 시스템과 비교할 값을 지정합니다.
비교할 값은 지정된 PropertyType에 따라 달라집니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ExpressionOperator
Value 매개 변수를 추가하면 PropertyType 및 ExpectedValue와 함께 ExpressionOperator를 사용합니다. 이러한 매개 변수를 사용하는 경우 파일은 이 애플리케이션의 존재를 나타내기 위해 규칙을 충족해야 합니다. 이 ExpressionOperator 매개 변수는 파일 시스템 값을 예상 값과 비교할 연산자를 지정합니다.
버전 2010부터 매개 변수 형식이 RuleExpressionOperator 에서 FileFolderRuleExpressionOperator로 변경되었습니다.
| 형식: | FileFolderRuleExpressionOperator |
| 허용되는 값: | IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-FileName
애플리케이션의 존재를 나타내는 파일의 이름을 지정합니다. Path 매개 변수를 사용하여 이 파일의 경로를 지정합니다.
예를 들어 Configuration Manager 콘솔은 기본적으로 C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe를 로 설치합니다. 이 파일에 대한 규칙을 만들려면 이 매개 변수를 로 Microsoft.ConfigurationManagement.exe 설정하고 Path 매개 변수를 로 %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin설정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Is64Bit
이 매개 변수를 추가하여 이 파일이 64비트 시스템의 32비트 애플리케이션과 연결되어 있음을 나타냅니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Path
애플리케이션의 존재를 나타내는 파일 시스템의 경로를 파일로 지정합니다. FileName 매개 변수를 사용하여 파일 이름을 지정합니다.
예를 들어 Configuration Manager 콘솔은 기본적으로 C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe를 로 설치합니다. 이 파일에 대한 규칙을 만들려면 이 매개 변수를 로 %ProgramFiles(x86)%\Microsoft Endpoint Manager\AdminConsole\bin 설정하고 FileName 매개 변수를 로 Microsoft.ConfigurationManagement.exe설정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PropertyType
Value 매개 변수를 추가하면 ExpressionOperator 및 ExpectedValue와 함께 PropertyType을 사용합니다. 이러한 매개 변수를 사용하는 경우 파일은 이 애플리케이션의 존재를 나타내기 위해 규칙을 충족해야 합니다. 이 PropertyType 매개 변수는 평가할 파일 속성을 지정합니다.
예를 들어 이 매개 변수를 로 Version설정하고 ExpressionOperator를 로 설정하고 ExpectedValue를 IsEquals로 1.48.1.0설정합니다. 그런 다음 규칙은 지정된 파일이 동일한 파일 버전을 갖도록 확인합니다.
| 형식: | FileFolderProperty |
| 허용되는 값: | DateCreated, DateModified, Version, Size |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Value
Value 매개 변수를 추가할 때 파일은 이 애플리케이션의 존재를 나타내기 위해 규칙을 충족해야 합니다. ExpectedValue, ExpressionOperator 및 PropertyType 매개 변수와 함께 이 매개 변수를 사용합니다.
규칙을 평가하는 대신 파일이 있는지 확인하려면 Existence 매개 변수를 사용합니다.
| 형식: | SwitchParameter |
| 별칭: | ValueRule |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
출력
System.Object