New-CMTSStepConditionFolder
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.