Share via

New-CMTSStepConditionSoftware

  • Référence
Module:
ConfigurationManager

Créez une condition logicielle installée pour une étape de séquence de tâches.

Syntax

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

Description

Utilisez cette applet de commande pour créer un objet de condition logicielle installé pour une étape de séquence de tâches. Utilisez ensuite l’une des applets de commande New-CMTSStep* ou Set-CMTSStep* avec les paramètres Condition ou AddCondition . Par exemple, Set-CMTSStepApplyDataImage.

Pour plus d’informations, consultez Utiliser l’éditeur de séquence de tâches : conditions.

Remarque

Exécutez Configuration Manager applets de commande à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1

Cet exemple crée d’abord un objet de condition pour le MSI de la console Configuration Manager.

Il utilise ensuite l’applet de commande Set-CMTSStepRunPowerShellScript pour ajouter cet objet de condition à l’étape Exécuter le script PowerShell de la séquence de tâches de déploiement du système d’exploitation par défaut .

$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

Cet exemple de script crée la condition suivante à l’étape :

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

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-IsAnyVersion

Utilisez ce paramètre pour déterminer comment la condition correspond aux codes MSI :

  • $true: Correspond à n’importe quelle version de ce produit, code de mise à niveau MSI uniquement
  • $false: Faire correspondre ce produit spécifique, le code de produit MSI et le code de mise à niveau

Si vous ne spécifiez pas ce paramètre, il correspond par défaut au produit spécifique.

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

-MsiFilePath

Spécifiez le chemin du fichier MSI à évaluer. L’applet de commande lit les détails du produit à partir de cette MSI. Le chemin d’accès au MSI n’est pas enregistré, mais uniquement les détails du produit.

Par exemple, il enregistre les détails suivants pour la Configuration Manager version 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

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

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

Entrées

None

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_TaskSequence_SoftwareConditionExpression classe WMI du serveur.