Get-EntraApplicationServiceEndpoint

取得應用程式的服務端點。

語法

Default (預設值)

Get-EntraApplicationServiceEndpoint

    -ServicePrincipalId <String>
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [<CommonParameters>]

Description

指令 Get-EntraApplicationServiceEndpoint 小子會擷取應用程式的服務端點。

服務端點實體包含服務發現資訊。 應用程式實體的 serviceEndpoints 屬性為 ServiceEndpoint。

其他服務可利用 ServiceEndpoint 實體中儲存的資訊來尋找此服務及其可位址端點。

範例

範例 1:依 ID 檢索應用程式服務端點

Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "DisplayName eq 'Contoso Helpdesk App'"
Get-EntraApplicationServiceEndpoint -ServicePrincipalId $servicePrincipal.Id

此範例示範如何透過物件 ID 參數檢索應用程式的服務端點。

-ServicePrincipalId參數指定 Microsoft Entra ID 中應用程式物件的 ID。

範例 2:取得所有服務端點

Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "DisplayName eq 'Contoso Helpdesk App'"
Get-EntraApplicationServiceEndpoint -ServicePrincipalId $servicePrincipal.Id -All

此範例示範如何檢索指定應用程式的所有服務端點。

-ServicePrincipalId參數指定 Microsoft Entra ID 中應用程式物件的 ID。

範例 3:取得前五名服務端點

Connect-Entra -Scopes 'Application.Read.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "DisplayName eq 'Contoso Helpdesk App'"
Get-EntraApplicationServiceEndpoint -ServicePrincipalId $servicePrincipal.Id -Top 5

此範例示範如何擷取指定應用程式的五個服務端點。 您可以使用 -Limit 作為 -Top的別名。

-ServicePrincipalId參數指定 Microsoft Entra ID 中應用程式物件的 ID。

參數

-All

回傳所有服務端點。

參數屬性

類型:System.Management.Automation.SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False

參數集

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

-Property

指定要回傳的屬性

參數屬性

類型:

System.String[]

預設值:None
支援萬用字元:False
不要顯示:False
別名:選取

參數集

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

-ServicePrincipalId

指定所取得服務端點的應用程式的物件 ID。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False
別名:ObjectId (物件識別碼)

參數集

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

-Top

指定回傳的最大結果數量。 預設值為 100。

參數屬性

類型:System.Int32
預設值:None
支援萬用字元:False
不要顯示:False
別名:極限

參數集

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

CommonParameters

此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。

輸入

System.String

System.Nullable'1[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]] System.Nullable'1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

輸出

System.Object