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

Met de cmdlet Get-AzPolicyAssignment worden alle beleidstoewijzingen of bepaalde toewijzingen opgehaald. 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 Cmdlet Get-AzResourceGroup en slaat deze op in de $ResourceGroup variabele. Met de tweede opdracht wordt de beleidstoewijzing met de naam 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 eigenschap DisplayName voor lezer 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 eigenschap DisplayName voor lezer 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

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

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