Get-AzPolicyAssignment

  • 參考
模組:
Az.Resources

取得原則指派。

Syntax

Get-AzPolicyAssignment
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   [-Name <String>]
   [-Scope <String>]
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   -Id <String>
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Get-AzPolicyAssignment Cmdlet 會取得所有原則指派或特定指派。 識別要依名稱和範圍或標識碼取得的原則指派。

範例

範例 1：取得所有原則指派

Get-AzPolicyAssignment

此命令會取得所有原則指派。

範例 2：取得特定原則指派

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId

第一個命令會使用 Get-AzResourceGroup Cmdlet 取得名為 ResourceGroup11 的資源群組，並將它儲存在$ResourceGroup變數中。 第二個命令會取得名為 PolicyAssignment07 的原則指派，以取得$ResourceGroup ResourceId 屬性所識別的範圍。

範例 3：取得指派給管理群組的所有原則指派

$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'

第一個命令會指定要查詢的管理群組標識碼。 第二個命令會取得指派給標識符為 『myManagementGroup』 之管理群組的所有原則指派。

範例 4：取得範圍、原則集定義標識碼，以及格式化為清單之所有原則指派的顯示名稱

Get-AzPolicyAssignment | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

當您需要尋找 Azure 原則 指派的易讀程式 DisplayName 屬性時，此命令很有用。

參數

-ApiVersion

指定要使用的資源提供者 API 版本。 如果您未指定版本，此 Cmdlet 會使用最新的可用版本。

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

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

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

-Id

指定此 Cmdlet 取得之原則指派的完整資源識別碼。

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

-IncludeDescendent

導致傳回的原則指派清單包含與指定範圍相關的所有指派，包括來自上階範圍和子代範圍的工作分派。

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

-Name

指定此 Cmdlet 取得的原則指派名稱。

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

-PolicyDefinitionId

指定此 Cmdlet 取得之原則指派的原則定義標識符。

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

-Pre

指出此 Cmdlet 會在自動判斷要使用的版本時，考慮發行前版本 API 版本。

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

-Scope

指定套用此 Cmdlet 指派之原則的範圍。

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

輸入

String

SwitchParameter

輸出

PsPolicyAssignment