Get-AzADServicePrincipal

模組:

Az.Resources

列出服務主體中的實體，或依索引鍵從服務主體取得實體

語法

Get-AzADServicePrincipal
   [-Select <String[]>]
   [-Count]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   -ObjectId <String>
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -DisplayNameBeginsWith <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -DisplayName <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ApplicationId <Guid>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ApplicationObject <IMicrosoftGraphApplication>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADServicePrincipal
   [-Select <String[]>]
   -ServicePrincipalName <String>
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

列出服務主體中的實體，或依索引鍵從服務主體取得實體

範例

範例 1：依顯示名稱取得服務主體

Get-AzADServicePrincipal -DisplayName $name

依顯示名稱取得服務主體

範例 2：搜尋服務主體顯示名稱開頭為

Get-AzADServicePrincipal -DisplayNameStartsWith $prefix

搜尋服務主體顯示名稱開頭為

範例 3：列出服務主體

Get-AzADServicePrincipal -First 10 -Select Tags -AppendSelected

列出前 10 個服務主體，並在默認屬性之後附加屬性 'Tags'：'DisplayName'、'Id'、'DeletedDateTime'、'ServicePrincipalNames'、'AppId'

範例 4：依應用程式識別碼取得服務主體

Get-AzADServicePrincipal -ApplicationId $appId

依應用程式識別碼取得服務主體

範例 5：依管線輸入取得服務主體

Get-AzADApplication -DisplayName $name | Get-AzADServicePrincipal

依管線輸入取得服務主體

範例 6：使用篩選取得服務主體

Get-AzADServicePrincipal -Filter "startsWith(DisplayName,'some-name')"

使用篩選取得服務主體

範例 7：將 OdataCount 指派給變數

Get-AzADServicePrincipal -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

將 OdataCount 指派給變數

參數

-AppendSelected

在開啟此參數時，附加以預設屬性選取的屬性，僅適用於參數 '-Select'。

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

-ApplicationId

serviceprincipal 的應用程式標識碼

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

-ApplicationObject

服務主體物件可用來做為管線輸入。

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

-ConsistencyLevel

表示要求的一致性層級。 檔 URL：https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

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

-Count

包含項目計數

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

-CountVariable

指定集合中項目總數的計數。 根據預設，此變數會在全域範圍中設定。

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

-DefaultProfile

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

類型:	PSObject
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisplayName

serviceprincipal 顯示名稱

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

-DisplayNameBeginsWith

serviceprincipal 顯示名稱開頭為

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

-Filter

如需篩選查詢的詳細資訊，請依屬性值篩選專案，請參閱：https://learn.microsoft.com/en-us/graph/filter-query-parameter

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

-First

只取得第一個 『n』 物件。

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

-ObjectId

機碼：servicePrincipal 的標識符

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

-Orderby

依屬性值排序專案

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

-Search

依搜尋片語搜尋專案

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

-Select

選取要傳回的屬性

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

-ServicePrincipalName

serviceprincipal 名稱

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

-Skip

忽略第一個 'n' 對象，然後取得其餘的物件。

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

輸入

IMicrosoftGraphApplication

輸出

IMicrosoftGraphServicePrincipal