Share via

New-CMDetectionClauseDirectory

  • 참조
모듈:
ConfigurationManager

파일 시스템 디렉터리에 대한 검색 방법 절을 만듭니다.

Syntax

New-CMDetectionClauseDirectory
   -DirectoryName <String>
   -PropertyType <FileFolderProperty>
   -ExpectedValue <String[]>
   -ExpressionOperator <FileFolderRuleExpressionOperator>
   [-Is64Bit]
   -Path <String>
   [-Value]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
New-CMDetectionClauseDirectory
   -DirectoryName <String>
   [-Is64Bit]
   -Path <String>
   [-Existence]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 애플리케이션의 검색 메서드에 절을 만듭니다. 이 절은 애플리케이션의 존재를 나타내는 파일 시스템 폴더에 대한 규칙입니다.

폴더 대신 파일을 검색하려면 New-CMDetectionClauseFile cmdlet을 사용합니다.

이 cmdlet을 사용한 후 배포 유형에 추가 또는Set- cmdlet 중 하나를 사용합니다. 이 검색 절 개체를 AddDetectionClause 또는 RemoveDetectionClause 매개 변수에 전달합니다.

검색 절을 그룹화하려면 배포 유형 cmdlet에서 GroupDetectionClauses 매개 변수를 사용합니다.

참고

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

예제

예제 1: 존재 감지 방법 추가

이 예제에서는 특정 제품 ID 및 디렉터리 이름이 필요한 검색 절을 추가합니다.

$app = Get-CMApplication -ApplicationName "CentralApp"
$guid = "9900a338-484b-4a18-884e-bce87654ce1b"
$clause1 = New-CMDetectionClauseWindowsInstaller -ProductCode $guid -Value -ExpressionOperator IsEquals -ExpectedValue "1.1.1.1"
$clause2 = New-CMDetectionClauseDirectory -DirectoryName "mymsi" -Path "C:\" -Existence

$app | Add-CMMsiDeploymentType -ContentLocation "\\myserver\mypath\mymsi.msi" -Force -AddDetectionClause ($clause1, $clause2)

예제 2: 규칙 평가 검색 방법 추가

다음은 2020년 12월 30일 이후에 폴더가 수정되었는지 확인하는 규칙 기반 검색 절을 추가하는 예제입니다.

$clause1 = New-CMDetectionClauseDirectory -DirectoryName "AdminConsole" -Path "%ProgramFiles(x86)%\Microsoft Endpoint Manager" -Value -PropertyType DateCreated -ExpressionOperator GreaterThan -ExpectedValue "2020-11-30T08:00:00Z"

Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1

매개 변수

-DirectoryName

애플리케이션의 존재를 나타내는 폴더의 이름을 지정합니다. Path 매개 변수를 사용하여 이 폴더의 경로를 지정합니다.

예를 들어 Configuration Manager 콘솔은 기본적으로 C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole를 설치합니다. 이 폴더에 대한 규칙을 만들려면 이 매개 변수를 로 AdminConsole 설정하고 Path 매개 변수를 로 %ProgramFiles(x86)%\Microsoft Endpoint Manager설정합니다.

Type:String
Position:Named
Default value:None
Required:True
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

-Existence

이 매개 변수를 추가할 때 이 애플리케이션의 존재를 나타내려면 대상 시스템에 폴더가 있어야 합니다.

단순히 존재하는 대신 이 폴더의 속성에 대한 규칙을 평가하려면 Value 매개 변수를 사용합니다.

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

-ExpectedValue

Value 매개 변수를 추가하면 PropertyType 및 ExpressionOperator와 함께 ExpectedValue를 사용합니다. 이러한 매개 변수를 사용하는 경우 폴더는 이 애플리케이션의 존재를 나타내는 규칙을 충족해야 합니다. 이 ExpectedValue 매개 변수는 파일 시스템과 비교할 값을 지정합니다.

이 절의 PropertyType 매개 변수는 폴더를 만들거나 수정한 날짜만 허용하므로 이 값은 유효한 datetime이 있는 문자열입니다. 예를 들면 "2020-11-30T08:00:00Z"와 같습니다.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExpressionOperator

Value 매개 변수를 추가하면 PropertyType 및 ExpectedValue와 함께 ExpressionOperator를 사용합니다. 이러한 매개 변수를 사용하는 경우 폴더는 이 애플리케이션의 존재를 나타내는 규칙을 충족해야 합니다. 이 ExpressionOperator 매개 변수는 파일 시스템 값을 예상 값과 비교할 연산자를 지정합니다.

버전 2010부터 매개 변수 형식이 RuleExpressionOperator 에서 FileFolderRuleExpressionOperator로 변경되었습니다.

Type:FileFolderRuleExpressionOperator
Accepted values:IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf
Position:Named
Default value:None
Required:True
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

-Is64Bit

이 매개 변수를 추가하여 이 폴더가 64비트 시스템의 32비트 애플리케이션과 연결되어 있음을 나타냅니다.

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

-Path

애플리케이션의 존재를 나타내는 폴더에 대한 파일 시스템의 경로를 지정합니다. DirectoryName 매개 변수를 사용하여 폴더의 이름을 지정합니다.

예를 들어 Configuration Manager 콘솔은 기본적으로 C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole를 설치합니다. 이 폴더에 대한 규칙을 만들려면 이 매개 변수를 로 %ProgramFiles(x86)%\Microsoft Endpoint Manager 설정하고 DirectoryName 매개 변수를 로 AdminConsole설정합니다.

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

-PropertyType

Value 매개 변수를 추가하면 ExpressionOperator 및 ExpectedValue와 함께 PropertyType을 사용합니다. 이러한 매개 변수를 사용하는 경우 폴더는 이 애플리케이션의 존재를 나타내는 규칙을 충족해야 합니다. 이 PropertyType 매개 변수는 평가할 폴더 속성을 지정합니다.

Type:FileFolderProperty
Accepted values:DateCreated, DateModified
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value

Value 매개 변수를 추가할 때 폴더는 이 애플리케이션의 존재를 나타내기 위해 규칙을 충족해야 합니다. ExpectedValue, ExpressionOperator 및 PropertyType 매개 변수와 함께 이 매개 변수를 사용합니다.

규칙을 평가하는 대신 폴더가 있는지 확인하려면 Existence 매개 변수를 사용합니다.

Type:SwitchParameter
Aliases:ValueRule
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

입력

None

출력

System.Object