Get-AzPolicyDefinition

Reference

Modul:: Az.Resources

Získá definice sady zásad.

Syntax

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

Get-AzPolicyDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   -SubscriptionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Builtin]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Custom]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Static]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

Rutina Get-AzPolicySetDefinition získá kolekci definic sady zásad nebo konkrétní definici sady 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 -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í.

Příklad 7: [Backcompat] 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 -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List

Parametry

-BackwardCompatible

Způsobí, že rutina vrátí artefakty pomocí staršího formátu, který umísťuje vlastnosti specifické pro zásady do objektu kontejneru vlastností.

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

-Builtin

Způsobí, že rutina vrátí jenom předdefinované definice zásad.

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

-Custom

Způsobí, že rutina vrátí pouze vlastní definice zásad.

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

-DefaultProfile

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

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Úplné ID definice zásady, která se má získat.

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.

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

-Name

Název definice zásady, která se má získat.

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

-Static

Způsobí, že rutina vrátí pouze definice statických zásad.

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

-SubscriptionId

ID cílového předplatného.

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

Vstupy

SwitchParameter

String

Výstupy

IPolicyDefinition

Sdílet prostřednictvím