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

發行項
06/22/2024

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

當使用者啟動應用程式時，預設會將他們導向已發佈應用程式的根網域 URL。登陸頁面通常設定為首頁 URL。當您想要讓應用程式使用者登陸應用程式內的特定頁面時，請使用 Azure AD 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 應用程式啟動器中。

在您開始使用 Intune 之前

設定首頁 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 的目錄。
瀏覽至 [身分識別]>[應用程式]>[應用程式註冊]。已註冊的應用程式清單隨即出現。
從清單中選擇您的應用程式。顯示已註冊應用程式詳細資料的頁面隨即出現。
在 [管理] 底下，選取 [商標]。
使用新路徑來更新 [首頁 URL]。
選取 [儲存]。

使用 PowerShell 變更首頁

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

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

安裝 Azure AD PowerShell 模組

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

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

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

尋找應用程式的 ObjectId

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

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

更新首頁 URL

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

建立一個變數來保存您所複製的 ObjectId 值。
```
$objguid = "<object id>"
```
透過執行下列命令來確認您具有正確的應用程式。輸出應該與您在上一節 (尋找應用程式的 ObjectId) 中看到的輸出相同。
```
Get-AzureADApplication -ObjectId $objguid | Format-List DisplayName, Homepage, ObjectId
```

建立空白應用程式物件以存放您要進行的變更。

$appnew = New-Object "Microsoft.Open.AzureAD.Model.Application"

將首頁 URL 設定為您想要的值。此值必須是已發佈應用程式的子網域路徑。例如，如果您將首頁 URL 從 https://sharepoint-iddemo.msappproxy.net/ 變更為 https://sharepoint-iddemo.msappproxy.net/hybrid/，則應用程式使用者會直接前往自訂首頁。
```
$homepage = "https://sharepoint-iddemo.msappproxy.net/hybrid/"
```

進行首頁更新。

Set-AzureADApplication -ObjectId $objguid -Homepage $homepage

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

Get-AzureADApplication -ObjectId $objguid | Format-List DisplayName, Homepage, ObjectId

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

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

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

注意

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

共用方式為