PowerShell을 사용하여 Unified Access Gateway 장치 배포

PowerShell 스크립트는 모든 구성 설정을 사용하여 환경을 준비합니다. PowerShell 스크립트를 실행하여 Unified Access Gateway를 배포할 경우 첫 번째 시스템 부팅 시 솔루션의 프로덕션 사용 준비가 완료됩니다.

중요:

PowerShell 배포를 사용하여 INI 파일에 있는 모든 설정을 제공할 수 있습니다. 또한 Unified Access Gateway 인스턴스는 부팅하는 즉시 운영 준비가 완료됩니다. 배포 후에 어떤 설정도 변경하지 않으려면 관리 UI 암호를 제공할 필요가 없습니다.

그러나 배포 중에 관리 UI 암호를 제공하지 않으면 관리 UI 및 API를 둘 다 사용하지 못합니다.

참고:

배포 시에 관리 UI 암호를 제공하지 않으면 나중에 사용자를 추가하여 관리 UI 또는 API에 대한 액세스를 사용하도록 설정할 수 없습니다. 관리 UI 사용자를 추가하려는 경우 올바른 암호를 사용하여 Unified Access Gateway 인스턴스를 다시 배포해야 합니다.

참고:

Unified Access Gateway 3.4 이상에는 배포를 위한 licenseEdition 속성이 포함되어 있습니다. 옵션으로는 Standard, Advanced 및 Enterprise가 있습니다. Unified Access Gateway 3.4 이전 버전에서 INI 파일을 다운로드할 경우 licenseEdition 속성이 INI 파일에 포함되어 있지 않습니다. 수동으로 licenseEdition 속성을 설정해야 합니다. 속성을 지정하지 않으면 기본적으로 Advanced 버전이 사용됩니다.

licenseEdition 속성이 Unified Access Gateway 3.4의 관리 UI에서 다운로드한 INI 파일에 포함되어 있습니다. 속성 값은 배포 중에 선택한 버전과 동일합니다.

사전 요구 사항

• Hyper-V 배포에서 정적 IP를 사용하여 Unified Access Gateway를 업그레이드할 경우 Unified Access Gateway의 새 인스턴스를 배포하기 전에 이전 장치를 삭제합니다.

• 시스템 요구 사항이 적절한지와 사용 가능한지 확인합니다.

  다음은 사용자 환경에 Unified Access Gateway를 배포하기 위한 샘플 스크립트입니다.

  그림 1. 샘플 PowerShell 스크립트

  

프로시저

1. [My VMware]에서 Windows 시스템으로 Unified Access Gateway OVA를 다운로드합니다.
2. uagdeploy-XXX.zip 파일을 Windows 시스템의 폴더로 다운로드합니다.

   이 ZIP 파일은 https://communities.vmware.com/docs/DOC-30835에서 다운로드할 수 있습니다.

3. PowerShell 스크립트를 열고 디렉토리를 스크립트의 위치로 수정합니다.
4. Unified Access Gateway 가상 장치에 대한 INI 구성 파일을 생성합니다.

   예를 들어 새 Unified Access Gateway 장치 AP1을 배포합니다. 구성 파일 이름은 ap1.ini입니다. 이 파일에는 AP1에 대한 모든 구성 설정이 포함됩니다. apdeploy.ZIP 파일의 샘플 INI 파일을 사용하여 INI 파일을 생성하고 설정을 적절히 수정할 수 있습니다.

   참고:

   • 환경의 여러 Unified Access Gateway 배포에 대해 고유한 lNI 파일이 있을 수 있습니다. 여러 장치를 배포하려면 INI 파일의 IP 주소 및 이름 매개 변수를 적절히 변경해야 합니다.

   • HealthCheckUrl 설정의 favicon.ico 값은 Content Gateway 및 VMware Tunnel에서 지원되지 않습니다.

   수정할 INI 파일의 예입니다.

   [General]
   netManagementNetwork=
   netInternet=
   netBackendNetwork=
   name=
   dns=10.112.64.1
   ip0=10.108.120.119
   diskMode=
   source=
   defaultGateway=10.108.120.125
   target=
   ds=
   authenticationTimeout=300000
   fipsEnabled=false
   uagName=trustedcert
   locale=en_US
   ipModeforNIC3=DHCPV4_DHCPV6
   tls12Enabled=true
   ipMode=DHCPV4_DHCPV6
   requestTimeoutMsec=10000
   ipModeforNIC2=DHCPV4_DHCPV6
   tls11Enabled=true
   clientConnectionIdleTimeout=180
   tls10Enabled=false
   adminCertRolledBack=false
   honorCipherOrder=false
   cookiesToBeCached=none
   healthCheckUrl=/favicon.ico
   quiesceMode=false
   isCiphersSetByUser=false
   tlsPortSharingEnabled=true
   For UAG 3.4 onwards include licenseEdition property to be deployed.
   # Options include- Standard, Advanced or Enterprise.
   # Please uncomment the UAG license edition based on the Horizon/Workspace ONE licensing.
   # licenseEdition=Standard
   # licenseEdition=Advanced
   # licenseEdition=Enterprise
   ceipEnabled=true
   bodyReceiveTimeoutMsec=15000
   monitorInterval=60
   cipherSuites=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA
   adminPasswordExpirationDays=90
   httpConnectionTimeout=120
   isTLS11SetByUser=false
   sessionTimeout=36000000
   ssl30Enabled=false
   
   [WebReverseProxy1]
   proxyDestinationUrl=https://10.108.120.21
   trustedCert1=
   instanceId=view
   healthCheckUrl=/favicon.ico
   userNameHeader=AccessPoint-User-ID
   proxyPattern=/(.*)
   landingPagePath=/
   hostEntry1=10.108.120.21 HZNView.uagqe.auto.com
   
   [Horizon]
   proxyDestinationUrl=https://enterViewConnectionServerUrl
   trustedCert1=
   gatewayLocation=external
   disableHtmlAccess=false
   healthCheckUrl=/favicon.ico
   proxyDestinationIPSupport=IPV4
   smartCardHintPrompt=false
   queryBrokerInterval=300
   proxyPattern=(/|/view-client(.*)|/portal(.*)|/appblast(.*))
   matchWindowsUserName=false
   windowsSSOEnabled=false
   
   [SSLCert]
   pemPrivKey=
   pemCerts=
   pfxCerts=
   pfxCertAlias=
   
   [SSLCertAdmin]
   pemPrivKey=
   pemCerts=
   pfxCerts=
   pfxCertAlias=
   
   

5. 스크립트를 성공적으로 실행하려면 PowerShell set-executionpolicy 명령을 입력합니다.

   set-executionpolicy -scope currentuser unrestricted

   이 명령은 현재 제한된 경우에만 한 번 실행해야 합니다.

   1. (선택 사항) 스크립트에 대한 경고가 표시되면 다음 명령을 실행하여 경고를 차단 해제합니다. unblock-file -path .\uagdeploy.ps1
6. 이 명령을 실행하여 배포를 시작합니다. .INI 파일을 지정하지 않으면 스크립트는 기본적으로 ap.ini가 됩니다.

   .\uagdeploy.ps1 -iniFile uag1.ini

7. 자격 증명을 입력하라는 메시지가 표시되면 입력하고 스크립트를 완료합니다.
   참고:

   대상 시스템에 대한 지문을 추가하라는 메시지가 표시되면 yes를 입력합니다.

   Unified Access Gateway 장치가 배포되고 프로덕션용으로 사용 가능합니다.

결과

PowerShell 스크립트에 대한 자세한 내용은 https://communities.vmware.com/docs/DOC-30835를 참조하십시오.

다음에 수행할 작업

기존 설정을 유지하면서 Unified Access Gateway를 업그레이드하려면 .ini 파일을 편집하여 소스 참조를 새 버전으로 변경한 후 .ini 파일을 다시 실행합니다( uagdeploy.ps1 uag1.ini). 이 프로세스에는 최대 3분이 소요될 수 있습니다.

[General]
name=UAG1
source=C:\temp\euc-unified-access-gateway-3.2.1-7766089_OVF10.ova

서비스 중단 없이 업그레이드하려면 다운타임이 없는 업그레이드를 참조하십시오.