Remove-WSManInstance
Egy felügyeleti erőforráspéldány törlése.
Syntax
ComputerName (Alapértelmezett)
Remove-WSManInstance
[-ResourceURI] <Uri>
[-SelectorSet] <Hashtable>
[-ApplicationName <String>]
[-ComputerName <String>]
[-OptionSet <Hashtable>]
[-Port <Int32>]
[-SessionOption <SessionOption>]
[-UseSSL]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
URI
Remove-WSManInstance
[-ResourceURI] <Uri>
[-SelectorSet] <Hashtable>
[-ConnectionURI <Uri>]
[-OptionSet <Hashtable>]
[-SessionOption <SessionOption>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Description
A Remove-WSManInstance parancsmag törli a ResourceURI és SelectorSet paraméterekben megadott felügyeleti erőforrás egy példányát.
Ez a parancsmag a WinRM kapcsolati/átviteli réteget használja a felügyeleti erőforráspéldány törléséhez.
Példák
1. példa: Figyelő törlése
PS C:\> Remove-WSManInstance -ResourceUri winrm/config/Listener -SelectorSet Address=test.fabrikam.com;Transport=http
Ez a parancs törli a WS-Management HTTP-figyelőt a számítógépen.
Paraméterek
-ApplicationName
Megadja az alkalmazás nevét a kapcsolatban. Az ApplicationName paraméter alapértelmezett értéke a WSMAN. A távoli végpont teljes azonosítója a következő formátumban van:
<átviteli>://<kiszolgáló>:<port>/<ApplicationName>
Például: http://server01:8080/WSMAN
A munkamenetet üzemeltető Internet Information Services (IIS) továbbítja a végponttal kapcsolatos kérelmeket a megadott alkalmazásnak. A WSMAN alapértelmezett beállítása a legtöbb használathoz megfelelő. Ez a paraméter akkor használható, ha sok számítógép létesít távoli kapcsolatot egy Windows PowerShellt futtató számítógéppel. Ebben az esetben az IIS a Web Services for Management (WS-Management) szolgáltatást üzemelteti a hatékonyság érdekében.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | Wsman |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerName
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Authentication
Megadja a kiszolgálón használandó hitelesítési mechanizmust. A paraméter elfogadható értékei a következők:
- Alapvető. Az Alapszintű séma egy olyan séma, amelyben a rendszer a felhasználónevet és a jelszót világos szövegben küldi el a kiszolgálónak vagy a proxynak.
- Alapértelmezett. Használja a WS-Management protokoll által implementált hitelesítési módszert. Ez az alapértelmezett érték.
- Emészt. A Digest egy kihívás-válasz séma, amely egy kiszolgáló által megadott adatsztringet használ a feladathoz.
- Kerberos. Az ügyfélszámítógép és a kiszolgáló Kerberos-tanúsítványokkal kölcsönösen hitelesítik egymást.
- Tárgyal. Az egyeztetés egy kihívás-válasz séma, amely egyeztet a kiszolgálóval vagy a proxyval a hitelesítéshez használni kívánt séma meghatározásához. Ez a paraméterérték lehetővé teszi például, hogy a tárgyalások meghatározzák, hogy a Kerberos-protokoll vagy az NTLM van-e használatban.
- CredSSP. Használjon hitelesítőadat-biztonsági támogatási szolgáltatót (CredSSP) hitelesítést, amely lehetővé teszi, hogy a felhasználó hitelesítő adatokat delegáljon. Ez a beállítás olyan parancsokhoz készült, amelyek egy távoli számítógépen futnak, de adatokat gyűjtenek más távoli számítógépekről, vagy további parancsokat futtatnak.
Figyelem: A CredSSP a helyi számítógépről egy távoli számítógépre delegálja a felhasználói hitelesítő adatokat. Ez a gyakorlat növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a hitelesítő adatok átadásakor a hitelesítő adatokkal szabályozható a hálózati munkamenet.
Paramétertulajdonságok
| Típus: | AuthenticationMechanism |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | autentikáció, de |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-CertificateThumbprint
Egy olyan felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509) adja meg, amely jogosult a művelet végrehajtására. Adja meg a tanúsítvány ujjlenyomatát.
A tanúsítványok az ügyféltanúsítvány-alapú hitelesítésben használatosak. Ezek csak helyi felhasználói fiókokra képezhetők le; nem működnek tartományi fiókokkal.
Tanúsítvány ujjlenyomatának lekéréséhez használja a Windows PowerShell Cert: meghajtó Get-Item vagy Get-ChildItem parancsát.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ComputerName
Azt a számítógépet adja meg, amelyen futtatni szeretné a felügyeleti műveletet. Az érték lehet teljes tartománynév, NetBIOS-név vagy IP-cím. Használja a helyi számítógép nevét, használja a localhost parancsot, vagy használjon egy pont (.) értéket a helyi számítógép megadásához. A helyi számítógép az alapértelmezett. Ha a távoli számítógép a felhasználótól eltérő tartományban van, teljes tartománynevet kell használnia. Ennek a paraméternek az értékét a parancsmagba is be lehet csövezni.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | Localhost |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Kína |
Paraméterkészletek
ComputerName
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ConnectionURI
Megadja a kapcsolati végpontot. A sztring formátuma a következő:
<Transport>://<Server>:<Port>/<ApplicationName>
A következő sztring a paraméter helyesen formázott értéke:
http://Server01:8080/WSMAN
Az URI-nak teljes mértékben minősítettnek kell lennie.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
URI
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó. Írjon be egy felhasználónevet, például User01, Domain01\User01 vagy User@Domain.com. Vagy adjon meg egy PSCredential objektumot, például a Get-Credential parancsmag által visszaadott objektumot. Felhasználónév beírásakor ez a parancsmag jelszó megadását kéri.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | cred, c |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-OptionSet
A kérés jellegének módosításához vagy pontosításához szolgáltatásra való váltások készletét adja meg. Ezek hasonlítanak a parancssori rendszerhéjakban használt kapcsolókra, mert szolgáltatásspecifikusak. Tetszőleges számú beállítás adható meg.
Az alábbi példa azt a szintaxist mutatja be, amely az a, b és c paraméterek 1, 2 és 3 értékeit adja át:
-OptionSet @{a=1;b=2;c=3}
Paramétertulajdonságok
| Típus: | Hashtable |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | OS |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Port
Megadja azt a portot, amelyet az ügyfél a WinRM szolgáltatáshoz való csatlakozáskor használ. Ha az átvitel HTTP, az alapértelmezett port 80. Ha az átvitel HTTPS, az alapértelmezett port a 443.
Ha HTTPS-t használ átvitelként, a ComputerName paraméter értékének meg kell egyeznie a kiszolgáló tanúsítványának köznapi nevével (CN). Ha azonban a SkipCNCheck paraméter a SessionOption paraméter részeként van megadva, a kiszolgáló tanúsítványának nem kell megegyeznie a kiszolgáló gazdagépnevével. A SkipCNCheck paraméter csak megbízható számítógépekhez használható.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ComputerName
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-ResourceURI
Az erőforrásosztály vagy -példány URI-ját adja meg. Az URI egy adott típusú erőforrás, például lemezek vagy folyamatok azonosítására szolgál a számítógépen.
Az URI egy előtagból és egy erőforrás elérési útból áll. Például:
https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | ruri |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-SelectorSet
Az adott felügyeleti erőforráspéldányok kiválasztásához használt értékpárok készletét adja meg. A SelectorSet paraméter akkor használatos, ha az erőforrás több példánya is létezik. A SelectorSet értékének kivonattáblának kell lennie.
Az alábbi példa bemutatja, hogyan adhat meg értéket ehhez a paraméterhez:
-SelectorSet @{Name="WinRM";ID="yyy"}
Paramétertulajdonságok
| Típus: | Hashtable |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-SessionOption
A WS-Management munkamenet kiterjesztett beállításait adja meg.
Adjon meg egy SessionOption objektumot, amelyet a New-WSManSessionOption parancsmaggal hoz létre.
Az elérhető beállításokkal kapcsolatos további információkért írja be a Get-Help New-WSManSessionOption.
Paramétertulajdonságok
| Típus: | SessionOption |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | so |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-UseSSL
Megadja, hogy a secure Sockets Layer (SSL) protokoll használatával létesítsen kapcsolatot a távoli számítógéppel. Alapértelmezés szerint az SSL nem használatos.
WS-Management titkosítja a hálózaton keresztül továbbított összes Windows PowerShell-tartalmat. A UseSSL paraméterrel a HTTP helyett a HTTPS további védelmét adhatja meg. Ha az SSL nem érhető el a kapcsolathoz használt porton, és ezt a paramétert adja meg, a parancs meghiúsul.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | SSL |
Paraméterkészletek
ComputerName
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Ez a parancsmag semmilyen bemenetet nem fogad el.
Kimenetek
None
Ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
A Remove-WmiObject parancsmag, a Windows Management Instrumentation (WMI) parancsmag hasonló. Remove-WmiObject a DCOM kapcsolati/átviteli réteget használja WMI-példányok létrehozásához vagy frissítéséhez.