Get-AzPolicyDefinition

Referens

Modul:: Az.Resources

Hämtar definitioner för principuppsättningar.

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
   [-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

Cmdleten Get-AzPolicyDefinition hämtar en samling principuppsättningsdefinitioner eller en specifik principuppsättningsdefinition som identifieras med namn eller ID.

Exempel

Exempel 1: Hämta alla principdefinitioner

Get-AzPolicyDefinition

Det här kommandot hämtar alla principdefinitioner.

Exempel 2: Hämta principdefinition från aktuell prenumeration efter namn

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

Det här kommandot hämtar principdefinitionen VMPolicyDefinition från den aktuella standardprenumerationen.

Exempel 3: Hämta principdefinition från hanteringsgrupp efter namn

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

Det här kommandot hämtar principdefinitionen VMPolicyDefinition från hanteringsgruppen med namnet Dept42.

Exempel 4: Hämta alla inbyggda principdefinitioner från prenumerationen

Get-AzPolicyDefinition -SubscriptionId 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e' -Builtin

Det här kommandot hämtar alla inbyggda principdefinitioner från prenumerationen med ID aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e4e4e.

Exempel 5: Hämta principdefinitioner från en viss kategori

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

Det här kommandot hämtar alla principdefinitioner i kategorin Taggar.

Exempel 6: Hämta visningsnamn, beskrivning, principtyp och metadata för alla principdefinitioner som är formaterade som en lista

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

Det här kommandot är användbart när du behöver hitta den läsvänliga DisplayName-egenskapen för en Azure Policy-definition. Du kan parsa egenskapen Metadata för att identifiera principdefinitionens versionsnummer och kategoritilldelning.

Exempel 7: [Backcompat] Hämta visningsnamn, beskrivning, principtyp och metadata för alla principdefinitioner som formaterats som en lista

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

Parametrar

-BackwardCompatible

Gör att cmdleten returnerar artefakter med äldre format som placerar principspecifika egenskaper i ett egenskapspåseobjekt.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Builtin

Gör att cmdleten endast returnerar inbyggda principdefinitioner.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Custom

Gör att cmdleten endast returnerar anpassade principdefinitioner.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	PSObject
Alias:	AzureRMContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Id

Det fullständiga ID:t för principdefinitionen som ska hämtas.

Typ:	String
Alias:	ResourceId
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ListVersion

Gör att cmdleten endast returnerar anpassade principdefinitioner.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ManagementGroupName

Namnet på hanteringsgruppen.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Name

Namnet på den principdefinition som ska hämtas.

Typ:	String
Alias:	PolicyDefinitionName
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Static

Gör att cmdleten endast returnerar statiska principdefinitioner.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-SubscriptionId

ID för målprenumerationen.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Version

Principdefinitionsversionen i #.#.#-format.

Typ:	String
Alias:	PolicyDefinitionVersion
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

Indata

SwitchParameter

String

Utdata

IPolicyDefinition

Dela via