Stabilisce la connessione al servizio WinRM in un computer remoto.

Sintassi

Connect-WSMan [-ApplicationName <string>] [-ComputerName <string>] [-Port <int>] [-UseSSL] [-Authentication <Authentication>] [-ComputerName <string>] [-Credential <PSCredential>] [-Port <int>] [-SessionOption <hashtable>] [<CommonParameters>]

Connect-WSMan [-ConnectionURI <Uri>] [-Authentication <Authentication>] [-ComputerName <string>] [-Credential <PSCredential>] [-Port <int>] [-SessionOption <hashtable>] [<CommonParameters>]

Descrizione

Il cmdlet Connect-WSMan crea una connessione al servizio Gestione remota Windows in un computer remoto e stabilisce una connessione permanente al computer remoto. È possibile utilizzare questo cmdlet nel contesto del provider di WS-Management per stabilire la connessione al servizio Gestione remota Windows in un computer remoto. È inoltre possibile utilizzare questo cmdlet per stabilire la connessione al servizio Gestione remota Windows in un computer remoto prima di passare al provider di WS-Management. Il computer remoto verrà visualizzato nella directory radice del provider di WS-Management.

Per ulteriori informazioni su come effettuare la disconnessione dal servizio Gestione remota Windows in un computer remoto, vedere Disconnect-WSMan.

Parametri

-ApplicationName <string>

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

<trasporto>://<server>:<porta>/<NomeApplicazione>

Ad esempio:

http://server01:8080/WSMAN

Tramite Internet Information Services (IIS), che ospita la sessione, le richieste con questo endpoint vengono inoltrate all'applicazione specificata. L'impostazione predefinita "WSMAN" è appropriata per la maggior parte degli utilizzi. Questo parametro è progettato per essere utilizzato quando più computer stabiliscono connessioni remote a un computer in cui è in esecuzione Windows PowerShell. In questo caso, IIS ospita Gestione remota Windows (WS-Management) per motivi di efficienza.

Obbligatorio?

false

Posizione?

named

Valore predefinito

wsman

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Authentication <Authentication>

Specifica il meccanismo di autenticazione da utilizzare nel server. I valori possibili sono:

- Basic: Basic è uno schema in cui il nome utente e la password vengono inviati come testo non crittografato al server o al proxy.

- Default: utilizzare il metodo di autenticazione implementato dal protocollo WS-Management. Si tratta dell'impostazione predefinita.

- Digest: Digest è uno schema basato su una richiesta di verifica e relativa risposta che utilizza una stringa di dati specificata dal server per la richiesta di verifica.

- Kerberos: il server e il computer client si autenticano reciprocamente utilizzando certificati Kerberos.

- Negotiate: Negotiate è uno schema basato su una richiesta di verifica e relativa risposta che negozia con il server o il proxy per determinare lo schema da utilizzare per l'autenticazione. Ad esempio, questo valore di parametro consente la negoziazione per determinare se viene utilizzato il protocollo Kerberos o NTLM.

- CredSSP: utilizzare l'autenticazione CredSSP (Credential Security Service Provider) che consente all'utente di delegare le credenziali. Questa opzione è destinata ai comandi che vengono eseguiti in un computer remoto, ma raccolgono dati o eseguono ulteriori comandi in altri computer remoti.

Attenzione: CredSSP (Credential Security Service Provider) delega le credenziali dell'utente dal computer locale a un computer remoto. Questa procedura aumenta il rischio per la sicurezza dell'operazione remota. Se il computer remoto è compromesso, quando le credenziali vengono passate a tale computer è possibile utilizzarle per controllare la sessione di rete.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Default

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-ComputerName <string>

Specifica il computer in cui si desidera eseguire l'operazione di gestione. Il valore può essere un nome di dominio completo, un nome NetBIOS o un indirizzo IP. Utilizzare il nome del computer locale, localhost o un punto (.) per specificare il computer locale. Il valore predefinito è il computer locale. Quando il computer remoto si trova in un dominio diverso da quello dell'utente, è necessario utilizzare un nome di dominio completo. È possibile reindirizzare un valore per questo parametro al cmdlet.

Obbligatorio?

false

Posizione?

named

Valore predefinito

localhost

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-ConnectionURI <Uri>

Specifica l'endpoint di connessione. Il formato di questa stringa è:

<Trasporto>://<Server>:<Porta>/<NomeApplicazione>.

La seguente stringa rappresenta un valore formattato correttamente per questo parametro:

http://Server01:8080/WSMAN. L'URI deve essere completo.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Credential <PSCredential>

Specifica un account utente con autorizzazione per l'esecuzione di 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 cmdlet Get-Credential. Quando si digita un nome utente, viene richiesta una password.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-OptionSet <hashtable>

Passa un set di opzioni a un servizio per modificare o perfezionare la natura della richiesta. Si tratta di opzioni simili a quelle utilizzate nelle shell della riga di comando in quanto specifiche del servizio. È possibile specificare qualsiasi numero di opzioni.

Nell'esempio seguente viene illustrata la sintassi che passa i valori 1, 2 e 3 per i parametri a, b e c:

-OptionSet @{a=1;b=2;c=3}

Obbligatorio?

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Port <int>

Specifica la porta da utilizzare per la connessione del client al servizio Gestione remota Windows. Quando il trasporto è HTTP, la porta predefinita è 80. Quando il trasporto è HTTPS, la porta predefinita è 443. Quando si utilizza HTTPS come trasporto, il valore del parametro ComputerName deve corrispondere al nome comune del certificato del server. Tuttavia, se il parametro SkipCNCheck viene specificato come parte del parametro SessionOption, il nome comune del certificato del server non deve corrispondere al nome host del server. Il parametro SkipCNCheck deve essere utilizzato solo per computer attendibili.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-SessionOption <hashtable>

Definisce un set di opzioni estese per la sessione WS-Management. Immettere un oggetto SessionOption creato utilizzando il cmdlet New-WSManSessionOption. Per ulteriori informazioni sulle opzioni disponibili, vedere New-WSManSessionOption.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-UseSSL

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

In WS-Management viene crittografato tutto il contenuto di Windows PowerShell trasmesso in rete. Il parametro UseSSL consente di specificare la protezione aggiuntiva derivante dall'utilizzo di HTTPS anziché HTTP. Se si specifica questo parametro ma SSL non è disponibile sulla porta utilizzata per la connessione, il comando ha esito negativo.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

Nessuno

Questo cmdlet non accetta alcun input.

Output

Nessuno

Questo cmdlet non genera alcun output.

Note

È possibile eseguire comandi di gestione o query sui dati di gestione in un computer remoto senza creare una sessione WS-Management. A tale scopo, è possibile utilizzare i parametri ComputerName di Invoke-WSManAction e Get-WSManInstance. Quando si utilizza il parametro ComputerName, in Windows PowerShell viene creata una connessione temporanea utilizzata per il singolo comando. Una volta eseguito il comando, la connessione viene chiusa.

Esempio 1

C:\PS>Connect-WSMan -computer server01

PS C:\Users\testuser> cd wsman:
PS WSMan:\> 
PS WSMan:\> dir


   WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Descrizione
-----------
Questo comando crea una connessione al computer remoto server01.

Il cmdlet Connect-WSMan viene generalmente utilizzato nel contesto del provider di WS-Management per stabilire la connessione a un computer remoto, in questo caso server01. È tuttavia possibile utilizzare il cmdlet per stabilire le connessioni ai computer remoti prima di passare al provider di WS-Management. Le connessioni verranno visualizzate nell'elenco ComputerName.






Esempio 2

C:\PS>$cred = Get-Credential Administrator
Connect-WSMan -computer server01 -credential $cred

PS C:\Users\testuser> cd wsman:
PS WSMan:\>
PS WSMan:\> dir


   WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Descrizione
-----------
Questo comando crea una connessione al sistema remoto server01 utilizzando le credenziali dell'account amministratore.

Il primo comando utilizza il cmdlet Get-Credential per ottenere le credenziali di amministratore e archiviarle nella variabile $cred. Il cmdlet Get-Credential richiede all'utente una password o un nome utente e una password. La richiesta viene visualizzata tramite una finestra di dialogo
o sulla riga di comando, a seconda delle impostazioni del Registro di sistema.

Il secondo comando utilizza il parametro Credential per passare a Connect-WSMan le credenziali archiviate in $cred Connect-WSMan quindi stabilisce la connessione al sistema remoto server01 utilizzando le credenziali di amministratore.

Il cmdlet Connect-WSMan viene generalmente utilizzato nel contesto del provider di WS-Management per stabilire la connessione a un computer remoto, in questo caso server01. È tuttavia possibile utilizzare il cmdlet per stabilire le connessioni ai computer remoti prima di passare al provider di WS-Management. Le connessioni verranno visualizzate nell'elenco ComputerName.






Esempio 3

C:\PS>Connect-WSMan -computer server01 -port 80

PS C:\Users\testuser> cd wsman:
PS WSMan:\> 
PS WSMan:\> dir


   WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Descrizione
-----------
Questo comando crea una connessione al computer remoto server01 sulla porta 80.

Il cmdlet Connect-WSMan viene generalmente utilizzato nel contesto del provider di WS-Management per stabilire la connessione a un computer remoto, in questo caso server01. È tuttavia possibile utilizzare il cmdlet per stabilire le connessioni ai computer remoti prima di passare al provider di WS-Management. Le connessioni verranno visualizzate nell'elenco ComputerName.






Esempio 4

C:\PS>$a = New-WSManSessionOption -operationtimeout 30000
Connect-WSMan -computer server01 -sessionoption $a

PS C:\Users\testuser> cd wsman:
PS WSMan:\> 
PS WSMan:\> dir


   WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Descrizione
-----------
Questo comando crea una connessione al computer remoto server01 utilizzando le opzioni di connessione definite nel comando New-WSManSessionOption.

Il primo comando utilizza il cmdlet New-WSManSessionOption per archiviare un set di opzioni di impostazione della connessione nella variabile $a. In questo caso, nelle opzioni di sessione viene impostato un timeout connessione di 30 secondi (30.000 millisecondi).

Il secondo comando utilizza il parametro SessionOption per passare a Connect-WSMan le credenziali archiviate nella variabile $a. Tramite Connect-WSMan viene quindi stabilita la connessione al computer remoto server01 mediante le opzioni di sessione specificate.

Il cmdlet Connect-WSMan viene generalmente utilizzato nel contesto del provider di WS-Management per stabilire la connessione a un computer remoto, in questo caso server01. È tuttavia possibile utilizzare il cmdlet per stabilire le connessioni ai computer remoti prima di passare al provider di WS-Management. Le connessioni verranno visualizzate nell'elenco ComputerName.






Vedere anche




Argomenti della Guida