Get-AzPolicySetDefinition

Modul:
Az.Resources Module

Ruft Richtliniensatzdefinitionen ab.

Syntax

Name (Standard) 

Get-AzPolicySetDefinition
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ManagementGroupName 

Get-AzPolicySetDefinition
    -ManagementGroupName <String>
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SubscriptionId 

Get-AzPolicySetDefinition
    -SubscriptionId <String>
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Builtin 

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

Custom 

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

Id 

Get-AzPolicySetDefinition
    -Id <String>
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-AzPolicySetDefinition " 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

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 '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

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: Abrufen der Definitionsversion des Richtliniensatzes nach ID

Get-AzPolicySetDefinition -Id '/providers/Microsoft.Authorization/policySetDefinitions/1bb84455-9e6e-434c-8db6-fa6d03a67e87' -Version "1.1.1"

Dieser Befehl ruft Version 1.1.1 der Richtliniendefinition mit der ID /providers/Microsoft ab. Authorization/policySetDefinitions/1bb84455-9e6e-434c-8db6-fa6d03a67e87.

Beispiel 7: Abrufen aller Richtliniensatzdefinitionsversionen einer Richtliniensatzdefinition anhand des Namens

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -ListVersion

Dieser Befehl ruft alle Richtliniensatzdefinitionsversionen der Richtliniensatzdefinition namens VMPolicySetDefinition aus dem aktuellen Standardabonnement ab.

Parameter

-Builtin

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Builtin
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Custom

Bewirkt, dass cmdlet nur benutzerdefinierte Richtliniensatzdefinitionen zurückgibt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Custom
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:PSObject
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzureRMContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Expand

Durch Trennzeichen getrennte Liste zusätzlicher Eigenschaften, die in die Antwort aufgenommen werden sollen. Unterstützte Werte sind "LatestDefinitionVersion, EffectiveDefinitionVersion".

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Name
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
ManagementGroupName
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
SubscriptionId
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
Id
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Id

Die vollständige ID der abzurufenden Richtliniensatzdefinition.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ResourceId

Parametersätze

Id
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ListVersion

Führt dazu, dass cmdlet nur benutzerdefinierte Richtliniensatzdefinitionsversionen zurückgibt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Name
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
ManagementGroupName
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
SubscriptionId
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
Id
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ManagementGroupName

Der Name der Verwaltungsgruppe.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ManagementGroupName
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Name

Der Name der Definition des Police-Satzes, um zu erhalten.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:PolicySetDefinitionName

Parametersätze

Name
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
ManagementGroupName
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
SubscriptionId
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-SubscriptionId

Die ID des Zielabonnements.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SubscriptionId
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Version

Die Definitionsversion des Richtliniensatzes im #.#.#-Format.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:PolicySetDefinitionVersion

Parametersätze

Name
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
ManagementGroupName
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
SubscriptionId
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
Id
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

SwitchParameter

String

Ausgaben

IPolicySetDefinition