Freigeben über

New-CMDetectionClauseRegistryKey

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie eine Erkennungsmethodenklausel für einen Registrierungsschlüssel.

Syntax

New-CMDetectionClauseRegistryKey
   [-Existence]
   -Hive <RegistryRootKey>
   [-Is64Bit]
   -KeyName <String>
   [-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 Registrierungsschlüssel, um das Vorhandensein einer Anwendung anzugeben.

Um einen Registrierungswert anstelle eines Schlüssels zu erkennen, verwenden Sie das Cmdlet New-CMDetectionClauseRegistryKeyValue .

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: Erstellen mehrerer Klauseln für einen MSI-App-Bereitstellungstyp

In diesem Beispiel werden zwei Dateiklauseln und eine Registrierungsklausel erstellt und dann verwendet, um einer App einen MSI-Bereitstellungstyp hinzuzufügen.

$cla1=New-CMDetectionClauseFile -FileName "filetest" -PropertyType Size -ExpectedValue 123 -ExpressionOperator IsEquals -Path "C:\" -Value -Is64Bit
$cla2=New-CMDetectionClauseFile -FileName "foldertest" -PropertyType DateCreated -ExpectedValue (Get-Date) -ExpressionOperator LessThan -Path "C:\" -Value
$cla3=New-CMDetectionClauseRegistryKey -Hive ClassesRoot -KeyName "aaa"
$logic1=$cla1.Setting.LogicalName
$logic2=$cla2.Setting.LogicalName
$logic3=$cla3.Setting.LogicalName

Add-CMMsiDeploymentType -AddDetectionClause $cla1,$cla2,$cla3 -ApplicationName "app" -DeploymentTypeName "dt" -InstallCommand "mycommand" -ContentLocation "\\server\sources\Orca.msi" -GroupDetectionClauses $logic1,$logic2 -DetectionClauseConnector {LogicalName=$logic2;Connector="or"},{LogicalName=$logic3;Connector="or"}

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

Dieser Parameter ist impliziert und optional.

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

-Hive

Geben Sie die Registrierungsstruktur an, in der der Schlüssel vorhanden ist. Verwenden Sie den KeyName-Parameter , um den Schlüsselnamen anzugeben.

Typ:RegistryRootKey
Aliase:RegistryHive
Zulässige Werte:ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Is64Bit

Fügen Sie diesen Parameter hinzu, um anzugeben, dass dieser Registrierungsschlüssel einer 32-Bit-Anwendung auf 64-Bit-Systemen zugeordnet ist.

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

-KeyName

Geben Sie den Namen des Registrierungsschlüssels an, der vorhanden sein muss, um das Vorhandensein dieser Anwendung anzugeben. Verwenden Sie den Hive-Parameter , um die Registrierungsstruktur anzugeben, in der dieser Schlüssel vorhanden sein soll.

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

Eingaben

None

Ausgaben

System.Object