New-CMTSStepConditionFolder

  • Ссылка
Модуль:
ConfigurationManager

Создайте условие свойств папки для шага последовательности задач.

Синтаксис

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 сервера.