Test-WSMan
Ellenőrzi, hogy a WinRM szolgáltatás helyi vagy távoli számítógépen fut-e.
Syntax
Test-WSMan
[[-ComputerName] <String>]
[-Authentication <AuthenticationMechanism>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-Credential <PSCredential>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Description
Ez a parancsmag csak a Windows platformon érhető el.
A Test-WSMan
parancsmag egy azonosító kérést küld, amely meghatározza, hogy a WinRM szolgáltatás helyi vagy távoli számítógépen fut-e. Ha a tesztelt számítógép futtatja a szolgáltatást, a parancsmag megjeleníti a WS-Management identitássémát, a protokoll verzióját, a termék gyártóját és a tesztelt szolgáltatás termékverzióját.
Példák
1. példa: A WinRM szolgáltatás állapotának meghatározása
Test-WSMan
Ez a parancs határozza meg, hogy a WinRM szolgáltatás a helyi számítógépen vagy egy távoli számítógépen fut-e.
2. példa: A WinRM szolgáltatás állapotának meghatározása távoli számítógépen
Test-WSMan -ComputerName "server01"
Ez a parancs határozza meg, hogy a WinRM szolgáltatás fut-e a server01 számítógépen.
3. példa: A WinRM szolgáltatás állapotának és az operációs rendszer verziójának meghatározása
Test-WSMan -Authentication default
Ez a parancs ellenőrzi, hogy a WS-Management (WinRM) szolgáltatás fut-e a helyi számítógépen a hitelesítési paraméter használatával.
A hitelesítési paraméter Test-WSMan
használatával visszaadhatja az operációs rendszer verzióját.
4. példa: A WinRM szolgáltatás és az operációs rendszer verziójának meghatározása távoli számítógépen
Test-WSMan -ComputerName "server01" -Authentication default
Ez a parancs ellenőrzi, hogy a WS-Management (WinRM) szolgáltatás fut-e a server01 nevű számítógépen a hitelesítési paraméter használatával.
A hitelesítési paraméter Test-WSMan
használatával visszaadhatja az operációs rendszer verzióját.
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:
<Transport>://<Server>:<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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Authentication
Megadja a kiszolgálón használandó hitelesítési mechanizmust. A paraméter elfogadható értékei a következők:
Basic
- Az alapszintű séma 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.Default
- Használja a WS-Management protokoll által implementált hitelesítési módszert. Ez az alapértelmezett beállítás.- 1 – A kivonatolás 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.Negotiate
– 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
– Hitelesítőadat-biztonsági támogatási szolgáltató (CredSSP) hitelesítés használata, amellyel a felhasználó hitelesítő adatokat delegálhat. 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.
Figyelemfelhívás
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.
Fontos
Ha nem adja meg a hitelesítési paramétert, a Test-WSMan
rendszer névtelenül, hitelesítés nélkül küldi el a kérést a távoli számítógépre. Ha a kérés névtelenül történik, az nem ad vissza olyan információt, amely az operációs rendszer verziójára vonatkozik. Ez a parancsmag ehelyett null értékeket jelenít meg az operációs rendszer verziójának és szervizcsomagjának szintjén (operációs rendszer: 0.0.0 SP: 0.0).
Type: | AuthenticationMechanism |
Aliases: | auth, am |
Accepted values: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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ón található Get-Item vagy Get-ChildItem
parancsot.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 localhostot, 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.
Type: | String |
Aliases: | cn |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Alapértelmezés szerint az aktuális felhasználó. Írjon be egy felhasználónevet, például User01, Domain01\User01 vagy User@Domain.com. Vagy írjon be egy PSCredential objektumot, például a parancsmag által Get-Credential
visszaadott objektumot. Felhasználónév beírásakor ez a parancsmag jelszó megadását kéri.
Type: | PSCredential |
Aliases: | cred, c |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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).
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
A WS-Management a hálózaton keresztül továbbított összes Windows PowerShell-tartalmat titkosítja. 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
Alapértelmezés szerint a Test-WSMan
parancsmag hitelesítés nélkül lekérdezi a WinRM szolgáltatást, és nem ad vissza olyan információt, amely az operációs rendszer verziójára vonatkozik. Ehelyett null értékeket jelenít meg az operációs rendszer verziójának és szervizcsomagjának szintjén (operációs rendszer: 0.0.0 SP: 0.0).
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: