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

说明

此 cmdlet 仅在 Windows 平台上可用。

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。

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

示例 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 协议的编码。 此参数的可接受值为:DefaultUtf8Utf16

类型: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 会话。

此参数的有效值为:

  • 默认值:DCOM 可以使用其正常的安全协商算法选择模拟级别。
  • 无:客户端对服务器是匿名的。 服务器进程可以模拟客户端,但模拟令牌不包含任何信息,不能使用。
  • 标识:允许对象查询调用方凭据。
  • 模拟:允许对象使用调用方凭据。
  • 委托:允许对象允许其他对象使用调用方凭据。

如果未指定 模拟New-CimSession cmdlet 将使用 模拟的值。

类型: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

指定要使用的协议。 此参数的可接受值为:DcomDefaultWsman

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

-ProxyAuthentication

指定要用于代理解析的身份验证方法。 此参数的可接受值为:DefaultDigestNegotiateBasicKerberosNtlmDomainCredSsp

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

-ProxyCertificateThumbprint

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

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

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

-ProxyCredential

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

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

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

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

-ProxyType

指定要使用的主机名解析机制。 此参数的可接受值为:NoneWinHttpAutoInternetExplorer

此参数的默认值 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 会话选项信息的对象。

备注

PowerShell 包含以下 New-CimSessionOption别名:

  • 窗户:
    • ncso

此 cmdlet 仅在 Windows 平台上可用。