Run PowerShell proxy server setup script#

Overview#

VOSS provides a script to automate the setup of the Windows PowerShell proxy server for for Microsoft Teams and (optionally) Microsoft Exchange Online.

Note

You can run the script on a new PowerShell proxy server, or use an existing one. A single PowerShell server can be used by multiple tenants, with or without Microsoft Exchange.

Pre-requisites

  • Download the script from the client portal: https://voss.portalshape.com

  • You’ll need a Windows server >=2019

  • You must have local Administrator privileges on the PowerShell proxy server.

Execute the script#

This procedure runs the PowershellProxySetup_24.2.0_v1.0.ps1 script.

  1. Transfer the downloaded PowershellProxySetup_24.2.0_v1.0.ps1 script to the Microsoft PowerShell proxy server.

  2. On the Windows server, run the script as an Administrator.

  3. Are you using a currently active service user account, or do you need to create one?

    • Using a currently active service user account. Press Enter to proceed.

    • Creating a new service user account. Fill out the name you want to use for the service user account that will be created, then press Enter to proceed.

    Note

    If you don’t provide a service user account name, the script uses the currently active user account.

  4. Fill out a password for the service user account to be assigned. If you’re using the current service user account, fill out the password for that user.

  5. Press Enter.

  6. Are you using an outbound internet proxy?

    • Yes. Fill out the proxy server IP/FQDN and port in the following format: xxx.xxx.xxx.xxx:yyyy (for example, 192.168.1.1:3128)

    • No. Leave the field blank.

  7. Press Enter.

    The script executes, performing the following steps:

    Note

    This script uses local files to install all required PowerShell modules so that an internet connection won’t be required to execute it. The files must be downloaded from the VOSS client portal and placed in the same folder as the script before executing.

    • Checks that the local admin service account is present

    • Configures the outbound internet proxy

    • Configures WinRM (Windows Remote Management service)

    • Installs/updates .NET framework

    • Installs/updates PowerShell modules

    • Checks that OpenSSH server is enabled and running

    • Checks that the privileged scheduled task is present

    • Checks that debug tools are present

    • Installs PowerShell 7

Related Topics

Step 1: Microsoft UC Application Setup