Get-MsolServicePrincipal

  • 參考
模組:
MSOnline

從 Azure Active Directory 取得服務主體。

語法

Get-MsolServicePrincipal
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

Get-MsolServicePrincipal Cmdlet 會從 Azure Active Directory 取得服務主體或服務主體清單。

範例

範例 1：顯示所有服務主體

PS C:\> Get-MsolServicePrincipal

此命令會顯示組織租使用者中的所有現有服務主體。

範例 2：使用名稱取得服務主體

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

此命令會取得具有以 MyApp 開頭之服務主體名稱的所有現有服務主體。 這是與服務主體名稱的 appClass 部分完全相符，最多為正斜線。

範例 3：取得服務主體

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

此命令會取得具有特定應用程式主體標識碼的服務主體。

參數

-All

表示此 Cmdlet 會傳回所有結果。 請勿與 MaxResults 參數一起指定。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-AppPrincipalId

指定要取得之服務主體的唯一應用程式標識碼。

類型:Guid
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-MaxResults

指定這個 Cmdlet 傳回的結果數目上限。 預設值為 500。

類型:Int32
Position:Named
預設值:500
必要:False
接受管線輸入:False
接受萬用字元:False

-ObjectId

指定要取得之服務主體的唯一對象標識碼。

類型:Guid
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-SearchString

指定要比對服務主體名稱的字串。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ServicePrincipalName

指定要取得的服務主體或服務主體名稱。 SPN 必須使用下列其中一種格式：

  • appName
  • appName/hostname
  • 有效的 URL

AppName 代表應用程式的名稱，而主機名代表應用程式的 URI 授權單位。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-TenantId

指定要在其中執行作業之租使用者的唯一標識符。 預設值為目前使用者的租使用者。 此參數僅適用於合作夥伴使用者。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸出

Microsoft.Online.Administration.ServicePrincipal[]

此 Cmdlet 會從 Azure Active Directory 傳回服務主體或服務主體清單。 每個服務主體都包含下列資訊：

  • ObjectId。 服務主體的唯一標識碼。
  • AppPrincipalId。 服務主體的應用程式識別碼。
  • DisplayName。 服務主體的易記名稱。
  • ServicePrincipalName。 與服務主體相關聯的服務主體名稱清單 (SPN) 。
  • AccountEnabled。 值，指出帳戶是否已啟用。