Condividi tramite

New-CimSessionOption

  • Riferimento
Modulo:
CimCmdlets

Specifica le opzioni avanzate per il cmdlet New-CimSession.

Sintassi

New-CimSessionOption
   [-Protocol] <ProtocolType>
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]
New-CimSessionOption
   [-NoEncryption]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-EncodePortInServicePrincipalName]
   [-Encoding <PacketEncoding>]
   [-HttpPrefix <Uri>]
   [-MaxEnvelopeSizeKB <UInt32>]
   [-ProxyAuthentication <PasswordAuthenticationMechanism>]
   [-ProxyCertificateThumbprint <String>]
   [-ProxyCredential <PSCredential>]
   [-ProxyType <ProxyType>]
   [-UseSsl]
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]
New-CimSessionOption
   [-Impersonation <ImpersonationType>]
   [-PacketIntegrity]
   [-PacketPrivacy]
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]

Descrizione

Il cmdlet New-CimSessionOption crea un'istanza di un'opzione di sessione CIM. Si usa un oggetto opzioni di sessione CIM come input per il cmdlet New-CimSession per specificare le opzioni per una sessione CIM.

Questo cmdlet include due set di parametri, uno per le opzioni WsMan e uno per le opzioni DCOM (Distributed Component Object Model). A seconda dei parametri usati, il cmdlet restituisce un'istanza delle opzioni di sessione DCOM o restituisce le opzioni di sessione WsMan.

Esempio

Esempio 1: Creare un oggetto opzioni di sessione CIM per DCOM

Questo esempio crea un oggetto opzioni di sessione CIM per il protocollo DCOM e lo archivia in una variabile denominata $so. Il contenuto della variabile viene quindi passato al cmdlet New-CimSession. New-CimSession quindi crea una nuova sessione CIM con il server remoto denominato Server01, usando le opzioni definite nella variabile.

$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so

Esempio 2: Creare un oggetto opzioni di sessione CIM per WsMan

In questo esempio viene creato un oggetto opzioni di sessione CIM per il protocollo WsMan. L'oggetto contiene la configurazione per la modalità di autenticazione di Kerberos specificata dal parametro ProxyAuthentication , le credenziali specificate dal parametro ProxyCredential e specifica che il comando deve ignorare il controllo CA, ignorare il controllo CN e usare SSL.

$option = @{
    ProxyAuthentication = 'Kerberos'
    ProxyCredential = $cred
    SkipCACheck = $true
    SkipCNCheck = $true
    UseSsl = $true
}
New-CimSessionOption @option

Esempio 3: Creare un oggetto opzioni di sessione CIM con la cultura specificata

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

In questo esempio viene specificata la cultura utilizzata per la sessione CIM. Per impostazione predefinita, la cultura del client viene usata nelle operazioni. È tuttavia possibile eseguire l'override delle impostazioni cultura predefinite usando il parametro Cultura.

Parametri

-Culture

Specifica la cultura dell'interfaccia utente da utilizzare per la sessione CIM. Specificare il valore per questo parametro usando uno dei formati seguenti:

  • Il nome cultura nel formato <languagecode2>-<country/regioncode2>, ad esempio "EN-US".
  • Una variabile che contiene un oggetto CultureInfo.
  • Comando che ottiene un oggetto CultureInfo, ad esempio Get-Culture
Tipo:CultureInfo
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-EncodePortInServicePrincipalName

Indica che la connessione Kerberos si sta collegando a un servizio il cui nome principale (SPN) include il numero di porta del servizio. Questo tipo di connessione non è comune.

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

-Encoding

Specifica la codifica utilizzata per il protocollo WsMan. I valori accettabili per questo parametro sono: Default, Utf8o Utf16.

Tipo:PacketEncoding
Valori accettati:Default, Utf8, Utf16
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-HttpPrefix

Specifica la parte dell'URL HTTP dopo il nome del computer e il numero di porta. La modifica non è comune. Per impostazione predefinita, il valore di questo parametro è /wsman.

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

-Impersonation

Crea una sessione DCOM nella Strumentazione gestione Windows (WMI) utilizzando l'impersonificazione.

I valori validi per questo parametro sono:

  • Impostazione predefinita: DCOM può scegliere il livello di impersonificazione utilizzando il normale algoritmo di negoziazione di sicurezza.
  • Nessuno: il client è anonimo al server. Il processo server può rappresentare il client, ma il token di rappresentazione non contiene informazioni e non può essere usato.
  • Identificazione: consente agli oggetti di eseguire query sulle credenziali del chiamante.
  • Impersonare: consente agli oggetti di usare le credenziali del chiamante.
  • Delegato: consente agli oggetti di consentire ad altri oggetti di usare le credenziali del chiamante.

Se Rappresentazione non è specificato, il cmdlet New-CimSession utilizza il valore di Rappresentazione.

Tipo:ImpersonationType
Valori accettati:Default, None, Identify, Impersonate, Delegate
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaxEnvelopeSizeKB

Specifica il limite di dimensioni dei messaggi XML WsMan per entrambe le direzioni.

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

-NoEncryption

Specifica che la crittografia dei dati è disattivata.

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

-PacketIntegrity

Specifica che la sessione DCOM creata in WMI usa la funzionalità Com (Component Object Model) PacketIntegrity. Per impostazione predefinita, tutte le sessioni CIM create tramite DCOM hanno il parametro packetIntegrity impostato su True.

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

-PacketPrivacy

Crea una sessione DCOM a WMI utilizzando il COM PacketPrivacy. Per impostazione predefinita, tutte le sessioni CIM create con DCOM hanno il parametro PacketPrivacy impostato su true.

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

-Protocol

Specifica il protocollo da utilizzare. I valori accettabili per questo parametro sono: DCOM, Defaulto Wsman.

Tipo:ProtocolType
Valori accettati:Dcom, Default, Wsman
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ProxyAuthentication

Specifica il metodo di autenticazione da usare per la risoluzione del proxy. I valori accettabili per questo parametro sono: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomaino CredSsp.

Tipo:PasswordAuthenticationMechanism
Valori accettati:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ProxyCertificateThumbprint

Specifica il certificato di chiave pubblica digitale (x.509) di un account utente per l'autenticazione proxy. Immettere l'impronta digitale del certificato. I certificati vengono usati nell'autenticazione basata su certificati client. Possono essere mappati solo agli account utente locali e non funzionano con gli account di dominio.

Per ottenere un'impronta digitale del certificato, usare i cmdlet Get-Item o Get-ChildItem nell'unità Cert: di PowerShell.

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

-ProxyCredential

Specifica le credenziali da usare per l'autenticazione proxy. Immettere uno dei seguenti elementi:

  • Variabile che contiene un oggetto PSCredential.
  • Comando che ottiene un oggetto PSCredential, ad esempio Get-Credential

Se questa opzione non è impostata, non è possibile specificare credenziali.

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

-ProxyType

Specifica il meccanismo di risoluzione dei nomi host da usare. I valori accettabili per questo parametro sono: None, WinHttp, Autoo InternetExplorer.

Il valore predefinito di questo parametro è InternetExplorer.

Tipo:ProxyType
Valori accettati:None, WinHttp, Auto, InternetExplorer
Posizione:Named
Valore predefinito:InternetExplorer
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SkipCACheck

Indica che quando ci si connette tramite HTTPS, il client non convalida che il certificato del server sia firmato da un'autorità di certificazione (CA) attendibile.

Usare questo parametro solo quando il computer remoto è considerato attendibile usando un altro meccanismo, ad esempio quando il computer remoto fa parte di una rete fisicamente sicura e isolata oppure quando il computer remoto è elencato come host attendibile in una configurazione WinRM.

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

-SkipCNCheck

Indica che il nome comune del certificato (CN) del server non deve corrispondere al nome host del server. Usare questo parametro per le operazioni remote solo con computer attendibili che usano il protocollo HTTPS.

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

-SkipRevocationCheck

Indica che il controllo della revoca per i certificati server viene ignorato. Usare questo parametro solo per i computer attendibili.

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

-UICulture

Specifica la cultura dell'interfaccia utente da utilizzare per la sessione CIM. Specificare il valore per questo parametro usando uno dei formati seguenti:

  • Il nome cultura nel formato <languagecode2>-<country/regioncode2>, ad esempio "EN-US".
  • Variabile che contiene un oggetto CultureInfo.
  • Comando che ottiene un oggetto CultureInfo, ad esempio Get-Culture.
Tipo:CultureInfo
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-UseSsl

Indica che SSL deve essere usato per stabilire una connessione al computer remoto. Per impostazione predefinita, SSL non viene usato. WsMan crittografa tutto il contenuto trasmesso in rete, anche quando si usa HTTP.

Questo parametro consente di specificare la protezione aggiuntiva di HTTPS anziché HTTP. Se SSL non è disponibile sulla porta usata per la connessione e si specifica questo parametro, il comando ha esito negativo.

È consigliabile usare questo parametro solo quando non è specificato il parametro packetPrivacy .

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

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

CimSessionOptions

Questo cmdlet restituisce un oggetto che contiene informazioni sulle opzioni di sessione CIM.