New-CimSession
Crea una sessione CIM.
Sintassi
CredentialParameterSet (impostazione predefinita).
New-CimSession
[[-Credential] <PSCredential>]
[[-ComputerName] <String[]>]
[-Authentication <PasswordAuthenticationMechanism>]
[-Name <String>]
[-OperationTimeoutSec <UInt32>]
[-SkipTestConnection]
[-Port <UInt32>]
[-SessionOption <CimSessionOptions>]
[<CommonParameters>]
CertificateParameterSet
New-CimSession
[[-ComputerName] <String[]>]
[-CertificateThumbprint <String>]
[-Name <String>]
[-OperationTimeoutSec <UInt32>]
[-SkipTestConnection]
[-Port <UInt32>]
[-SessionOption <CimSessionOptions>]
[<CommonParameters>]
Descrizione
Questo cmdlet è disponibile solo nella piattaforma Windows.
Il cmdlet New-CimSession crea una sessione CIM. Una sessione CIM è un oggetto lato client che rappresenta una connessione a un computer locale o a un computer remoto. La sessione CIM contiene informazioni sulla connessione, ad esempio ComputerName, il protocollo usato o vari identificatori.
Questo cmdlet restituisce un oggetto sessione CIM che può essere usato da tutti gli altri cmdlet CIM.
Esempio
Esempio 1: Creare una sessione CIM con le opzioni predefinite
In questo esempio viene creata una sessione CIM locale con le opzioni predefinite. Se ComputerName non è specificato, New-CimSession crea una sessione DCOM nel computer locale.
New-CimSession
Esempio 2: Creare una sessione CIM in un computer specifico
In questo esempio viene creata una sessione CIM nel computer specificato da NomeComputer.
Per impostazione predefinita, New-CimSession crea una sessione WSMan quando viene specificato ComputerName.
New-CimSession -ComputerName Server01
Esempio 3: Creare una sessione CIM in più computer
In questo esempio viene creata una sessione CIM in ognuno dei computer specificati da ComputerName, nell'elenco delimitato da virgole.
New-CimSession -ComputerName Server01, Server02, Server03
Esempio 4: Creare una sessione CIM con un nome descrittivo
In questo esempio viene creata una sessione CIM remota in ogni computer specificato da ComputerName, nell'elenco delimitato da virgole e viene assegnato un nome descrittivo alle nuove sessioni specificando Nome.
New-CimSession -ComputerName Server01, Server02 -Name FileServers
Get-CimSession -Name File*
È possibile usare il nome descrittivo di una sessione CIM per fare riferimento alla sessione in altri cmdlet CIM, ad esempio Get-CimSession.
Esempio 5: Creare una sessione CIM in un computer usando un oggetto PSCredential
In questo esempio viene creata una sessione CIM nel computer specificato da ComputerName, utilizzando l'oggetto PSCredential specificato da Credentiale il tipo di autenticazione specificato da Authentication.
New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate
È possibile creare un oggetto PSCredential usando il cmdlet Get-Credential.
Esempio 6: Creare una sessione CIM in un computer usando una porta specifica
In questo esempio viene creata una sessione CIM nel computer specificato da ComputerName utilizzando la porta TCP specificata da Port.
New-CimSession -ComputerName Server01 -Port 1234
Esempio 7: Creare una sessione CIM con DCOM
In questo esempio viene creata una sessione CIM usando il protocollo DCOM (Distributed COM) anziché WSMan.
$SessionOption = New-CimSessionOption -Protocol Dcom
New-CimSession -ComputerName Server1 -SessionOption $SessionOption
Parametri
-Authentication
Specifica il tipo di autenticazione usato per le credenziali dell'utente. I valori accettabili per questo parametro sono:
- Predefinito
- Sommario
- Negoziare
- Fondamentale
- Kerberos
- NtlmDomain
- CredSsp
Non è possibile utilizzare il tipo di autenticazione ntlmDomain per la connessione al computer locale. 'autenticazione CredSSP è disponibile solo in Windows Vista, Windows Server 2008 e versioni successive di Windows.
Attenzione
L'autenticazione credSSP (Credential Security Service Provider) è progettata per i comandi che richiedono l'autenticazione in più di una risorsa, ad esempio l'accesso a una condivisione di rete remota. Questo meccanismo aumenta il rischio di sicurezza dell'operazione remota. Se il computer remoto viene compromesso, è possibile usare le credenziali passate per controllare la sessione di rete.
Proprietà dei parametri
| Tipo: | PasswordAuthenticationMechanism |
| Valore predefinito: | None |
| Valori accettati: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
CredentialParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-CertificateThumbprint
Specifica il certificato di chiave pubblica digitale (X.509) di un account utente autorizzato a eseguire questa azione. Immettere l'impronta digitale del certificato.
I certificati vengono usati 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 personale del certificato, usare i cmdlet Get-Item o Get-ChildItem nel provider di certificati PowerShell.
Per altre informazioni, vedere about_Certificate_Provider.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
CertificateParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-ComputerName
Specifica il nome del computer in cui creare la sessione CIM. Specificare un singolo nome computer o più nomi di computer separati da una virgola.
Se ComputerName non viene specificato, viene creata una sessione CIM nel computer locale. È possibile specificare il valore per il nome del computer in uno dei formati seguenti:
- Uno o più nomi NetBIOS
- Uno o più indirizzi IP
- Uno o più nomi di dominio completi.
Se il computer si trova in un dominio diverso dall'utente, è necessario specificare il nome di dominio completo.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Cina, Nome del Server |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Credential
Specifica un account utente autorizzato a eseguire questa azione. Se non si specifica credenziali, viene usato l'account utente corrente.
Specificare il valore per credenziali usando uno dei formati seguenti:
- Nome utente: "User01"
- Un nome di dominio e un nome utente: "Domain01\User01"
- Nome dell'entità utente: "User@Domain.com"
- Oggetto PSCredential, ad esempio quello restituito dal cmdlet
Get-Credential.
Quando si digita un nome utente, viene richiesta una password.
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
CredentialParameterSet
| Posizione: | 2 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica un nome descrittivo per la sessione CIM.
È possibile usare il nome per fare riferimento alla sessione CIM quando si usano altri cmdlet, ad esempio cmdlet Get-CimSession. Il nome non deve essere univoco per il computer o la sessione corrente.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-OperationTimeoutSec
Durata per cui il cmdlet attende una risposta dal server.
Per impostazione predefinita, il valore di questo parametro è 0, il che significa che il cmdlet usa il valore di timeout predefinito per il server.
Se il parametro OperationTimeoutSec è impostato su un valore inferiore al timeout di tentativo di connessione affidabile di 3 minuti, gli errori di rete che durano più del valore del parametro OperationTimeoutSec non sono recuperabili, perché l'operazione sul server si verifica il timeout prima che il client possa riconnettersi.
Proprietà dei parametri
| Tipo: | UInt32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | OT |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Port
Specifica la porta di rete nel computer remoto utilizzato per questa connessione. Per connettersi a un computer remoto, il computer remoto deve essere in ascolto sulla porta usata dalla connessione. Le porte predefinite sono 5985 (porta WinRM per HTTP) e 5986 (porta WinRM per HTTPS).
Prima di usare una porta alternativa, è necessario configurare il listener WinRM nel computer remoto per l'ascolto su tale porta. Usare i comandi seguenti per configurare il listener:
winrm delete winrm/config/listener?Address=*+Transport=HTTP
winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}
Non usare il parametro porta a meno che non sia necessario. L'impostazione della porta nel comando si applica a tutti i computer o le sessioni in cui viene eseguito il comando. Un'impostazione di porta alternativa potrebbe impedire l'esecuzione del comando in tutti i computer.
Proprietà dei parametri
| Tipo: | UInt32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-SessionOption
Imposta le opzioni avanzate per la nuova sessione CIM. Immettere il nome di un oggetto CimSessionOption creato usando il cmdlet New-CimSessionOption.
Proprietà dei parametri
| Tipo: | CimSessionOptions |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-SkipTestConnection
Per impostazione predefinita, il cmdlet New-CimSession stabilisce una connessione con un endpoint WS-Management remoto per due motivi: per verificare che il server remoto sia in ascolto sul numero di porta specificato usando il parametro porta e per verificare le credenziali dell'account specificate. La verifica viene eseguita usando un'operazione di WS-Identity standard. È possibile aggiungere il parametro switch SkipTestConnection se l'endpoint WS-Management remoto non può usare WS-Identify o per ridurre il tempo di trasmissione dei dati.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
None
Gli oggetti non possono essere inviati tramite pipe a questo cmdlet.
Output
CimSession
Questo cmdlet restituisce un oggetto sessione CIM.
Note
PowerShell include gli alias seguenti per New-CimSession:
- Windows:
ncms
Questo cmdlet è disponibile solo nelle piattaforme Windows.
