Test-wsman PowerShell Command

The Test-WSMan command is a powerful tool in the Windows PowerShell scripting language. It is used to test the availability and functionality of the Windows Remote Management (WinRM) service on a local or remote computer. This command can be used to troubleshoot and diagnose problems with the WinRM service, as well as to verify the connection settings of a remote computer. In this guide, we will discuss the syntax, parameters, inputs, outputs, examples, and tips for using the Test-WSMan command.

Syntax

The syntax for the Test-WSMan command is as follows:

Test-WSMan [-ComputerName ] [-Authentication ] [-Credential ] [-Port ] [-UseSSL] [-SessionOption ] [-InformationLevel ] [-OperationTimeoutSec ] [-SkipCACheck] [-SkipCNCheck] [-SkipRevocationCheck] [-Thumbprint ] [-TransportOption ] [-CertificateThumbprint ] [-Certificate ] [-AllowUnencrypted] [-Force] [-WhatIf] [-Confirm] []

Parameters

The Test-WSMan command has several parameters that can be used to customize its behavior. These parameters are listed in the table below:

Parameter Description
ComputerName Specifies the name of the computer to be tested.
Authentication Specifies the authentication mechanism to be used for the test.
Credential Specifies the credentials to be used for the test.
Port Specifies the port to be used for the test.
UseSSL Specifies whether to use SSL for the test.
SessionOption Specifies the session options to be used for the test.
InformationLevel Specifies the information level to be used for the test.
OperationTimeoutSec Specifies the operation timeout to be used for the test.
SkipCACheck Specifies whether to skip the CA check for the test.
SkipCNCheck Specifies whether to skip the CN check for the test.
SkipRevocationCheck Specifies whether to skip the revocation check for the test.
Thumbprint Specifies the thumbprint to be used for the test.
TransportOption Specifies the transport option to be used for the test.
CertificateThumbprint Specifies the certificate thumbprint to be used for the test.
Certificate Specifies the certificate to be used for the test.
AllowUnencrypted Specifies whether to allow unencrypted traffic for the test.
Force Specifies whether to force the test to run.
WhatIf Specifies whether to display a preview of the test.
Confirm Specifies whether to prompt for confirmation before running the test.

Inputs

The Test-WSMan command accepts the following inputs:

  • ComputerName: The name of the computer to be tested.
  • Authentication: The authentication mechanism to be used for the test.
  • Credential: The credentials to be used for the test.
  • Port: The port to be used for the test.
  • UseSSL: Whether to use SSL for the test.
  • SessionOption: The session options to be used for the test.
  • InformationLevel: The information level to be used for the test.
  • OperationTimeoutSec: The operation timeout to be used for the test.
  • SkipCACheck: Whether to skip the CA check for the test.
  • SkipCNCheck: Whether to skip the CN check for the test.
  • SkipRevocationCheck: Whether to skip the revocation check for the test.
  • Thumbprint: The thumbprint to be used for the test.
  • TransportOption: The transport option to be used for the test.
  • CertificateThumbprint: The certificate thumbprint to be used for the test.
  • Certificate: The certificate to be used for the test.
  • AllowUnencrypted: Whether to allow unencrypted traffic for the test.
  • Force: Whether to force the test to run.
  • WhatIf: Whether to display a preview of the test.
  • Confirm: Whether to prompt for confirmation before running the test.

Outputs

The Test-WSMan command produces the following outputs:

  • ComputerName: The name of the computer tested.
  • Authentication: The authentication mechanism used for the test.
  • Credential: The credentials used for the test.
  • Port: The port used for the test.
  • UseSSL: Whether SSL was used for the test.
  • SessionOption: The session options used for the test.
  • InformationLevel: The information level used for the test.
  • OperationTimeoutSec: The operation timeout used for the test.
  • SkipCACheck: Whether the CA check was skipped for the test.
  • SkipCNCheck: Whether the CN check was skipped for the test.
  • SkipRevocationCheck: Whether the revocation check was skipped for the test.
  • Thumbprint: The thumbprint used for the test.
  • TransportOption: The transport option used for the test.
  • CertificateThumbprint: The certificate thumbprint used for the test.
  • Certificate: The certificate used for the test.
  • AllowUnencrypted: Whether unencrypted traffic was allowed for the test.
  • Force: Whether the test was forced to run.
  • WhatIf: Whether a preview of the test was displayed.
  • Confirm: Whether confirmation was prompted before running the test.
  • Result: The result of the test.

Examples

The following are some examples

Leave a Reply