共用方式為


Get-AzureRmPolicyAssignment

取得原則指派。

警告

自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源

Syntax

Get-AzureRmPolicyAssignment
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Get-AzureRmPolicyAssignment
   [-Name <String>]
   [-Scope <String>]
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Get-AzureRmPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Get-AzureRmPolicyAssignment
   -Id <String>
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

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

範例

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

PS C:\> Get-AzureRmPolicyAssignment

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

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

PS C:\> $ResourceGroup = Get-AzureRmResourceGroup -Name 'ResourceGroup11'
PS C:\> Get-AzureRmPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId

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

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

PS C:\> $mgId = 'myManagementGroup'
PS C:\> Get-AzureRmPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'

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

參數

-ApiVersion

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

類型:String
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

類型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

類型:String
Aliases:ResourceId
Position:Named
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-IncludeDescendent

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

類型:SwitchParameter
Position:Named
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

指定此 Cmdlet 如何回應資訊事件。 此參數可接受的值為:

  • 繼續
  • 忽略
  • 詢問
  • SilentlyContinue
  • 停止
  • 暫止
類型:ActionPreference
Aliases:infa
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

指定資訊變數。

類型:String
Aliases:iv
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

類型:String
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-PolicyDefinitionId

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

類型:String
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-Pre

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

類型:SwitchParameter
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

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

類型:String
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False