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。