Partager via

New-CMDetectionClauseWindowsInstaller

  • Référence
Module:
ConfigurationManager

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 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 : Détecter l’existence d’un code de produit MSI

Cet exemple ajoute le code de produit MSI Configuration Manager console au type de déploiement.

$clause = New-CMDetectionClauseWindowsInstaller -Existence -ProductCode 4F7840A9-9816-45E2-9F6C-F7067A8BC0FD

Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause

Paramè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