Get-AzPolicyAssignment

Referenz

Modul:: Az.Resources

Ruft Richtlinienzuweisungen ab.

Syntax

Get-AzPolicyAssignment
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

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

Get-AzPolicyAssignment
   [-Scope <String>]
   -PolicyDefinitionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Scope <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

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

Beschreibung

Das Cmdlet "Get-AzPolicyAssignment " ruft alle Richtlinienzuweisungen oder bestimmte Zuordnungen ab. Identifizieren Sie eine Richtlinienzuweisung, die nach Name und Bereich oder nach ID abgerufen werden soll.

Beispiele

Beispiel 1: Abrufen aller Richtlinienzuweisungen

Get-AzPolicyAssignment

Dieser Befehl ruft alle Richtlinienzuweisungen ab.

Beispiel 2: Abrufen einer bestimmten Richtlinienzuweisung

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId

Der erste Befehl ruft eine Ressourcengruppe namens ResourceGroup11 mithilfe des Cmdlets "Get-AzResourceGroup" ab und speichert sie in der variablen $ResourceGroup. Der zweite Befehl ruft die Richtlinienzuweisung mit dem Namen "PolicyAssignment07" für den Bereich ab, den die ResourceId-Eigenschaft von $ResourceGroup identifiziert.

Beispiel 3: Abrufen aller Richtlinienzuweisungen, die einer Verwaltungsgruppe zugewiesen sind

$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'

Der erste Befehl gibt die ID der abzufragenden Verwaltungsgruppe an. Der zweite Befehl ruft alle Richtlinienzuweisungen ab, die der Verwaltungsgruppe mit der ID "myManagementGroup" zugewiesen sind.

Beispiel 4: Abrufen des Bereichs, des Richtliniensatzdefinitionsbezeichners und des Anzeigenamens aller Richtlinienzuweisungen, die als Liste formatiert sind

Get-AzPolicyAssignment | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

Dieser Befehl ist nützlich, wenn Sie die anzeigefreundliche DisplayName-Eigenschaft einer Azure-Richtlinienzuweisung finden müssen.

Beispiel 5: [Backcompat] Rufen Sie den Bereich, den Definitionsbezeichner für Richtliniensatz und den Anzeigenamen aller Richtlinienzuweisungen ab, die als Liste formatiert sind.

Get-AzPolicyAssignment -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

Dieser Befehl ist nützlich, wenn Sie die anzeigefreundliche DisplayName-Eigenschaft einer Azure-Richtlinienzuweisung finden müssen.

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

-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 ID der abzurufenden Richtlinienzuweisung. Verwenden Sie das Format "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

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

-IncludeDescendent

Bewirkt, dass die Liste der zurückgegebenen Richtlinienzuweisungen alle Zuordnungen enthält, die sich auf den angegebenen Bereich beziehen, einschließlich der Zuordnungen aus vorgängern Bereichen und denen aus untergeordneten Bereichen. Wenn nicht angegeben, sind nur Zuordnungen zu und über dem angegebenen Bereich enthalten.

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

-Name

Der Name der abzurufenden Richtlinienzuweisung.

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

-PolicyDefinitionId

Rufen Sie alle Richtlinienzuweisungen ab, die auf die angegebene Richtliniendefinitions-ID [vollqualifizierte] abzielen.

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

-Scope

Der Bereich der Richtlinienzuweisung. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

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

Eingaben

SwitchParameter

String

Ausgaben

IPolicyAssignment

Freigeben über