Get-AzPolicyAssignment

Referentie

Module:: Az.Resources

Hiermee worden beleidstoewijzingen opgehaald.

Syntaxis

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

Description

De Get-AzPolicyAssignment cmdlet haalt alle beleidstoewijzingen of bepaalde toewijzingen op. Identificeer een beleidstoewijzing die moet worden opgehaald op naam en bereik of op id.

Voorbeelden

Voorbeeld 1: Alle beleidstoewijzingen ophalen

Get-AzPolicyAssignment

Met deze opdracht worden alle beleidstoewijzingen opgehaald.

Voorbeeld 2: Een specifieke beleidstoewijzing ophalen

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

De eerste opdracht haalt een resourcegroep met de naam ResourceGroup11 op met behulp van de Get-AzResourceGroup cmdlet en slaat deze op in de $ResourceGroup variabele. Met de tweede opdracht wordt de beleidstoewijzing PolicyAssignment07 opgehaald voor het bereik dat de eigenschap ResourceId van $ResourceGroup identificeert.

Voorbeeld 3: alle beleidstoewijzingen ophalen die zijn toegewezen aan een beheergroep

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

Met de eerste opdracht geeft u de id van de beheergroep op die moet worden opvragen. Met de tweede opdracht worden alle beleidstoewijzingen opgehaald die zijn toegewezen aan de beheergroep met id 'myManagementGroup'.

Voorbeeld 4: Het bereik, de definitie-id van de beleidsset en de weergavenaam van alle beleidstoewijzingen ophalen die zijn opgemaakt als een lijst

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

Deze opdracht is handig wanneer u de lezervriendelijke Eigenschap DisplayName van een Azure Policy-toewijzing moet vinden.

Voorbeeld 5: [Backcompat] Haal het bereik, de definitie-id van de beleidsset en de weergavenaam op van alle beleidstoewijzingen die zijn opgemaakt als een lijst

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

Deze opdracht is handig wanneer u de lezervriendelijke Eigenschap DisplayName van een Azure Policy-toewijzing moet vinden.

Parameters

-BackwardCompatible

Zorgt ervoor dat cmdlet artefacten retourneert met behulp van verouderde indeling waarbij beleidsspecifieke eigenschappen in een eigenschapsverzamelingsobject worden geplaatst.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:	PSObject
Aliassen:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Id

De id van de beleidstoewijzing die moet worden opgehaald. Gebruik de indeling {scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}.

Type:	String
Aliassen:	ResourceId, PolicyAssignmentId
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-IncludeDescendent

Zorgt ervoor dat de lijst met geretourneerde beleidstoewijzingen alle toewijzingen bevat die betrekking hebben op het opgegeven bereik, inclusief toewijzingen van bovenliggende bereiken en toewijzingen van afstammende bereiken. Indien niet opgegeven, worden alleen toewijzingen op en boven het opgegeven bereik opgenomen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Name

De naam van de beleidstoewijzing die moet worden opgehaald.

Type:	String
Aliassen:	PolicyAssignmentName
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PolicyDefinitionId

Haal alle beleidstoewijzingen op die gericht zijn op de opgegeven beleidsdefinitie [volledig gekwalificeerde] id.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Scope

Het bereik van de beleidstoewijzing. Geldige bereiken zijn: beheergroep (indeling: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), abonnement (indeling: '/subscriptions/{subscriptionId}'), resourcegroep (indeling: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', of resource (indeling: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

Invoerwaarden

SwitchParameter

String

Uitvoerwaarden

IPolicyAssignment

Delen via