Freigeben über


Get-AzureRmPolicySetDefinition

Ruft Richtliniensatzdefinitionen ab.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Get-AzureRmPolicySetDefinition
   [-Name <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmPolicySetDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmPolicySetDefinition
   [-Name <String>]
   -SubscriptionId <Guid>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmPolicySetDefinition
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmPolicySetDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Builtin]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmPolicySetDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Custom]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-AzureRmPolicySetDefinition " ruft eine Sammlung von Richtliniensatzdefinitionen oder einer bestimmten Richtliniensatzdefinition ab, die anhand des Namens oder der ID identifiziert wird.

Beispiele

Beispiel 1: Abrufen aller Richtliniensatzdefinitionen

PS C:\> Get-AzureRmPolicySetDefinition

Dieser Befehl ruft alle Richtliniensatzdefinitionen ab.

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

PS C:\> Get-AzureRmPolicySetDefinition -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

PS C:\> Get-AzureRmPolicySetDefinition -Name 'VMPolicySetDefinition' -subscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca'

Dieser Befehl ruft die Richtliniendefinition "VMPolicySetDefinition" aus dem Abonnement mit der ID 3bf44b72-c631-427a-b8c8-53e2595398ca ab.

Beispiel 4: Abrufen aller benutzerdefinierten Richtliniensatzdefinitionen aus der Verwaltungsgruppe

PS C:\> Get-AzureRmPolicySetDefinition -ManagementGroupName 'Dept42' -Custom

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

Parameter

-ApiVersion

Wenn festgelegt, gibt die Version der zu verwendenden Ressourcenanbieter-API an. Wenn nicht angegeben, wird die API-Version automatisch als neueste verfügbare Version bestimmt.

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

-Builtin

Liste der Ergebnisse auf integrierte Richtliniensatzdefinitionen beschränkt.

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

-Custom

Beschränkt die Liste der Ergebnisse auf nur benutzerdefinierte Richtliniensatzdefinitionen.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Die vollqualifizierte Richtliniensatzdefinitions-ID, einschließlich des Abonnements. z. B. /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}

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

-ManagementGroupName

Der Name der Verwaltungsgruppe der abzurufenden Richtliniensatzdefinitionen.

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

-Name

Der Name der Richtliniensatzdefinition.

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

-Pre

Wenn festgelegt, gibt an, dass das Cmdlet Vorabversionen von API-Versionen verwenden soll, wenn automatisch bestimmt wird, welche Version verwendet werden soll.

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

-SubscriptionId

Die Abonnement-ID der abzurufenden Richtliniensatzdefinitionen.

Typ:Nullable<T>[Guid]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

Nullable<T>[[System.Guid, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Ausgaben

PSObject