Get-EntraAuthorizationPolicy
取得授權政策。
語法
GetQuery (預設值)
Get-EntraAuthorizationPolicy
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraAuthorizationPolicy
-Id <String>
[-Property <String[]>]
[<CommonParameters>]
Description
指令Get-EntraAuthorizationPolicy長會獲得 Microsoft Entra ID 授權政策。
在工作或學校帳號的委派情境中,登入使用者必須擁有支援的 Microsoft Entra 角色或自訂角色,並具備所需權限。 此作業中最不特權的角色有:
- 全球閱讀器
- 安全性閱讀器
- 安全操作員
- 安全性系統管理員
- 雲端裝置管理員
- 授權管理員
- 特殊權限角色管理員
範例
範例 1:取得所有保單
Connect-Entra -Scopes 'Policy.Read.All'
Get-EntraAuthorizationPolicy
DeletedDateTime Description DisplayName Id AllowEmailVerifiedUsersToJoinOrganization AllowI
nvites
From
--------------- ----------- ----------- -- ----------------------------------------- ------
Used to manage authorization related settings across the company. Authorization Policy authorizationPolicy True every…
這個範例會取得 Microsoft Entra ID 授權政策。
範例 2:依 ID 取得授權政策
Connect-Entra -Scopes 'Policy.Read.All'
Get-EntraAuthorizationPolicy -Id 'authorizationPolicy' | Format-List
allowInvitesFrom : everyone
allowUserConsentForRiskyApps :
id : authorizationPolicy
defaultUserRolePermissions : @{allowedToCreateSecurityGroups=True; allowedToReadBitlockerKeysForOwnedDevice=True; allowedToCreateTenants=True;
allowedToReadOtherUsers=True; allowedToCreateApps=False; permissionGrantPoliciesAssigned=System.Object[]}
blockMsolPowerShell : False
guestUserRoleId : a0b1b346-4d3e-4e8b-98f8-753987be4970
displayName : Authorization Policy
@odata.context : https://graph.microsoft.com/v1.0/$metadata#policies/authorizationPolicy/$entity
allowedToSignUpEmailBasedSubscriptions : True
description : Used to manage authorization related settings across the company.
allowEmailVerifiedUsersToJoinOrganization : True
allowedToUseSSPR : True
DeletedDateTime :
AdditionalProperties : {}
這個範例會取得 Microsoft Entra ID 授權政策。
-
-Id參數指定授權政策的唯一識別碼。
反應性質如下:
-
allowedToSignUpEmailBasedSubscriptions- 顯示使用者是否可以註冊電子郵件訂閱。 -
allowedToUseSSPR- 指示租戶管理員是否可以使用 Self-Service 密碼重設(SSPR)。 -
allowEmailVerifiedUsersToJoinOrganization- 表示使用者是否可以透過電子郵件驗證加入租戶。 -
allowInvitesFrom- 表示誰可以邀請賓客加入組織。 可能的值為:none、adminsAndGuestInviters、adminsGuestInvitersAndAllMembers、everyone。everyone是除美國政府外所有雲端環境的預設設定。 -
allowUserConsentForRiskyApps- 表示是否允許使用者對風險較高的應用程式進行同意。 預設值為false。 我們建議你將值設定為false。 -
blockMsolPowerShell- 若要停用 MSOnline PowerShell 模組,請將此屬性設為true。 這也使使用者無法存取 MSOnline PowerShell 模組所使用的舊有服務端點。 這不會影響 Microsoft Entra Connect 或 Microsoft Graph。 -
defaultUserRolePermissions- 指定某些可自訂的預設使用者角色權限。 -
description- 本政策說明。 -
displayName- 此政策的顯示名稱。 -
enabledPreviewFeatures- 租戶啟用的功能列表,供私有預覽。 -
guestUserRoleId-represents 應該授予來賓的角色模板ID。 請參閱「列表 unifiedRoleDefinitions」以找到可用的角色範本清單。 目前支援以下角色:使用者(a0b1b346-4d3e-4e8b-98f8-753987be4970)、訪客使用者(10dae51f-b6af-4016-8d66-8c2a99b929b3)及受限訪客使用者(2af84b1e-32c8-42b7-82bc-daa82404023b)。 -
permissionGrantPolicyIdsAssignedToDefaultUserRole- 指示使用者是否允許使用應用程式,若允許,則說明管理用戶授權權限的應用程式同意政策。 數值應採用使用者同意政策或managePermissionGrantsForSelf.{id}資源特定同意政策的格式managePermissionGrantsForOwnedResource.{id},其中 {id} 是內建或自訂應用程式同意政策的 ID。 空白清單表示使用者對應用程式的同意被停用。
參數
-Id
指定授權政策的唯一識別碼。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
GetById
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Property
指定要回傳的屬性。
參數屬性
| 類型: | System.String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 選取 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。