Get-AzPolicyDefinition

  • Referentie
Module:
Az.Resources

Hiermee haalt u beleidsdefinities op.

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

De cmdlet Get-AzPolicyDefinition haalt een verzameling beleidsdefinities of een specifieke beleidsdefinitie op die wordt geïdentificeerd met de naam of id.

Voorbeelden

Voorbeeld 1: Alle beleidsdefinities ophalen

Get-AzPolicyDefinition

Met deze opdracht worden alle beleidsdefinities ophaalt.

Voorbeeld 2: Beleidsdefinitie ophalen uit huidig abonnement op naam

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

Met deze opdracht wordt de beleidsdefinitie met de naam VMPolicyDefinition opgehaald uit het huidige standaardabonnement.

Voorbeeld 3: Beleidsdefinitie ophalen uit beheergroep op naam

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

Met deze opdracht wordt de beleidsdefinitie met de naam VMPolicyDefinition opgehaald uit de beheergroep met de naam Dept42.

Voorbeeld 4: Alle ingebouwde beleidsdefinities ophalen uit een abonnement

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

Met deze opdracht worden alle ingebouwde beleidsdefinities opgehaald uit het abonnement met id 3bf44b72-c631-427a-b8c8-53e2595398ca.

Voorbeeld 5: Beleidsdefinities ophalen uit een bepaalde categorie

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

Met deze opdracht worden alle beleidsdefinities in de categorieTags opgeslagen.

Voorbeeld 6: De weergavenaam, beschrijving, beleidstype en metagegevens ophalen van alle beleidsdefinities die zijn opgemaakt als een lijst

Get-AzPolicyDefinition | Select-Object -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List

Deze opdracht is handig wanneer u de eigenschap DisplayName voor lezer van een Azure Policy-definitie moet vinden. U kunt de eigenschap Metagegevens parseren om het versienummer en de categorietoewijzing van de beleidsdefinitie te detecteren.

Parameters

-ApiVersion

Hiermee geeft u de versie van de resourceprovider-API die moet worden gebruikt. Als u geen versie opgeeft, gebruikt deze cmdlet de meest recente beschikbare versie.

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

-Builtin

Hiermee beperkt u de lijst met resultaten tot alleen ingebouwde beleidsdefinities.

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

-Custom

Hiermee beperkt u de lijst met resultaten tot alleen aangepaste beleidsdefinities.

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

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

-Id

Hiermee geeft u de volledig gekwalificeerde resource-id op voor de beleidsdefinitie die door deze cmdlet wordt ophaalt.

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

-ManagementGroupName

De naam van de beheergroep van de beleidsdefinitie(s) die u wilt ophalen.

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

-Name

Hiermee geeft u de naam op van de beleidsdefinitie die door deze cmdlet wordt ophaalt.

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

-Pre

Hiermee wordt aangegeven dat deze cmdlet api-versies van de voorlopige versie beschouwt wanneer deze automatisch bepaalt welke versie moet worden gebruikt.

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

-SubscriptionId

De abonnements-id van de beleidsdefinitie(s) die u wilt ophalen.

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

Invoerwaarden

String

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

Uitvoerwaarden

PSObject