New-CMTSStepConditionFile
Crie uma condição de propriedades de ficheiro para um passo de sequência de tarefas.
Sintaxe
New-CMTSStepConditionFile
[-FileDateTimeOperator <VariableOperatorType>]
-FilePath <String>
[-FileTimestamp <DateTime>]
[-FileVersion <String>]
[-VersionOperator <VariableOperatorType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Utilize este cmdlet para criar um objeto de condição de propriedades de ficheiro 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 três tipos de verificações que pode fazer com esta condição:
- Para verificar se o ficheiro existe, utilize o parâmetro FilePath necessário.
- Para verificar também a versão do ficheiro, utilize os parâmetros FileVersion e VersionOperator .
- Para verificar também o carimbo de data/hora do ficheiro, utilize os parâmetros FileTimestamp e FileDateTimeOperator .
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 de um dos ficheiros de ajuda do módulo do PowerShell do Configuration Manager. Cria um objeto de condição de ficheiro para o ficheiro 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 .
$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 $conditionEste script de exemplo cria a seguinte condição no passo:
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.
| 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 |
-FileDateTimeOperator
Quando utilizar o parâmetro FileTimestamp , utilize este parâmetro para especificar o operador da sequência de tarefas para avaliar o carimbo de data/hora do ficheiro.
| 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 |
-FilePath
Especifique o caminho completo, incluindo o nome do ficheiro 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 |
-FileTimestamp
Para avaliar o carimbo de data/hora do ficheiro, 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 FileDateTimeOperator 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 |
-FileVersion
Para avaliar a versão do ficheiro, utilize este parâmetro para especificar a cadeia de versão.
Em seguida, utilize o parâmetro VersionOperator para definir o operador de avaliação.
| Tipo: | String |
| 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 |
-VersionOperator
Quando utilizar o parâmetro FileVersion , utilize este parâmetro para especificar o operador da sequência de tarefas para avaliar a versão do ficheiro.
| 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 |
-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_FileConditionExpression classe WMI de servidor.