New-CMTSStepConditionFile
Создайте условие свойств файла для шага последовательности задач.
Синтаксис
New-CMTSStepConditionFile
[-FileDateTimeOperator <VariableOperatorType>]
-FilePath <String>
[-FileTimestamp <DateTime>]
[-FileVersion <String>]
[-VersionOperator <VariableOperatorType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Этот командлет используется для создания объекта условия свойств файла для шага последовательности задач. Затем используйте один из командлетов New-CMTSStep* или Set-CMTSStep* с параметрами Condition или AddCondition . Например, Set-CMTSStepApplyDataImage.
Дополнительные сведения см . в разделе Использование редактора последовательности задач: Условия.
Существует три типа проверок, которые можно выполнить с помощью этого условия:
- Чтобы проверить, существует ли файл, используйте обязательный параметр FilePath .
- Чтобы также проверить версию файла, используйте параметры FileVersion и VersionOperator .
- Чтобы также проверить метку времени файла, используйте параметры FileTimestamp и FileDateTimeOperator .
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1
В этом примере проверяется наличие и метка времени для одного из файлов справки модуля PowerShell Configuration Manager. Он создает объект условия файла для файла, и его метка времени больше 2 августа 2021 г.
Затем он использует командлет Set-CMTSStepRunPowerShellScript , чтобы добавить этот объект условия на шаг Запуск скрипта PowerShell последовательности задач развертывания ОС по умолчанию .
$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
Этот пример скрипта создает следующее условие на шаге:
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"
Параметры
-Confirm
Перед запуском командлет запросит подтверждение.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FileDateTimeOperator
При использовании параметра FileTimestamp используйте этот параметр, чтобы указать оператор последовательности задач для оценки метки времени файла.
Тип: | VariableOperatorType |
Допустимые значения: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FilePath
Укажите полный путь, включая имя файла для этого условия.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FileTimestamp
Чтобы оценить метку времени файла, используйте этот параметр, чтобы указать объект datetime. Чтобы получить этот объект, используйте встроенный командлет Get-Date .
Затем используйте параметр FileDateTimeOperator , чтобы задать оператор оценки.
Тип: | DateTime |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FileVersion
Чтобы оценить версию файла, используйте этот параметр, чтобы указать строку версии.
Затем используйте параметр VersionOperator , чтобы задать оператор оценки.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-VersionOperator
При использовании параметра FileVersion используйте этот параметр, чтобы указать оператор для последовательности задач для оценки версии файла.
Тип: | VariableOperatorType |
Допустимые значения: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_TaskSequence_FileConditionExpression класс WMI сервера.