New-CMTSStepConditionSoftware
Создайте установленное условие программного обеспечения для шага последовательности задач.
Синтаксис
New-CMTSStepConditionSoftware
[-IsAnyVersion <Boolean>]
-MsiFilePath <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Используйте этот командлет, чтобы создать установленный объект условия программного обеспечения для шага последовательности задач. Затем используйте один из командлетов New-CMTSStep* или Set-CMTSStep* с параметрами Condition или AddCondition . Например, Set-CMTSStepApplyDataImage.
Дополнительные сведения см . в разделе Использование редактора последовательности задач: Условия.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1
В этом примере сначала создается объект условия для MSI консоли Configuration Manager.
Затем он использует командлет Set-CMTSStepRunPowerShellScript , чтобы добавить этот объект условия на шаг Запуск скрипта PowerShell последовательности задач развертывания ОС по умолчанию .
$msi = "\\cm01.contoso.com\SMS_XYZ\bin\i386\adminconsole.msi"
$condition = New-CMTSStepConditionSoftware -MsiFilePath $msi -IsAnyVersion $true
$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"
Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -AddCondition $condition
Этот пример скрипта создает следующее условие на шаге:
Software An version of "Microsoft Endpoint Configuration Manager Console" installed
Параметры
-Confirm
Перед запуском командлет запросит подтверждение.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-IsAnyVersion
Используйте этот параметр, чтобы определить, как условие соответствует кодам MSI:
-
$true
: соответствует любой версии этого продукта, только код обновления MSI -
$false
: соответствие этому конкретному продукту, коду продукта MSI и коду обновления
Если этот параметр не указан, он по умолчанию соответствует конкретному продукту.
Тип: | Boolean |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MsiFilePath
Укажите путь к MSI-файлу для вычисления. Командлет считывает сведения о продукте из этого MSI. Путь к MSI не сохраняется, только сведения о продукте.
Например, он сохраняет следующие сведения для Configuration Manager версии 2107 AdminConsole.msi:
-
ProductCode
: {B3842C82-95EB-472C-940A-D82C4A10857D} -
ProductName
: консоль Microsoft Endpoint Configuration Manager -
UpgradeCode
: {B038D5E8-6C93-4A05-9E21-240324CFDF0E} -
Version
: 5.2107.1059.1000
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_TaskSequence_SoftwareConditionExpression класс WMI сервера.