New-WSManInstance

参考

模块:: Microsoft.WSMan.Management

创建管理资源的新实例。

语法

New-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-FilePath <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [-SelectorSet] <Hashtable>
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-ValueSet <Hashtable>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

New-WSManInstance
   [-ConnectionURI <Uri>]
   [-FilePath <String>]
   [-OptionSet <Hashtable>]
   [-ResourceURI] <Uri>
   [-SelectorSet] <Hashtable>
   [-SessionOption <SessionOption>]
   [-ValueSet <Hashtable>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

说明

此 cmdlet 仅在 Windows 平台上可用。

New-WSManInstance cmdlet 新建管理资源的实例。它使用资源 URI 和值集或输入文件来创建管理资源的新实例。

此 cmdlet 使用 WinRM 连接/传输层来创建管理资源实例。

示例

示例 1：创建 HTTPS 侦听器

此命令在所有 IP 地址上创建 WS-Management HTTPS 侦听器的实例。

New-WSManInstance winrm/config/Listener -SelectorSet @{Transport='HTTPS'; Address='*'} -ValueSet @{Hostname="HOST";CertificateThumbprint="XXXXXXXXXX"}

参数

-ApplicationName

指定连接中的应用程序名称。 ApplicationName 参数的默认值为“WSMAN”。远程终结点的完整标识符采用以下格式：

<transport>://<server>:<port>/<ApplicationName>

例如：

http://server01:8080/WSMAN

托管该会话的 Internet Information Services (IIS) 将带有此终结点的请求转发到指定的应用程序。默认设置 WSMAN 适用于大多数使用情况。当有许多计算机建立了与运行 Windows PowerShell 的一台计算机的远程连接时，需要使用此参数。在此情况下，IIS 将托管 Web Services for Management (WS-Management) 以提高效率。

类型:	String
Position:	Named
默认值:	Wsman
必需:	False
接受管道输入:	False
接受通配符:	False

-Authentication

指定服务器上要使用的身份验证机制。可能的值为：

Basic：Basic 是一种将用户名和密码以明文形式发送到服务器或代理的方案。
Default：使用由 WS-Management 协议实现的身份验证方法。这是默认情况。
Digest：Digest 是一种质询响应方案，该方案将服务器指定的数据字符串用于质询。
Kerberos：客户端计算机和服务器使用 Kerberos 证书相互进行身份验证。
Negotiate：Negotiate 是一种质询响应方案，该方案与服务器或代理协商以确定要用于身份验证的方案。例如，此参数值允许协商以确定是使用 Kerberos 协议还是 NTLM。
CredSSP：使用凭据安全支持提供程序 (CredSSP) 身份验证，可允许用户委派凭据。此选项专门用于这样的命令：在一台远程计算机上运行，但从其他远程计算机收集数据或在其他远程计算机上运行其他命令。

注意

CredSSP 将用户的凭据从本地计算机委派给远程计算机。此做法增加了远程操作的安全风险。如果远程计算机的安全受到威胁，则在向该计算机传递凭据时，可使用这些凭据来控制网络会话。

类型:	AuthenticationMechanism
别名:	auth, am
接受的值:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CertificateThumbprint

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

在基于客户端证书的身份验证中使用证书。证书只能映射到本地用户帐户，而不适用于域帐户。

若要获取证书指纹，请在 PowerShell Cert: 驱动器中使用 Get-Item 或 Get-ChildItem 命令。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ComputerName

指定要对其运行管理操作的计算机。该值可以是完全限定的域名、NetBIOS 名称或 IP 地址。可使用本地计算机名称、localhost 或点 (.) 指定本地计算机。默认值为本地计算机。当远程计算机与用户位于不同的域时，必须使用完全限定的域名。可以通过管道将此参数的值传递给 cmdle。

类型:	String
别名:	cn
Position:	Named
默认值:	Localhost
必需:	False
接受管道输入:	False
接受通配符:	False

-ConnectionURI

指定连接终结点。此字符串的格式为：

<Transport>://<Server>:<Port>/<ApplicationName>

以下字符串是此参数的格式正确的值：

http://Server01:8080/WSMAN

URI 必须完全限定。

类型:	Uri
别名:	CURI, CU
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Credential

指定有权执行此操作的用户帐户。默认为当前用户。键入用户名，例如“User01”、“Domain01\User01”或“User@Domain.com”。或者，输入 PSCredential 对象，例如 Get-Credential cmdlet 返回的对象。键入用户名时，将会提示你输入密码。

类型:	PSCredential
别名:	cred, c
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-FilePath

指定用于创建管理资源的文件的路径。使用 ResourceURI 参数和 SelectorSet 参数指定管理资源。例如，以下命令使用 File 参数：

Invoke-WSManAction -Action stopservice -ResourceUri wmi/cimv2/Win32_Service -SelectorSet @{Name="spooler"} -File c:\input.xml -Authentication Default

此命令使用来自文件的输入对后台处理程序服务调用 StopService 方法。文件 Input.xml 包含以下内容：

<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />

类型:	String
别名:	Path
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OptionSet

将一组开关传递到某个服务以修改或优化请求的性质。这些开关与命令行 shell 中使用的开关相似，因为它们也是特定于服务的。可以指定任何数量的选项。

以下示例演示为 a、b 和 c 参数传递值 1、2 和 3 的语法：

-OptionSet @{a=1;b=2;c=3}

类型:	Hashtable
别名:	os
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Port

指定要在客户端连接到 WinRM 服务时使用的端口。当传输为 HTTP 时，默认端口为 80。当传输为 HTTPS 时，默认端口为 443。

使用 HTTPS 作为传输协议时，ComputerName 参数的值必须与服务器的证书公用名 (CN) 匹配。但是，如果将 SkipCNCheck 参数指定为 SessionOption 参数的一部分，则服务器的证书公用名无需与服务器的主机名匹配。 SkipCNCheck 参数应仅用于受信任的计算机。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceURI

包含资源类或实例的统一资源标识符 (URI)。 URI 用于标识计算机上特定类型的资源，例如磁盘或进程。

URI 由前缀和指向资源的路径组成。例如：

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

类型:	Uri
别名:	ruri
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SelectorSet

指定一组用于选择特定管理资源实例的值对。如果相应资源存在多个实例，则使用 SelectorSet 参数。 SelectorSet 参数的值必须为哈希表。

以下示例显示如何为此参数输入值：

-SelectorSet @{Name="WinRM";ID="yyy"}

类型:	Hashtable
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-SessionOption

为 WS-Management 会话定义一组扩展选项。请输入你使用 New-WSManSessionOption cmdlet 创建的 SessionOption 对象。有关可用选项的详细信息，请参阅 New-WSManSessionOption。

类型:	SessionOption
别名:	so
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseSSL

指定应使用安全套接字层 (SSL) 协议来建立与远程计算机的连接。默认情况下，不使用 SSL。

WS-Management 对通过网络传输的所有 Windows PowerShell 内容进行加密。可以使用 UseSSL 参数指定 HTTPS（而非 HTTP）的额外保护措施。如果 SSL 在用于连接的端口上不可用，并且指定了此参数，则命令将失败。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ValueSet

指定可帮助修改管理资源的哈希表。使用 ResourceURI 参数和 SelectorSet 参数指定管理资源。 ValueSet 参数的值必须为哈希表。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

不能通过管道将对象传递给此 cmdlet。

输出

XmlElement

此 cmdlet 将所创建的 WSMan 实例作为 XmlElement 对象返回。

备注

Windows Management Instrumentation (WMI) cmdlet 类似于Set-WmiInstance cmdlet。 Set-WmiInstance 使用 DCOM 连接/传输层来创建或更新 WMI 实例。

通过