Delen via


Get-AzPolicySetDefinition

Hiermee haalt u definities van beleidssets op.

Syntaxis

Get-AzPolicySetDefinition
   [-Name <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-Name <String>]
   -SubscriptionId <Guid>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Builtin]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Custom]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

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

Voorbeelden

Voorbeeld 1: Alle beleidssetdefinities ophalen

Get-AzPolicySetDefinition

Met deze opdracht worden alle definities van de beleidsset ophaalt.

Voorbeeld 2: Definitie van beleidsset ophalen uit huidig abonnement op naam

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition'

Met deze opdracht wordt de beleidssetdefinitie met de naam VMPolicySetDefinition opgehaald uit het huidige standaardabonnement.

Voorbeeld 3: Definitie van beleidsset ophalen van abonnement op naam

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -subscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca'

Met deze opdracht wordt de beleidsdefinitie met de naam VMPolicySetDefinition opgehaald uit het abonnement met id 3bf44b72-c631-427a-b8c8-53e2595398ca.

Voorbeeld 4: Alle aangepaste beleidssetdefinities ophalen uit beheergroep

Get-AzPolicySetDefinition -ManagementGroupName 'Dept42' -Custom

Met deze opdracht worden alle aangepaste beleidssetdefinities opgehaald uit de beheergroep met de naam Dept42.

Voorbeeld 5: Definities van beleidssets ophalen uit een bepaalde categorie

Get-AzPolicySetDefinition | Where-Object {$_.Properties.metadata.category -eq "Virtual Machine"}

Met deze opdracht worden alle definities van beleidssets opgehaald in de categorie 'Virtuele machine'.

Parameters

-ApiVersion

Wanneer deze is ingesteld, geeft u de versie van de resourceprovider-API aan die moet worden gebruikt. Als deze niet is opgegeven, wordt de API-versie automatisch bepaald als de meest recente beschikbare versie.

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

-Builtin

Hiermee beperkt u de lijst met resultaten tot alleen ingebouwde definities van beleidssets.

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

-Custom

Hiermee beperkt u de lijst met resultaten tot alleen aangepaste definities van beleidssets.

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

De volledig gekwalificeerde definitie-id van de beleidsset, inclusief het abonnement. bijvoorbeeld /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}

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

-ManagementGroupName

De naam van de beheergroep van de definitie(s) van de beleidsset die u wilt ophalen.

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

-Name

De naam van de definitie van de beleidsset.

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

-Pre

Wanneer deze is ingesteld, geeft u aan dat de cmdlet api-versies van de voorlopige versie moet gebruiken wanneer automatisch wordt bepaald welke versie moet worden gebruikt.

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

-SubscriptionId

De abonnements-id van de definitie(s) van de beleidsset die moet worden opgehaald.

Type:Nullable<T>[Guid]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Uitvoerwaarden

PSObject