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>]
说明
Get-AzPolicyAssignment cmdlet 获取所有策略分配或特定分配。
标识策略分配,以便按名称和范围或 ID 获取。
示例
示例 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"
第一个命令指定要查询的管理组的 ID。
第二个命令获取分配给 ID 为“myManagementGroup”的管理组的所有策略分配。
示例 4:获取设置为列表的所有策略分配的范围、策略集定义标识符和显示名称
Get-AzPolicyAssignment | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List
如果需要查找 Azure Policy 分配的读者友好 DisplayName 属性,此命令非常有用。
示例 5:[Backcompat] 获取范围、策略集定义标识符以及格式化为列表的所有策略分配的显示名称
Get-AzPolicyAssignment -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List
如果需要查找 Azure Policy 分配的读者友好 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
要获取的策略分配的 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 |
| 别名: | PolicyAssignmentName |
参数集
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。
输出