Get-AzPolicySetDefinition

Referenz

Modul:: Az.Resources

Ruft Richtliniensatzdefinitionen ab.

Syntax

Get-AzPolicySetDefinition
   [-Name <String>]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   [-Name <String>]
   -SubscriptionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   [-Name <String>]
   [-Id <String>]
   [-BackwardCompatible]
   -Version <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   [-Name <String>]
   [-Id <String>]
   [-ListVersion]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Builtin]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicySetDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Custom]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Get-AzPolicySetDefinition ruft eine Sammlung von Richtliniensatzdefinitionen oder einer bestimmten Richtliniensatzdefinition ab, die durch den Namen oder die ID identifiziert wird.

Beispiele

Beispiel 1: Abrufen aller Richtliniensatzdefinitionen

Get-AzPolicySetDefinition

Dieser Befehl ruft alle Richtliniensatzdefinitionen ab.

Beispiel 2: Abrufen der Richtliniensatzdefinition aus dem aktuellen Abonnement anhand des Namens

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition'

Mit diesem Befehl wird die Richtliniensatzdefinition namens "VMPolicySetDefinition" aus dem aktuellen Standardabonnement abgerufen.

Beispiel 3: Abrufen der Richtliniensatzdefinition aus dem Abonnement anhand des Namens

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -subscriptionId 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'

Dieser Befehl ruft die Richtliniendefinition namens "VMPolicySetDefinition" aus dem Abonnement mit der ID aaaa0a0a-bb1b-cc2c-dd3d-eeeee4e4e4e ab.

Beispiel 4: Abrufen aller benutzerdefinierten Richtliniensatzdefinitionen aus der Verwaltungsgruppe

Get-AzPolicySetDefinition -ManagementGroupName 'Dept42' -Custom

Dieser Befehl ruft alle benutzerdefinierten Richtliniensatzdefinitionen aus der Verwaltungsgruppe "Dept42" ab.

Beispiel 5: Abrufen von Richtliniensatzdefinitionen aus einer bestimmten Kategorie

Get-AzPolicySetDefinition | Where-Object {$_.metadata.category -eq "Virtual Machine"}

Dieser Befehl ruft alle Richtliniensatzdefinitionen in der Kategorie "Virtueller Computer" ab.

Beispiel 6: [Backcompat] Abrufen von Richtliniensatzdefinitionen aus einer bestimmten Kategorie

Get-AzPolicySetDefinition -BackwardCompatible | Where-Object {$_.Properties.metadata.category -eq "Virtual Machine"}

Dieser Befehl ruft alle Richtliniensatzdefinitionen in der Kategorie "Virtueller Computer" ab.

Parameter

-BackwardCompatible

Bewirkt, dass cmdlet Artefakte mithilfe von richtlinienspezifischen Eigenschaften im Legacyformat in einem Eigenschaftenbehälterobjekt zurückgibt.

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

-Builtin

Führt dazu, dass cmdlet nur integrierte Richtliniendefinitionen zurückgibt.

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

-Custom

Bewirkt, dass cmdlet nur benutzerdefinierte Richtliniendefinitionen zurückgibt.

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

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:	PSObject
Aliase:	AzureRMContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Id

Die vollständige ID der abzurufenden Richtliniendefinition.

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

-ListVersion

Bewirkt, dass cmdlet nur benutzerdefinierte Richtliniendefinitionen zurückgibt.

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

-ManagementGroupName

Der Name der Verwaltungsgruppe.

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

-Name

Der Name der abzurufenden Richtliniendefinition.

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

-SubscriptionId

Die ID des Zielabonnements.

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

-Version

Die Richtliniendefinitionsversion im #.#.#.#-Format.

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

Eingaben

SwitchParameter

String

Ausgaben

IPolicySetDefinition

Freigeben über