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
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EncodePortInServicePrincipalName
指示 Kerberos 连接正在连接到其服务主体名称 (SPN) 包含服务端口号的服务。 这种类型的连接并不常见。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Encoding
指定用于 WsMan 协议的编码。 此参数的可接受值为：Default、Utf8 或 Utf16。
| Type: | PacketEncoding |
| Accepted values: | Default, Utf8, Utf16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HttpPrefix
指定计算机名称和端口号之后的 HTTP URL 部分。 更改此内容的情况并不常见。 默认情况下，此参数的值为 /wsman。
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Impersonation
使用模拟创建与 Windows Management Instrumentation (WMI) 的 DCOM 会话。
此参数的有效值为：
- Default：DCOM 可以使用其正常的安全协商算法选择模拟级别。
- None：客户端对服务器匿名。 服务器进程可以模拟客户端，但模拟令牌不包含任何信息，不能使用。
- Identify： 允许对象查询调用方的凭据。
- Impersonate： 允许对象使用调用方的凭据。
- Delegate：使对象能够允许其他对象使用调用方的凭据。
如果未指定 Impersonation，则 New-CimSession cmdlet 将使用 Impersonate 的值。
| Type: | ImpersonationType |
| Accepted values: | Default, None, Identify, Impersonate, Delegate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxEnvelopeSizeKB
为任一方向指定 WsMan XML 消息的大小限制。
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoEncryption
指定关闭数据加密。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PacketIntegrity
指定创建的与 WMI 的 DCOM 会话使用组件对象模型 (COM) PacketIntegrity 功能。 默认情况下，使用 DCOM 创建的所有 CIM 会话都将 PacketIntegrity 参数设置为 True。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PacketPrivacy
使用 COM PacketPrivacy 创建与 WMI 的 DCOM 会话。 默认情况下，使用 DCOM 创建的所有 CIM 会话都将 PacketPrivacy 参数设置为 true。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
指定要使用的协议。 此参数的可接受值为：DCOM、Default 或 Wsman。
| Type: | ProtocolType |
| Accepted values: | Dcom, Default, Wsman |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyAuthentication
指定要用于代理解析的身份验证方法。 此参数的可接受值为：Default、Digest、Negotiate、Basic、Kerberos、NtlmDomain 或 CredSsp。
| Type: | PasswordAuthenticationMechanism |
| Accepted values: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCertificateThumbprint
指定用户帐户用于代理身份验证的 (x.509) 数字公钥证书。 输入证书的证书指纹。 在基于客户端证书的身份验证中使用证书。 它们只能映射到本地用户帐户，不适用于域帐户。
若要获取证书指纹，请使用 PowerShell Cert: 驱动器中的 Get-Item 或 Get-ChildItem cmdlet。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
指定用于代理身份验证的凭据。 输入下列项之一：
- 一个包含 PSCredential 对象的变量。
- 一个获取 PSCredential 对象的命令，例如
Get-Credential
如果未设置此选项，则不能指定任何凭据。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProxyType
指定要使用的主机名称解析机制。 此参数的可接受值为：None、WinHttp、Auto 或 InternetExplorer。
此参数的默认值为 InternetExplorer。
| Type: | ProxyType |
| Accepted values: | None, WinHttp, Auto, InternetExplorer |
| Position: | Named |
| Default value: | InternetExplorer |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipCACheck
指示当通过 HTTPS 进行连接时，客户端不会验证服务器证书是否由受信任的证书颁发机构 (CA) 签名。
只有在远程计算机通过其他机制获得信任（例如远程计算机所属的网络在物理上是安全的并已进行隔离，或者远程计算机在 WinRM 配置中列为受信任主机）时，才使用此参数。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipCNCheck
指示服务器的证书公用名称 (CN) 无需与服务器的主机名相匹配。 仅对使用 HTTPS 协议的受信任计算机使用此参数进行远程操作。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipRevocationCheck
指示跳过对服务器证书的吊销检查。 仅对受信任的计算机使用此参数。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UICulture
指定要用于 CIM 会话的用户界面区域性。 使用以下格式之一指定此参数的值：
- 一个采用
<languagecode2>-<country/regioncode2>格式的区域性名称，例如“EN-US”。 - 一个包含 CultureInfo 对象的变量。
- 一个获取 CultureInfo 对象的命令，如
Get-Culture。
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UseSsl
指示应使用 SSL 建立与远程计算机的连接。 默认情况下，不使用 SSL。 WsMan 会加密通过网络传输的所有内容，即使在使用 HTTP 的情况下。
利用此参数，你可以指定 HTTPS（而非 HTTP）的额外保护措施。 如果 SSL 在用于连接的端口上不可用，并且你指定了此参数，则命令会失败。
建议仅在未指定 PacketPrivacy 参数时使用此参数。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
输入
None
不能通过管道将对象传递给此 cmdlet。
输出
此 cmdlet 返回包含 CIM 会话选项信息的对象。
相关链接
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈