Share via

New-CMTSStepConditionFile

  • 참조
모듈:
ConfigurationManager

작업 순서 단계에 대한 파일 속성 조건을 만듭니다.

Syntax

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을 실행하기 전에 확인 메시지를 표시합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
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

-FileDateTimeOperator

FileTimestamp 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 파일의 타임스탬프를 평가하는 작업 순서에 대한 연산자를 지정합니다.

Type:VariableOperatorType
Accepted values:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilePath

이 조건의 파일 이름을 포함하여 전체 경로를 지정합니다.

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

-FileTimestamp

파일의 타임스탬프를 평가하려면 이 매개 변수를 사용하여 datetime 개체를 지정합니다. 이 개체를 얻으려면 기본 제공 Get-Date cmdlet을 사용합니다.

그런 다음 FileDateTimeOperator 매개 변수를 사용하여 평가 연산자를 설정합니다.

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

-FileVersion

파일의 버전을 평가하려면 이 매개 변수를 사용하여 버전 문자열을 지정합니다.

그런 다음 VersionOperator 매개 변수를 사용하여 평가 연산자를 설정합니다.

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

-VersionOperator

FileVersion 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 작업 순서에 대한 연산자를 지정하여 파일의 버전을 평가합니다.

Type:VariableOperatorType
Accepted values:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

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

입력

None

출력

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_TaskSequence_FileConditionExpression 서버 WMI 클래스를 참조하세요.