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 协议的编码。 此参数的可接受值为: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 会话。
此参数的有效值为:
- 默认值: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
指定要使用的协议。 此参数的可接受值为: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 证书:驱动器中的 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。
输出
此 cmdlet 返回包含 CIM 会话选项信息的对象。
备注
PowerShell 包含以下 New-CimSessionOption
别名:
- 窗户:
ncso
此 cmdlet 仅在 Windows 平台上可用。