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
Accept pipeline input:	False
Accept wildcard characters:	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
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Die ID der abzurufenden Richtlinienzuweisung. Verwenden Sie das Format "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

Typ:	String
Aliases:	ResourceId, PolicyAssignmentId
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludeDescendent

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Der Name der abzurufenden Richtlinienzuweisung.

Typ:	String
Aliases:	PolicyAssignmentName
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PolicyDefinitionId

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

Eingaben

SwitchParameter

String

Ausgaben

IPolicyAssignment

Freigeben über