登录  |  注册
当前位置：网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] 新 CimSession (CimCmdlet)

作者：精品下载站 日期：2024-12-14 02:25:47 浏览：15 分类：玩电脑

新 CimSession (CimCmdlet)

New-CimSession

模块 ：CimCmdlets

创建 CIM 会话。

句法

New-CimSession
   [-Authentication <PasswordAuthenticationMechanism>]
   [[-Credential] <PSCredential>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]
New-CimSession
   [-CertificateThumbprint <String>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]

描述

此 cmdlet 仅适用于 Windows 平台。

New-CimSession cmdlet 创建 CIM 会话。 CIM 会话是表示与本地计算机或远程计算机的连接的客户端对象。 CIM 会话包含有关连接的信息，例如计算机名称、使用的协议或各种标识符。

此 cmdlet 返回可供所有其他 CIM cmdlet 使用的 CIM 会话对象。

示例

示例 1：使用默认选项创建 CIM 会话

此示例使用默认选项创建本地 CIM 会话。如果未指定 ComputerName，New-CimSession 将创建与本地计算机的 DCOM 会话。

New-CimSession

示例 2：创建到特定计算机的 CIM 会话

此示例创建与 ComputerName 指定的计算机的 CIM 会话。默认情况下，当指定 ComputerName 时，New-CimSession 创建 WSMan 会话。

New-CimSession -ComputerName Server01

示例 3：创建与多台计算机的 CIM 会话

此示例创建与逗号分隔列表中 ComputerName 指定的每台计算机的 CIM 会话。

New-CimSession -ComputerName Server01,Server02,Server03

示例 4：创建具有友好名称的 CIM 会话

此示例为逗号分隔列表中 ComputerName 指定的每台计算机创建一个远程 CIM 会话，并通过指定 Name 为新会话分配一个友好名称。

New-CimSession -ComputerName Server01,Server02 -Name FileServers
Get-CimSession -Name File*

您可以使用 CIM 会话的友好名称来引用其他 CIM cmdlet 中的会话，例如 Get-CimSession。

示例 5：使用 PSCredential 对象创建与计算机的 CIM 会话

此示例使用 Credential 指定的 PSCredential 对象以及 ComputerName 指定的身份验证类型创建与 ComputerName 指定的计算机的 CIM 会话。 >身份验证。

New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate

您可以使用 Get-Credential cmdlet 创建 PSCredential 对象。

示例 6：使用特定端口创建与计算机的 CIM 会话

此示例使用 Port 指定的 TCP 端口创建与 ComputerName 指定的计算机的 CIM 会话。

New-CimSession -ComputerName Server01 -Port 1234

示例 7：使用 DCOM 创建 CIM 会话

此示例使用分布式 COM (DCOM) 协议而不是 WSMan 创建 CIM 会话。

$SessionOption = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server1 -SessionOption $SessionOption

参数

-Authentication

指定用于用户凭据的身份验证类型。该参数可接受的值为：

  • 默认
  • 消化
  • 谈判
  • 基本的
  • 克伯罗斯
  • NtlmDomain
  • CredSsp

您无法使用 NtlmDomain 身份验证类型连接到本地计算机。 CredSSP 身份验证仅在 Windows Vista、Windows Server 2008 和更高版本的 Windows 中可用。

警告

凭据安全服务提供商 (CredSSP) 身份验证专为需要对多个资源进行身份验证的命令而设计，例如访问远程网络共享。这种机制增加了远程操作的安全风险。如果远程计算机受到威胁，则传递给它的凭据可用于控制网络会话。

类型 ：

密码认证机制

接受的值：

默认、摘要、协商、基本、Kerberos、NtlmDomain、CredSsp

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-CertificateThumbprint

指定有权执行此操作的用户帐户的数字公钥证书 (X.509)。输入证书的证书指纹。

证书用于基于客户端证书的身份验证。它们只能映射到本地用户帐户；它们不适用于域帐户。

要获取证书指纹，请使用 PowerShell 证书提供程序中的 Get-Item 或 Get-ChildItem cmdlet。

有关更多信息，请参阅 about_Certificate_Provider。

类型 ：

String

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-ComputerName

指定要创建 CIM 会话的计算机的名称。指定单个计算机名称或以逗号分隔的多个计算机名称。

如果未指定ComputerName，则会创建与本地计算机的 CIM 会话。您可以采用以下格式之一指定计算机名称的值：

  • 一个或多个 NetBIOS 名称
  • 一个或多个IP地址
  • 一个或多个完全限定域名。

如果计算机与用户位于不同的域中，则必须指定完全限定的域名。

类型 ：

String[]

别名：

CN, ServerName

位置：

1

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-Credential

指定有权执行此操作的用户帐户。如果未指定凭据，则使用当前用户帐户。

使用以下格式之一指定凭据的值：

  • 用户名：“User01”
  • 域名和用户名：“Domain01\User01”
  • 用户主体名称：“[email protected]”
  • 一个 PSCredential 对象，例如由 Get-Credential cmdlet 返回的对象。

当您键入用户名时，系统会提示您输入密码。

类型 ：

PS凭证

位置：

2

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Name

指定 CIM 会话的友好名称。

使用其他 cmdlet（例如 Get-CimSession cmdlet）时，可以使用该名称来引用 CIM 会话。该名称不需要对于计算机或当前会话是唯一的。

类型 ：

String

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-OperationTimeoutSec

cmdlet 等待服务器响应的持续时间。

默认情况下，此参数的值为 0，这意味着 cmdlet 使用服务器的默认超时值。

如果 OperationTimeoutSec 参数设置为小于 3 分钟的稳健连接重试超时的值，则持续时间超过 OperationTimeoutSec 参数值的网络故障将无法恢复，因为在客户端重新连接之前服务器上的操作超时。

类型 ：

UInt32

别名：

OT

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-Port

指定远程计算机上用于此连接的网络端口。要连接到远程计算机，远程计算机必须侦听连接使用的端口。默认端口为 5985（用于 HTTP 的 WinRM 端口）和 5986（用于 HTTPS 的 WinRM 端口）。

在使用备用端口之前，必须将远程计算机上的 WinRM 侦听器配置为侦听该端口。使用以下命令配置监听器：

winrm delete winrm/config/listener?Address=*+Transport=HTTP
winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}

除非必须，否则不要使用端口参数。命令中的端口设置适用于运行该命令的所有计算机或会话。备用端口设置可能会阻止该命令在所有计算机上运行。

类型 ：

UInt32

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-SessionOption

为新 CIM 会话设置高级选项。输入使用 New-CimSessionOption cmdlet 创建的 CimSessionOption 对象的名称。

类型 ：

Cim会话选项

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-SkipTestConnection

默认情况下，New-CimSession cmdlet 出于以下两个原因与远程 WS-Management 端点建立连接： 验证远程服务器是否正在侦听使用 Port 指定的端口号 参数，并验证指定的帐户凭据。验证是使用标准 WS-Identity 操作完成的。如果远程 WS-Management 端点无法使用 WS-Identify，或者为了减少一些数据传输时间，您可以添加 SkipTestConnection 开关参数。

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

输入

无

您无法通过管道将对象传递到此 cmdlet。

输出

CimSession

此 cmdlet 返回 CIM 会话对象。

笔记

PowerShell 包含 New-CimSession 的以下别名：

  • Windows:

      ncms

    此 cmdlet 仅适用于 Windows 平台。

    猜你还喜欢

    您需要 登录账户 后才能发表评论

    取消回复欢迎 你 发表评论:

    精品推荐！
    欢迎 访客 登录没有账号？
    • 最新文章
    • 热门文章
    • 热评文章
    最新评论
      热门tag
      友情链接

      关灯