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 egenskapen ResourceId 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 DisplayName-egenskapen 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 DisplayName-egenskapen 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
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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
Alias:	AzureRMContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Id

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

Typ:	String
Alias:	ResourceId, PolicyAssignmentId
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-IncludeDescendent

Gör att listan över returnerade principtilldelningar inkluderar alla tilldelningar som är relaterade till det angivna omfånget, inklusive de från överordnade omfång och de från underordnade omfång. Om det inte anges inkluderas endast tilldelningar vid och över det angivna omfånget.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Name

Namnet på den principtilldelning som ska hämtas.

Typ:	String
Alias:	PolicyAssignmentName
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	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
Godkänn pipeline-indata:	True
Godkänn jokertecken:	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
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

Indata

SwitchParameter

String

Utdata

IPolicyAssignment

Dela via