New-CimSessionOption
指定 New-CimSession cmdlet 的高级选项。
语法
ProtocolTypeSet （默认值）
New-CimSessionOption
[-Protocol] <ProtocolType>
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>]
WSManParameterSet
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>]
DcomParameterSet
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 会话选项对象
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so
这组命令为 DCOM 协议创建 CIM 会话选项对象，并将其存储在名为$so的变量中。 然后，变量的内容将传递给 New-CimSession cmdlet。 然后，New-CimSession 使用变量中定义的选项，与名为 Server01 的远程服务器创建新的 CIM 会话。
示例 2：为 WsMan 创建 CIM 会话选项对象
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl
此命令为 WsMan 协议创建 CIM 会话选项对象。 该对象包含由 ProxyAuthentication 参数指定的 Kerberos 身份验证模式、ProxyCredential 参数指定的凭据的配置，并指定命令是跳过 CA 检查、跳过 CN 检查和使用 SSL。
示例 3：使用指定的文化设置创建 CIM 会话选项对象
New-CimSessionOption -Culture Fr-Fr -Protocol Wsman
此命令指定用于 CIM 会话的区域性。 默认情况下，执行操作时使用客户端的区域性。 但是，可以使用 Culture 参数重写默认区域性。
参数
-Culture
指定要用于 CIM 会话的用户界面文化。 使用以下格式之一指定此参数的值：
以 <languagecode2>-<country/regioncode2> 格式（如“EN-US”）输入区域性名称。
一个包含 CultureInfo 对象的变量。
一个获取 CultureInfo 对象的命令，例如 Get-Culture
参数属性
| 类型: | CultureInfo |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-EncodePortInServicePrincipalName
指示 Kerberos 连接正在连接到其服务主体名称 (SPN) 包含服务端口号的服务。 这种类型的连接并不常见。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Encoding
指定用于 WsMan 协议的编码。
此参数的可接受值为：Default、Utf8 或 Utf16。
参数属性
| 类型: | PacketEncoding |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-HttpPrefix
指定 HTTP URL 中计算机名称和端口号之后的部分。 更改此操作并不常见。
默认情况下，此参数的值为 /wsman。
参数属性
| 类型: | Uri |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Impersonation
使用模拟创建与 Windows Management Instrumentation (WMI) 的 DCOM 会话。
此参数的有效值为：
- 默认情况下，DCOM 可以通过其常规的安全协商算法来选择模拟级别。
- 无：客户端对服务器是匿名的。 服务器进程可以模拟客户端，但模拟令牌不包含任何信息，不能使用。
- 标识：允许对象查询调用方凭据。
- Impersonate： 允许对象使用调用方的凭据。
- 委托：允许对象将调用方的凭据提供给其他对象使用。
如果未指定模拟，则 New-CimSession cmdlet 使用值 3：模拟
参数属性
| 类型: | ImpersonationType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
DcomParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MaxEnvelopeSizeKB
为任一方向指定 WsMan XML 消息的大小限制。
参数属性
| 类型: | UInt32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-NoEncryption
指定关闭数据加密。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PacketIntegrity
指定为 WMI 创建的 DCOM 会话使用组件对象模型 （COM） PacketIntegrity 功能。 为了增强安全性，默认情况下，使用 DCOM 创建的所有 CIM 会话将 PacketIntegrity 参数设置为 True。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
DcomParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PacketPrivacy
使用 COM PacketPrivacy 创建与 WMI 的 DCOM 会话。 为了增强安全性，默认情况下，使用 DCOM 创建的所有 CIM 会话将 PacketPrivacy 参数设置为 true。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
DcomParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Protocol
指定要使用的协议。
此参数的可接受值为：DCOM 或 WinRM。
参数属性
| 类型: | ProtocolType |
| 默认值: | None |
| 接受的值: | Dcom, Default, Wsman |
| 支持通配符: | False |
| 不显示: | False |
参数集
ProtocolTypeSet
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-ProxyAuthentication
指定要用于代理解析的身份验证方法。
此参数的可接受值为：Default、Digest、Negotiate、Basic、Kerberos、NtlmDomain 或 CredSsp。
参数属性
| 类型: | PasswordAuthenticationMechanism |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-ProxyCertificateThumbprint
指定用于代理身份验证的用户帐户的 (x.509) 数字公钥证书。 输入证书的证书指纹。
证书用于基于客户端证书的身份验证。 它们只能映射到本地用户帐户，它们不适用于域帐户。
若要获取证书指纹，请使用 PowerShell 证书：驱动器中的 Get-Item 或 Get-ChildItem cmdlet。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-ProxyCredential
指定要用于代理身份验证的凭据。 输入下列项之一：
- 一个包含 PSCredential 对象的变量。
- 获取 PSCredential 对象的命令，例如 Get-Credential
如果未设置此选项，则不能指定任何凭据。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ProxyType
指定要使用的主机名解析机制。
此参数的可接受值为：None、WinHttp、Auto 或 InternetExplorer。
默认情况下，此参数的值为 InternetExplorer。
参数属性
| 类型: | ProxyType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-SkipCACheck
指示通过 HTTPS 进行连接时，客户端不会验证服务器证书是否由受信任的证书颁发机构（CA）签名。
仅当远程计算机通过其他机制被信任时才使用此参数，例如，远程计算机是处于物理安全隔离的网络中的一部分，或者远程计算机在 WinRM 配置中被列为受信任主机。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-SkipCNCheck
指示服务器的证书公用名（CN）不需要与服务器的主机名匹配。
仅对使用 HTTPS 协议的远程操作使用此参数。
注意：仅对受信任的计算机使用此参数。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-SkipRevocationCheck
指示跳过对服务器证书的吊销检查。
注意：仅对受信任的计算机使用此参数。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-UICulture
指定要用于 CIM 会话的用户界面文化。 使用以下格式之一指定此参数的值：
- 以
<languagecode2>-<country/regioncode2>格式（如“EN-US”）输入区域性名称。 - 一个包含 CultureInfo 对象的变量。
- 一个获取 CultureInfo 对象的命令，如
Get-Culture。
参数属性
| 类型: | CultureInfo |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-UseSsl
指示应使用 SSL 建立与远程计算机的连接。 默认情况下，不使用 SSL。
WsMan 加密通过网络传输的所有内容。 此参数允许你指定对 HTTPS 的附加保护，而不是 HTTP。 如果 SSL 在用于连接的端口上不可用，并且你指定此参数，则该命令将失败。
建议仅在未指定 PacketPrivacy 参数时使用此参数。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
WSManParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
None
此 cmdlet 不接受任何输入对象。
输出
CIMSessionOption
此 cmdlet 返回包含 CIM 会话选项信息的对象。