Nuovo-PSSession

Crea una connessione persistente a un computer locale o remoto.

Attenzione

L’autenticazione CredSSP (Credential Security Support Provider), in cui le credenziali dell’utente vengono passate a un computer remoto per essere autenticate, è progettata per i comandi che richiedono l’autenticazione su più di una risorsa, ad esempio l’accesso a una condivisione di rete remota. Questo meccanismoaumenta il rischio per la sicurezza dell’operazione remota. Se il computer remoto è compromesso, i potenziali che vengono passati ad esso possono essere utilizzati per controllare la sessione di rete.,div>

Type: AuthenticationMechanism Accepted values: Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False

-CertificateThumbprint

Specifies the digital public key certificate (X509) of a user account that has permission to performthis action., Immettere l’impronta 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 certificato, utilizzare il comando Get-Item o Get-ChildItem nell’unità PowerShell Cert:.,

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Specifies an array of names of computers. This cmdlet creates a persistent connection(PSSession) to the specified computer., Se si immettono più nomi di computer,New-PSSessioncrea più oggetti PSSession, uno 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 si trova in un dominio diverso da quello dell’utente, è richiesto il nome di dominio completo. Puoi anche inserire il nome di un computer, tra virgolette, in New-PSSession.,

Per utilizzare un indirizzo IP nel valore del parametro ComputerName, il comando deve includere il parametro Credential. Inoltre, il computer deve essere configurato per il trasporto HTTPS o l’indirizzo IP del computer remoto deve essere incluso nell’elenco TrustedHosts di WinRM sul localcomputer. Per istruzioni sull’aggiunta di un nome di computer all’elenco TrustedHosts, vedere “Come aggiungere un computer all’elenco degli host attendibili” inabout_Remote_Troubleshooting.

Per includere il computer locale nel valore del parametro ComputerName, avviare WindowsPowerShell utilizzando l’opzione Esegui come amministratore.,

Type:	String
Aliases:	Cn
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ConfigurationName

Specifies the session configuration that is used for the new PSSession.

Enter a configuration name or the fully qualified resource URI for a session configuration., Se si specifica solo il nome della configurazione, viene anteposto il seguente URI dello schema:

The session configuration for a session is located on the remote computer. If the specified sessionconfiguration does not exist on the remote computer, the command fails.

The default value is the value of the $PSSessionConfigurationName variabile di preferenza sul localcomputer. Se questa variabile di preferenza non è impostata, il valore predefinito è Microsoft.PowerShell. Per ulteriori informazioni, vedere about_Preference_Variables.,

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ConnectionUri

Specifies a URI that defines the connection endpoint for the session. The URI must be fullyqualified., Il formato di questa stringa è il seguente:

<Transport>://<ComputerName>:<Port>/<ApplicationName>

Il valore predefinito è il seguente:

If you do not specify a ConnectionURI, you can use the UseSSL, ComputerName, Port, andApplicationName parameters to specify the ConnectionURI values.

Valid values for the Transport segment of the URI are HTTP and HTTPS. If you specify a connectionURI with a Transport segment, but do not specify a port, the session is created with standardsports: 80 for HTTP and 443 for HTTPS. To use the default ports for PowerShell remoting, specify port5985 for HTTP or 5986 for HTTPS.

If the destination computer redirects the connection to a different URI, PowerShell prevents theredirection unless you use the AllowRedirection parameter in the command.

Type:	Uri
Aliases:	URI, CU
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ContainerId

Specifies an array of IDs of containers. This cmdlet starts an interactive session with each of thespecified containers. Use the docker ps comando per ottenere un elenco di ID contenitore. Per ulteriori informazioni, consultare la guida per il comando ps di docker.,

Tipo:	String
Posizione:	Nome
valore Predefinito:	Nessuno
Accettare l’input della pipeline:	True
Accetta i caratteri jolly:	False

-Credential

consente di Specificare un account utente che dispone dell’autorizzazione per eseguire questa azione. Il valore predefinito è l’utente corrente.

Digitare un nome utente, ad esempio User01 o Domain01\User01, oppure immettere un oggetto PSCredential generato dal cmdletGet-Credential., Se si digita un nome utente, viene richiesto di inserire ilpassword.

Le credenziali vengono memorizzate in un oggetto PSCredentialobject e la password viene memorizzata come SecureString.

Tipo:	Credenzialeps
Posizione:	Nome
valore di Default:	utente Corrente
Accettare input:	True
Accetta i caratteri jolly:	False

-EnableNetworkAccess

Indica che questo cmdlet aggiunge interattiva token di sicurezza di loopback sessioni. interactivetoken consente di eseguire comandi nella sessione di loopback che ottengono dati da altri computer., Ad esempio,è possibile eseguire un comando nella sessione che copia i file XML da un computer remoto al localcomputer.

Una sessione di loopback è una PSSession che ha origine e termina sullo stesso computer. Per creare una sessione di aloopback, omettere il parametro ComputerName o impostarne il valore su dot (.), localhost, o ilnome del computer locale.

Per impostazione predefinita, questo cmdlet crea sessioni di loopback utilizzando un token di rete, che potrebbe non fornire un’autorizzazione sufficiente per l’autenticazione su computer remoti.

Il parametro EnableNetworkAccess è efficace solo nelle sessioni di loopback., Se si useEnableNetworkAccess quando si crea una sessione su un computer remoto, il comando ha esito positivo, mail parametro viene ignorato.

È inoltre possibile abilitare l’accesso remoto in una sessione di loopback utilizzando il valore CredSSP del parametro Authentication, che delega le credenziali di sessione ad altri computer.

Per proteggere il computer da accessi dannosi, le sessioni di loopback disconnesse con interactivetokens, ovvero quelle create utilizzando il parametro EnableNetworkAccess, possono essere ricollegatesolo dal computer in cui è stata creata la sessione., Le sessioni disconnesse che utilizzano CredSSPauthentication possono essere ricollegate da altri computer. Per ulteriori informazioni, vedereDisconnect-PSSession.

Questo parametro è stato introdotto in PowerShell 3.0.,

Tipo:	SwitchParameter
Posizione:	Nome
valore Predefinito:	Nessuno
Accettare l’input della pipeline:	False
Accetta i caratteri jolly:	False

-HostName

Specifica un array di nomi di computer per un Secure Shell (SSH) a base di connessione. Questo è simile al parametro ComputerName tranne che la connessione al computer remoto viene effettuata utilizzando SSHrather rispetto a Windows WinRM.,

This parameter was introduced in PowerShell 6.0.

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyFilePath

Specifies a key file path used by Secure Shell (SSH) to authenticate a user on a remote computer.,

SSH consente di eseguire l’autenticazione dell’utente tramite chiavi private / pubbliche in alternativa all’autenticazione basicpassword. Se il computer remoto è configurato per l’autenticazione della chiave, thisparameter può essere utilizzato per fornire la chiave che identifica l’utente.

Questo parametro è stato introdotto in PowerShell 6.0.,

Type:	String
Aliases:	IdentityFilePath
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Specifies a friendly name for the PSSession.

You can use the name to refer to the PSSession when you use other cmdlets, such asGet-PSSession and Enter-PSSession., Il nome non deve essere univoco per il computer o la sessione corrente.

Tipo:	String
Posizione:	Nome
valore Predefinito:	Nessuno
Accettare l’input della pipeline:	False
Accetta i caratteri jolly:	False

Porta

Specifica la porta di rete sul computer remoto che è utilizzato per la connessione., Per connettersi al computer aremote, il computer remoto deve essere in ascolto sulla porta utilizzata dalla connessione. Le porte predefinite sono 5985, che è la porta WinRM per HTTP, e 5986, che è la porta WinRM per HTTPS.

Prima di utilizzare un’altra porta, è necessario configurare il listener WinRM sul computer remoto per ascoltare quella porta. Utilizzare i seguenti comandi per configurare il listener:

1. winrm delete winrm/config/listener?Address=*+Transport=HTTP
2. winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}

Non utilizzare il parametro Port a meno che non sia necessario., L’impostazione della porta nel comando si applica a tutticomputer o sessioni su cui viene eseguito il comando. Un’impostazione di porta alternativa potrebbe impedire l’esecuzione del comando su tutti i computer.

Tipo:	Int32
Posizione:	Nome
valore Predefinito:	Nessuno
Accettare l’input della pipeline:	False
Accetta i caratteri jolly:	False

-RunAsAdministrator

Indica che il PSSession viene eseguito come amministratore.,

Tipo:	SwitchParameter
Posizione:	Nome
valore Predefinito:	Nessuno
Accettare l’input della pipeline:	False
Accetta i caratteri jolly:	False

-Sessione

Specifica una matrice di PSSession oggetti che questo cmdlet utilizza come modello per la newPSSession. Questo parametro crea nuovi oggetti PSSession che hanno le stesse proprietà degli oggetti PSSESSION specificati.,

Immettere una variabile che contiene gli oggetti PSSession o un comando che crea o ottiene gli oggetti psssession, ad esempio unNew-PSSession oGet-PSSession comando.

Gli oggetti PSSession risultanti hanno lo stesso valore computer name, Application name, Connection URI,port, configuration name, throttle limit e Secure Sockets Layer (SSL) degli originali, ma hanno un nome visualizzato, ID e ID istanza (GUID) diversi.,

Type:	PSSession
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SessionOption

Specifies advanced options for the session., Immettere un oggetto SessionOption, ad esempio uno che si crea utilizzando il cmdlet New-PSSessionOption o una tabella hash in cui le chiavi sono nomi di sessionoption e i valori sono valori di opzione di sessione.

I valori predefiniti per le opzioni sono determinati dal valore di $PSSessionOption preferenzavariabile, se è impostato. In caso contrario, i valori predefiniti vengono stabiliti dalle opzioni impostate nella sessioneconfigurazione.,

I valori delle opzioni di sessione hanno la precedenza sui valori predefiniti per le sessioni impostate nella variabile di preferenza$PSSessionOption e nella configurazione della sessione. Tuttavia, non prendono precedenti su valori massimi, quote o limiti impostati nella configurazione della sessione.

Per una descrizione delle opzioni di sessione che include i valori predefiniti, vedereNew-PSSessionOption. Per informazioni sulla variabile di preferenza $PSSessionOption, vedere about_preference_variables. Per ulteriori informazioni sulle configurazioni di sessione, vedere about_Session_Configurations.,

Type:	PSSessionOption
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHConnection

This parameter takes an array of hashtables where each hashtable contains one or more connectionparameters needed to establish a Secure Shell (SSH) connection (HostName, Port, UserName,KeyFilePath).,

I parametri di connessione hashtable sono gli stessi definiti per il set di parametri HostName.

Il parametro SSHConnection è utile per creare più sessioni in cui ogni sessione richiede diverse informazioni di connessione.

Questo parametro è stato introdotto in PowerShell 6.0.,

Type:	Hashtable
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHTransport

Indicates that the remote connection is established using Secure Shell (SSH).

By default PowerShell uses Windows WinRM to connect to a remote computer., Questa opzione impone a PowerShell di utilizzare il set di parametri HostName per stabilire una connessione remota basata su SSH.

Questo parametro è stato introdotto in PowerShell 6.0.,

Type:	SwitchParameter
Accepted values:	true
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Subsystem

Specifies the SSH subsystem used for the new PSSession.

This specifies the subsystem to use on the target as defined in sshd_config.,Il sottosistema avvia una versione specifica di PowerShell con parametri predefiniti.Se il sottosistema specificato non esiste nel computer remoto, il comando non riesce.

Se questo parametro non viene utilizzato, il valore predefinito è il sottosistema ‘powershell’.,

Tipo:	String
Posizione:	Nome
valore Predefinito:	powershell
Accettare l’input della pipeline:	True
Accetta i caratteri jolly:	False

-ThrottleLimit

Specifica il numero massimo di connessioni simultanee che possono essere stabilite 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 dell’acceleratore si applica solo al comando corrente, non alla sessione o al computer.

Tipo:	Int32
Posizione:	Nome
valore Predefinito:	Nessuno
Accettare l’input della pipeline:	False
Accetta i caratteri jolly:	False

nome utente

Specifica il nome utente per l’account utilizzato per creare una sessione sul computer remoto., Userauthentication metodo dipenderà da come Secure Shell (SSH) è configurato sul computer remoto.

Se SSH è configurato per l’autenticazione della password di base, verrà richiesto di utilizzare userpassword.

Se SSH è configurato per l’autenticazione utente basata su chiave, è possibile fornire un percorso del file chiave tramite il parametro Keyfilepath e non si verificherà alcun prompt della password. Si noti che se il file chiave utente client è localizzato in una posizione nota SSH, il parametro KeyFilePath non è necessario per l’autenticazione basata su chiave e l’autenticazione utente verrà eseguita automaticamente in base al nome utente., Per ulteriori informazioni, vedere SSHdocumentation sull’autenticazione utente basata su chiave.

Questo non è un parametro obbligatorio. Se non viene specificato alcun parametro UserName, viene utilizzato il nome utente di accesso corrente per la connessione.

Questo parametro è stato introdotto in PowerShell 6.0.,

Tipo:	String
Posizione:	Nome
valore Predefinito:	Nessuno
Accettare l’input della pipeline:	False
Accetta i caratteri jolly:	False

-UseSSL

Indica che questo cmdlet utilizza il protocollo SSL per stabilire una connessione remota computer.By di default, non viene utilizzato SSL.

WS-Management crittografa tutti i contenuti PowerShell trasmessi attraverso la rete., Il parametro USESSL offre una protezione aggiuntiva che invia i dati attraverso una connessione HTTPS anziché una connessione HTTP.

Se si utilizza questo parametro, ma SSL non è disponibile sulla porta utilizzata per il comando, il comando non riesce.,e

Accept wildcard characters: False

-UseWindowsPowerShell

{{ Fill UseWindowsPowerShell Description }}

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-VMId

Specifies an array of ID of virtual machines., Questo cmdlet avvia una sessione interattiva con ciascuna delle macchine virtuali specificate., To see the virtual machines that are available to you, use thefollowing command:

Get-VM | Select-Object -Property Name, ID

Type:	Guid
Aliases:	VMGuid
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

Specifies an array of names of virtual machines., Questo cmdlet avvia una sessione interattiva con ciascunodelle macchine virtuali specificate. Per visualizzare le macchine virtuali disponibili, utilizzare il cmdletGet-VM.

Tipo:	String
Posizione:	Nome
valore Predefinito:	Nessuno
Accettare l’input della pipeline:	True
Accetta i caratteri jolly:	False