New-PSSession

Consente il reindirizzamento di questa connessione a un URI alternativo.

Quando si utilizza il parametro ConnectionURI, la destinazione remota può restituire un'istruzione di reindirizzamento a un altro URI. Per impostazione predefinita in Windows PowerShell le connessioni non vengono reindirizzate, ma è possibile utilizzare il parametro AllowRedirection per consentire il reindirizzamento della connessione.

È inoltre possibile limitare il numero di volte in cui la connessione viene reindirizzata impostando la proprietà MaximumConnectionRedirectionCount della variabile di preferenza $PSSessionOption o la proprietà MaximumConnectionRedirectionCount del valore del parametro SessionOption.

Il valore predefinito è 5. Per ulteriori informazioni, vedere la descrizione del parametro SessionOption e New-PSSessionOption.

Specifica il segmento del nome dell'applicazione dell'URI di connessione. Utilizzare questo parametro per specificare il nome dell'applicazione quando non si utilizza il parametro ConnectionURI nel comando.

Il valore predefinito è il valore della variabile di preferenza $PSSessionApplicationName nel computer locale. Se questa variabile non viene definita, il valore predefinito è WSMAN. Questo valore è appropriato per la maggior parte degli utilizzi. Per ulteriori informazioni, vedere about_Preference_Variables.

Il servizio Gestione remota Windows utilizza il nome dell’applicazione per selezionare un listener per la gestione della richiesta di connessione. Il valore di questo parametro deve corrispondere al valore della proprietà URLPrefix di un listener nel computer remoto.

Specifica il meccanismo utilizzato per autenticare le credenziali dell'utente. I valori validi sono "Default", "Basic", "Credssp", "Digest", "Kerberos", "Negotiate" e "NegotiateWithImplicitCredential". Il valore predefinito è "Default".

L'autenticazione CredSSP è disponibile unicamente in Windows Vista, Windows Server 2008 e versioni successive di Windows.

Per ulteriori informazioni sui valori di questo parametro, vedere la descrizione dell'enumerazione System.Management.Automation.Runspaces.AuthenticationMechanism in MSDN Library all'indirizzo https://go.microsoft.com/fwlink/?LinkId=144382 (le informazioni potrebbero essere in lingua inglese).

Attenzione: l'autenticazione CredSSP (Credential Security Service Provider), che prevede il passaggio delle credenziali dell'utente a un computer remoto per l'autenticazione, è progettata per i comandi che richiedono l'autenticazione su più di una risorsa, ad esempio l'accesso a una condivisione di rete remota. Questo meccanismo aumenta il rischio per la sicurezza dell'operazione remota. Se il computer remoto è compromesso, è possibile utilizzare le credenziali passate a tale computer per controllare la sessione di rete.

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

I certificati vengono utilizzati nell'autenticazione basata su certificati client. Possono essere mappati solo agli account utente locali; non funzionano con gli account di dominio.

Per ottenere un'identificazione digitale del certificato, utilizzare il comando Get-Item o Get-ChildItem nell'unità Cert: di Windows PowerShell.

Crea una connessione permanente (PSSession) al computer specificato. Se si immettono più nomi di computer, New-PSSession crea più sessioni PSSession, una per ogni computer. Il valore predefinito è il computer locale.

Digitare il nome NetBIOS, un indirizzo IP o un nome di dominio completo di uno o più computer remoti. Per specificare il computer locale, digitare il nome del computer, "localhost" o un punto (.). Quando il computer fa parte di un dominio diverso da quello dell'utente, è obbligatorio utilizzare il nome di dominio completo. È inoltre possibile reindirizzare un nome di computer (tra virgolette) a New-PSSession.

Per utilizzare un indirizzo IP nel valore del parametro ComputerName, il comando deve includere il parametro Credential. È inoltre necessario configurare il computer per il trasporto HTTPS o includere l'indirizzo IP del computer remoto nell'elenco di host attendibili (TrustedHosts) di Gestione remota Windows nel computer locale. Per istruzioni relative all'aggiunta di un nome di computer all'elenco degli host attendibili (TrustedHosts), vedere "Come aggiungere un computer all'elenco di host attendibili" in about_Remote_Troubleshooting.

Nota: in Windows Vista e nelle versioni successive di Windows per includere il computer locale nel valore del parametro ComputerName, è necessario avviare Windows PowerShell con l'opzione "Esegui come amministratore".

Specifica la configurazione di sessione utilizzata per la nuova sessione PSSession.

Immettere un nome di configurazione o l'URI di risorsa completo per una configurazione di sessione. Se si specifica unicamente il nome di configurazione, viene anteposto l'URI di schema seguente: https://schemas.microsoft.com/powershell.

La configurazione di sessione per una sessione si trova nel computer remoto. Se la configurazione di sessione specificata non esiste nel computer remoto, il comando ha esito negativo.

Il valore predefinito è il valore della variabile di preferenza $PSSessionConfigurationName nel computer locale. Se questa variabile di preferenza non è impostata, l'impostazione predefinita è Microsoft.PowerShell. Per ulteriori informazioni, vedere about_Preference_Variables.

Specifica un URI (Uniform Resource Identifier) che definisce l'endpoint della connessione. L'URI deve essere completo.

Il formato di questa stringa è il seguente:

<Trasporto>://<NomeComputer>:<Porta>/<NomeApplicazione>

Il valore predefinito è il seguente:

http://localhost:80/WSMAN

I valori validi per il segmento Transport dell'URI sono HTTP e HTTPS. Se non si specifica ConnectionURI, è possibile utilizzare i parametri UseSSL, ComputerName, Port e ApplicationName per specificare i valori URI.

Se il computer di destinazione reindirizza la connessione a un URI diverso, in Windows PowerShell viene impedito il reindirizzamento a meno che non si utilizzi il parametro AllowRedirection nel comando.

Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio "Utente01", "Dominio01\Utente01" o "Utente@Dominio.com", oppure immettere un oggetto PSCredential, ad esempio uno restituito dal cmdlet Get-Credential.

Quando si digita un nome utente, viene richiesta una password.

Specifica un nome descrittivo per la sessione PSSession.

È possibile utilizzare il nome per fare riferimento alla sessione PSSession in caso di utilizzo di altri cmdlet, ad esempio Get-PSSession e Enter-PSSession. Non è obbligatorio che il nome sia univoco nel computer o nella sessione corrente.

Specifica la porta di rete nel computer remoto utilizzata per questo comando. Il valore predefinito è la porta 80 (porta HTTP).

Prima di utilizzare una porta alternativa, è necessario configurare il listener WinRM nel computer remoto affinché resti in ascolto su tale porta. Utilizzare i comandi seguenti per configurare il listener:

1. winrm delete winrm/config/listener?Address=*+Transport=HTTP

2. winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port=&quot;&lt;numero-porta&gt;&quot;}

Non utilizzare il parametro Port a meno che non sia necessario. L'impostazione della porta nel comando si applica a tutti i computer e a tutte le sessioni in cui viene eseguito il comando. Un'impostazione di porta alternativa potrebbe impedire l'esecuzione del comando in tutti i computer.

Utilizza la sessione PSSession specificata come modello per la nuova sessione PSSession. Questo parametro consente di creare nuove sessioni PSSession con le stesse proprietà delle sessioni PSSession specificate.

Immettere una variabile che contiene le sessioni PSSession o un comando che consente di creare o ottenere tali sessioni, ad esempio New-PSSession o Get-PSSession.

Le sessioni PSSession risultanti hanno lo stesso nome di computer, nome di applicazione, URI di connessione, porta, nome di configurazione, limite di velocità, timeout e valore SSL di quelle originali, ma presentano un nome descrittivo, un ID e un ID istanza (GUID) diversi.

Imposta opzioni avanzate per la sessione. Immettere un oggetto SessionOption creato utilizzando il cmdlet New-PSSessionOption.

I valori predefiniti delle opzioni sono determinati dal valore della variabile di preferenza $PSSessionOption, se impostato. In caso contrario nella sessione vengono utilizzate le impostazioni predefinite del sistema.

Per una descrizione delle opzioni di sessione, inclusi i valori predefiniti, vedere New-PSSessionOption. Per informazioni sulla variabile di preferenza $PSSessionOption, vedere about_Preference_Variables.

Specifica il numero massimo di connessioni simultanee che è possibile stabilire per eseguire questo comando. Se si omette questo parametro o si immette un valore pari a 0 (zero), viene utilizzato il valore predefinito 32.

Il limite di velocità si applica solo al comando corrente, non alla sessione o al computer.

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

WS-Management consente di crittografare tutto il contenuto di Windows PowerShell trasmesso in rete. UseSSL consente di inviare i dati con una protezione aggiuntiva mediante una connessione HTTPS anziché HTTP.

Se si utilizza questo parametro, ma SSL non è disponibile sulla porta utilizzata per il comando, il comando ha esito negativo.

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