WSMan Provider

提供者名稱

WSMan

磁碟機

WSMan

簡短描述

提供 Web Services for Management (WS-Management) 設定資訊的存取權。

詳細描述

Windows PowerShell 的 WS-Management 提供者可讓您新增、變更、清除及刪除本機或遠端電腦的 WS-Management 設定資料。

WS-Management 提供者會公開 Windows PowerShell 磁碟機，其中包含對應於 WS-Management 組態設定之邏輯群組的目錄結構。這些群組稱為容器。

-- Client

您可以設定 WS-Management 用戶端的各種層面。設定資訊會儲存在登錄中。

-- Service

您可以設定 WS-Management 服務的各種層面。設定資訊會儲存在登錄中。

注意：服務設定有時也稱為「伺服器設定」。

-- Shell

您可以設定 WS-Management 殼層的各種層面，例如允許遠端殼層存取 (AllowRemoteShellAccess) 以及允許的並行使用者數目上限 (MaxConcurrentUsers) 等設定。

-- Listener

您可以建立並設定接聽程式。接聽程式是實作 WS-Management 通訊協定以傳送及接收訊息的管理服務。

-- Plugin

WS-Management 服務會載入並使用外掛程式來提供各種功能。Windows PowerShell 預設提供三個外掛程式：事件轉送外掛程式、Microsoft.PowerShell 外掛程式和 Windows Management Instrumentation (WMI) 提供者外掛程式。這三個外掛程式支援事件轉送、設定和 WMI 存取。

-- ClientCertificate

您可以建立並設定用戶端憑證。當 WS-Management 用戶端設定為使用憑證驗證時，便會使用用戶端憑證。

WS-Management 提供者的目錄階層

---------------

本機電腦之 WS-Management 提供者的目錄階層如下：

WSMan:\localhost

--- Client

--- Service

--- Shell

--- Listener

------ <特定接聽程式>

--- Plugin

------ Event Forwarding Plugin

--------- InitializationParameters

--------- Resources

------------ Security

------ Microsoft.Powershell

--------- InitializationParameters

--------- Resources

------------ Security

------ WMI Provider

--------- InitializationParameters

--------- Resources

------------ Security

--- ClientCertificate

遠端電腦之 WS-Management 提供者的目錄階層與本機電腦相同。不過，您必須使用 Connect-WSMan 建立與遠端電腦的連線，才能存取遠端電腦的組態設定。在建立與遠端電腦的連線之後，遠端電腦的名稱便會出現在提供者中。

WSMan:\<遠端電腦的名稱>

--- Client

--- Service

--- Shell

--- Listener

------ <特定接聽程式>

--- Plugin

------ Event Forwarding Plugin

--------- InitializationParameters

--------- Resources

------------ Security

------ Microsoft.Powershell

--------- InitializationParameters

--------- Resources

------------ Security

------ WMI Provider

--------- InitializationParameters

--------- Resources

------------ Security

--- ClientCertificate

自訂提供者說明

--------------------

Listener、Plugin (IntitializationParameters、Resources、Security) 和 ClientCertificate 提供者路徑可提供特定 New-Item 支援。請在相關路徑中輸入 "Get-HelpNew-Item" 以取得自訂說明。

範例

瀏覽 WSMan: 磁碟機

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

這個命令會使用 Set-Location Cmdlet，將目前位置變更為 WSMan: 磁碟機。

Set-Location WSMan:

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

這個命令會使用 Set-Location 命令，將目前位置變更為 Localhost 存放區位置中的根目錄位置。請使用反斜線 (\) 或斜線 (/) 來指出 WSMan: 磁碟機的層級。

Set-Location -Path Localhost

如果您目前不在 WSMan: 磁碟機中，請在路徑開頭加上磁碟機名稱。

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

這個命令會使用 Set-Location 命令，將目前位置變更為遠端系統存放區位置中的根目錄位置。請使用反斜線 (\) 或斜線 (/) 來指出 WSMan: 磁碟機的層級。

Set-Location -Path  WSMan:\SERVER01

如果您目前不在 WSMan: 磁碟機中，請在路徑開頭加上磁碟機名稱。 上述命令假設與遠端系統的連線已經存在。如果尚未建立與遠端系統的連線，則可在瀏覽到遠端系統存放區位置中的根目錄之前，立即建立連線。例如： WSMan-Connect SERVER01 Set-Location -Path WSMan:\SERVER01

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

這個命令會使用 Set-Location 命令，將目前位置變更為 Localhost 存放區位置中的 Client 位置。請使用反斜線 (\) 或斜線 (/) 來指出 WSMan: 磁碟機的層級。

Set-Location -Path Localhost\Client

如果您目前不在 WSMan: 磁碟機中，請在路徑開頭加上磁碟機名稱。

顯示 WSMan: 磁碟機的內容

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

這個命令會使用 Get-Childitem Cmdlet，顯示 Localhost 存放區位置中的 WS-Management 存放區。

get-childitem -path WSMan:\Localhost

如果您目前在 WSMan: 磁碟機中，則可省略磁碟機名稱。

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

這個命令會使用 Get-Childitem Cmdlet，顯示遠端電腦 (SERVER01) 存放區位置中的 WS-Management 存放區。

get-childitem -path WSMan:\SERVER01

如果您目前在 WSMan: 磁碟機中，則可省略磁碟機名稱。 上述命令假設與遠端系統的連線已經存在。如果尚未建立與遠端系統的連線，則可在顯示遠端系統存放區位置中的屬性和容器之前，立即建立連線。例如： WSMan-Connect SERVER01 get-childitem -path WSMan:\SERVER01

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

這個命令會使用 Get-Childitem Cmdlet，顯示目前的 WS-Management 連線。

get-childitem -path WSMan:\

如果您目前在 WSMan: 磁碟機中，則可省略磁碟機名稱。

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

這個命令會使用 Get-Item Cmdlet，取得目前存放區中的屬性和容器。

Get-Childitem

上述命令會傳回屬性和內容的清單。例如： PS WSMan:\localhost&gt; get-childitem WSManConfig: Microsoft.WSMan.Management\WSMan::localhost Name Value Type ---- ----- ---- MaxEnvelopeSizekb 150 System.String MaxTimeoutms 60000 System.String MaxBatchItems 32000 System.String MaxProviderRequests 4294967295 System.String Client Container Service Container Shell Container Listener Container Plugin Container ClientCertificate Container

動態參數

動態參數是 Cmdlet 參數，由 Windows PowerShell 提供者所新增，只有在已啟用提供者之磁碟機上的 Cmdlet 方可使用。

Address <String>

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

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

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

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

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

所支援的 Cmdlet

• Get-Item

AllowRemoteShellAccess <Boolean>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

AllowUnEncrypted <Boolean>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Arguments <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Basic <Boolean>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Capability <Enumeration>

指定此統一資源識別項 (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 作業來管理殼層。因此，外掛程式無法處理這些作業。

所支援的 Cmdlet

• Get-Item

• New-Item

• Remove-Item

• Set-Item

CbtHardeningLevel <String>

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

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

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

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

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

所支援的 Cmdlet

• Get-Item

• Set-Item

CertificateThumbprint <String>

指定服務憑證的指紋。

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

所支援的 Cmdlet

• Clear-Item

• Get-Item

• Set-Item

Certificate <Boolean>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

CredSSP <Boolean>

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

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

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

所支援的 Cmdlet

• Get-Item

• Set-Item

HTTP <Unsigned Short Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

HTTPS <Unsigned Short Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Digest <Boolean>

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

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Enabled <Boolean>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

ExactMatch <Boolean>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

FileName <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

FileName (Plugin) <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

HostName <String>

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

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

所支援的 Cmdlet

• Clear-Item

• Get-Item

• Set-Item

IdleTimeOut <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

IPv4Filter <String>

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

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

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

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

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

所支援的 Cmdlet

• Clear-Item

• Get-Item

• Set-Item

IPv6Filter <String>

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

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

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

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

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

所支援的 Cmdlet

• Clear-Item

• Get-Item

• Set-Item

Issuer <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Kerberos <Boolean>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

ListeningOn <String>

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

ListeningOn_1201550598

ListeningOn_1973755898

ListeningOn_1508953035

ListeningOn_1560839940

所支援的 Cmdlet

• Get-Item

MaxBatchItems <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

MaxConcurrentUsers <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

MaxEnvelopeSizekb <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

MaxMemoryPerShellMB <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

MaxProcessesPerShell <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

MaxProviderRequests <Unsigned Long Integer>

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

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

所支援的 Cmdlet

• Get-Item

MaxShellsPerUser <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

MaxTimeoutMs <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Name <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Name (Plugin) <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Negotiate <Boolean>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

NetworkDelayMs <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Password <String>

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

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

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Plugin <>

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

所支援的 Cmdlet

• New-Item

• Remove-Item

Port <Unsigned Short Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Resource <String>

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

統一資源識別項 (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

所支援的 Cmdlet

• Get-Item

• Set-Item

ResourceURI <String>

指定用來識別電腦上特定資源類型 (如磁碟或處理序) 的統一資源識別項 (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

所支援的 Cmdlet

• Get-Item

RootSDDL <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

SDKVersion <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Shell <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

ShellTimeout <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Subject <String>

指定憑證所識別的實體。

所支援的 Cmdlet

• Get-Item

SupportsOptions <Boolean>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Transport <String>

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

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

所支援的 Cmdlet

• Get-Item

TrustedHosts <String>

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

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

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

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

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

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

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

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

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

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

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

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

所支援的 Cmdlet

• Clear-Item

• Get-Item

• Set-Item

URI <String>

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

所支援的 Cmdlet

• Get-Item

URLPrefix <String>

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

所支援的 Cmdlet

• Clear-Item

• Get-Item

• Set-Item

UserName <String>

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

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

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

所支援的 Cmdlet

• Get-Item

• Set-Item

Value <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

XMLRenderingType <String>

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

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

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

所支援的 Cmdlet

• Get-Item

• Set-Item

xmlns <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

lang <String>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

HTTP <Unsigned Short Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

HTTPS <Unsigned Short Integer>

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

所支援的 Cmdlet

• Get-Item

• Set-Item

MaxShellRunTime <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item

MaxShellRunTime <Unsigned Long Integer>

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

所支援的 Cmdlet

• Get-Item