Get-AzPolicyDefinition

Module:

Az.Resources

Hiermee haalt u definities van beleidssets op.

Syntaxis

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

De cmdlet Get-AzPolicyDefinition haalt een verzameling beleidssetdefinities of een specifieke beleidssetdefinitie op die wordt geïdentificeerd met de naam of id.

Voorbeelden

Voorbeeld 1: Alle beleidsdefinities ophalen

Get-AzPolicyDefinition

Met deze opdracht worden alle beleidsdefinities ophaalt.

Voorbeeld 2: Beleidsdefinitie ophalen uit huidig abonnement op naam

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

Met deze opdracht wordt de beleidsdefinitie met de naam VMPolicyDefinition opgehaald uit het huidige standaardabonnement.

Voorbeeld 3: Beleidsdefinitie ophalen uit beheergroep op naam

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

Met deze opdracht wordt de beleidsdefinitie met de naam VMPolicyDefinition opgehaald uit de beheergroep met de naam Dept42.

Voorbeeld 4: Alle ingebouwde beleidsdefinities ophalen uit een abonnement

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

Met deze opdracht worden alle ingebouwde beleidsdefinities opgehaald uit het abonnement met id 3bf44b72-c631-427a-b8c8-53e2595398ca.

Voorbeeld 5: Beleidsdefinities ophalen uit een bepaalde categorie

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

Met deze opdracht worden alle beleidsdefinities in de categorieTags opgeslagen.

Voorbeeld 6: De weergavenaam, beschrijving, beleidstype en metagegevens ophalen van alle beleidsdefinities die zijn opgemaakt als een lijst

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

Deze opdracht is handig wanneer u de eigenschap DisplayName voor lezer van een Azure Policy-definitie moet vinden. U kunt de eigenschap Metagegevens parseren om het versienummer en de categorietoewijzing van de beleidsdefinitie te detecteren.

Voorbeeld 7: [Backcompat] De weergavenaam, beschrijving, beleidstype en metagegevens ophalen van alle beleidsdefinities die zijn opgemaakt als een lijst

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

Deze opdracht is handig wanneer u de eigenschap DisplayName voor lezer van een Azure Policy-definitie moet vinden. U kunt de eigenschap Metagegevens parseren om het versienummer en de categorietoewijzing van de beleidsdefinitie te detecteren.

Parameters

-BackwardCompatible

Zorgt ervoor dat cmdlet artefacten retourneert met behulp van verouderde indeling waarbij beleidsspecifieke eigenschappen in een eigenschapsverzamelingsobject worden geplaatst.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Builtin

Zorgt ervoor dat cmdlet alleen ingebouwde beleidsdefinities retourneert.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Custom

Zorgt ervoor dat cmdlet alleen aangepaste beleidsdefinities retourneert.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	PSObject
Aliassen:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Id

De volledige id van de beleidsdefinitie die u wilt ophalen.

Type:	String
Aliassen:	ResourceId
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ListVersion

Zorgt ervoor dat cmdlet alleen aangepaste beleidsdefinities retourneert.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ManagementGroupName

De naam van de beheergroep.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Name

De naam van de beleidsdefinitie die u wilt ophalen.

Type:	String
Aliassen:	PolicyDefinitionName
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Static

Zorgt ervoor dat cmdlet alleen statische beleidsdefinities retourneert.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SubscriptionId

De id van het doelabonnement.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Version

De beleidsdefinitieversie in #.#.#-indeling.

Type:	String
Aliassen:	PolicyDefinitionVersion
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

Invoerwaarden

SwitchParameter

String

Uitvoerwaarden

IPolicyDefinition