使用 Microsoft Entra 應用程式 Proxy 為已發佈的應用程式設定自訂首頁

此文章討論如何設定應用程式來將使用者導向自訂首頁。當您使用應用程式 Proxy 發佈應用程式時，您會設定內部 URL，但有時這不是使用者應該先看到的頁面。設定自定義首頁，讓使用者在存取應用程式時取得正確的頁面。無論使用者從 Microsoft Entra My Apps 或 Microsoft 365 應用程式啟動器存取應用程式，都會看到您設定的自定義首頁。

當使用者啟動應用程式時，預設會導向至已發佈應用程式的根域URL。登陸頁面通常設定為首頁 URL。當您想要讓應用程式使用者登陸應用程式內的特定頁面時，請使用 Microsoft Entra PowerShell 模組來定義自定義首頁 URL。

以下提供一個案例來說明您的公司應設定自訂首頁的原因：

在您的公司網路內部，使用者會前往 https://ExpenseApp/login/login.aspx，以登入並存取您的應用程式。
由於您有應用程式 Proxy 需要在資料夾結構最上層存取的其他資產 (例如影像)，因此會以 https://ExpenseApp 作為內部 URL 來發佈應用程式。
默認的外部 URL 是 https://ExpenseApp-contoso.msappproxy.net，不會將外部用戶導向登入頁面。
您想要改為將 https://ExpenseApp-contoso.msappproxy.net/login/login.aspx 設定為首頁 URL，讓外部使用者先看到登入頁面。

注意

當您為使用者提供已發佈應用程式的存取權時，應用程式會出現在我的應用程式和 Office 365 應用程式啟動器中。

在您開始之前

設定首頁 URL 之前，請記住下列需求：

您指定的路徑必須是根網域 URL 的子網域路徑。

例如，如果根域 URL 是 https://apps.contoso.com/app1/，您設定的首頁 URL 必須以 https://apps.contoso.com/app1/開頭。
若變更已發佈的應用程式，則變更可能會重設首頁 URL 的值。當您未來更新應用程式時，您應該重新檢查並視需要更新首頁 URL。

您可以透過 Microsoft Entra 系統管理中心或使用 PowerShell 來設定首頁 URL。

變更 Microsoft Entra 系統管理中心的首頁

若要透過 Microsoft Entra 系統管理中心變更應用程式的首頁 URL，請遵循下列步驟：

以至少應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
在右上角選取您的使用者名稱。請確認您已登入使用應用程式 Proxy 的目錄。如果您需要變更目錄，請選取 [切換目錄]，然後選擇會使用應用程式 Proxy 的目錄。
流覽至 Entra ID>應用程式註冊。已註冊的應用程式清單隨即出現。
從清單中選擇您的應用程式。顯示已註冊應用程式詳細資料的頁面隨即出現。
在 [管理] 底下，選取 [商標]。
使用新路徑更新首頁 URL。
選擇 <儲存>。

使用 PowerShell 變更首頁

若要使用 PowerShell 來設定應用程式的首頁，您需要：

安裝 Microsoft Entra PowerShell 模組。
尋找應用程式的 ObjectId 值。
使用 PowerShell 命令來更新應用程式的首頁 URL。

安裝 Microsoft Entra PowerShell 模組

使用 PowerShell 定義自定義首頁 URL 之前，請先安裝 Microsoft Entra PowerShell 模組。您可以從 PowerShell 資源庫下載此套件，其使用圖形 API 端點。

若要安裝套件，請遵循下列步驟：

開啟標準 PowerShell 視窗，然後執行下列命令：
```
Install-Module -Name Microsoft.Graph
```
如果您在沒有管理權限的情況下執行該命令，請使用 -Scope CurrentUser 選項。
在安裝期間，選取 [Y] 以從 Nuget.org 安裝兩個套件。兩個套件都是必要套件。

查找應用程式的 ObjectId

您可以使用應用程式的顯示名稱或首頁來搜尋應用程式，以取得其 ObjectId。

在相同的 PowerShell 視窗中，匯入 Microsoft Entra 模組。
```
Import-Module -Name Microsoft.Graph
```
以租用戶系統管理員身分登入 Microsoft Entra 模組。
```
Connect-Entra -Scopes 'Application.Read.All'
```
尋找應用程式。使用 PowerShell，此範例會搜尋顯示名稱為 SharePoint 的應用程式，以尋找其 ObjectId。
```
Get-EntraApplication | Where-Object { $_.DisplayName -eq "SharePoint" } | Format-List DisplayName, IdentifierUris, ObjectId
```
您應會取得如下所示的結果。複製 ObjectId GUID，以便在下一節使用。
```
DisplayName       : SharePoint
IdentifierUris    : https://sharepoint-iddemo.msappproxy.net/
ObjectId          : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
```
或者，您可以直接提取所有應用程式的清單、在清單中搜尋具有特定顯示名稱或首頁的應用程式，然後在找到應用程式之後複製應用程式的 ObjectId。
```
Get-EntraApplication | Format-List DisplayName, IdentifierUris, ObjectId
```

更新首頁 URL

建立首頁 URL，並使用該值來更新您的應用程式。繼續使用相同的 PowerShell 視窗，或者，如果您使用的是新的 PowerShell 視窗，請使用 Connect-Entra 重新登入 Microsoft Entra 模組。接著，依照下列步驟執行：

建立一個變數來保存您所複製的 ObjectId 值。
```
$objguid = "<object id>"
```
透過執行下列命令來確認您具有正確的應用程式。輸出應該與您在上一節 (尋找應用程式的 ObjectId) 中看到的輸出相同。
```
Get-EntraApplication -ObjectId $objguid | Format-List DisplayName, IdentifierUris, ObjectId
```
將首頁 URL 設定為您想要的值。此值必須是已發佈應用程式的子網域路徑。例如，如果您將首頁 URL 從 https://sharepoint-iddemo.msappproxy.net/ 變更為 https://sharepoint-iddemo.msappproxy.net/hybrid/，則應用程式使用者會直接前往自訂首頁。

使用此命令：
```
Set-EntraApplication -ApplicationId $objguid -IdentifierUris 'https://sharepoint-iddemo.msappproxy.net/hybrid/'
```

若要確認變更成功，請再次執行步驟 2 中的下列命令。

Get-EntraApplication -ObjectId $objguid | Format-List DisplayName, IdentifierUris, ObjectId

在我們的範例中，輸出現在看起來應該如下所示：

DisplayName       : SharePoint
IdentifierUris    : https://sharepoint-iddemo.msappproxy.net/hybrid/
ObjectId          : bbbbbbbb-1111-2222-3333-cccccccccccc

重新啟動應用程式，以確認首頁會如預期般顯示為第一個畫面。

注意

您對應用程式所做的任何變更都可能會重設首頁 URL。如果您的首頁 URL 重設，請重複本節中的步驟重新設定。

下一步

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-04-10