Get-AzPolicyAssignment

Referens

Modul:: Az.Resources

Hämtar principtilldelningar.

Syntax

Get-AzPolicyAssignment
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   [-Name <String>]
   [-Scope <String>]
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Id <String>
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<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 -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

-ApiVersion

Anger vilken version av resursprovider-API:et som ska användas. Om du inte anger någon version använder den här cmdleten den senaste tillgängliga versionen.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Anger det fullständigt kvalificerade resurs-ID:t för principtilldelningen som den här cmdleten hämtar.

Type:	String
Aliases:	ResourceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Anger namnet på den principtilldelning som den här cmdleten hämtar.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PolicyDefinitionId

Anger ID för principdefinitionen för de principtilldelningar som den här cmdleten får.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Pre

Anger att den här cmdleten tar hänsyn till förhandsversioner av API:et när den automatiskt avgör vilken version som ska användas.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Anger det omfång där principen tillämpas för den tilldelning som den här cmdleten får.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Indata

String

SwitchParameter

Utdata

PsPolicyAssignment