Share via

New-CMTSStepConditionFile

  • Referência
Módulo:
ConfigurationManager

Crie uma condição de propriedades de arquivo para uma etapa de sequência de tarefas.

Syntax

New-CMTSStepConditionFile
   [-FileDateTimeOperator <VariableOperatorType>]
   -FilePath <String>
   [-FileTimestamp <DateTime>]
   [-FileVersion <String>]
   [-VersionOperator <VariableOperatorType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para criar um objeto de condição de propriedades de arquivo para uma etapa de sequência de tarefas. Em seguida, use um dos cmdlets New-CMTSStep* ou Set-CMTSStep* com os parâmetros Condição ou AddCondition . Por exemplo, Set-CMTSStepApplyDataImage.

Para obter mais informações, consulte Usar o editor de sequência de tarefas: Condições.

Há três tipos de verificações que você pode fazer com essa condição:

  • Para verificar se o arquivo existe, use o parâmetro FilePath necessário.
  • Para verificar também a versão do arquivo, use os parâmetros FileVersion e VersionOperator .
  • Para verificar também o carimbo de data/hora do arquivo, use os parâmetros FileTimestamp e FileDateTimeOperator .

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1

Este exemplo verifica a existência e o carimbo de data/hora de um dos arquivos de ajuda do módulo Configuration Manager PowerShell. Ele cria um objeto de condição de arquivo para o arquivo e que seu carimbo de data/hora é maior que 2 de agosto de 2021.

Em seguida, ele usa o cmdlet Set-CMTSStepRunPowerShellScript para adicionar esse objeto de condição à etapa Executar Script do PowerShell da sequência de tarefas de implantação do sistema operacional padrão .

$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

Este script de exemplo cria a seguinte condição na etapa:

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"

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-FileDateTimeOperator

Ao usar o parâmetro FileTimestamp , use esse parâmetro para especificar o operador para a sequência de tarefas para avaliar o carimbo de data/hora do arquivo.

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

Especifique o caminho completo, incluindo o nome do arquivo para essa condição.

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

-FileTimestamp

Para avaliar o carimbo de data/hora do arquivo, use esse parâmetro para especificar um objeto datetime. Para obter esse objeto, use o cmdlet get-date interno.

Em seguida, use o parâmetro FileDateTimeOperator para definir o operador de avaliação.

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

-FileVersion

Para avaliar a versão do arquivo, use esse parâmetro para especificar a cadeia de caracteres de versão.

Em seguida, use o parâmetro VersionOperator para definir o operador de avaliação.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-VersionOperator

Ao usar o parâmetro FileVersion , use esse parâmetro para especificar o operador para a sequência de tarefas para avaliar a versão do arquivo.

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

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_TaskSequence_FileConditionExpression classe WMI do servidor.