New-CMTSStepConditionFile
작업 순서 단계에 대한 파일 속성 조건을 만듭니다.
구문
New-CMTSStepConditionFile
[-FileDateTimeOperator <VariableOperatorType>]
-FilePath <String>
[-FileTimestamp <DateTime>]
[-FileVersion <String>]
[-VersionOperator <VariableOperatorType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
이 cmdlet을 사용하여 작업 순서 단계에 대한 파일 속성 조건 개체를 만듭니다. 그런 다음 조건 또는 AddCondition 매개 변수와 함께 New-CMTSStep* 또는 Set-CMTSStep* cmdlet 중 하나를 사용합니다. 예를 들어 Set-CMTSStepApplyDataImage입니다.
자세한 내용은 작업 순서 편집기 사용: 조건을 참조하세요.
이 조건으로 수행할 수 있는 세 가지 유형의 검사가 있습니다.
- 파일이 있는지 확인하려면 필요한 FilePath 매개 변수를 사용합니다.
- 파일 버전도 확인하려면 FileVersion 및 VersionOperator 매개 변수를 사용합니다.
- 또한 파일 타임스탬프를 확인하려면 FileTimestamp 및 FileDateTimeOperator 매개 변수를 사용합니다.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>
). 자세한 내용은 시작을 참조하세요.
예제
예 1
이 예제에서는 Configuration Manager PowerShell 모듈 도움말 파일 중 하나에 대한 존재 및 타임스탬프를 확인합니다. 파일에 대한 파일 조건 개체를 만들고 해당 타임스탬프가 2021년 8월 2일보다 큽니다.
그런 다음 Set-CMTSStepRunPowerShellScript cmdlet을 사용하여 기본 OS 배포 작업 순서의 PowerShell 스크립트 실행 단계에 이 조건 개체를 추가합니다.
$file = "C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US\AdminUI.PS.dll-Help.xml"
$datetime = Get-Date ("August 2, 2021")
$condition = New-CMTSStepConditionFile -FilePath $file -FileTimestamp $datetime -FileDateTimeOperator Greater
$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"
Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -AddCondition $condition
이 샘플 스크립트는 단계에서 다음 조건을 만듭니다.
File C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US\AdminUI.PS.dll-Help.xml exists and timestamp greater than "8/1/2021 16:00:00"
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-FileDateTimeOperator
FileTimestamp 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 작업 순서에 대한 연산자를 지정하여 파일의 타임스탬프를 평가합니다.
형식: | VariableOperatorType |
허용되는 값: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-FilePath
이 조건의 파일 이름을 포함하여 전체 경로를 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-FileTimestamp
파일의 타임스탬프를 평가하려면 이 매개 변수를 사용하여 datetime 개체를 지정합니다. 이 개체를 얻으려면 기본 제공 Get-Date cmdlet을 사용합니다.
그런 다음 FileDateTimeOperator 매개 변수를 사용하여 평가 연산자를 설정합니다.
형식: | DateTime |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-FileVersion
파일의 버전을 평가하려면 이 매개 변수를 사용하여 버전 문자열을 지정합니다.
그런 다음 VersionOperator 매개 변수를 사용하여 평가 연산자를 설정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VersionOperator
FileVersion 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 작업 순서에 대한 연산자를 지정하여 파일의 버전을 평가합니다.
형식: | VariableOperatorType |
허용되는 값: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
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_FileConditionExpression 서버 WMI 클래스를 참조하세요.