Set-WSManInstance
修改與資源相關的管理資訊。
Syntax
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 服務 (WS-Management) 以獲得較佳效率。
Type: | String |
Position: | Named |
Default value: | Wsman |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Authentication
指定用於伺服器的驗證機制。 可能的值包括:
Basic
:基本是一種配置,其中使用者名稱和密碼會以純文本形式傳送至伺服器或 Proxy。Default
:使用由 WS-Management 通訊協定實作的驗證方法。 此為預設值。Digest
:摘要是一種挑戰回應配置,使用伺服器指定的數據字串來進行挑戰。Kerberos
:用戶端計算機和伺服器會使用 Kerberos 憑證相互驗證。Negotiate
:交涉是一種挑戰回應配置,會與伺服器或 Proxy 交涉,以判斷要用於驗證的配置。 例如,此參數值允許交涉以決定要使用 Kerberos 通訊協定或 NTLM。CredSSP
:使用認證安全性支援提供者 (CredSSP) 驗證,讓用戶能夠委派認證。 此選項是針對下列命令所設計:命令在遠端電腦上執行,但是收集來自其他遠端電腦上的資料,或是在其他遠端電腦上執行其他命令。
警告
CredSSP 將使用者認證從本機電腦委派給遠端電腦。 此做法會使得遠端作業的安全性風險變高。 若遠端電腦遭到入侵,當認證被傳遞給它時,該認證便可用來控制網路工作階段。
Type: | AuthenticationMechanism |
Aliases: | auth, am |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
對於具有執行此動作之權限的使用者帳戶,指定其數位公開金鑰憑證 (X509)。 請輸入憑證的憑證指紋。
憑證將用於用戶端憑證式驗證。 這些憑證只能對應至本機使用者帳戶,無法用於網域帳戶。
若要取得憑證指紋,請使用 Get-Item
PowerShell Cert:
磁碟驅動器中的或 Get-ChildItem
命令。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
指定要執行管理作業的電腦。 值可以是完整網域名稱、NetBIOS 名稱或 IP 位址。 使用本機計算機名稱 、 localhost
或點 (.
) 來指定本機計算機。 預設值是本機電腦。
當遠端電腦與使用者位於不同的網域時,您必須使用完整功能變數名稱。 您可以使用管線將此參數的值傳送至 Cmdlet。
Type: | String |
Aliases: | cn |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionURI
指定連線端點。 此字串的格式為:
<Transport>://<Server>:<Port>/<ApplicationName>
下列字串是此參數的正確格式值:
http://Server01:8080/WSMAN
此 URI 必須是完整的 URI。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
指定具有執行此動作權限的使用者帳戶。 預設為目前使用者。 輸入使用者名稱,例如 User01
、 Domain01\User01
或 User@Domain.com
。 或者,輸入 PSCredential 物件,例如 Cmdlet 所傳回的物件 Get-Credential
。 當您輸入使用者名稱時,會提示您輸入密碼。
Type: | PSCredential |
Aliases: | cred, c |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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
Type: | Uri |
Position: | Named |
Default value: | http://schemas.microsoft.com/wbem/wsman/1/WQL |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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" />
Type: | String |
Aliases: | Path |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Fragment
指定要針對所指定操作在執行個體中更新或抓取的區段。 例如,若要取得多工作緩衝處理程式服務的狀態,請指定 -Fragment Status
。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OptionSet
將一組切換參數傳遞給服務,以修改或精簡要求的本質。 這些切換參數類似於命令列殼層中使用的切換參數,因為都是服務特定的切換參數。 您可以指定任意數目的選項。
下列範例示範傳遞、 2
b
和 參數值1
、 和 3
c
的a
語法:
-OptionSet @{a=1;b=2;c=3}
Type: | Hashtable |
Aliases: | os |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
指定用戶端連線 WinRM 服務時所使用的連接埠。 傳輸為 HTTP 時,預設連接埠為 80。 傳輸為 HTTPS 時,預設連接埠為 443。
當您使用 HTTPS 作為傳輸時, ComputerName 參數的值必須符合伺服器的憑證一般名稱 (CN) 。 不過,如果 SkipCNCheck 參數指定為 SessionOption 參數的一部分,則伺服器的憑證通用名稱不需要符合伺服器的主機名。 SkipCNCheck 參數應該只用於信任的電腦。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | Uri |
Aliases: | ruri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SelectorSet
指定一組值組,用來選取特定管理資源執行個體。 當有多個資源實例存在時,就會使用 SelectorSet 參數。 SelectorSet 參數的值必須是哈希表。 下列範例顯示如何輸入此參數的值:
-SelectorSet @{Name="WinRM";ID="yyy"}
Type: | Hashtable |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SessionOption
定義 WS-Management 工作階段的一組擴充選項。 輸入您使用 Cmdlet 建立的 New-WSManSessionOption
SessionOption 物件。 如需可用選項的詳細資訊,請參閱 New-WSManSessionOption。
Type: | SessionOption |
Aliases: | so |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
指定建立遠端電腦連線時,應使用「安全通訊端層 (SSL)」通訊協定。 預設不會使用 SSL。
WS-Management 會加密透過網路傳輸的所有 Windows PowerShell 內容。 UseSSL 參數可讓您指定 HTTPS 的額外保護,而不是 HTTP。 若用於連線的連接埠上無法使用 SSL,且您指定此參數,則命令會失敗。
Type: | SwitchParameter |
Aliases: | ssl |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValueSet
指定有助於修改管理資源的雜湊表。 您可以使用 ResourceURI 參數和 SelectorSet 參數來指定管理資源。 ValueSet 參數的值必須是哈希表。
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
輸入
None
您無法使用管線將物件傳送至此 Cmdlet。
輸出
此 Cmdlet 會將更新的 WSMan 實例當做 XmlElement 物件傳回。