Share via

New-CMTSStepConditionSoftware

  • Referência
Módulo:
ConfigurationManager

Crie uma condição de software instalada para uma etapa de sequência de tarefas.

Syntax

New-CMTSStepConditionSoftware
   [-IsAnyVersion <Boolean>]
   -MsiFilePath <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para criar um objeto de condição de software instalado para uma etapa de sequência de tarefas. Em seguida, use um dos cmdlets New-CMTSStep* ou Set-CMTSStep* com os parâmetros Condição ou AddCondition . Por exemplo, Set-CMTSStepApplyDataImage.

Para obter mais informações, consulte Usar o editor de sequência de tarefas: Condições.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1

Este exemplo cria primeiro um objeto de condição para o MSI do console Configuration Manager.

Em seguida, ele usa o cmdlet Set-CMTSStepRunPowerShellScript para adicionar esse objeto de condição à etapa Executar Script do PowerShell da sequência de tarefas de implantação do sistema operacional padrão .

$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

Este script de exemplo cria a seguinte condição na etapa:

Software An version of "Microsoft Endpoint Configuration Manager Console" installed

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-IsAnyVersion

Use este parâmetro para determinar como a condição corresponde aos códigos MSI:

  • $true: corresponder a qualquer versão deste produto, somente código de atualização MSI
  • $false: corresponder a este produto específico, código de produto MSI e código de atualização

Se você não especificar esse parâmetro, por padrão, ele corresponderá ao produto específico.

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

-MsiFilePath

Especifique o caminho para o arquivo MSI a ser avaliado. O cmdlet lê os detalhes do produto deste MSI. O caminho para o MSI não é salvo, apenas os detalhes do produto.

Por exemplo, ele salva os seguintes detalhes para o Configuration Manager versão 2107 AdminConsole.msi:

  • ProductCode: {B3842C82-95EB-472C-940A-D82C4A10857D}
  • ProductName: Microsoft Endpoint Configuration Manager Console
  • 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

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_TaskSequence_SoftwareConditionExpression classe WMI do servidor.