New-CMTSStepConditionSoftware

  • Referencia
Módulo:
ConfigurationManager

Cree una condición de software instalada para un paso de secuencia de tareas.

Syntax

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

Description

Use este cmdlet para crear un objeto de condición de software instalado para un paso de secuencia de tareas. A continuación, use uno de los cmdlets New-CMTSStep* o Set-CMTSStep* con los parámetros Condition o AddCondition . Por ejemplo, Set-CMTSStepApplyDataImage.

Para obtener más información, vea Usar el editor de secuencia de tareas: Condiciones.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1

En este ejemplo se crea primero un objeto de condición para la msi de consola de Configuration Manager.

A continuación, usa el cmdlet Set-CMTSStepRunPowerShellScript para agregar este objeto de condición al paso Ejecutar script de PowerShell de la secuencia de tareas de implementación predeterminada del sistema operativo .

$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 ejemplo crea la siguiente condición en el paso:

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

Parámetros

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con 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 cómo coincide la condición con los códigos MSI:

  • $true: coincide con cualquier versión de este producto, solo código de actualización msi
  • $false: coincide con este producto específico, el código de producto MSI y el código de actualización

Si no especifica este parámetro, de forma predeterminada coincide con el producto específico.

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

-MsiFilePath

Especifique la ruta de acceso al archivo MSI que se va a evaluar. El cmdlet lee los detalles del producto de esta MSI. La ruta de acceso a msi no se guarda, solo los detalles del producto.

Por ejemplo, guarda los detalles siguientes para la versión 2107 de Configuration Manager 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

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

None

Salidas

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_SoftwareConditionExpression clase WMI de servidor.