New-CimSessionOption

参考

模块:: CimCmdlets

指定 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。

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-Item 或 Get-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 会话选项信息的对象。

备注

PowerShell 包含以下 New-CimSessionOption 别名：

Windows：
- ncso

此 cmdlet 仅在 Windows 平台上可用。

通过