Dela via

Get-AzPolicyAssignment

Modul:
Az.Resources Module

Hämtar principtilldelningar.

Syntax

Default (Standard) 

Get-AzPolicyAssignment
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Name 

Get-AzPolicyAssignment
    -Name <String>
    [-Scope <String>]
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

PolicyDefinitionId 

Get-AzPolicyAssignment
    -PolicyDefinitionId <String>
    [-Scope <String>]
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

IncludeDescendent 

Get-AzPolicyAssignment
    [-Scope <String>]
    [-IncludeDescendent]
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Scope 

Get-AzPolicyAssignment
    -Scope <String>
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Id 

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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:PSObject
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzureRMContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Id

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ResourceId, PolicyAssignmentId

Parameteruppsättningar

Id
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

IncludeDescendent
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

Namnet på den principtilldelning som ska hämtas.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PolicyAssignmentName

Parameteruppsättningar

Name
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PolicyDefinitionId

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

PolicyDefinitionId
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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}'

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Name
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
PolicyDefinitionId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
IncludeDescendent
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

SwitchParameter

String

Utdata

IPolicyAssignment