Set-WSManInstance

语法

ComputerName （默认值）

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

URI

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

说明

示例

示例 1：在本地计算机上禁用侦听器

Set-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : https://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.171, ::1, 2001:4898:0:fff:0:5efe:172.30.168.171...}

示例 2：在本地计算机上设置最大信封大小

Set-WSManInstance -ResourceURI winrm/config -ValueSet @{MaxEnvelopeSizekb = "200"}

cfg                 : https://schemas.microsoft.com/wbem/wsman/1/config
lang                : en-US
MaxEnvelopeSizekb   : 200
MaxTimeoutms        : 60000
MaxBatchItems       : 32000
MaxProviderRequests : 4294967295
Client              : Client
Service             : Service
Winrs               : Winrs

示例 3：在远程计算机上禁用侦听器

Set-WSManInstance -ResourceURI winrm/config/listener -ComputerName SERVER02 -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : https://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.172, ::1, 2001:4898:0:fff:0:5efe:172.30.168.172...}

参数

-ApplicationName

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

<传输>：//<服务器>：<端口>/<ApplicationName>

例如：

http://server01:8080/WSMAN

承载会话的 Internet Information Services （IIS）会将具有此终结点的请求转发到指定的应用程序。 此默认设置“WSMAN”适用于大多数使用。 当许多计算机与一台运行 Windows PowerShell 的计算机建立远程连接时，将使用此参数。 在这种情况下，IIS 托管用于管理的 Web 服务（WS-Management），以提高效率。

参数属性

参数集

-Authentication

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

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

警告：CredSSP 将用户的凭据从本地计算机委托给远程计算机。 这种做法会增加远程操作的安全风险。 如果远程计算机遭到入侵，则当凭据传递给该计算机时，凭据可用于控制网络会话。

参数属性

参数集

-CertificateThumbprint

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

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

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

参数属性

参数集

-ComputerName

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

参数属性

参数集

-ConnectionURI

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

<传输>：//<服务器>：<端口>/<ApplicationName>

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

http://Server01:8080/WSMAN

URI 必须完全限定。

参数属性

参数集

-Credential

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

参数属性

参数集

-Dialect

指定要在筛选器谓词中使用的方言。 这可以是远程服务支持的任何方言。 以下别名可用于方言 URI：

• WQL：https://schemas.microsoft.com/wbem/wsman/1/WQL
• 选择器：https://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
• 关联：http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

参数属性

参数集

-FilePath

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

Invoke-WSManAction -action StopService -resourceuri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:c:\input.xml -authentication default

此命令使用文件中的输入调用 Spooler 服务上的 StopService 方法。 该文件 Input.xml包含以下内容：

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

参数属性

参数集

-Fragment

指定要为指定操作更新或检索的实例内的节。 例如，若要获取后台处理程序服务的状态，请指定“-Fragment Status”。

参数属性

参数集

-OptionSet

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

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

-选项集 @{a=1;b=2;c=3}

参数属性

参数集

-Port

指定客户端连接到 WinRM 服务时要使用的端口。 当传输为 HTTP 时，默认端口为 80。 当传输为 HTTPS 时，默认端口为 443。 使用 HTTPS 作为传输时，ComputerName 参数的值必须与服务器的证书公用名（CN）匹配。 但是，如果将 SkipCNCheck 参数指定为 SessionOption 参数的一部分，则服务器的证书公用名不必与服务器的主机名匹配。 SkipCNCheck 参数应仅用于受信任的计算机。

参数属性

参数集

-ResourceURI

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

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

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

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

参数属性

参数集

-SelectorSet

指定一组值对，用于选择特定的管理资源实例。 当存在多个资源实例时，将使用 SelectorSet 参数。 SelectorSet 参数的值必须是哈希表。 以下示例演示如何输入此参数的值：

-SelectorSet @{Name=“WinRM”;ID=“yyy”}

参数属性

参数集

-SessionOption

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

参数属性

参数集

-UseSSL

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

WS-Management 加密通过网络传输的所有 Windows PowerShell 内容。 UseSSL 参数允许指定对 HTTPS 的附加保护，而不是 HTTP。 如果 SSL 在用于连接的端口上不可用，并且指定此参数，则命令将失败。

参数属性

参数集

-ValueSet

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

参数属性

参数集

CommonParameters

输入

None

输出

None

相关链接

• Connect-WSMan
• Disable-WSManCredSSP
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Get-WSManInstance
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption
• Remove-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan