Get-AzPolicySetDefinition

Hämtar definitioner för principuppsättningar.

Syntax

Name (Standard)

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

ManagementGroupName

Get-AzPolicySetDefinition
    -ManagementGroupName <String>
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SubscriptionId

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

Builtin

Get-AzPolicySetDefinition
    [-SubscriptionId <String>]
    [-ManagementGroupName <String>]
    [-Builtin]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Custom

Get-AzPolicySetDefinition
    [-SubscriptionId <String>]
    [-ManagementGroupName <String>]
    [-Custom]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Id

Get-AzPolicySetDefinition
    -Id <String>
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<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 {$_.metadata.category -eq "Virtual Machine"}

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

Exempel 6: Hämta definitionsversion för principuppsättning efter ID

Get-AzPolicySetDefinition -Id '/providers/Microsoft.Authorization/policySetDefinitions/1bb84455-9e6e-434c-8db6-fa6d03a67e87' -Version "1.1.1"

Det här kommandot hämtar version 1.1.1 av principdefinitionen med ID /providers/Microsoft. Authorization/policySetDefinitions/1bb84455-9e6e-434c-8db6-fa6d03a67e87.

Exempel 7: Hämta alla definitionsversioner av principuppsättningar efter namn

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -ListVersion

Det här kommandot hämtar alla definitionsversioner av principuppsättningen med namnet VMPolicySetDefinition från den aktuella standardprenumerationen.

Parametrar

-Builtin

Gör att cmdleten endast returnerar inbyggda principuppsättningsdefinitioner.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Builtin
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Custom

Gör att cmdleten endast returnerar definitioner för anpassade principuppsättningar.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Custom
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Parameteregenskaper

Typ:PSObject
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzureRMContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Expand

Kommaavgränsad lista över ytterligare egenskaper som ska ingå i svaret. Värden som stöds är "LatestDefinitionVersion, EffectiveDefinitionVersion".

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Name
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ManagementGroupName
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
SubscriptionId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
Id
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Id

Det fullständiga ID:t för den principuppsättningsdefinition som ska hämtas.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ResourceId

Parameteruppsättningar

Id
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ListVersion

Gör att cmdleten endast returnerar definitionsversioner av anpassade principuppsättningar.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Name
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ManagementGroupName
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
SubscriptionId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
Id
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ManagementGroupName

Namnet på hanteringsgruppen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ManagementGroupName
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

Namnet på policyuppsättningsdefinitionen att få.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PolicySetDefinitionName

Parameteruppsättningar

Name
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ManagementGroupName
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
SubscriptionId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-SubscriptionId

ID för målprenumerationen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SubscriptionId
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Version

Principuppsättningens definitionsversion i #.#.#-format.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PolicySetDefinitionVersion

Parameteruppsättningar

Name
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ManagementGroupName
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
SubscriptionId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
Id
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

SwitchParameter

String

Utdata

IPolicySetDefinition