在 Windows 上透過 WinRS 安裝代理程式

您可以在 Windows 系統上透過 WinRS 以遠端方式安裝代理程式。

開始之前

您可以使用此方法來在具有 Windows PowerShell 的 Windows 版本（包括 Windows Server 2003、2008 及 2012）上安裝代理程式。作為替代方案，您可以在大部分 Windows 系統上手動安裝代理程式，如從指令行安裝代理程式中所述。

在您可以遠端方式在 Windows 系統上安裝代理程式之前，您必須手動安裝一個代理程式並將該代理程式指定為 WinRS 代理程式。請遵循下列步驟：

在 Windows 系統上透過指令行安裝代理程式。請參閱從指令行安裝代理程式。
在 IBM® UrbanCode Deploy 伺服器上，以管理者身分按一下設定 > 系統設定
在「系統設定」頁面上，於 WinRS 代理程式欄位中選取已在 Windows 系統上安裝的代理程式。
按一下儲存。

配置管理 WinRS 代理程式的系統：

在指令行上執行下列指令，將系統配置為透過 WinRS 進行通訊。每一個指令都必須在單一行上。

winrm quickconfig

winrm set winrm/config/winrs @{MaxMemoryPerShellMB="1024"}

如果您沒有執行那些指令的許可權，請改為執行下列指令：

sc config "WinRM" start= auto

net start WinRM

winrm create winrm/config/listener?Address=*+Transport=HTTP

netsh firewall add portopening TCP 80 "Windows Remote Management"

netsh firewall add portopening TCP 5985 "Windows Remote Management"

reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System /v LocalAccountTokenFilterPolicy /t REG_DWORD /d 1 /f

winrm set winrm/config/winrs @{MaxMemoryPerShellMB="1024"}

確保執行代理程式的使用者具有對映網路磁碟機的許可權。

既然您已指定一個代理程式作為 WinRS 代理程式，您可以使用該代理程式來以遠端方式安裝其他代理程式。

程序

配置您要在其中安裝代理程式的系統：
1. 在指令行上執行下列指令，將系統配置為透過 WinRS 進行通訊。每一個指令都必須在單一行上。
```
winrm quickconfig
```
```
winrm set winrm/config/winrs '@{MaxMemoryPerShellMB="1024"}'
```
  如果您沒有執行那些指令的許可權，請改為執行下列指令：
```
sc config "WinRM" start= auto
```
```
net start WinRM
```
```
winrm create winrm/config/listener?Address=*+Transport=HTTP
```
```
netsh firewall add portopening TCP 80 "Windows Remote Management"
```
```
netsh firewall add portopening TCP 5985 "Windows Remote Management"
```
```
reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System /v LocalAccountTokenFilterPolicy /t REG_DWORD /d 1 /f
```
```
winrm set winrm/config/winrs @{MaxMemoryPerShellMB="1024"}
```
2. 如果代理程式系統不是伺服器所在網域的一部分，請將每一個系統新增至另一個系統的授信主機。例如，執行下列指令：
```
winrm set winrm/config/client @{TrustedHosts="HOST1,HOST2,HOST3"}
```
  如果系統不是相同網域的一部分，則代理程式必須在其授信主機清單中具有伺服器主機名稱。類似地，伺服器必須在其授信主機清單中具有代理程式主機名稱。
3. 在代理程式系統上啟用檔案及印表機共用。
4. 在代理程式系統上建立使用者。此使用者必須具有下列許可權：
  - 暫存目錄的寫入權
  - 代理程式安裝目錄的寫入權
  - 建立網路共用
  - 當作作業系統的一部分運作（僅當您將代理程式作為服務安裝時，才需要此許可權）
  此使用者還必須是管理者群組成員。
5. 如果您將代理程式作為服務安裝，則執行服務的使用者必須具有作為服務登入的許可權。
6. 請確保要在其中安裝代理程式的每台電腦，都有 Java™ 執行時期環境 (JRE) 或 Java 開發者套件 (JDK) 的受支援版本。如需相關資訊，請參閱IBM UrbanCode Deploy 的系統需求。
  如果目標電腦具有 IBM JRE 或 Java 開發者套件，請更新為 IBM JRE 或 Java 開發者套件的受支援版本。
在 IBM UrbanCode Deploy 伺服器上，按一下資源 > 代理程式，然後按一下安裝新代理程式。
在「安裝新代理程式」視窗中，選取 WinRS
指定代理程式系統的主機名稱或 IP 位址、使用者名稱及密碼。如果要指定多個項目，請在獨立的行中鍵入每一個。代理程式名稱與您輸入的主機名稱或 IP 位址相同。

從代理程式安裝內容清單中選取一個代理程式安裝內容表，或者使用新建來建立一個內容表。代理程式安裝內容表是可以儲存且用於安裝代理程式的範本。您可以建立任意數目的代理程式安裝內容表。代理程式安裝內容列在下表中：

表 1. 遠端代理程式安裝內容
欄位	說明
名稱	代理程式安裝內容表的名稱。此值是必要項目。
說明	內容表說明。
代理程式目錄	在其中安裝代理程式之目標上的目錄。此值是必要項目。
Java 起始目錄路徑	目標上 Java 的路徑。一般而言，您應輸入代理程式系統的 JAVA_HOME 系統變數的值。在這個欄位中，請勿使用 JAVA_HOME 變數自身或任何其他變數；必須指定完整的文字路徑。例如，在 Microsoft Windows 系統上，Java 起始目錄路徑可能是 C:\Program Files\Java\jre。在 Linux 系統上，Java 起始目錄路徑可能是 /usr/lib/jvm/default-java。此值是必要項目。
暫存目錄路徑	安裝期間用於暫存檔之目錄的路徑。此值是必要項目。
伺服器主機	代理程式所連接的 IBM UrbanCode Deploy 伺服器或代理程式中繼的主機名稱或 IP 位址。此值是必要項目。
伺服器埠	IBM UrbanCode Deploy 伺服器或代理程式中繼用於連接至代理程式的埠。用於連接至伺服器的預設埠是 7918。用於連接至代理程式中繼的預設埠是 7916。此值是必要項目。
Proxy 主機	代理程式中繼（如果使用的話）的主機名稱或 IP 位址。
Proxy 埠	代理程式中繼（如果使用的話）的 HTTP Proxy 埠。預設值為 `20080`。
自動啟動	如果要將代理程式作為服務進行安裝，請選取自動啟動，以在 Windows 啟動時自動執行代理程式。僅限於 Windows。
服務名稱	如果將代理程式作為服務進行安裝，請輸入代理程式服務的名稱。僅限於 Windows。
服務使用者	如果將代理程式作為服務進行安裝，請輸入具有適當許可權來執行服務的使用者名稱。僅限於 Windows。
服務密碼	如果將代理程式作為服務進行安裝，請輸入與服務使用者相關聯的密碼。僅限於 Windows。

選擇性的：勾選指派團隊，以將代理程式指派給某個團隊。
1. 按一下新增 .
2. 從團隊清單中，選取要對其指派代理程式的團隊。
3. 從角色清單中，選取代理程式角色。如需團隊的相關資訊，請參閱直接將團隊指派給項目
按一下儲存。

結果

從遠端安裝的代理程式自動開始執行。如果以遠端方式安裝的代理程式停止執行，則必須在管理該代理程式的系統上將其重新啟動。

下一步

如果使用交互鑑別，則必須在代理程式與伺服器之間手動交換金鑰。如需這個選項的相關資訊，請參閱配置交互鑑別。

如果您是使用高可用性環境，請配置代理程式，以便可失效接手至叢集中的其他伺服器。請參閱對代理程式進行失效接手配置。

意見