建立 Microsoft Entra 私人網路連接器的無操作安裝指令碼

本文可協助您建立 Windows PowerShell 指令碼，以啟用自動安裝和註冊 Microsoft Entra 私人網路連接器。

要進行下列動作時，自動安裝會很有用：

• 在未啟用使用者介面或您無法使用遠端桌面存取的 Windows 伺服器上安裝連接器。
• 一次安裝並註冊許多連接器。
• 將連接器安裝與註冊整合成另一個程序的一部分。
• 建立一個包含連接器位元但未註冊的標準伺服器映像。

若要讓私人網路連接器能夠運作，您必須向 Microsoft Entra ID 註冊。 安裝連接器時，會在使用者介面中完成註冊，但您可以使用 PowerShell 將程序自動化。

自動安裝有兩個步驟。 首先，安裝連接器。 其次，使用 Microsoft Entra ID 註冊連接器。

重要

若要安裝適用於 Microsoft Azure Government 雲端的連接器，請檢閱必要條件和安裝步驟。 Microsoft Azure Government 雲端需要啟用對不同組 URL 的存取權，以及執行安裝的其他參數。

安裝連接器

使用下列步驟安裝連接器而不註冊連接器：

1. 開啟命令提示字元。

2. 執行下列命令，/q 旗標代表無訊息安裝。 無訊息安裝不會提示您接受《使用者授權合約》。

   MicrosoftEntraPrivateNetworkConnectorInstaller.exe REGISTERCONNECTOR="false" /q
   

使用 Microsoft Entra ID 註冊連接器

使用離線時建立的權杖註冊連接器。

使用離線時建立的權杖註冊連接器

1. 使用此程式碼片段中的值或 PowerShell Cmdlet，建立使用 AuthenticationContext 類別的離線權杖：

   使用 C#：

   using System;
   using System.Linq;
   using System.Collections.Generic;
   using Microsoft.Identity.Client;
   
   class Program
   {
      #region constants
      /// <summary>
      /// The AAD authentication endpoint uri
      /// </summary>
      static readonly string AadAuthenticationEndpoint = "https://login.microsoftonline.com/common/oauth2/v2.0/authorize";
   
      /// <summary>
      /// The application ID of the connector in AAD
      /// </summary>
      static readonly string ConnectorAppId = "55747057-9b5d-4bd4-b387-abf52a8bd489";
   
      /// <summary>
      /// The AppIdUri of the registration service in AAD
      /// </summary>
      static readonly string RegistrationServiceAppIdUri = "https://proxy.cloudwebappproxy.net/registerapp/user_impersonation";
   
      #endregion
   
      #region private members
      private string token;
      private string tenantID;
      #endregion
   
      public void GetAuthenticationToken()
      {
         IPublicClientApplication clientApp = PublicClientApplicationBuilder
            .Create(ConnectorAppId)
            .WithDefaultRedirectUri() // will automatically use the default Uri for native app
            .WithAuthority(AadAuthenticationEndpoint)
            .Build();
   
         AuthenticationResult authResult = null;
   
         IAccount account = null;
   
         IEnumerable<string> scopes = new string[] { RegistrationServiceAppIdUri };
   
         try
         {
         authResult = await clientApp.AcquireTokenSilent(scopes, account).ExecuteAsync();
         }
         catch (MsalUiRequiredException ex)
         {
         authResult = await clientApp.AcquireTokenInteractive(scopes).ExecuteAsync();
         }
   
         if (authResult == null || string.IsNullOrEmpty(authResult.AccessToken) || string.IsNullOrEmpty(authResult.TenantId))
         {
         Trace.TraceError("Authentication result, token or tenant id returned are null");
         throw new InvalidOperationException("Authentication result, token or tenant id returned are null");
         }
   
         token = authResult.AccessToken;
         tenantID = authResult.TenantId;
      }
   }
   

   使用 PowerShell：

   # Loading DLLs
   
   Find-PackageProvider -Name NuGet| Install-PackageProvider -Force
   Register-PackageSource -Name nuget.org -Location https://www.nuget.org/api/v2 -ProviderName NuGet
   Install-Package Microsoft.IdentityModel.Abstractions  -ProviderName Nuget -RequiredVersion 6.22.0.0 
   Install-Module Microsoft.Identity.Client
   
   add-type -path "C:\Program Files\PackageManagement\NuGet\Packages\Microsoft.IdentityModel.Abstractions.6.22.0\lib\net461\Microsoft.IdentityModel.Abstractions.dll"
   add-type -path "C:\Program Files\WindowsPowerShell\Modules\Microsoft.Identity.Client\4.53.0\Microsoft.Identity.Client.dll"
   
   # The AAD authentication endpoint uri
   
   $authority = "https://login.microsoftonline.com/common/oauth2/v2.0/authorize"
   
   #The application ID of the connector in AAD
   
   $connectorAppId = "55747057-9b5d-4bd4-b387-abf52a8bd489";
   
   #The AppIdUri of the registration service in AAD
   $registrationServiceAppIdUri = "https://proxy.cloudwebappproxy.net/registerapp/user_impersonation"
   
   # Define the resources and scopes you want to call
   
   $scopes = New-Object System.Collections.ObjectModel.Collection["string"] 
   
   $scopes.Add($registrationServiceAppIdUri)
   
   $app = [Microsoft.Identity.Client.PublicClientApplicationBuilder]::Create($connectorAppId).WithAuthority($authority).WithDefaultRedirectUri().Build()
   
   [Microsoft.Identity.Client.IAccount] $account = $null
   
   # Acquiring the token
   
   $authResult = $null
   
   $authResult = $app.AcquireTokenInteractive($scopes).WithAccount($account).ExecuteAsync().ConfigureAwait($false).GetAwaiter().GetResult()
   
   # Check AuthN result
   If (($authResult) -and ($authResult.AccessToken) -and ($authResult.TenantId)) {
   
      $token = $authResult.AccessToken
      $tenantId = $authResult.TenantId
   
      Write-Output "Success: Authentication result returned."
   }
   Else {
   
      Write-Output "Error: Authentication result, token or tenant id returned with null."
   
   } 
   

2. 擁有權杖之後，請使用該權杖建立一個 SecureString：

   $SecureToken = $Token | ConvertTo-SecureString -AsPlainText -Force
   

3. 執行下列 Windows PowerShell 命令，將 <tenant GUID> 取代為您的目錄識別碼：

   .\RegisterConnector.ps1 -modulePath "C:\Program Files\Microsoft Entra private network connector\Modules\" -moduleName "MicrosoftEntraPrivateNetworkConnectorPSModule" -Authenticationmode Token -Token $SecureToken -TenantId <tenant GUID> -Feature ApplicationProxy
   

4. 將指令碼或程式碼存放在安全的位置，因為其包含敏感性認證資訊。

下一步

• 什麼是全球安全存取？