New-WSManSessionOption

  • Riferimento
Modulo:
Microsoft.WSMan.Management

Crea la tabella hash delle opzioni di sessione da usare come parametri di input per i cmdlet WS-Management.

Sintassi

New-WSManSessionOption
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <ProxyAuthentication>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-SPNPort <Int32>]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [<CommonParameters>]

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

Il New-WSManSessionOption cmdlet crea una tabella hash dell'opzione sessione WSMan che può essere passata ai cmdlet WSMan:

  • Get-WSManInstance
  • Set-WSManInstance
  • Invoke-WSManAction
  • Connect-WSMan

Esempio

Esempio 1: Creare una connessione che usa le opzioni di connessione

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

In questo esempio viene creata una connessione al computer server01 remoto usando le opzioni di connessione definite da New-WSManSessionOption.

Il primo comando usa New-WSManSessionOption per archiviare un set di opzioni di impostazione di connessione nella $a variabile. In questo caso, le opzioni della sessione impostano un timeout di connessione di 30 secondi (30.000 millisecondi).

Il secondo comando usa il parametro SessionOption per passare le credenziali archiviate nella $a variabile a Connect-WSMan. Quindi, Connect-WSMan si connette al computer remoto server01 usando le opzioni di sessione specificate.

Connect-WSMan viene in genere usato nel contesto del provider WSMan per connettersi a un computer remoto, in questo caso il computer server01. Tuttavia, è possibile usare il cmdlet per stabilire connessioni ai computer remoti prima di passare al provider WSMan. Tali connessioni vengono visualizzate nell'elenco ComputerName .

Parametri

-NoEncryption

Indica che la connessione non usa la crittografia per le operazioni remote su HTTP.

Per impostazione predefinita, il traffico non crittografato non è abilitato. Deve essere abilitato nella configurazione locale.

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

-OperationTimeout

Specifica il timeout, espresso in millisecondi, per l'operazione WS-Management.

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

-ProxyAccessType

Specifica il meccanismo mediante il quale si trova il server proxy. I valori validi per questo parametro sono:

  • ProxyIEConfig - Usare la configurazione proxy di Internet Explorer per l'utente corrente.
  • ProxyWinHttpConfig - Il client WSMan usa le impostazioni proxy configurate per WinHTTP, usando l'utilità ProxyCfg.exe.
  • ProxyAutoDetect - Forzare il rilevamento automatico di un server proxy.
  • ProxyNoProxyServer - Non usare un server proxy. Risolvere tutti i nomi host in locale.

Il valore predefinito è ProxyIEConfig.

Tipo:ProxyAccessType
Valori accettati:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProxyAuthentication

Specifica il metodo di autenticazione da usare nel proxy. 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.
  • Digest - Digest è uno schema challenge-response che usa una stringa di dati specificata dal server per la richiesta di verifica.
  • Negotiate - Negotiate è uno schema challenge-response che negozia con il server o il proxy per determinare quale schema usare per l'autenticazione. Alcuni esempi sono il protocollo Kerberos e NTLM.

Il valore predefinito è Negotiate.

Tipo:ProxyAuthentication
Valori accettati:Negotiate, Basic, Digest
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProxyCredential

Specifica un account utente che dispone dell'autorizzazione per ottenere l'accesso tramite un proxy Web intermedio.

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

-SkipCACheck

Specifica che, quando si connette tramite HTTPS, il client non convalida che il certificato del server sia firmato da un'autorità di certificazione attendibile . Utilizzare questa opzione solo quando il computer remoto è considerato attendibile da un altro metodo, ad esempio se il computer remoto fa parte di una rete fisicamente sicura e isolata oppure il computer remoto è elencato come host attendibile nella configurazione WS-Management.

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

-SkipCNCheck

Specifica che il nome comune del certificato (CN) del server non deve corrispondere al nome host del server. Viene usato solo in operazioni remote tramite HTTPS. Questa opzione deve essere usata solo per i computer attendibili.

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

-SkipRevocationCheck

Indica che la connessione non convalida lo stato di revoca nel certificato del server.

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

-SPNPort

Specifica un numero di porta da aggiungere al nome dell'entità servizio di connessione (SPN) del server remoto. Un nome SPN viene usato quando il meccanismo di autenticazione è Kerberos o Negotiate.

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

-UseUTF16

Indica che la connessione codifica la richiesta in formato UTF16 anziché UTF8. Per impostazione predefinita verrà usata la codifica UTF8.

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

Output

SessionOption

Questo cmdlet restituisce l'opzione di sessione WSMan creata come oggetto SessionOption .