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

Перед запуском командлет запросит подтверждение.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsAnyVersion

Используйте этот параметр, чтобы определить, как условие соответствует кодам MSI:

  • $true: соответствует любой версии этого продукта, только код обновления MSI
  • $false: соответствие этому конкретному продукту, коду продукта MSI и коду обновления

Если этот параметр не указан, он по умолчанию соответствует конкретному продукту.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MsiFilePath

Укажите путь к MSI-файлу для вычисления. Командлет считывает сведения о продукте из этого MSI. Путь к MSI не сохраняется, только сведения о продукте.

Например, он сохраняет следующие сведения для Configuration Manager версии 2107 AdminConsole.msi:

  • ProductCode: {B3842C82-95EB-472C-940A-D82C4A10857D}
  • ProductName: консоль Configuration Manager конечной точки Майкрософт
  • UpgradeCode: {B038D5E8-6C93-4A05-9E21-240324CFDF0E}
  • Version: 5.2107.1059.1000
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

None

Выходные данные

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе класс WMI сервера SMS_TaskSequence_SoftwareConditionExpression.