Share via

New-CMTSStepConditionFolder

  • Referência
Módulo:
ConfigurationManager

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

Syntax

New-CMTSStepConditionFolder
   [-FolderDateTimeOperator <VariableOperatorType>]
   -FolderPath <String>
   [-FolderTimestamp <DateTime>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

Para obter mais informações, consulte Use the task sequence editor: Conditions.

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

  • Para verificar se a pasta existe, use o parâmetro FolderPath necessário.
  • Para verificar também o data/hora da pasta, use os parâmetros FolderTimestamp e FolderDateTimeOperator.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1

Este exemplo verifica a existência e o data/hora da pasta de arquivos de ajuda do módulo do PowerShell do Configuration Manager. Ele cria um objeto de condição para a pasta e que seu 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.

$folder = "C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US"
$datetime = Get-Date ("August 2, 2021")

$condition = New-CMTSStepConditionFolder -FolderPath $folder -FolderTimestamp $datetime -FolderDateTimeOperator 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:

Folder C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US 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
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-FolderDateTimeOperator

Ao usar o parâmetro FolderTimestamp, use esse parâmetro para especificar o operador da sequência de tarefas para avaliar o timestamp da pasta.

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

-FolderPath

Especifique o caminho completo da pasta para essa condição.

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

-FolderTimestamp

Para avaliar o timestamp da pasta, use esse parâmetro para especificar um objeto datetime. Para obter esse objeto, use o cmdlet Get-Date integrado.

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

Type:DateTime
Position:Named
Default value:None
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). Não é possível combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Nenhum

Saídas

IResultObject

Observações

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