Get-AzPolicyAssignment

Referens

Modul:: Az.Resources

Hämtar principtilldelningar.

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

Description

Cmdleten Get-AzPolicyAssignment hämtar alla principtilldelningar eller specifika tilldelningar. Identifiera en principtilldelning som ska hämtas efter namn och omfång eller efter ID.

Exempel

Exempel 1: Hämta alla principtilldelningar

Get-AzPolicyAssignment

Det här kommandot hämtar alla principtilldelningar.

Exempel 2: Hämta en specifik principtilldelning

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

Det första kommandot hämtar en resursgrupp med namnet ResourceGroup11 med hjälp av cmdleten Get-AzResourceGroup och lagrar den i variabeln $ResourceGroup. Det andra kommandot hämtar principtilldelningen med namnet PolicyAssignment07 för det omfång som ResourceId-egenskapen för $ResourceGroup identifierar.

Exempel 3: Hämta alla principtilldelningar som tilldelats till en hanteringsgrupp

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

Det första kommandot anger ID:t för hanteringsgruppen som ska frågas. Det andra kommandot hämtar alla principtilldelningar som har tilldelats till hanteringsgruppen med ID:t "myManagementGroup".

Exempel 4: Hämta omfång, definitionsidentifierare för principuppsättning och visningsnamn för alla principtilldelningar som är formaterade som en lista

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

Det här kommandot är användbart när du behöver hitta den läsvänliga Egenskapen DisplayName för en Azure Policy-tilldelning.

Exempel 5: [Backcompat] Hämta omfång, definitionsidentifierare för principuppsättning och visningsnamn för alla principtilldelningar som är formaterade som en lista

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

Det här kommandot är användbart när du behöver hitta den läsvänliga Egenskapen DisplayName för en Azure Policy-tilldelning.

Parametrar

-BackwardCompatible

Gör att cmdleten returnerar artefakter med äldre format som placerar principspecifika egenskaper i ett egenskapspåseobjekt.

Typ:	SwitchParameter
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Typ:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

ID för den principtilldelning som ska hämtas. Använd formatet {scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}.

Typ:	String
Aliases:	ResourceId, PolicyAssignmentId
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludeDescendent

Hämta alla principtilldelningar som riktar sig mot den angivna principdefinitionen [fullständigt kvalificerat] ID.

Typ:	SwitchParameter
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Namnet på den principtilldelning som ska hämtas.

Typ:	String
Aliases:	PolicyAssignmentName
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PolicyDefinitionId

Hämta alla principtilldelningar som riktar sig mot den angivna principdefinitionen [fullständigt kvalificerat] ID.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Scope

Omfånget för principtilldelningen. Giltiga omfång är: hanteringsgrupp (format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), prenumeration (format: '/subscriptions/{subscriptionId}'), resursgrupp (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', eller resurs (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Indata

SwitchParameter

String

Utdata

IPolicyAssignment

Dela via