Remove-WSManInstance

模組:

Microsoft.WsMan.Management

刪除管理資源實例。

語法

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

Remove-WSManInstance
      [-ConnectionURI <Uri>]
      [-OptionSet <Hashtable>]
      [-ResourceURI] <Uri>
      [-SelectorSet] <Hashtable>
      [-SessionOption <SessionOption>]
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Description

Remove-WSManInstance Cmdlet 會刪除在 ResourceURI 中指定的管理資源的實例，並 SelectorSet 參數。

此 Cmdlet 會使用 WinRM 連線/傳輸層來刪除管理資源實例。

範例

範例 1：刪除接聽程式

PS C:\> Remove-WSManInstance -ResourceUri winrm/config/Listener -SelectorSet Address=test.fabrikam.com;Transport=http

此命令會刪除電腦上的 WS-Management HTTP 接聽程式。

參數

-ApplicationName

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

<傳輸>：//<伺服器>：<埠>/<ApplicationName>

例如：http://server01:8080/WSMAN

裝載會話的 Internet Information Services （IIS）會將具有此端點的要求轉送至指定的應用程式。 此 WSMAN 的預設設定適用於大部分用途。 如果許多電腦與執行 Windows PowerShell 的電腦建立遠端連線，則此參數的設計用途為 。 在此情況下，IIS 會裝載 Web Services for Management （WS-Management），以提高效率。

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

-Authentication

指定要在伺服器上使用的驗證機制。 此參數可接受的值為：

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

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

類型:	AuthenticationMechanism
別名:	auth, am
接受的值:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CertificateThumbprint

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

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

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

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

-ComputerName

指定要執行管理作業的電腦。 此值可以是完整功能變數名稱、NetBIOS 名稱或IP位址。 使用本機計算機名稱、使用localhost，或使用點 （.） 來指定本機電腦。 本機計算機是預設值。 當遠端電腦位於與使用者不同的網域時，您必須使用完整功能變數名稱。 您可以使用管線將此參數的值傳送至 Cmdlet。

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

-ConnectionURI

指定連接端點。 此字串格式如下所示：

<傳輸>：//<Server>：<埠>/<ApplicationName>

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

http://Server01:8080/WSMAN

URI 必須完整。

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

-Credential

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

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

-OptionSet

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

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

-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 包含前置詞和資源的路徑。 例如：

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

-SessionOption

指定 WS-Management 工作階段的擴充選項。 輸入您使用 New-WSManSessionOption Cmdlet 建立的 SessionOption 物件。 如您可以可用選項的詳細資訊，請輸入 Get-Help 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

輸入

None

此 Cmdlet 不接受任何輸入。

輸出

None

此 Cmdlet 不會產生任何輸出。

備註

• Windows Management Instrumentation （WMI） Cmdlet Remove-WmiObject Cmdlet 很類似。 Remove-WmiObject 會使用 DCOM 連線/傳輸層來建立或更新 WMI 實例。

相關連結

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