Share via

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

Questo cmdlet è disponibile solo nella piattaforma Windows.

Il New-CimSessionOption cmdlet crea un'istanza di un oggetto opzioni di sessione CIM. Si usa un oggetto opzioni di sessione CIM come input per il New-CimSession cmdlet 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 New-CimSession cmdlet . New-CimSession crea quindi 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.

New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl

Esempio 3: Creare un oggetto opzioni di sessione CIM con le impostazioni cultura specificate

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

In questo esempio vengono specificate le impostazioni cultura utilizzate per la sessione CIM. Per impostazione predefinita, le impostazioni cultura del client vengono usate durante l'esecuzione di operazioni. È tuttavia possibile eseguire l'override delle impostazioni cultura predefinite usando il parametro Culture .

Parametri

-Culture

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

  • Nome delle impostazioni cultura in <languagecode2>-<country/regioncode2> formato "EN-US".
  • Variabile che contiene un oggetto CultureInfo .
  • Comando che ottiene un oggetto CultureInfo , ad esempio Get-Culture
Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-EncodePortInServicePrincipalName

Indica che la connessione Kerberos si connette a un servizio il cui nome dell'entità servizio (SPN) include il numero di porta del servizio. Questo tipo di connessione non è comune.

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

-Encoding

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

Type:PacketEncoding
Accepted values:Default, Utf8, Utf16
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-Impersonation

Crea una sessione DCOM in Strumentazione gestione Windows (WMI) usando la rappresentazione.

I valori validi per questo parametro sono:

  • Impostazione predefinita: DCOM può scegliere il livello di rappresentazione usando 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.
  • Rappresentazione: 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 la rappresentazione non è specificata, il New-CimSession cmdlet usa il valore di Impersonate.

Type:ImpersonationType
Accepted values:Default, None, Identify, Impersonate, Delegate
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxEnvelopeSizeKB

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

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

-NoEncryption

Specifica che la crittografia dei dati è disattivata.

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

-PacketIntegrity

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

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

-PacketPrivacy

Crea una sessione DCOM in WMI usando Il pacchetto COMPrivacy. Per impostazione predefinita, tutte le sessioni CIM create con DCOM hanno il parametro PacketPrivacy impostato su true.

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

-Protocol

Specifica il protocollo da usare. I valori accettabili per questo parametro sono: DCOM, Default o Wsman.

Type:ProtocolType
Accepted values:Dcom, Default, Wsman
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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, NtlmDomain o CredSsp.

Type:PasswordAuthenticationMechanism
Accepted values:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCertificateThumbprint

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

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

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

-ProxyCredential

Specifica le credenziali da usare per l'autenticazione proxy. Eseguire una delle operazioni seguenti:

  • 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.

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

-ProxyType

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

Il valore predefinito di questo parametro è InternetExplorer.

Type:ProxyType
Accepted values:None, WinHttp, Auto, InternetExplorer
Position:Named
Default value:InternetExplorer
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-SkipRevocationCheck

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

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

-UICulture

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

  • Nome delle impostazioni cultura in <languagecode2>-<country/regioncode2> formato "EN-US".
  • Variabile che contiene un oggetto CultureInfo.
  • Comando che ottiene un oggetto CultureInfo, ad esempio Get-Culture.
Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UseSsl

Indica che SSL deve essere usato per stabilire una connessione al computer remoto. Per impostazione predefinita SSL non viene utilizzato. 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 il parametro PacketPrivacy non è specificato.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Note

PowerShell include gli alias seguenti per New-CimSessionOption:

  • Windows:
    • ncso

Questo cmdlet è disponibile solo nelle piattaforme Windows.