New-CimSessionOption

指定 New-CimSession cmdlet 的高级选项。

语法

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>]

说明

New-CimSessionOption cmdlet 创建 CIM 会话选项对象的实例。 使用 CIM 会话选项对象作为 New-CimSession cmdlet 的输入来指定 CIM 会话的选项。

此 cmdlet 有两个参数集,一个用于 WsMan 选项,一个用于分布式组件对象模型 (DCOM) 选项。 cmdlet 会返回 DCOM 会话选项的实例或返回 WsMan 会话选项,具体取决于你使用的参数。

示例

示例 1:为 DCOM 创建 CIM 会话选项对象

此示例为 DCOM 协议创建 CIM 会话选项对象,并将其存储在名为 $so 的变量中。 然后,变量的内容将传递给 New-CimSession cmdlet。 然后,New-CimSession 使用变量中定义的选项,通过名为 Server01 的远程服务器创建新的 CIM 会话。

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

示例 2:为 WsMan 创建 CIM 会话选项对象

此示例为 WsMan 协议创建 CIM 会话选项对象。 该对象包含由 ProxyAuthentication 参数指定的 Kerberos 身份验证模式的配置、ProxyCredential 参数指定的凭据,并指定命令跳过 CA 检查、跳过 CN 检查和使用 SSL。

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

示例 3:使用指定的区域性创建 CIM 会话选项对象

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

此示例指定用于 CIM 会话的区域性。 默认情况下,执行操作时使用客户端的区域性。 但是,可以使用 Culture 参数替代默认区域性。

参数

-Culture

指定要用于 CIM 会话的用户界面区域性。 使用以下格式之一指定此参数的值:

  • 一个采用 <languagecode2>-<country/regioncode2> 格式的区域性名称,例如“EN-US”。
  • 一个包含 CultureInfo 对象的变量。
  • 一个获取 CultureInfo 对象的命令,例如 Get-Culture
类型:CultureInfo
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-EncodePortInServicePrincipalName

指示 Kerberos 连接正在连接到其服务主体名称 (SPN) 包含服务端口号的服务。 这种类型的连接并不常见。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Encoding

指定用于 WsMan 协议的编码。 此参数的可接受值为:Default、Utf8 或 Utf16。

类型:PacketEncoding
接受的值:Default, Utf8, Utf16
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-HttpPrefix

指定计算机名称和端口号之后的 HTTP URL 部分。 更改此内容的情况并不常见。 默认情况下,此参数的值为 /wsman

类型:Uri
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Impersonation

使用模拟创建与 Windows Management Instrumentation (WMI) 的 DCOM 会话。

此参数的有效值为:

  • Default:DCOM 可以使用其正常的安全协商算法选择模拟级别。
  • None:客户端对服务器匿名。 服务器进程可以模拟客户端,但模拟令牌不包含任何信息,不能使用。
  • Identify: 允许对象查询调用方的凭据。
  • Impersonate: 允许对象使用调用方的凭据。
  • Delegate:使对象能够允许其他对象使用调用方的凭据。

如果未指定 Impersonation,则 New-CimSession cmdlet 将使用 Impersonate 的值。

类型:ImpersonationType
接受的值:Default, None, Identify, Impersonate, Delegate
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MaxEnvelopeSizeKB

为任一方向指定 WsMan XML 消息的大小限制。

类型:UInt32
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-NoEncryption

指定关闭数据加密。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PacketIntegrity

指定创建的与 WMI 的 DCOM 会话使用组件对象模型 (COM) PacketIntegrity 功能。 默认情况下,使用 DCOM 创建的所有 CIM 会话都将 PacketIntegrity 参数设置为 True。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PacketPrivacy

使用 COM PacketPrivacy 创建与 WMI 的 DCOM 会话。 默认情况下,使用 DCOM 创建的所有 CIM 会话都将 PacketPrivacy 参数设置为 true。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Protocol

指定要使用的协议。 此参数的可接受值为:DCOM、Default 或 Wsman。

类型:ProtocolType
接受的值:Dcom, Default, Wsman
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ProxyAuthentication

指定要用于代理解析的身份验证方法。 此参数的可接受值为:Default、Digest、Negotiate、Basic、Kerberos、NtlmDomain 或 CredSsp。

类型:PasswordAuthenticationMechanism
接受的值:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ProxyCertificateThumbprint

指定用户帐户用于代理身份验证的 (x.509) 数字公钥证书。 输入证书的证书指纹。 在基于客户端证书的身份验证中使用证书。 它们只能映射到本地用户帐户,不适用于域帐户。

若要获取证书指纹,请使用 PowerShell Cert: 驱动器中的 Get-ItemGet-ChildItem cmdlet。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ProxyCredential

指定用于代理身份验证的凭据。 输入下列项之一:

  • 一个包含 PSCredential 对象的变量。
  • 一个获取 PSCredential 对象的命令,例如 Get-Credential

如果未设置此选项,则不能指定任何凭据。

类型:PSCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ProxyType

指定要使用的主机名称解析机制。 此参数的可接受值为:None、WinHttp、Auto 或 InternetExplorer。

此参数的默认值为 InternetExplorer

类型:ProxyType
接受的值:None, WinHttp, Auto, InternetExplorer
Position:Named
默认值:InternetExplorer
必需:False
接受管道输入:True
接受通配符:False

-SkipCACheck

指示当通过 HTTPS 进行连接时,客户端不会验证服务器证书是否由受信任的证书颁发机构 (CA) 签名。

只有在远程计算机通过其他机制获得信任(例如远程计算机所属的网络在物理上是安全的并已进行隔离,或者远程计算机在 WinRM 配置中列为受信任主机)时,才使用此参数。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-SkipCNCheck

指示服务器的证书公用名称 (CN) 无需与服务器的主机名相匹配。 仅对使用 HTTPS 协议的受信任计算机使用此参数进行远程操作。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-SkipRevocationCheck

指示跳过对服务器证书的吊销检查。 仅对受信任的计算机使用此参数。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-UICulture

指定要用于 CIM 会话的用户界面区域性。 使用以下格式之一指定此参数的值:

  • 一个采用 <languagecode2>-<country/regioncode2> 格式的区域性名称,例如“EN-US”。
  • 一个包含 CultureInfo 对象的变量。
  • 一个获取 CultureInfo 对象的命令,如 Get-Culture
类型:CultureInfo
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-UseSsl

指示应使用 SSL 建立与远程计算机的连接。 默认情况下,不使用 SSL。 WsMan 会加密通过网络传输的所有内容,即使在使用 HTTP 的情况下。

利用此参数,你可以指定 HTTPS(而非 HTTP)的额外保护措施。 如果 SSL 在用于连接的端口上不可用,并且你指定了此参数,则命令会失败。

建议仅在未指定 PacketPrivacy 参数时使用此参数。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输入

None

不能通过管道将对象传递给此 cmdlet。

输出

CimSessionOptions

此 cmdlet 返回包含 CIM 会话选项信息的对象。