共用方式為

Get-ServicePrincipal

模組:
Exchange PowerShell

此指令程式只能在雲端式服務中使用。

使用 Get-ServicePrincipal 指令碼來查看您雲端組織中服務主體的資訊。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

語法

Default (預設值) 

Get-ServicePrincipal
    [[-Identity] <ServicePrincipalIdParameter>]
    [-Organization <OrganizationIdParameter>]
    [<CommonParameters>]

Description

Microsoft Entra ID 中存在服務主體，用以定義應用程式能做什麼、誰能存取應用程式，以及應用程式能存取哪些資源。 在 Exchange Online 中，服務主體是對 Microsoft Entra ID 中服務主體的參考。 若要將Exchange Online基於角色的存取控制 (RBAC) 角色指派給 Microsoft Entra ID 中的服務主體，請使用Exchange Online中的服務主體參考。 Exchange Online PowerShell 中的 *-ServicePrincipal 指令集讓你可以查看、建立並移除這些服務主體參考。

欲了解更多資訊，請參閱 Microsoft Entra ID 中的應用程式與服務主體物件。

您必須已獲指派權限，才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-ServicePrincipal

此範例回傳組織內所有服務主體的摘要清單。

範例 2

Get-ServicePrincipal -Identity ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1 | Format-List

此範例回傳服務主體的詳細資訊，ObjectId 值為 ca73fffa-cedb-4b84-860f-d7fb8aa8a6c1。

參數

-Identity

適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件

Identity 參數指定你想要查看的服務主體。 你可以使用任何能唯一識別服務主體的值。 例如：

  • 名稱
  • 辨別名稱 (DN)
  • GUID
  • AppID
  • ObjectId

注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。

參數屬性

類型:ServicePrincipalIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Organization

適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件

將保留此參數供 Microsoft 內部使用。

參數屬性

類型:OrganizationIdParameter
預設值: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。