Get-AzPolicySetDefinition

取得原則集定義。

語法

Name (預設值)

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

ManagementGroupName

Get-AzPolicySetDefinition
    -ManagementGroupId <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>]
    [-ManagementGroupId <String>]
    [-Builtin]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Custom

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

Id

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

Description

Get-AzPolicySetDefinition Cmdlet 會取得原則集定義的集合,或以名稱或識別碼識別的特定原則集定義。

範例

範例 1: 取得所有原則集定義

Get-AzPolicySetDefinition

此指令會取得所有原則集定義。

範例 2: 依名稱從現行訂閱取得原則集定義

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition'

此指令會從現行預設訂閱取得名為 VMPolicySetDefinition 的原則集定義。

範例 3: 依名稱從訂閱取得原則集定義

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

此命令從識別碼為 3bf44b72-c631-427a-b8c8-53e2595398ca 的訂用帳戶取得名為 VMPolicySetDefinition 的原則定義。

範例 4:從管理群組取得所有自訂原則集定義

Get-AzPolicySetDefinition -ManagementGroupName 'Dept42' -Custom

此命令會從名為 Dept42 的管理群組取得所有自訂原則集定義。

範例 5: 從給定種類取得原則集定義

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

此指令會取得種類 “虛擬機器” 中的所有原則集定義。

範例 6:依 id 取得政策集定義版本

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

此指令取得 1.1.1 版本的政策定義,ID /providers/Microsoft。授權/policySetDefinitions/1bb84455-9e6e-434c-8db6-fa6d03a67e87.

範例 7:依名稱取得所有政策集定義版本

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -ListVersion

此指令從目前預設訂閱中取得名為 VMPolicySetDefinition 的政策集定義的所有版本。

參數

-Builtin

導致 cmdlet 只回傳內建的政策集定義。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Builtin
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Custom

導致 cmdlet 只回傳自訂的政策集定義。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Custom
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-DefaultProfile

DefaultProfile 參數無法運作。 如果針對不同的訂用帳戶執行 Cmdlet,請使用 SubscriptionId 參數。

參數屬性

類型:PSObject
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzureRMContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Expand

要包含在回應中的其他屬性逗號分隔清單。 支援的值為 'LatestDefinitionVersion, EffectiveDefinitionVersion'。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Name
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
ManagementGroupName
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SubscriptionId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
Id
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Id

政策集定義的完整 ID。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:資源識別碼

參數集

Id
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ListVersion

導致 cmdlet 只回傳自訂政策集定義版本。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Name
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
ManagementGroupName
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SubscriptionId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
Id
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-ManagementGroupId

管理群組的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:管理群組名稱

參數集

ManagementGroupName
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Name

政策集定義的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:原則設定定義名稱

參數集

Name
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
ManagementGroupName
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SubscriptionId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-SubscriptionId

目標訂用帳戶的標識碼。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SubscriptionId
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Version

原則會以 #.#.# 格式設定定義版本。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:原則集定義版本

參數集

Name
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
ManagementGroupName
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
SubscriptionId
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
Id
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。

輸入

SwitchParameter

String

輸出

IPolicySetDefinition