Get-AzPolicySetDefinition

Hämtar definitioner för principuppsättningar.

Syntax

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

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

Exempel

Exempel 1: Hämta alla definitioner för principuppsättningar

Get-AzPolicySetDefinition

Det här kommandot hämtar alla definitioner av principuppsättningar.

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

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition'

Det här kommandot hämtar principuppsättningsdefinitionen med namnet VMPolicySetDefinition från den aktuella standardprenumerationen.

Exempel 3: Hämta principuppsättningsdefinition från prenumeration efter namn

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

Det här kommandot hämtar principdefinitionen VMPolicySetDefinition från prenumerationen med ID 3bf44b72-c631-427a-b8c8-53e2595398ca.

Exempel 4: Hämta alla definitioner för anpassade principuppsättningar från hanteringsgruppen

Get-AzPolicySetDefinition -ManagementGroupName 'Dept42' -Custom

Det här kommandot hämtar alla definitioner av anpassade principuppsättningar från hanteringsgruppen med namnet Dept42.

Exempel 5: Hämta definitioner för principuppsättningar från en viss kategori

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

Det här kommandot hämtar alla principuppsättningsdefinitioner i kategorin "Virtuell dator".

Parametrar

-ApiVersion

När värdet anges anger du vilken version av resursprovider-API:et som ska användas. Om den inte anges bestäms API-versionen automatiskt som den senaste tillgängliga.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Builtin

Begränsar listan med resultat till endast inbyggda principuppsättningsdefinitioner.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Custom

Begränsar listan med resultat till endast anpassade definitioner för principuppsättningar.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Det fullständigt kvalificerade principuppsättningsdefinitions-ID:t, inklusive prenumerationen. t.ex. /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}

Type:String
Aliases:ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementGroupName

Namnet på hanteringsgruppen för principuppsättningsdefinitionerna som ska hämtas.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Definitionsnamnet för principuppsättningen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Pre

När den anges anger att cmdleten ska använda förhandsversioner av API-versioner när du automatiskt avgör vilken version som ska användas.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Prenumerations-ID:t för principuppsättningsdefinitionerna som ska hämtas.

Type:Nullable<T>[Guid]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Indata

String

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

Utdata

PSObject