Remove-WSManInstance

刪除管理資源執行個體。

Syntax

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

Cmdlet 會 Remove-WSManInstance 刪除 ResourceURISelectorSet 參數中指定的管理資源實例。

此 Cmdlet 會使用 WinRM 連線/傳輸層來刪除管理資源執行個體。

範例

範例 1:刪除接聽程式

Remove-WSManInstance -ResourceUri winrm/config/Listener -SelectorSet Address=test.fabrikam.com;Transport=http

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

參數

-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:None
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:Microsoft.WSMan.Management.AuthenticationMechanism
Aliases:auth, am
Accepted values:None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CertificateThumbprint

對於具有執行此動作之權限的使用者帳戶,指定其數位公開金鑰憑證 (X509)。 請輸入憑證的憑證指紋。

憑證將用於用戶端憑證式驗證。 這些憑證只能對應至本機使用者帳戶,無法用於網域帳戶。

若要取得憑證指紋,請在 Windows PowerShell Cert: 磁碟機中使用 Get-Item 或 Get-ChildItem 命令。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

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

Type:String
Aliases:cn
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

Type:PSCredential
Aliases:cred, c
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-OptionSet

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

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

-OptionSet @{a=1;b=2;c=3}

Type:Hashtable
Aliases:os
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False

-SelectorSet

指定一組值組,用來選取特定管理資源執行個體。 當資源有多個實例存在時,就會使用 SelectorSet 參數。 SelectorSet的值必須是雜湊表。

下列範例顯示如何輸入此參數的值:

-SelectorSet @{Name="WinRM";ID="yyy"}

Type:Hashtable
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-SessionOption

指定 WS-Management 工作階段的擴充選項。 輸入您使用 New-WSManSessionOption Cmdlet 建立的 SessionOption 物件。 如需可用選項的詳細資訊,請輸入 Get-Help New-WSManSessionOption

Type:Microsoft.WSMan.Management.SessionOption
Aliases:so
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

輸入

None

此 Cmdlet 不接受任何輸入。

輸出

None

此 Cmdlet 不會產生任何輸出。

備註

CimCmdlets 模組中的 Cmdlet 類似。 他們會使用 DCOM 連線/傳輸層來建立或更新 WMI 實例。