Get-AzPolicyDefinition

Modul:

Az.Resources Module

Získá definice sady zásad.

Syntax

Name (Výchozí)

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

ManagementGroupName

Get-AzPolicyDefinition
    -ManagementGroupId <String>
    [-Name <String>]
    [-ListVersion]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SubscriptionId

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

Builtin

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

Custom

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

Static

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

Id

Get-AzPolicyDefinition
    -Id <String>
    [-ListVersion]
    [-Version <String>]
    [-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 '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í konkrétní verze definice zásad podle ID

Get-AzPolicyDefinition -Id '/providers/Microsoft.Authorization/policyDefinitions/36fd7371-8eb7-4321-9c30-a7100022d048' -Version "1.1.1"

Tento příkaz získá verzi 1.1.1 definice zásady s ID /providers/Microsoft. Autorizace/policyDefinitions/36fd7371-8eb7-4321-9c30-a7100022d048.

Příklad 7: Získání všech verzí definic zásad definice zásady podle názvu

Get-AzPolicyDefinition -Name 'VMPolicyDefinition' -ListVersion

Tento příkaz získá všechny verze definic zásad definice zásady s názvem VMPolicyDefinition z aktuálního výchozího předplatného.

Příklad 8: 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ý, pokud potřebujete najít vlastnost DisplayName vlastnosti Azure Policy definice. Vlastnost Metadata můžete analyzovat a zjistit číslo verze definice zásady a přiřazení kategorií.

Parametry

-Builtin

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Builtin

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Custom

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Custom

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

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

Vlastnosti parametru

Typ:	PSObject
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzureRMContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Id

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	ResourceId

Sady parametrů

Id

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ListVersion

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Name

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ManagementGroupName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

SubscriptionId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

Id

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ManagementGroupId

Název skupiny pro správu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Název skupiny správy

Sady parametrů

ManagementGroupName

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Name

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	PolicyDefinitionName

Sady parametrů

Name

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ManagementGroupName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

SubscriptionId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Static

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

Static

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-SubscriptionId

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SubscriptionId

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Version

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	PolicyDefinitionVersion

Sady parametrů

Name

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

ManagementGroupName

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

SubscriptionId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

Id

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

SwitchParameter

String

Výstupy

IPolicyDefinition