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