Get-AzPolicyDefinition

Referens

Modul:: Az.Resources

Hämtar principdefinitioner.

Syntax

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

Get-AzPolicyDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   -SubscriptionId <Guid>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

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

Get-AzPolicyDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Builtin]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Custom]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Cmdleten Get-AzPolicyDefinition hämtar en samling principdefinitioner eller en specifik principdefinition som identifieras med namn eller ID.

Exempel

Exempel 1: Hämta alla principdefinitioner

Get-AzPolicyDefinition

Det här kommandot hämtar alla principdefinitioner.

Exempel 2: Hämta principdefinition från aktuell prenumeration efter namn

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

Det här kommandot hämtar principdefinitionen VMPolicyDefinition från den aktuella standardprenumerationen.

Exempel 3: Hämta principdefinition från hanteringsgrupp efter namn

Get-AzPolicyDefinition -Name 'VMPolicyDefinition' -ManagementGroupName 'Dept42'

Det här kommandot hämtar principdefinitionen VMPolicyDefinition från hanteringsgruppen med namnet Dept42.

Exempel 4: Hämta alla inbyggda principdefinitioner från prenumerationen

Get-AzPolicyDefinition -SubscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca' -Builtin

Det här kommandot hämtar alla inbyggda principdefinitioner från prenumerationen med ID 3bf44b72-c631-427a-b8c8-53e2595398ca.

Exempel 5: Hämta principdefinitioner från en viss kategori

Get-AzPolicyDefinition | Where-Object {$_.Properties.metadata.category -eq 'Tags'}

Det här kommandot hämtar alla principdefinitioner i kategorin Taggar.

Exempel 6: Hämta visningsnamn, beskrivning, principtyp och metadata för alla principdefinitioner som är formaterade som en lista

Get-AzPolicyDefinition | Select-Object -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | 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-definition. Du kan parsa egenskapen Metadata för att identifiera principdefinitionens versionsnummer och kategoritilldelning.

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

-Builtin

Begränsar listan med resultat till endast inbyggda principdefinitioner.

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

-Custom

Begränsar listan med resultat till endast anpassade principdefinitioner.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
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 principdefinitionen som den här cmdleten får.

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

-ManagementGroupName

Namnet på hanteringsgruppen för principdefinitionerna som ska hämtas.

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

-Name

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

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

-SubscriptionId

Prenumerations-ID för de principdefinitioner som ska hämtas.

Type:	Nullable<T>[Guid]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Indata

String

Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Utdata

PSObject