Test-WSMan

Verifica se il servizio Gestione remota Windows è in esecuzione in un computer locale o remoto.

Sintassi

Test-WSMan
    [[-ComputerName] <String>]
    [-Authentication <AuthenticationMechanism>]
    [-Port <Int32>]
    [-UseSSL]
    [-ApplicationName <String>]
    [-Credential <PSCredential>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

Descrizione

Il Test-WSMan cmdlet invia una richiesta di identificazione che determina se il servizio WinRM è in esecuzione in un computer locale o remoto. Se il servizio è in esecuzione sul computer testato, il cmdlet visualizza lo schema di identità WS-Management, la versione del protocollo, il fornitore del prodotto e la versione del prodotto del servizio testato.

Esempio

Esempio 1: Determinare lo stato del servizio WinRM

Test-WSMan

Questo comando determina se il servizio Gestione remota Windows è in esecuzione nel computer locale o in un computer remoto.

Esempio 2: Determinare lo stato del servizio WinRM in un computer remoto

Test-WSMan -ComputerName "server01"

Questo comando determina se il servizio WinRM è in esecuzione nel computer server01.

Esempio 3: Determinare lo stato del servizio WinRM e la versione del sistema operativo

Test-WSMan -Authentication default

Questo comando verifica se il servizio WS-Management (WinRM) è in esecuzione nel computer locale usando il parametro di autenticazione.

L'uso del parametro di autenticazione consente di Test-WSMan restituire la versione del sistema operativo.

Esempio 4: Determinare lo stato del servizio WinRM e la versione del sistema operativo in un computer remoto

Test-WSMan -ComputerName "server01" -Authentication default

Questo comando verifica se il servizio WS-Management (WinRM) è in esecuzione nel computer denominato server01 usando il parametro di autenticazione.

L'uso del parametro di autenticazione consente di Test-WSMan restituire la versione del sistema operativo.

Parametri

-ApplicationName

Specifica il nome dell'applicazione nella connessione. Il valore predefinito del parametro ApplicationName è WSMAN. L'identificatore completo per l'endpoint remoto è nel formato seguente:

<Transport>://<Server>:<Port>/<ApplicationName>

Ad esempio: http://server01:8080/WSMAN

Internet Information Services (IIS) che ospita la sessione, inoltra le richieste con questo endpoint all'applicazione specificata. Questa impostazione predefinita di WSMAN è appropriata per la maggior parte degli usi. Questo parametro è progettato per essere usato se molti computer stabiliscono connessioni remote a un computer che esegue Windows PowerShell. In questo caso, IIS ospita Web Services for Management (WS-Management) per migliorare l'efficienza.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Authentication

Specifica il meccanismo di autenticazione da utilizzare nel server. I valori validi per questo parametro sono:

  • Basic - Basic è uno schema in cui il nome utente e la password vengono inviati in testo non crittografato al server o al proxy.
  • Default - Usare il metodo di autenticazione implementato dal protocollo WS-Management. Si tratta dell'impostazione predefinita.
  • 1 - Digest è uno schema challenge-response che usa una stringa di dati specificata dal server per la richiesta di verifica.
  • Kerberos - Il computer client e il server si autenticano a vicenda usando i certificati Kerberos.
  • Negotiate - Negotiate è uno schema challenge-response che negozia con il server o il proxy per determinare lo schema da usare per l'autenticazione. Ad esempio, questo valore di parametro consente la negoziazione per determinare se viene usato il protocollo Kerberos o NTLM.
  • CredSSP - Usare l'autenticazione CredSSP (Credential Security Support Provider), che consente all'utente di delegare le credenziali. Questa opzione è progettata per i comandi eseguiti in un computer remoto, ma che raccolgono i dati o eseguono comandi aggiuntivi in altri computer remoti.

Attenzione

CredSSP delega le credenziali utente dal computer locale a un computer remoto. Questa pratica aumenta il rischio di sicurezza dell'operazione remota. Se il computer remoto viene compromesso, le credenziali che gli vengono passate possono essere usate per controllare la sessione di rete.

Importante

Se non si specifica il parametro Authentication , la Test-WSMan richiesta viene inviata al computer remoto in modo anonimo, senza usare l'autenticazione. Se la richiesta viene effettuata in modo anonimo, non restituisce informazioni specifiche della versione del sistema operativo. Questo cmdlet visualizza invece i valori Null per la versione del sistema operativo e il livello di Service Pack (OS: 0.0.0 SP: 0.0).

Tipo:AuthenticationMechanism
Alias:auth, am
Valori accettati:None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CertificateThumbprint

Specifica il certificato di chiave pubblica digitale (X509) di un account utente con autorizzazione per l'esecuzione di questa azione. Immettere l'identificazione personale del certificato.

I certificati vengono usati nell'autenticazione basata sui certificati client. Possono essere mappati solo ad account utente locali. Non funzionano con gli account di dominio.

Per ottenere un'identificazione personale del certificato, usare il comando Get-Item o Get-ChildItem nell'unità Certificato di Windows PowerShell: .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ComputerName

Specifica il computer in cui eseguire l'operazione di gestione. Il valore può essere un nome di dominio completo, un nome NetBIOS o un indirizzo IP. Usare il nome del computer locale, usare localhost o usare un punto (.) per specificare il computer locale. Il valore predefinito è il computer locale. Quando il computer remoto è in un dominio diverso dall'utente, è necessario usare un nome di dominio completo. È possibile inviare tramite pipe un valore per questo parametro al cmdlet.

Tipo:String
Alias:cn
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Credential

Specifica un account utente che dispone delle autorizzazioni per eseguire questa azione. Il valore predefinito è l'utente corrente. Digitare un nome utente, ad esempio User01, Domain01\User01 o User@Domain.com. In alternativa, immettere un oggetto PSCredential , ad esempio quello restituito dal Get-Credential cmdlet . Quando si digita un nome utente, questo cmdlet richiede una password.

Tipo:PSCredential
Alias:cred, c
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Port

Specifica la porta da usare quando il client stabilisce la connessione al servizio Gestione remota Windows. Quando il trasporto è HTTP, la porta predefinita è 80. Quando il trasporto è HTTPS, la porta predefinita è 443.

Quando si usa HTTPS come trasporto, il valore del parametro ComputerName deve corrispondere al nome comune del certificato del server.When you use HTTPS as the transport, the value of the ComputerName parameter must match the server's certificate common name (CN).

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UseSSL

Specifica che il protocollo SSL (Secure Sockets Layer) viene usato per stabilire una connessione al computer remoto. Per impostazione predefinita SSL non viene utilizzato.

WS-Management crittografa tutto il contenuto di Windows PowerShell trasmesso in rete. Il parametro UseSSL consente di specificare la protezione aggiuntiva di HTTPS anziché HTTP. Se SSL non è disponibile sulla porta usata per la connessione e si specifica questo parametro, il comando ha esito negativo.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

Per impostazione predefinita, il Test-WSMan cmdlet esegue una query sul servizio WinRM senza usare l'autenticazione e non restituisce informazioni specifiche per la versione del sistema operativo. Visualizza invece i valori Null per la versione del sistema operativo e il livello di Service Pack (SISTEMA OPERATIVO: 0.0.0 SP: 0.0).