PowerShell Logo Small


This is the built-in help made by Microsoft for the command 'New-CimSessionOption', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.


Specifies advanced options for the New-CimSession cmdlet.


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

Search powershellhelp.space


The New-CimSessionOption cmdlet creates an instance of a CIM session options object. You use a CIM session options object as input to the New-CimSession cmdlet to specify
the options for a CIM session.

This cmdlet has two parameter sets, one for WsMan options and one for Distributed Component Object Model (DCOM) options. Depending on which parameters you use, the cmdlet
returns either an instance of DCOM session options or returns WsMan session options.







Example 1: Create a CIM session options object for DCOM

PS C:\>$so = New-CimSessionOption -Protocol DCOM

PS C:\>New-CimSession -ComputerName Server01 -SessionOption $so

This set of commands creates a CIM session options object for the DCOM protocol and stores it in a variable named $so. The contents of the variable are then passed to the
New-CimSession cmdlet. New-CimSession then creates a new CIM session with the remote server named Server01, using the options defined in the variable.

Example 2: Create a CIM session options object for WsMan

PS C:\>New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl

This command creates a CIM session options object for the WsMan protocol. The object contains configuration for the authentication mode of Kerberos specified by the
ProxyAuthentication parameter, the credentials specified by the ProxyCredential parameter, and specifies that the command is to skip the CA check, skip the CN check, and use

Example 3: Create a CIM session options object with the culture specified

PS C:\>New-CimSessionOption -Culture Fr-Fr –Protocol Wsman

This command specifies the culture that is used for the CIM session. By default, the culture of the client is used when performing operations. However, the default culture
can be overridden using the Culture parameter.