New-CMDetectionClauseWindowsInstaller
Créez une clause de méthode de détection pour un code de produit MSI.
Syntaxe
New-CMDetectionClauseWindowsInstaller
-ExpectedValue <String>
-ExpressionOperator <WindowsInstallerRuleExpressionOperator>
-ProductCode <Guid>
[-PropertyType <MSIProperty>]
[-Value]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] New-CMDetectionClauseWindowsInstaller
-ProductCode <Guid>
[-Existence]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Description
Utilisez cette applet de commande pour créer une clause dans une méthode de détection sur une application. Cette clause est une règle pour un code de produit Windows Installer (MSI) qui indique la présence d’une application.
Après avoir utilisé cette applet de commande, utilisez l’une des applets de commande Add- ou Set- pour les types de déploiement. Transmettez cet objet de clause de détection aux paramètres AddDetectionClause ou RemoveDetectionClause .
Pour regrouper les clauses de détection, utilisez le paramètre GroupDetectionClauses sur les applets de commande de type de déploiement.
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 : Détecter l’existence d’un code de produit MSI
Cet exemple ajoute le code de produit MSI de la console Configuration Manager au type de déploiement.
$clause = New-CMDetectionClauseWindowsInstaller -Existence -ProductCode 4F7840A9-9816-45E2-9F6C-F7067A8BC0FD
Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clauseParamètres
-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 |
-Existence
Lorsque vous ajoutez ce paramètre, le code de produit MSI doit exister sur le système cible pour indiquer la présence de cette application.
Au lieu de simplement exister, pour évaluer également une condition de version, utilisez le paramètre Value .
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ExpectedValue
Lorsque vous ajoutez le paramètre Value , utilisez ExpectedValue avec PropertyType et ExpressionOperator. Lorsque vous utilisez ces paramètres, la version MSI doit satisfaire à la règle pour indiquer la présence de cette application. Ce paramètre ExpectedValue spécifie la valeur à comparer à l’appareil.
| 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 |
-ExpressionOperator
Lorsque vous ajoutez le paramètre Value , utilisez ExpressionOperator avec PropertyType et ExpectedValue. Lorsque vous utilisez ces paramètres, la version MSI doit satisfaire à la règle pour indiquer la présence de cette application. Ce paramètre ExpressionOperator spécifie l’opérateur pour comparer la valeur de l’appareil à la valeur attendue.
À compter de la version 2010, le type de paramètre est passé de RuleExpressionOperator à WindowsInstallerRuleExpressionOperator.
| Type: | WindowsInstallerRuleExpressionOperator |
| Valeurs acceptées: | IsEquals, NotEquals, GreaterThan, LessThan, GreaterEquals, LessEquals |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| 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 |
-ProductCode
Spécifiez le code de produit Windows Installer qui indique la présence de cette application. Le format est un GUID, par exemple 4F7840A9-9816-45E2-9F6C-F7067A8BC0FD.
| Type: | Guid |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PropertyType
Lorsque vous ajoutez le paramètre Value , utilisez PropertyType avec ExpressionOperator et ExpectedValue. Lorsque vous utilisez ces paramètres, la version MSI doit satisfaire à la règle pour indiquer la présence de cette application.
Ce paramètre PropertyType ne prend actuellement en charge qu’une seule valeur, ProductVersion.
| Type: | MSIProperty |
| Valeurs acceptées: | ProductVersion |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Value
Lorsque vous ajoutez le paramètre Value , ainsi que le code de produit, la version MSI doit également satisfaire à la règle pour indiquer la présence de cette application. Utilisez ce paramètre avec les paramètres suivants : ExpectedValue, ExpressionOperator et PropertyType.
Au lieu d’évaluer une règle, pour vérifier simplement le code de produit MSI, utilisez le paramètre Existence .
| Type: | SwitchParameter |
| Alias: | ValueRule |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
None
Sorties
System.Object