Get-AzPolicyAssignment
語法
Default (預設值)
Get-AzPolicyAssignment
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Name
Get-AzPolicyAssignment
-Name <String>
[-Scope <String>]
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
PolicyDefinitionId
Get-AzPolicyAssignment
-PolicyDefinitionId <String>
[-Scope <String>]
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
IncludeDescendent
Get-AzPolicyAssignment
[-Scope <String>]
[-IncludeDescendent]
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Scope
Get-AzPolicyAssignment
-Scope <String>
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Id
Get-AzPolicyAssignment
-Id <String>
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[<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： 取得格式化為清單之所有原則指派的範圍、原則集定義 ID 及顯示名稱
Get-AzPolicyAssignment | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List
當您需要尋找 Azure 原則指派的讀者易記 DisplayName 屬性時，此命令很有用。
範例 5： [Backcompat] 取得格式化為清單之所有原則指派的範圍、原則集定義 ID 及顯示名稱
Get-AzPolicyAssignment -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List
當您需要尋找 Azure 原則指派的讀者易記 DisplayName 屬性時，此命令很有用。
參數
-BackwardCompatible
導致 Cmdlet 使用舊版格式傳回成品，將原則特定的屬性放在屬性包物件中。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultProfile
DefaultProfile 參數無法運作。
如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。
參數屬性
| 類型: | PSObject
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | AzureRMContext, AzureCredential |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Id
要取得的原則指派識別碼。
使用格式 '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 資源識別碼 (ResourceId), PolicyAssignmentId |
參數集
Id
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludeDescendent
導致傳回的原則指派清單包含與指定範圍相關的所有指派，包括來自上階範圍和子代範圍的指派。
如果未提供，則僅包括指定範圍及以上的指派。
參數屬性
參數集
IncludeDescendent
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Name
要取得的原則指派名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 原則指派名稱 |
參數集
Name
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-PolicyDefinitionId
取得以指定原則定義 [完整] ID 為目標的所有原則指派。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PolicyDefinitionId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Scope
原則指派的範圍。
有效的範圍包括：管理群組 （格式：'/providers/Microsoft.Management/managementGroups/{managementGroup}'）、訂用帳戶 （格式：'/subscriptions/{subscriptionId}'）、資源群組 （格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'） 或資源 （格式：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Name
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
PolicyDefinitionId
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
IncludeDescendent
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸出
