New-CMTSStepConditionFolder
Criar uma condição de propriedades de pasta para um passo de sequência de tarefas.
Sintaxe
New-CMTSStepConditionFolder
[-FolderDateTimeOperator <VariableOperatorType>]
-FolderPath <String>
[-FolderTimestamp <DateTime>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Utilize este cmdlet para criar um objeto de condição de propriedades de pasta para um passo de sequência de tarefas. Em seguida, utilize um dos cmdlets New-CMTSStep* ou Set-CMTSStep* com os parâmetros Condition ou AddCondition . Por exemplo, Set-CMTSStepApplyDataImage.
Para obter mais informações, veja Utilizar o editor de sequência de tarefas: Condições.
Existem dois tipos de verificações que pode fazer com esta condição:
- Para verificar se a pasta existe, utilize o parâmetro FolderPath necessário.
- Para verificar também o carimbo de data/hora da pasta, utilize os parâmetros FolderTimestamp e FolderDateTimeOperator .
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1
Este exemplo verifica a existência e o carimbo de data/hora da pasta de ficheiros de ajuda do módulo do PowerShell do Configuration Manager. Cria um objeto de condição para a pasta e que o carimbo de data/hora é superior a 2 de agosto de 2021.
Em seguida, utiliza o cmdlet Set-CMTSStepRunPowerShellScript para adicionar este objeto de condição ao passo Executar Script do PowerShell da sequência de tarefas de implementação do SO Predefinido .
$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 $conditionEste script de exemplo cria a seguinte condição no passo:
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.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-FolderDateTimeOperator
Quando utilizar o parâmetro FolderTimestamp , utilize este parâmetro para especificar o operador da sequência de tarefas para avaliar o carimbo de data/hora da pasta.
| Tipo: | VariableOperatorType |
| Valores aceitos: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-FolderPath
Especifique o caminho completo da pasta para esta condição.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-FolderTimestamp
Para avaliar o carimbo de data/hora da pasta, utilize este parâmetro para especificar um objeto datetime. Para obter este objeto, utilize o cmdlet Get-Date incorporado.
Em seguida, utilize o parâmetro FolderDateTimeOperator para definir o operador de avaliação.
| Tipo: | DateTime |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
None
Saídas
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_FolderConditionExpression classe WMI de servidor.