New-WSManInstance

Létrehoz egy új felügyeleti erőforráspéldányt.

Syntax

New-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-FilePath <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [-SelectorSet] <Hashtable>
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-ValueSet <Hashtable>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]
New-WSManInstance
   [-ConnectionURI <Uri>]
   [-FilePath <String>]
   [-OptionSet <Hashtable>]
   [-ResourceURI] <Uri>
   [-SelectorSet] <Hashtable>
   [-SessionOption <SessionOption>]
   [-ValueSet <Hashtable>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Description

Ez a parancsmag csak a Windows platformon érhető el.

A New-WSManInstance parancsmag létrehoz egy új felügyeleti erőforráspéldányt. Erőforrás-URI-t és értékkészletet vagy bemeneti fájlt használ a felügyeleti erőforrás új példányának létrehozásához.

Ez a parancsmag a WinRM kapcsolati/átviteli réteget használja a felügyeleti erőforráspéldány létrehozásához.

Példák

1. példa: HTTPS-figyelő létrehozása

Ez a parancs egy WS-Management HTTPS-figyelő egy példányát hozza létre az összes IP-címen.

New-WSManInstance winrm/config/Listener -SelectorSet @{Transport='HTTPS'; Address='*'} -ValueSet @{Hostname="HOST";CertificateThumbprint="XXXXXXXXXX"}

Paraméterek

-ApplicationName

Megadja az alkalmazás nevét a kapcsolaton belül. 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éréseket a megadott alkalmazásnak. A WSMAN ezen alapértelmezett beállítása a legtöbb használathoz megfelelő. Ez a paraméter akkor használható, ha számos számítógép létesít távoli kapcsolatot egy Windows PowerShell futó számítógéppel. Ebben az esetben az IIS a Web Services for Managementet (WS-Management) üzemelteti a hatékonyság érdekében.

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

-Authentication

Megadja a kiszolgálón használandó hitelesítési mechanizmust. Lehetséges értékek:

  • Alapszintű: Az Alapszintű egy olyan séma, amelyben a felhasználónév és a jelszó világos szövegben lesz elküldve 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 beállítás.
  • Kivonat: A Digest egy feladat-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ó kölcsönösen hitelesíti magát Kerberos-tanúsítványokkal.
  • Egyeztetés: 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 például lehetővé teszi a egyeztetést annak megállapítására, hogy a Kerberos protokollt vagy az NTLM-et használja-e a rendszer.
  • CredSSP: Használja a hitelesítő adatok biztonsági támogatási szolgáltatójának (CredSSP) hitelesítését, amely lehetővé teszi a felhasználó számára a hitelesítő adatok delegálását. 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 delegálja a felhasználó hitelesítő adatait a helyi számítógépről egy távoli számítógépre. 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.

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

Megadja a művelet végrehajtásához engedéllyel rendelkező felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509). 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.

A tanúsítvány ujjlenyomatának lekéréséhez használja a Get-ItemGet-ChildItem PowerShell Tanúsítvány: meghajtóban található parancsot.

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

-ComputerName

Meghatározza azt a számítógépet, 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 más tartományban van, mint a felhasználó, teljes tartománynevet kell használnia. Ennek a paraméternek az értékét a parancsmagba is átadhatja.

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

-ConnectionURI

Megadja a kapcsolati végpontot. A sztring formátuma:

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

A következő sztring egy megfelelően formázott érték ehhez a paraméterhez:

http://Server01:8080/WSMAN

Az URI-nak teljes mértékben minősítettnek kell lennie.

Type:Uri
Aliases:CURI, CU
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Olyan felhasználói fiókot ad meg, amely jogosult a művelet végrehajtására. 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 Get-Credential parancsmag által visszaadott objektumot. Amikor beír egy felhasználónevet, a rendszer jelszó megadását kéri.

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

-FilePath

A felügyeleti erőforrás létrehozásához használt fájl elérési útját adja meg. A felügyeleti erőforrást a ResourceURI paraméterrel és a SelectorSet paraméterrel adhatja meg. A következő parancs például a Fájl paramétert használja:

Invoke-WSManAction -Action stopservice -ResourceUri wmi/cimv2/Win32_Service -SelectorSet @{Name="spooler"} -File c:\input.xml -Authentication Default

Ez a parancs meghívja a StopService metódust a Spooler szolgáltatásban egy fájl bemenetének használatával. A fájl a Input.xmlkövetkező tartalmat tartalmazza:

<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />

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

-OptionSet

A kérés jellegének módosításához vagy finomításához kapcsolókat ad át egy szolgáltatásnak. Ezek hasonlóak a parancssori rendszerhéjakban használt kapcsolókhoz, mivel 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}

Type:Hashtable
Aliases:os
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Port

Megadja, hogy az ügyfél mikor csatlakozik a WinRM szolgáltatáshoz. Ha az átvitel HTTP, az alapértelmezett port a 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 köznapi nevének nem kell megegyeznie a kiszolgáló állomásnevével. A SkipCNCheck paraméter csak megbízható számítógépekhez használható.

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

-ResourceURI

Az erőforrásosztály vagy -példány egységes erőforrás-azonosítóját (URI) tartalmazza. 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:

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

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étert akkor használja a rendszer, ha az erőforrás egynél több példánya létezik. A SelectorSet paraméter é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"}

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

-SessionOption

A WS-Management munkamenethez tartozó kiterjesztett beállítások készletét határozza 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 lásd: New-WSManSessionOption.

Type:Microsoft.WSMan.Management.SessionOption
Aliases:so
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseSSL

Meghatározza, hogy a Secure Sockets Layer (SSL) protokollt kell használni a távoli számítógéppel való kapcsolat létrehozásához. 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 sikertelen lesz.

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

-ValueSet

Egy kivonattáblát ad meg, amely segít módosítani egy felügyeleti erőforrást. A felügyeleti erőforrást a ResourceURI és a SelectorSet paraméter használatával adhatja meg. A ValueSet paraméter értékének kivonattáblának kell lennie.

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

Bevitelek

None

Ez a parancsmag nem fogad bemenetet.

Kimenetek

None

Ez a parancsmag nem hoz létre kimenetet.

Jegyzetek

A Set-WmiInstance parancsmag, a Windows Management Instrumentation (WMI) parancsmag hasonló. Set-WmiInstance A a DCOM kapcsolati/átviteli réteget használja WMI-példányok létrehozásához vagy frissítéséhez.