New-CMTSStepConditionSoftware
Créez une condition logicielle installée pour une étape de séquence de tâches.
Syntaxe
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 des applets de commande Configuration Manager à 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 $conditionCet 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 |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 configuration Manager version 2107 AdminConsole.msi:
-
ProductCode: {B3842C82-95EB-472C-940A-D82C4A10857D} -
ProductName: Console Microsoft Endpoint Configuration Manager -
UpgradeCode: {B038D5E8-6C93-4A05-9E21-240324CFDF0E} -
Version: 5.2107.1059.1000
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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.