Freigeben über

Get-CMConfigurationPolicy

  • Referenz
Modul:
ConfigurationManager

Ruft eine Konfigurationsrichtlinie ab.

Syntax

Get-CMConfigurationPolicy
   [-AsXml]
   [-CategoryInstanceType <String[]>]
   [-Fast]
   [[-Name] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationPolicy
   [-AsXml]
   [-CategoryInstanceType <String[]>]
   [-Fast]
   [-Id] <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationPolicy
   [-AsXml]
   [-CategoryInstanceType <String[]>]
   [-Fast]
   [[-InputObject] <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-CMConfigurationPolicy ruft eine Konfigurationsrichtlinie ab.

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: Abrufen einer Konfigurationsrichtlinie anhand des Namens

PS XYZ:\> Get-CMConfigurationPolicy -Name "TrustedCACert01" -AsXml

Dieser Befehl ruft die Konfigurationsrichtlinie TrustedCACert01 ab und zeigt die Ausgabe im XML-Format an.

Beispiel 2: Abrufen einer Konfigurationsrichtlinie nach ID

PS XYZ:\> Get-CMConfigurationPolicy -Id 16777454 -Fast

Dieser Befehl ruft die Konfigurationsrichtlinie mit der ID von 16777454 ab und zeigt keine verzögerten Eigenschaften an.

Parameter

-AsXml

Gibt an, dass die Konfigurationsrichtlinie im XML-Format zurückgegeben wird.

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

-CategoryInstanceType

Gibt ein Array von Kategorieinstanztypen an.

Typ:String[]
Aliase:CategoryInstanceTypes
Position:Named
Standardwert:None
Erforderlich:False
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

-Fast

Gibt an, dass das Cmdlet verzögerte Eigenschaften nicht automatisch aktualisiert.

Verzögerte Eigenschaften enthalten Werte, die relativ ineffizient abgerufen werden können, was zusätzlichen Netzwerkdatenverkehr verursachen und die Cmdlet-Leistung beeinträchtigen kann. Wenn keine verzögerten Eigenschaften verwendet werden, sollte dieser Parameter angegeben werden.

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

-Id

Gibt die CI__ID einer Konfigurationsrichtlinie an.

Typ:Int32
Aliase:CIId, CI_ID
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Konfigurationsrichtlinienobjekt an.

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

-Name

Gibt den Namen einer Konfigurationsrichtlinie an.

Typ:String
Aliase:LocalizedDisplayName
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject[]

IResultObject