Share via

Get-AzPolicyDefinition

  • Reference
Modul:
Az.Resources

Získá definice zásad.

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

Rutina Get-AzPolicyDefinition získá kolekci definic zásad nebo konkrétní definici zásad identifikovanou názvem nebo ID.

Příklady

Příklad 1: Získání všech definic zásad

Get-AzPolicyDefinition

Tento příkaz získá všechny definice zásad.

Příklad 2: Získání definice zásady z aktuálního předplatného podle názvu

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

Tento příkaz získá definici zásady s názvem VMPolicyDefinition z aktuálního výchozího předplatného.

Příklad 3: Získání definice zásad ze skupiny pro správu podle názvu

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

Tento příkaz získá definici zásady s názvem VMPolicyDefinition ze skupiny pro správu s názvem Dept42.

Příklad 4: Získání všech předdefinovaných definic zásad z předplatného

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

Tento příkaz získá všechny předdefinované definice zásad z předplatného s ID 3bf44b72-c631-427a-b8c8-53e2595398ca.

Příklad 5: Získání definic zásad z dané kategorie

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

Tento příkaz získá všechny definice zásad v kategorii Značky.

Příklad 6: Získání zobrazovaného názvu, popisu, typu zásady a metadat všech definic zásad formátovaných jako seznam

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

Tento příkaz je užitečný, když potřebujete najít vlastnost DisplayName popisnou pro čtenáře definice Azure Policy. Vlastnost Metadata můžete analyzovat a zjistit číslo verze definice zásady a přiřazení kategorií.

Parametry

-ApiVersion

Určuje verzi rozhraní API poskytovatele prostředků, která se má použít. Pokud nezadáte verzi, použije tato rutina nejnovější dostupnou verzi.

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

-Builtin

Omezuje seznam výsledků jenom na předdefinované definice zásad.

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

-Custom

Omezí seznam výsledků jenom na vlastní definice zásad.

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

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

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

-Id

Určuje plně kvalifikované ID prostředku pro definici zásady, kterou tato rutina získá.

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

-ManagementGroupName

Název skupiny pro správu definic zásad, které chcete získat.

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

-Name

Určuje název definice zásady, kterou tato rutina získá.

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

-Pre

Označuje, že tato rutina bere v úvahu předběžné verze rozhraní API, když automaticky určí, kterou verzi použít.

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

-SubscriptionId

ID předplatného definic zásad, které chcete získat.

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

Vstupy

String

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

Výstupy

PSObject