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 oggetto opzioni sessione CIM. Si usa un oggetto opzioni 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 una 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: Create un oggetto opzioni sessione CIM per DCOM

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

Questo set di comandi crea un oggetto opzioni 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.

Esempio 2: Create un oggetto opzioni sessione CIM per WsMan

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

Questo comando crea un oggetto opzioni 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 consiste nell'ignorare il controllo CA, ignorare il controllo CN e usare SSL.

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

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

Questo comando specifica le impostazioni cultura usate 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:

Immettere un nome delle impostazioni cultura in <languagecode2>-<country/regioncode2> formato come "EN-US".

Variabile contenente 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 usata per il protocollo WsMan.

I valori accettabili per questo parametro sono: Default, Utf8 o Utf16.

Type:PacketEncoding
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 della sicurezza.
  • Nessuno: il client è anonimo al server. Il processo del server può rappresentare il client, ma il token di rappresentazione non contiene informazioni e non può essere usato.
  • Identificare: 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 cmdlet New-CimSession usa il valore 3: Rappresentazione

Type:ImpersonationType
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 la sicurezza avanzata, per impostazione predefinita tutte le sessioni CIM create usando 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 COM PacketPrivacy. Per la sicurezza avanzata, per impostazione predefinita tutte le sessioni CIM create usando 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 o WinRM.

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
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 contenente un oggetto PSCredential.
  • Comando che ottiene un oggetto PSCredential, ad esempio Get-Credential

Se questa opzione non è impostata, non è possibile specificare le 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.

Per impostazione predefinita, il valore di questo parametro è InternetExplorer.

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

-SkipCACheck

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

Usare questo parametro solo quando il computer remoto è attendibile usando un altro meccanismo, ad esempio quando il computer remoto fa parte di una rete fisicamente sicura e isolata o 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 solo per le operazioni remote che usano il protocollo HTTPS.

Nota: 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

-SkipRevocationCheck

Indica che il controllo di revoca per i certificati server viene ignorato.

Nota: 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:

  • Immettere un nome delle impostazioni cultura in <languagecode2>-<country/regioncode2> formato come "EN-US".
  • Variabile contenente 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 usato.

WsMan crittografa tutto il contenuto trasmesso sulla rete. 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

Questo cmdlet non accetta oggetti di input.

Output

CIMSessionOption

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