Remove-WSManInstance
Odstraní instanci prostředku správy.
Syntaxe
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
Rutina Remove-WSManInstance odstraní instanci prostředku pro správu, který je zadaný v parametrech ResourceURI a SelectorSet .
Tato rutina používá k odstranění instance prostředku pro správu vrstvu přenosu připojení 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í naslouchací proces HTTP služby WS-Management 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 do zadané aplikace. Toto výchozí nastavení WSMAN je vhodné pro většinu použití. Tento parametr je navržený tak, aby se používal, pokud mnoho počítačů navazuje vzdálená připojení k jednomu počítači, na kterém běží Windows PowerShell. V tomto případě služba IIS hostuje webové služby pro správu (WS-Management) kvůli efektivitě.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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í na server nebo proxy server ve formátu prostého textu.Default– Použijte metodu ověřování implementovanou protokolem WS-Management. Tato možnost je výchozí.Digest- Digest je schéma odpovědí na výzvu, 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 odezvy výzvy, které vyjednává se serverem nebo proxy serverem k určení schématu, které se má použít k ověřování. Tato hodnota parametru například umožňuje vyjednávání zjistit, jestli se používá protokol Kerberos nebo NTLM.CredSSP– Použijte ověřování zprostředkovatele podpory zabezpečení přihlašovacích údajů (CredSSP), které umožňuje delegování přihlašovacích údajů uživatele. 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 riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, lze při předání přihlašovacích údajů použít k řízení síťové relace.
| Typ: | AuthenticationMechanism |
| Aliasy: | auth, am |
| Přípustné hodnoty: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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ů. Je možné je mapovat pouze na místní uživatelské účty. Certifikáty nefungují s účty domény.
Pokud chcete získat kryptografický otisk certifikátu, použijte příkaz nebo Get-ChildItem ho Get-Item použijte na jednotce PowerShelluCert:.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ComputerName
Určuje počítač, pro který má být spuštěna operace správy. Hodnota 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, použijte localhost nebo použijte 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. Do rutiny můžete zadat hodnotu tohoto parametru.
| Typ: | String |
| Aliasy: | cn |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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ě naformátovaná hodnota pro tento parametr:
http://Server01:8080/WSMAN
Identifikátor URI musí být plně kvalifikovaný.
| Typ: | Uri |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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.
| Typ: | PSCredential |
| Aliasy: | cred, c |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-OptionSet
Určuje sadu přepínačů do služby, která upraví nebo upřesní povahu požadavku. Tyto přepínače se podobají přepínačům používaným v prostředích příkazového řádku, protože jsou specifické pro službu. Můžete 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}
| Typ: | Hashtable |
| Aliasy: | os |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Port
Určuje port, který se má použít, když se klient připojí ke službě WinRM. Pokud je přenos HTTP, výchozí port je 80. Když je přenos HTTPS, výchozí port je 443.
Při použití PROTOKOLU HTTPS jako přenosu musí hodnota parametru ComputerName odpovídat běžnému názvu certifikátu serveru (CN). Pokud je však parametr SkipCNCheck zadán jako součást parametru SessionOption , běžný název certifikátu serveru se nemusí shodovat s názvem hostitele serveru. Parametr SkipCNCheck by se měl používat jenom pro důvěryhodné počítače.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ResourceURI
Určuje identifikátor URI třídy prostředků nebo instance. 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 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
| Typ: | Uri |
| Aliasy: | ruri |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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 instancí prostředku. Hodnota SelectorSet musí být tabulka hash.
Následující příklad ukazuje, jak zadat hodnotu pro tento parametr:
-SelectorSet @{Name="WinRM";ID="yyy"}
| Typ: | Hashtable |
| Position: | 1 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-SessionOption
Určuje rozšířené možnosti pro relaci WS-Management. Zadejte objekt SessionOption, který vytvoříte pomocí rutiny New-WSManSessionOption. Další informace o možnostech, které jsou k dispozici, zadejte Get-Help New-WSManSessionOption.
| Typ: | SessionOption |
| Aliasy: | so |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-UseSSL
Určuje, že protokol SSL (Secure Sockets Layer) slouží k navázání připojení ke vzdálenému počítači. Ve výchozím nastavení se ssl nepoužívá.
WS-Management šifruje veškerý obsah Windows PowerShellu přenášený přes síť. Parametr UseSSL umožňuje zadat další ochranu HTTPS místo protokolu HTTP. Pokud protokol SSL není k dispozici na portu, který se používá pro připojení, a zadáte tento parametr, příkaz selže.
| Typ: | SwitchParameter |
| Aliasy: | ssl |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
None
Do této rutiny nemůžete roušit objekty.
Výstupy
None
Tato rutina nevrátí žádný výstup.
Poznámky
Rutiny v modulu CimCmdlets jsou podobné. K vytvoření nebo aktualizaci instancí rozhraní WMI používají vrstvu připojení/přenosu DCOM.
