WSMan Provider

-------------------------- 範例 1 --------------------------

Set-Location WSMan:

-------------------------- 範例 2 --------------------------

Set-Location -Path Localhost

-------------------------- 範例 3 --------------------------

Set-Location -Path  WSMan:\SERVER01

-------------------------- 範例 4 --------------------------

Set-Location -Path Localhost\Client

-------------------------- 範例 1 --------------------------

get-childitem -path WSMan:\Localhost

-------------------------- 範例 2 --------------------------

get-childitem -path WSMan:\SERVER01

-------------------------- 範例 3 --------------------------

get-childitem -path WSMan:\

-------------------------- 範例 4 --------------------------

Get-Childitem

指定為其建立此接聽程式的位址。值可以是下列其中一項：

-- 常值字串 "*" (萬用字元 (*) 會使命令繫結所有網路介面卡 [NIC] 上的所有 IP 位址)。

-- 常值字串 "IP:"，後面再加上 IPv4 小數點十進位格式或 IPv6 冒號十六進位格式的有效 IP 位址。

-- 常值字串 "MAC:"，後面再加上 NIC 的 MAC 位址。例如：MAC:32-a3-58-90-be-cc。

注意：此 Address 值是在建立接聽程式時設定。

啟用遠端殼層的存取。如果您將此參數設定為 False，伺服器便會拒絕新的遠端殼層連線。預設為 True。

允許用戶端電腦要求未加密的流量。根據預設，用戶端電腦需要加密的網路流量。

指定您要傳遞到自訂殼層的引數字串和命令列引數。此參數為選擇項。

允許用戶端電腦使用基本驗證。基本驗證是一種以純文字格式將使用者名稱和密碼傳送到伺服器或 Proxy 的配置。這是最不安全的驗證方法。

指定此統一資源識別項 (URI) 支援的作業。您必須為此 URI 支援的每一種作業建立一個項目。有效值如下：

-- Create：URI 可支援 Create 作業。如果 Create 作業支援使用 SupportFragment 屬性的概念，則會使用該屬性。SupportFiltering 屬性無效，必須設定為 False。這項作業不適用於也支援 Shell 作業的 URI。

-- Delete：URI 可支援 Delete 作業。如果 Delete 作業支援使用 SupportFragment 屬性的概念，則會使用該屬性。SupportFiltering 屬性無效，必須設定為 False。這項作業不適用於也支援 Shell 作業的 URI。

-- Enumerate：URI 可支援 Enumerate 作業。Enumerate 作業不支援 SupportFragment 屬性，此屬性必須設定為 False。SupportFiltering 屬性有效，而且如果外掛程式支援篩選功能，此屬性必須設定為 True。這項作業不適用於也支援 Shell 作業的 URI。

-- Get：URI 可支援 Get 作業。如果 Get 作業支援使用 SupportFragment 屬性的概念，則會使用該屬性。SupportFiltering 屬性無效，必須設定為 False。這項作業不適用於也支援 Shell 作業的 URI。

-- Invoke：URI 可支援 Invoke 作業。Invoke 作業不支援 SupportFragment 屬性，此屬性必須設定為 False。SupportFiltering 屬性無效，必須設定為 False。這項作業不適用於也支援 Shell 作業的 URI。

-- Put：URI 可支援 Put 作業。如果 Put 作業支援使用 SupportFragment 屬性的概念，則會使用該屬性。SupportFiltering 屬性無效，必須設定為 False。這項作業不適用於也支援 Shell 作業的 URI。

-- Subscribe：URI 可支援 Subscribe 作業。Subscribe 作業不支援 SupportFragment 屬性，此屬性必須設定為 False。SupportFiltering 屬性無效，必須設定為 False。這項作業不適用於也支援 Shell 作業的 URI。

-- Shell：URI 可支援 Shell 作業。Shell 作業不支援 SupportFragment 屬性，此屬性必須設定為 False。SupportFiltering 屬性無效，必須設定為 False。這項作業不適用於也支援其他任何作業的 URI。若 URI 是設定為支援 Shell 作業，則會在 WS-Management (WinRM) 服務內部處理 Get、Put、Create、Delete、Invoke 和 Enumerate 作業來管理殼層。因此，外掛程式無法處理這些作業。

設定驗證要求中通道繫結權杖需求的原則。有效值如下：

-- Strict：除非有通道繫結權杖，否則將拒絕所有要求。這項設定可利用通道繫結權杖來確保所有連線都安全無虞。

-- Relaxed：如果要求中有通道繫結權杖存在，連線便會受到保護。如果通道繫結權杖不存在，仍會接受連線。不過，這個連線很容易遭受通道繫結權杖能防止的攻擊。

-- None：忽略提供的任何通道繫結權杖。

此參數的值只對 HTTPS 連線有效。

指定服務憑證的指紋。

這個值代表憑證之 Thumbprint 欄位中兩位數的十六進位值字串，用於指定有權執行此動作之使用者帳戶的數位公開金鑰憑證 (X509)。憑證係在進行用戶端憑證式驗證時使用。這些憑證可以對應到本機使用者帳戶，並不適用於網域帳戶。若要取得憑證指紋，請在 Windows PowerShell Cert: 磁碟機中使用 Get-Item 或 Get-ChildItem Cmdlet。

允許使用用戶端來驗證憑證。WS-Management 用戶端會嘗試在電腦存放區中尋找憑證。如果用戶端在電腦存放區中找不到憑證，則會嘗試在目前的使用者存放區中尋找憑證。如果找不到符合的憑證，使用者會收到錯誤訊息。

允許用戶端使用認證安全性服務提供者 (CredSSP) 驗證。

CredSSP 驗證允許使用者委派認證。此選項專為在一台遠端電腦執行，但卻從其他遠端電腦收集資料或執行其他命令的命令而設計。

警告：CredSSP 驗證會從本機電腦將使用者的認證委派給遠端電腦。此做法會提高遠端操作的安全性風險。如果遠端電腦已經遭受危害，當認證傳送到遠端電腦時，便可能遭到利用來控制網路工作階段。

指定使用 HTTP 時，用戶端要使用的連接埠。根據預設，HTTP 會使用連接埠 80，而您可以指定 1 到 65535 之間的任何值。

指定使用 HTTPS 時，用戶端要使用的連接埠。根據預設，HTTPS 會使用連接埠 443，而您可以指定 1 到 65535 之間的任何值。

允許用戶端使用摘要式驗證。摘要式驗證是一種挑戰-回應配置，會使用伺服器指定的資料字串進行挑戰。只有用戶端電腦可以啟動摘要式驗證要求。用戶端電腦會將要求傳送到伺服器進行驗證，並接收伺服器傳回的權杖字串。接著，用戶端電腦會傳送資源要求，其中包括使用者名稱，以及結合權杖字串之密碼的編譯雜湊。HTTP 和 HTTPS 都可支援摘要式驗證。WinRM 殼層用戶端指令碼和應用程式可以指定摘要式驗證，但是 WS-Management 服務並不接受摘要式驗證。

注意：透過 HTTP 進行摘要式驗證並不安全。

指定接聽程式處於啟用或停用狀態。預設為 True。

指定如何使用 Sddl 參數中指定的安全性設定。如果 ExactMatch 參數設定為 True，則只有在嘗試存取 URI 中指定的 URI 時，Sddl 中的安全性設定才會用來進行授權。如果 ExactMatch 設定為 false，則在嘗試存取以 URI 中指定之字串開頭的 URI 時，Sddl 中的安全性設定便會用來進行授權。

指定用來更新 ResourceURI 和 SelectorSet 所指定之管理資源的輸入檔。

指定作業外掛程式的檔名。在收到要求時，置於此項目的任何環境變數都會在使用者的內容中展開。由於各個使用者都可能擁有相同環境變數的不同版本，因此都可能擁有不同的外掛程式。這個項目不能空白，而且必須指向有效的外掛程式。

指定正在執行 WS-Management (WinRM) 服務之電腦的主機名稱。

這個值必須是完整網域名稱、IPv4 或 IPv6 常值字串，或是萬用字元。

指定當遠端殼層中沒有任何使用者活動時，遠端殼層保持開啟的時間上限 (毫秒)。在經過指定的時間之後，便會自動刪除遠端殼層。您可以指定 0 到 2147483647 之間的任何值。值為 0 表示逾時沒有限制。預設為 900000 (15 分鐘)。

指定接聽程式可以使用的 IPv4 位址。有效值如下：

-- 如果您將此參數保留空白，則無法使用任何 IPv4 位址。

-- 如果您輸入萬用字元 (*)，則可以使用任何 IPv4 位址。

-- 如果您輸入 IP 範圍清單，則可以使用指定範圍內的任何 IP 位址。請使用逗號 (,) 來分隔各個範圍，並將每個範圍指定成一組使用小數點十進位格式且以連字號 (-) 分隔的 IPv4 位址。請務必將各組位址中較小的值放在前面。這些範圍包含頭尾值。

注意：IPv4 常值字串是由四個分別介於 0 到 255 之間的小數點十進位數字所組成，例如 192.168.0.0。

指定接聽程式可以使用的 IPv6 位址。有效值如下：

-- 如果您將此參數保留空白，則無法使用任何 IPv6 位址。

-- 如果您輸入萬用字元 (*)，則可以使用任何 IPv6 位址。

-- 如果您輸入 IP 範圍清單，則可以使用指定範圍內的任何 IP 位址。請使用逗號 (,) 來分隔各個範圍，並將每個範圍指定成一組使用冒號十六進位格式且以連字號 (-) 分隔的 IPv6 位址。請務必將各組位址中較小的值放在前面。這些範圍包含頭尾值。

注意：IPv6 常值字串請置於方括號內，並包含以冒號分隔的十六進位數字，例如 [::1] 或 [3ffe:ffff::6ECB:0101]。

指定發行憑證的憑證授權單位名稱。

允許用戶端使用 Kerberos 驗證。Kerberos 驗證是一種配置，讓用戶端與伺服器使用 Kerberos 憑證相互驗證。

指定服務實際正在接聽的一個或所有 IP 位址。此參數衍生自以與接聽程式相關聯之實際 IP 為基礎的 Address 元素。IP 位址的值必須採用 IPv4 小數點十進位表示法或 IPv6 冒號分隔十六進位表示法。有多個 ListeningOn 項目存在，每個項目都以 ListeningOn_ 開頭。例如：

ListeningOn_1201550598

ListeningOn_1973755898

ListeningOn_1508953035

ListeningOn_1560839940

指定 Pull 回應中可以使用的元素數目上限。您可以指定 1 到 4294967295 之間的任何值。

指定可以透過遠端殼層在相同電腦上同時執行遠端作業的使用者數目上限。如果新的殼層連線數目超過指定的限制，便會遭到拒絕。您可以指定 1 到 100 之間的任何值。

指定 SOAP 資料上限 (以 KB 為單位)。您可以指定 32 到 4294967295 之間的任何值。

指定使用中遠端殼層及其所有子處理序能配置的記憶體總容量上限。您可以指定 0 到 2147483647 之間的任何值。值為 0 表示遠端作業僅能以可用的虛擬記憶體來配置記憶體。預設值為 0。

指定允許任何殼層作業啟動的處理序數目上限。您可以指定 0 到 2147483647 之間的任何數字。值為 0 表示允許的處理序數目不受限制。根據預設，每個殼層的上限是五個處理序。

指定服務允許的同時要求數目上限。您可以指定 1 到 4294967295 之間的任何值。此限制適用於各個提供者。

注意：這個值已被取代，不應該使用。

指定任何使用者可以透過遠端方式，在相同系統上開啟之並行殼層數目的上限。啟用這個原則設定後，如果此計數超過指定的限制，使用者便無法開啟新的遠端殼層。如果已停用或未設定這個原則設定，此限制將預設為每個使用者可開啟兩個遠端殼層。您可以指定 0 到 2147483647 之間的任何數字。值為 0 表示允許的殼層數目不受限制。

指定除了 Pull 要求以外的任何要求所需的逾時上限 (毫秒)。您可以指定 500 到 4294967295 之間的任何數字。

指定 WS-Management 工作階段的顯示名稱。您可以在使用其他 Cmdlet (例如 Get-PSSession 和 Enter-PSSession) 時，使用此名稱來表示工作階段。此名稱不一定要是電腦或目前工作階段的唯一名稱。

指定要用於外掛程式的顯示名稱。如果外掛程式傳回錯誤，此顯示名稱會放入傳回到用戶端應用程式的錯誤 XML 中。此名稱與地區設定無關。

允許用戶端使用交涉式驗證。交涉式驗證是一種配置，用戶端會傳送要求到伺服器進行驗證。伺服器會決定要使用 Kerberos 通訊協定還是 NTLM。伺服器會選取 Kerberos 通訊協定來驗證網域帳戶，並選取 NTLM 來驗證本機電腦帳戶。網域使用者的使用者名稱必須以 domain\user_name 的格式來指定。若是伺服器電腦上的本機使用者，則使用者名稱必須以 server_name\user_name 的格式來指定。

指定用戶端電腦因為考慮到網路延遲時間而等待的額外時間 (毫秒)。您可以指定 500 到 4294967295 之間的任何值。

指定本機或網域帳戶的密碼。此值不可為 NULL。

用戶端電腦可以指定在電腦上建立殼層時所要使用的認證。網域使用者的使用者名稱必須以 domain\user_name 的格式來指定。若是伺服器電腦上的本機使用者，則使用者名稱必須以 server_name\user_name 的格式來指定。

如果您使用這個結構，就必須同時指定使用者名稱和密碼欄位。此結構可用於基本、摘要式、交涉式或 Kerberos 驗證。使用基本或摘要式驗證時，用戶端必須明確指定認證。

WS-Management 外掛程式是原生動態連結程式庫 (DLL)，其外掛於 WS-Management 並可擴充其功能。WSW-Management 外掛程式 API 可提供功能，讓使用者針對支援的資源 URI 和作業實作特定 API，以便撰寫外掛程式。針對 WS-Management (WinRM) 服務或 Internet Information Services (IIS) (IIS) 設定外掛程式之後，這些外掛程式便會分別載入 WS-Management 主機或 IIS 主機中。遠端要求會通過路由傳送到這些外掛程式進入點來執行作業。

指定為其建立此接聽程式的 TCP 連接埠。您可以指定 1 到 65535 之間的任何值。

指定代表特殊管理作業類型或值型別的端點。服務會公開一個或多個資源，而且某些資源可以有一個以上的執行個體。管理資源類似於 WMI 類別或資料庫資料表，而執行個體則與類別的執行個體或資料表中的資料列類似。例如，Win32_LogicalDisk 類別代表資源，Win32_LogicalDisk="C:\" 則是該項資源的特定執行個體。

統一資源識別項 (URI) 包含首碼和資源路徑。例如：

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

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

指定用來識別電腦上特定資源類型 (如磁碟或處理序) 的統一資源識別項 (URI)。

URI 由首碼和資源路徑組成。例如：

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

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

指定存取控制項目的安全性描述元定義語言 (SDDL)。此參數可識別用來授權存取指定之資源 URI 的安全性設定。

指定 WS-Management 外掛程式 SDK 的版本。唯一的有效值是 1。

指定自訂殼層的處理序字串。您可以指定環境變數。

指定由於閒置導致殼層逾時的時間長度。請指定以毫秒為單位的逾時值。

指定憑證所識別的實體。

指定外掛程式是否支援使用在要求訊息之 wsman:OptionSet 標頭內傳送的選項。

指定用來傳送及接收 WS-Management 通訊協定要求和回應的傳輸協定。值必須是 HTTP 或 HTTPS。

注意：此 Transport 值是在建立接聽程式時設定。

透過信任的網路連線連接到本機電腦的遠端電腦清單。使用不允許用戶端驗證服務的驗證配置和傳輸協定 (例如基本驗證或 HTTP) 時，允許將要求傳送到這份清單中指定的電腦。

如果在 TrustedHosts 中指定伺服器，用戶端不會驗證伺服器的身分識別，而讓用戶端很容易遭受攔截式攻擊。建議只有在沒有惡意使用者的安全網路連線中 (例如在網域環境中)，才指定主機名稱。

指定的主機名稱可以是網域名稱系統 (DNS) 名稱或 IP 位址。有效值如下：

-- 空白：不信任任何主機。

-- 星號 "*" 字元：信任所有主機。

以逗號 (,) 分隔的主機名稱模式清單。主機名稱模式必須使用下列格式：

-- 以萬用字元 (*) 開頭的字串。此字串至少必須包含兩個字元。如此表示信任共用此尾碼的所有主機。

-- 以萬用字元 (*) 結尾的字串。此字串至少必須包含兩個字元。如此表示信任共用此首碼的所有主機。

-- 信任所有的 NetBIOS 名稱 (例如，不包含句號的字串)。

-- 不含萬用字元的字串 (*)：信任以此字串命名的主機。

注意：使用 Set-Item Cmdlet 設定 TrustedHosts 值時，Set-Item Cmdlet 另外還支援 -Concatenate 參數。下列範例會將新值 (*.domain2.com) 附加到儲存在 TrustedHost 中的舊值：

Set-Item .\TrustedHosts *.domain2.com -Concatenate -Force

識別依據 Sddl 參數值授權存取的 URI。

可接受 HTTP 或 HTTPS 要求的 URL 首碼。這是只包含字元 a-z、A-Z、9-0、底線 (_) 和反斜線 (/) 的字串。此字串不能以反斜線 (/) 開頭或結尾。例如，如果電腦名稱是 SampleComputer，WS-Management 用戶端就要在目的位址中指定 http://SampleMachine/URLPrefix。

指定本機帳戶或網域帳戶的使用者名稱。值不能為 NULL。

用戶端可以指定在電腦上建立殼層時所要使用的認證。網域帳戶的使用者名稱必須以 domain\user_name 的格式來指定。若是伺服器電腦上的本機帳戶，則使用者名稱必須以 server_name\user_name 的格式來指定。

如果使用這個結構，就必須同時指定使用者名稱和密碼欄位。此結構可用於基本、摘要式、交涉式或 Kerberos 驗證。使用基本或摘要式驗證時，用戶端必須明確指定認證。

指定初始化參數的值，這是用來指定設定選項的外掛程式專屬值。

指定透過 WSMAN_DATA 物件將 XML 傳送到外掛程式時所使用的格式。有效值如下：

Text：內送 XML 資料包含在 WSMAN_DATA_TYPE_TEXT 結構中，將 XML 表示成 PCWSTR 記憶體緩衝區。

XMLReader：內送 XML 資料包含在 WSMAN_DATA_TYPE_WS_XML_READER 結構中，將 XML 表示成 WebServices.h 標頭檔中定義的 XmlReader 物件。

字串，指定可唯一識別命名空間的統一資源名稱 (URN)。

字串，指定語言，或是以連字號分隔語言及地區的「語言-地區」。

指定使用 HTTP 時，用戶端要使用的連接埠。根據預設，HTTP 會使用連接埠 80，而您可以指定 1 到 65535 之間的任何值。

指定使用 HTTPS 時，用戶端要使用的連接埠。根據預設，HTTPS 會使用連接埠 443，而您可以指定 1 到 65535 之間的任何值。

注意：這個值已被取代，已經不再使用。

注意：這個值已被取代，已經不再使用。