Error Description

The error message "The WS-Management service cannot process the request because the specified URI is not supported on the service side. Retry the request with local session" typically occurs when you try to execute WinRM (Windows Remote Management) commands or establish a remote PowerShell session, but the local configuration restricts remote connections.

This happens because the local WinRM client is attempting to access a remote resource or address that is not configured or permitted in the WS-Management (WSMan) trusted hosts list, or because the WinRM service itself is misconfigured or disabled on the local machine. By enforcing a "local session," Windows prevents the execution of commands over network protocols until explicit permissions and configurations are established.

Step-by-Step Fix

Follow these straightforward steps to resolve the issue by enabling WinRM and configuring the trusted hosts list.

Step 1: Open PowerShell as Administrator

1. Click on the Start Menu or press the Windows Key.
2. Type PowerShell into the search bar.
3. Right-click on Windows PowerShell from the search results.
4. Select Run as administrator.
5. Click Yes if a User Account Control (UAC) prompt appears.

Step 2: Enable and Configure the WinRM Service

You need to ensure that the Windows Remote Management service is running and properly configured on your system.

1. In the PowerShell window, type the following command and press Enter:

   winrm quickconfig

2. If the system prompts you to make changes (such as starting the service or enabling the firewall exception), type y (for Yes) and press Enter for each prompt.

Step 3: Configure Trusted Hosts

If you are trying to connect to a specific remote machine, or if a local script requires loopback remote permissions, you must add the target to your trusted hosts list.

1. To trust all hosts for testing or environment setup, type the following command and press Enter:

   Set-Item WSMan:\localhost\Client\TrustedHosts -Value "*" -Force

   (Note: If you only want to trust a specific computer, replace `with the specific IP address or hostname of that computer, for example:Set-Item WSMan:\localhost\Client\TrustedHosts -Value "192.168.1.50" -Force`)*

Step 4: Restart the WinRM Service

Apply the configuration changes by restarting the service.

1. Type the following command and press Enter:

   Restart-Service WinRM

Step 5: Verify the Configuration

Ensure that the changes have been saved successfully.

1. Type the following command to check your trusted hosts list and press Enter:

   Get-Item WSMan:\localhost\Client\TrustedHosts

2. Verify that the output displays the value (* or the specific IP/hostname) you set in Step 3.

Once these steps are completed, rerun your original command or script, and the error should be resolved.