Get-AzPolicyDefinition

Reference

Modul:: Az.Resources

Získá definice sady zásad.

Syntaxe

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
   [-Name <String>]
   [-Id <String>]
   [-BackwardCompatible]
   -Version <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

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

Get-AzPolicyDefinition
   -Id <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>]

Description

Rutina Get-AzPolicyDefinition 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 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e' -Builtin

Tento příkaz získá všechny předdefinované definice zásad z předplatného s ID aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e4e4e.

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 definice služby Azure Policy popisnou pro čtenáře. Vlastnost metadat 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í.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Builtin

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Custom

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DefaultProfile

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

Typ:	PSObject
Aliasy:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Id

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

Typ:	String
Aliasy:	ResourceId
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ListVersion

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ManagementGroupName

Název skupiny pro správu.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Name

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

Typ:	String
Aliasy:	PolicyDefinitionName
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Static

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SubscriptionId

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Version

Verze definice zásady ve formátu #.#.#

Typ:	String
Aliasy:	PolicyDefinitionVersion
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

Vstupy

SwitchParameter

String

Výstupy

IPolicyDefinition

Sdílet prostřednictvím