Freigeben über

Add-CMCIDetectionMethod

  • Referenz
Modul:
ConfigurationManager

Geben Sie an, wie der Client eine Anwendung erkennt.

Syntax

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>]

Beschreibung

Dieses Cmdlet gibt an, wie der Client eine Anwendung auf dem Gerät erkennt. Es gibt drei Erkennungsmethoden: Windows Installer-Erkennung, Erkennung durch eine bestimmte Anwendung und einen bestimmten Bereitstellungstyp und ein benutzerdefiniertes Skript zum Erkennen der Anwendung.

Beispiele

Beispiel 1: Windows Installer-Erkennung

$ci = Get-CMConfigurationItem -Name "testCI"

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

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

Beispiel 2: Bestimmte App und Bereitstellungstyp

$ci = Get-CMConfigurationItem -Name "testCI"

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

Beispiel 3: Erkennung benutzerdefinierter Skripts

$ci = Get-CMConfigurationItem -Name "testCI"

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

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

Parameter

-ApplicationName

Wenn Sie DetectionOption auf DeploymentTypefestlegen, verwenden Sie diesen Parameter, um den Namen einer Configuration Manager-Anwendung anzugeben. Verwenden Sie diesen Parameter mit DeploymentTypeID.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeploymentTypeId

Wenn Sie DetectionOption auf DeploymentTypefestlegen, verwenden Sie diesen Parameter, um die ID des Bereitstellungstyps der Configuration Manager-Anwendung anzugeben. Verwenden Sie diesen Parameter mit ApplicationName.

Verwenden Sie zum Abrufen der Bereitstellungstyp-ID das Cmdlet Get-CMDeploymentType , und verweisen Sie auf die Eigenschaft CI_ID .

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DetectionOption

Geben Sie die zu verwendende Erkennungsmethode an.

Typ:ApplicationDetectionMethod
Zulässige Werte:None, Msi, Script, DeploymentType
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Geben Sie ein Konfigurationselementobjekt für einen Anwendungsbereitstellungstyp an. Verwenden Sie Get-CMConfigurationItem, um dieses Objekt abzurufen.

Typ:IResultObject
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-IsPerUserInstallation

Legen Sie diesen Parameter auf fest $true , um anzugeben, dass er pro Benutzer installiert wird.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MsiFilePath

Wenn Sie DetectionOption auf Msifestlegen, verwenden Sie diesen Parameter, um den Pfad zur Windows Installer-Datei anzugeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScriptFile

Wenn Sie DetectionOption auf Scriptfestlegen, verwenden Sie diesen Parameter, um den Pfad zum Skript anzugeben. Verwenden Sie diesen Parameter mit ScriptLanguage.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScriptLanguage

Wenn Sie DetectionOption auf Scriptfestlegen, verwenden Sie diesen Parameter, um die Sprache des Skripts anzugeben. Verwenden Sie diesen Parameter mit ScriptFile und ScriptText.

Typ:ScriptingLanguage
Aliase:ScriptType
Zulässige Werte:PowerShell, VBScript, JScript
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScriptText

Wenn Sie DetectionOption auf Scriptfestlegen, verwenden Sie diesen Parameter, um den Text des Skripts anzugeben. Verwenden Sie diesen Parameter mit ScriptLanguage.

Typ:String
Aliase:ScriptContent
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object