Partager via


Add-CMCIDetectionMethod

Spécifiez la façon dont le client détecte une application.

Syntaxe

Add-CMCIDetectionMethod
   [-InputObject] <IResultObject>
   -DetectionOption <ApplicationDetectionMethod>
   [-MsiFilePath <String>]
   [-IsPerUserInstallation <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptingLanguage>]
   [-ScriptText <String>]
   [-ApplicationName <String>]
   [-DeploymentTypeId <String>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cette applet de commande spécifie comment le client détecte une application sur l’appareil. Il existe trois méthodes de détection : la détection de Windows Installer, la détection par une application et un type de déploiement spécifiques, et un script personnalisé pour détecter l’application.

Exemples

Exemple 1 : détection de Windows Installer

$ci = Get-CMConfigurationItem -Name "testCI"

$msiFilePath = "C:\tools\CCMTools\Orca.Msi"

$ci | Add-CMCIDetectionMethod -DetectionOption Msi -MsiFilePath $msiFilePath

Exemple 2 : application et type de déploiement spécifiques

$ci = Get-CMConfigurationItem -Name "testCI"

$ci | Add-CMCIDetectionMethod -DetectionOption DeploymentType -ApplicationName "testApp" -DeploymentTypeId "392672"

Exemple 3 : détection de script personnalisée

$ci = Get-CMConfigurationItem -Name "testCI"

$scriptFile  = "C:\share\testScript.ps1"

$ci | Add-CMCIDetectionMethod -DetectionOption Script -ScriptLanguage PowerShell -ScriptFile $scriptFile

Paramètres

-ApplicationName

Lorsque vous définissez DetectionOptionDeploymentTypesur , utilisez ce paramètre pour spécifier le nom d’une application Configuration Manager. Utilisez ce paramètre avec DeploymentTypeID.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-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

-DeploymentTypeId

Lorsque vous définissez DetectionOption sur DeploymentType, utilisez ce paramètre pour spécifier l’ID du type de déploiement de l’application Configuration Manager. Utilisez ce paramètre avec ApplicationName.

Pour obtenir l’ID de type de déploiement, utilisez l’applet de commande Get-CMDeploymentType et référencez la propriété CI_ID .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DetectionOption

Spécifiez la méthode de détection à utiliser.

Type:ApplicationDetectionMethod
Valeurs acceptées:None, Msi, Script, DeploymentType
Position:Named
Valeur par défaut:None
Obligatoire:True
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

-InputObject

Spécifiez un objet élément de configuration pour un type de déploiement d’application. Pour obtenir cet objet, utilisez Get-CMConfigurationItem.

Type:IResultObject
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-IsPerUserInstallation

Définissez ce paramètre sur $true pour spécifier qu’il est installé par utilisateur.

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

Lorsque vous définissez DetectionOption sur Msi, utilisez ce paramètre pour spécifier le chemin d’accès au fichier Windows Installer.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassThru

Renvoie un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

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

-ScriptFile

Lorsque vous définissez DetectionOption sur Script, utilisez ce paramètre pour spécifier le chemin d’accès au script. Utilisez ce paramètre avec ScriptLanguage.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScriptLanguage

Lorsque vous définissez DetectionOption sur Script, utilisez ce paramètre pour spécifier la langue du script. Utilisez ce paramètre avec ScriptFile et ScriptText.

Type:ScriptingLanguage
Alias:ScriptType
Valeurs acceptées:PowerShell, VBScript, JScript
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScriptText

Lorsque vous définissez DetectionOption sur Script, utilisez ce paramètre pour spécifier le texte du script. Utilisez ce paramètre avec ScriptLanguage.

Type:String
Alias:ScriptContent
Position:Named
Valeur par défaut:None
Obligatoire:False
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object