共用方式為

Set-WSManInstance

  • 參考
模組:
Microsoft.WSMan.Management

修改與資源相關的管理資訊。

語法

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

Description

Cmdlet Set-WSManInstance 會修改與資源相關的管理資訊。

此 Cmdlet 會使用 WinRM 連線/傳輸層來修改資訊。

範例

範例 1：停用本機電腦上的接聽程式

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

cfg                   : http://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...}

此命令會停用本機電腦上的 HTTPS 接聽程式。

重要

當符合指定的屬性時，ValueSet 參數會區分大小寫。

例如，在此命令中，

這會失敗： -ValueSet @{enabled="False"}

這會成功： -ValueSet @{Enabled="False"}

範例 2：設定本機電腦上的信封大小上限

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

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

此命令會將 本機電腦上的 MaxEnvelopeSizekb 值設定為 200。

重要

當符合指定的屬性時，ValueSet 參數會區分大小寫。

例如，使用上述命令。

這會失敗： -ValueSet @{MaxEnvelopeSizeKB ="200"}

這會成功： -ValueSet @{MaxEnvelopeSizekb ="200"}

範例 3：停用遠端電腦上的接聽程式

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

cfg                   : http://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...}

此命令會停用遠端電腦上的 HTTPS 接聽程式SERVER02。

重要

當符合指定的屬性時，ValueSet 參數會區分大小寫。

例如，使用上述命令。

這會失敗： -ValueSet @{enabled="False"}

這會成功： -ValueSet @{Enabled="False"}

參數

-ApplicationName

指定連接中的應用程式名稱。 ApplicationName 參數的預設值為 「WSMAN」。。 遠端端端點的完整識別碼格式如下：

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

例如：

http://server01:8080/WSMAN

裝載會話的 網際網路資訊服務 （IIS）會將具有此端點的要求轉送至指定的應用程式。 此 預設設定 WSMAN 適用於大部分用途。 當許多計算機與一部執行 Windows PowerShell 的電腦建立遠端連線時，這個參數是設計成使用。 在此情況下，IIS 會裝載 Web Services for Management （WS-Management） 以提高效率。

類型:String
Position:Named
預設值:Wsman
必要:False
接受管線輸入:False
接受萬用字元:False

-Authentication

指定用於伺服器的驗證機制。 可能的值包括：

  • Basic：基本是一種配置，其中使用者名稱和密碼會以純文本傳送至伺服器或 Proxy。
  • Default ：使用 WS-Management 通訊協定所實作的驗證方法。 這是預設值。
  • Digest：摘要是一種挑戰回應配置，會針對挑戰使用伺服器指定的數據字串。
  • Kerberos：用戶端計算機和伺服器會使用 Kerberos 憑證相互驗證。
  • Negotiate：交涉是一種挑戰回應配置，會與伺服器或 Proxy 交涉，以判斷要用於驗證的配置。 例如，此參數值允許交涉來判斷是否使用 Kerberos 通訊協定或 NTLM。
  • CredSSP：使用認證安全性支援提供者 （CredSSP） 驗證，可讓使用者委派認證。 此選項是針對在一部遠端電腦上執行的命令所設計，但從其他遠端電腦上收集資料或執行其他命令。

警告

CredSSP 會將用戶的認證從本機計算機委派給遠端電腦。 這種做法會增加遠端作業的安全性風險。 如果遠端電腦遭到入侵，當認證傳遞至該計算機時，可以使用認證來控制網路會話。

類型:AuthenticationMechanism
別名:auth, am
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CertificateThumbprint

指定具有執行此動作許可權之用戶帳戶的數位公鑰憑證 （X509）。 輸入憑證的憑證指紋。

憑證將用於用戶端憑證式驗證。 它們只能對應至本機用戶帳戶;它們不適用於網域帳戶。

若要取得憑證指紋，請使用 Get-Item PowerShell Cert: 磁碟驅動器中的或 Get-ChildItem 命令。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ComputerName

指定您要執行管理作業的電腦。 此值可以是完整功能變數名稱、NetBIOS 名稱或IP位址。 使用本機計算機名稱、 localhost或點 （.） 來指定本機電腦。 本機計算機是預設值。

當遠端電腦位於與使用者不同的網域時，您必須使用完整功能變數名稱。 您可以使用管線將此參數的值傳送至 Cmdlet。

類型:String
別名:cn
Position:Named
預設值:Localhost
必要:False
接受管線輸入:False
接受萬用字元:False

-ConnectionURI

指定連接端點。 此字串格式為：

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

下列字串是此參數格式正確的值：

http://Server01:8080/WSMAN

URI 必須完整。

類型:Uri
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Credential

指定具有執行此動作許可權的用戶帳戶。 預設為目前使用者。 輸入使用者名稱，例如 User01、 Domain01\User01或 User@Domain.com。 或者，輸入 PSCredential 物件，例如 Cmdlet 所傳回的物件 Get-Credential 。 當您輸入使用者名稱時，系統會提示您輸入密碼。

類型:PSCredential
別名:cred, c
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Dialect

指定要在篩選述詞中使用的方言。 這可以是遠端服務所支援的任何方言。 下列別名可用於方言 URI：

  • WQL: http://schemas.microsoft.com/wbem/wsman/1/WQL
  • Selector: http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
  • Association: http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter
類型:Uri
Position:Named
預設值:http://schemas.microsoft.com/wbem/wsman/1/WQL
必要:False
接受管線輸入:False
接受萬用字元:False

-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="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />

類型:String
別名:Path
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Fragment

指定要針對指定作業更新或擷取實例內的區段。 例如，若要取得多工作緩衝處理程式服務的狀態，請指定 -Fragment Status。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-OptionSet

將一組參數傳遞至服務，以修改或精簡要求的性質。 這些參數類似於命令行殼層中使用的參數，因為它們是特定的服務。 您可以指定任意數目的選項。

下列範例示範傳遞、 和 值1、、 3 和 c 參數的ab語法： 2

-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
必要:False
接受管線輸入:True
接受萬用字元:False

-SessionOption

定義 WS-Management 工作階段的一組擴充選項。 輸入您使用 Cmdlet 建立的 New-WSManSessionOption SessionOption 物件。 如需可用選項的詳細資訊，請參閱 New-WSManSessionOption。

類型:SessionOption
別名:so
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UseSSL

指定安全套接字層 （SSL） 通訊協議應該用來建立與遠端電腦的連線。 預設不會使用 SSL。

WS-Management 會加密透過網路傳輸的所有 Windows PowerShell 內容。 UseSSL 參數可讓您指定 HTTPS 的額外保護，而不是 HTTP。 如果用於連線的埠上無法使用 SSL，而且您指定此參數，命令會失敗。

類型:SwitchParameter
別名:ssl
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ValueSet

指定可協助修改管理資源的哈希表。 您可以使用 ResourceURI 參數和 SelectorSet 參數來指定管理資源。 ValueSet 參數的值必須是哈希表。

類型:Hashtable
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸入

None

您無法使用管線將物件傳送至此 Cmdlet。

輸出

XmlElement

此 Cmdlet 會將更新的 WSMan 實例當做 XmlElement 物件傳回。