Remove-WSManInstance

Modul:

Microsoft.WSMan.Management

Odstraní instanci prostředku správy.

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

Tato rutina je dostupná jenom na platformě Windows.

Rutina Remove-WSManInstance odstraní instanci prostředku správy, která je určená v parametrech ResourceURI a SelectorSet .

Tato rutina používá k odstranění instance prostředku správy vrstvu připojení nebo přenosu WinRM.

Příklady

Příklad 1: Odstranění naslouchacího procesu

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

Tento příkaz odstraní WS-Management naslouchací proces HTTP v počítači.

Parametry

-ApplicationName

Určuje název aplikace v připojení. Výchozí hodnota parametru ApplicationName je WSMAN. Úplný identifikátor vzdáleného koncového bodu je v následujícím formátu:

<Transport>://<Server>:<Port>/<ApplicationName>

Příklad: http://server01:8080/WSMAN

Internetová informační služba (IIS), která hostuje relaci, předává požadavky s tímto koncovým bodem zadané aplikaci. Toto výchozí nastavení WSMAN je vhodné pro většinu použití. Tento parametr je určen k použití, pokud mnoho počítačů naváže vzdálené připojení k jednomu počítači se systémem Windows PowerShell. V tomto případě služba IIS kvůli efektivitě hostuje webové služby pro správu (WS-Management).

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

-Authentication

Určuje mechanismus ověřování, který se má použít na serveru. Tento parametr přijímá tyto hodnoty:

• Basic – Základní je schéma, ve kterém se uživatelské jméno a heslo odesílají jako prostý text na server nebo proxy server.
• Default – Použijte metodu ověřování implementovanou protokolem WS-Management. Tato možnost je výchozí.
• Digest – Digest je schéma výzvy a odpovědi, které pro výzvu používá datový řetězec zadaný serverem.
• Kerberos – Klientský počítač a server se vzájemně ověřují pomocí certifikátů Kerberos.
• Negotiate - Negotiate je schéma výzvy a odpovědi, které vyjednává se serverem nebo proxy serverem o určení schématu, které se má použít pro ověřování. Tato hodnota parametru například umožňuje vyjednávání k určení, jestli se používá protokol Kerberos nebo NTLM.
• CredSSP – Použijte ověřování CredSSP (Credential Security Support Provider), které uživateli umožňuje delegovat přihlašovací údaje. Tato možnost je určená pro příkazy, které běží na jednom vzdáleném počítači, ale shromažďují data z jiných vzdálených počítačů nebo spouštějí další příkazy.

Upozornění

CredSSP deleguje přihlašovací údaje uživatele z místního počítače na vzdálený počítač. Tento postup zvyšuje bezpečnostní riziko vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače a jsou mu předány přihlašovací údaje, mohou být přihlašovací údaje použity k řízení síťové relace.

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

Určuje certifikát digitálního veřejného klíče (X509) uživatelského účtu, který má oprávnění k provedení této akce. Zadejte kryptografický otisk certifikátu.

Certifikáty se používají při ověřování na základě klientských certifikátů. Mohou být mapovány pouze na místní uživatelské účty; nefungují s doménovými účty.

Kryptografický otisk certifikátu získáte pomocí příkazu Get-Item nebo Get-ChildItem na jednotce Windows PowerShell Cert: .

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

-ComputerName

Určuje počítač, na kterém se má operace správy spustit. Hodnotou může být plně kvalifikovaný název domény, název NetBIOS nebo IP adresa. Použijte název místního počítače, localhost nebo tečku (.) k určení místního počítače. Místní počítač je výchozí. Pokud je vzdálený počítač v jiné doméně než uživatel, musíte použít plně kvalifikovaný název domény. Hodnotu tohoto parametru můžete předvést do rutiny .

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

-ConnectionURI

Určuje koncový bod připojení. Formát tohoto řetězce je následující:

<Transport>://<Server>:<Port>/<ApplicationName>

Následující řetězec je správně formátovaná hodnota pro tento parametr:

http://Server01:8080/WSMAN

Identifikátor URI musí být plně kvalifikovaný.

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

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Ve výchozím nastavení je to aktuální uživatel. Zadejte uživatelské jméno, například User01, Domain01\User01nebo User@Domain.com. Nebo zadejte objekt PSCredential , například objekt vrácený rutinou Get-Credential . Když zadáte uživatelské jméno, tato rutina vás vyzve k zadání hesla.

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

-OptionSet

Určuje sadu přepínačů do služby pro úpravu nebo upřesnění povahy požadavku. Ty se podobají přepínačům používaným v prostředích příkazového řádku, protože jsou specifické pro službu. Je možné zadat libovolný počet možností.

Následující příklad ukazuje syntaxi, která předává hodnoty 1, 2 a 3 pro parametry a, b a c:

-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

Určuje port, který se má použít při připojení klienta ke službě WinRM. Pokud je přenos http, výchozí port je 80. Pokud je přenos HTTPS, výchozí port je 443.

Pokud jako přenos použijete HTTPS, hodnota parametru ComputerName musí odpovídat běžnému názvu certifikátu serveru. Pokud je však parametr SkipCNCheck zadán jako součást parametru SessionOption , nemusí se běžný název certifikátu serveru shodovat s názvem hostitele serveru. Parametr SkipCNCheck by měl být použit pouze pro důvěryhodné počítače.

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

-ResourceURI

Určuje identifikátor URI instance nebo třídy prostředků. Identifikátor URI slouží k identifikaci konkrétního typu prostředku, jako jsou disky nebo procesy, v počítači.

Identifikátor URI se skládá z předpony a cesty k prostředku. Příklad:

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

Určuje sadu párů hodnot, které se používají k výběru konkrétních instancí prostředků správy. Parametr SelectorSet se používá, pokud existuje více než jedna instance prostředku. Hodnota SelectorSet musí být hashovací tabulka.

Následující příklad ukazuje, jak zadat hodnotu pro tento parametr:

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

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

-SessionOption

Určuje rozšířené možnosti pro relaci WS-Management. Zadejte objekt SessionOption , který vytvoříte pomocí rutiny New-WSManSessionOption. Pokud chcete získat další informace o dostupných možnostech, zadejte 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

Určuje, že se k navázání připojení ke vzdálenému počítači použije protokol SSL (Secure Sockets Layer). Ve výchozím nastavení se protokol SSL nepoužívá.

WS-Management šifruje veškerý Windows PowerShell obsah přenášený přes síť. Parametr UseSSL umožňuje zadat dodatečnou ochranu HTTPS místo HTTP. Pokud na portu, který se používá pro připojení, není k dispozici protokol SSL a zadáte tento parametr, příkaz se nezdaří.

Type:	SwitchParameter
Aliases:	ssl
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

None

Objekty nelze do této rutiny převést.

Výstupy

None

Tato rutina nevrací žádný výstup.

Poznámky

Rutiny v modulu CimCmdlets jsou podobné. K vytvoření nebo aktualizaci instancí rozhraní WMI používají vrstvu připojení nebo přenosu DCOM.

Související odkazy

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