Freigeben über

New-CMDetectionClauseWindowsInstaller

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie eine Erkennungsmethodenklausel für einen MSI-Produktcode.

Syntax

New-CMDetectionClauseWindowsInstaller
   -ExpectedValue <String>
   -ExpressionOperator <WindowsInstallerRuleExpressionOperator>
   -ProductCode <Guid>
   [-PropertyType <MSIProperty>]
   [-Value]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
New-CMDetectionClauseWindowsInstaller
   -ProductCode <Guid>
   [-Existence]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine -Klausel in einer Erkennungsmethode für eine Anwendung zu erstellen. Diese Klausel ist eine Regel für einen Windows Installer (MSI)-Produktcode, der angibt, dass eine Anwendung vorhanden ist.

Nachdem Sie dieses Cmdlet verwendet haben, verwenden Sie eines der Add- oder Set-Cmdlets für Bereitstellungstypen. Übergeben Sie dieses Erkennungsklauselobjekt entweder an die Parameter AddDetectionClause oder RemoveDetectionClause .

Verwenden Sie zum Gruppieren von Erkennungsklauseln den GroupDetectionClauses-Parameter für die Cmdlets des Bereitstellungstyps.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Erkennen des Vorhandenseins eines MSI-Produktcodes

In diesem Beispiel wird dem Bereitstellungstyp der MSI-Produktcode der Configuration Manager-Konsole hinzugefügt.

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

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

Parameter

-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

-Existence

Wenn Sie diesen Parameter hinzufügen, muss der MSI-Produktcode auf dem Zielsystem vorhanden sein, um das Vorhandensein dieser Anwendung anzuzeigen.

Verwenden Sie den Value-Parameter , um auch eine Versionsbedingung auszuwerten, anstatt nur zu existieren.

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

-ExpectedValue

Wenn Sie den Value-Parameter hinzufügen, verwenden Sie ExpectedValue mit PropertyType und ExpressionOperator. Wenn Sie diese Parameter verwenden, muss die MSI-Version die Regel erfüllen, um anzugeben, dass diese Anwendung vorhanden ist. Dieser ExpectedValue-Parameter gibt den Wert an, der mit dem Gerät verglichen werden soll.

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

-ExpressionOperator

Wenn Sie den Value-Parameter hinzufügen, verwenden Sie ExpressionOperator mit PropertyType und ExpectedValue. Wenn Sie diese Parameter verwenden, muss die MSI-Version die Regel erfüllen, um anzugeben, dass diese Anwendung vorhanden ist. Dieser ExpressionOperator-Parameter gibt den Operator an, der den Wert des Geräts mit dem erwarteten Wert vergleichen soll.

Ab Version 2010 wurde der Parametertyp von RuleExpressionOperator in WindowsInstallerRuleExpressionOperator geändert.

Typ:WindowsInstallerRuleExpressionOperator
Zulässige Werte:IsEquals, NotEquals, GreaterThan, LessThan, GreaterEquals, LessEquals
Position:Named
Standardwert:None
Erforderlich:True
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

-ProductCode

Geben Sie den Windows Installer-Produktcode an, der das Vorhandensein dieser Anwendung angibt. Das Format ist eine GUID, z. B 4F7840A9-9816-45E2-9F6C-F7067A8BC0FD. .

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PropertyType

Wenn Sie den Value-Parameter hinzufügen, verwenden Sie PropertyType mit ExpressionOperator und ExpectedValue. Wenn Sie diese Parameter verwenden, muss die MSI-Version die Regel erfüllen, um anzugeben, dass diese Anwendung vorhanden ist.

Dieser PropertyType-Parameter unterstützt derzeit nur einen einzelnen Wert, ProductVersion.

Typ:MSIProperty
Zulässige Werte:ProductVersion
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Value

Wenn Sie den Parameter Value zusammen mit dem Produktcode hinzufügen, muss die MSI-Version auch die Regel erfüllen, um anzugeben, dass diese Anwendung vorhanden ist. Verwenden Sie diesen Parameter mit den folgenden Parametern: ExpectedValue, ExpressionOperator und PropertyType.

Anstatt eine Regel auszuwerten, verwenden Sie den Parameter Existence , um nur den MSI-Produktcode zu überprüfen.

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

Eingaben

None

Ausgaben

System.Object