Import-PSSession
Parancsokat importál egy másik munkamenetből az aktuális munkamenetbe.
Syntax
Default (Alapértelmezett)
Import-PSSession
[-Prefix <String>]
[-DisableNameChecking]
[[-CommandName] <String[]>]
[-AllowClobber]
[-ArgumentList <Object[]>]
[-CommandType <CommandTypes>]
[-Module <String[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[[-FormatTypeName] <String[]>]
[-Certificate <X509Certificate2>]
[-Session] <PSSession>
[<CommonParameters>]
Description
A Import-PSSession parancsmag parancsokat , például parancsmagokat, függvényeket és aliasokat importál egy helyi vagy távoli számítógép PSSession rendszeréből az aktuális munkamenetbe. Importálhat minden olyan parancsot, amelyet a Get-Command parancsmag a PSSessionban talál.
Az Import-PSSession parancsokkal parancsokat importálhat testre szabott rendszerhéjból, például Microsoft Exchange Server-rendszerhéjból, vagy olyan munkamenetből, amely windowsos PowerShell-modulokat és beépülő modulokat vagy más, az aktuális munkamenetben nem szereplő elemeket tartalmaz.
Parancsok importálásához először használja a New-PSSession parancsmagot PSSession létrehozásához. Ezután a parancsok importálásához használja a Import-PSSession parancsmagot. Alapértelmezés szerint Import-PSSession az összes parancsot importálja, kivéve azokat a parancsokat, amelyek neve megegyezik az aktuális munkamenet parancsaival. Az összes parancs importálásához használja az AllowClobber paramétert.
Az importált parancsokat ugyanúgy használhatja, mint a munkamenet bármely parancsát. Importált parancs használatakor a parancs importált része implicit módon fut abban a munkamenetben, amelyből importálták. A távoli műveleteket azonban teljes egészében a Windows PowerShell kezeli. Ezekről még csak nem is kell tudnia, kivéve, hogy nyitva kell tartania a kapcsolatot a másik munkamenethez (PSSession). Ha bezárja, az importált parancsok már nem érhetők el.
Mivel az importált parancsok futtatása hosszabb időt vehet igénybe, mint a helyi parancsok, Import-PSSession minden importált parancshoz hozzáad egy AsJob paramétert. Ez a paraméter lehetővé teszi a parancs Windows PowerShell-háttérfeladatként való futtatását. További információért lásd about_Jobs.
A Import-PSSessionhasználatakor a Windows PowerShell hozzáadja az importált parancsokat egy ideiglenes modulhoz, amely csak a munkamenetben létezik, és visszaad egy, a modult jelképező objektumot. A jövőbeli munkamenetekben használható állandó modul létrehozásához használja a Export-PSSession parancsmagot.
A Import-PSSession parancsmag a Windows PowerShell implicit újraküldési funkcióját használja. Amikor parancsokat importál az aktuális munkamenetbe, azok implicit módon futnak az eredeti munkamenetben vagy egy hasonló munkamenetben az eredeti számítógépen.
A Windows PowerShell 3.0-tól kezdve a Import-Module parancsmaggal importálhat modulokat egy távoli munkamenetből az aktuális munkamenetbe. Ez a funkció implicit újraegyezést használ. Egyenértékű a Import-PSSession használatával, ha a kiválasztott modulokat távoli munkamenetből importálja az aktuális munkamenetbe.
Példák
1. példa: Az összes parancs importálása PSSession-ből
$S = New-PSSession -ComputerName Server01
Import-PSSession -Session $S
Ez a parancs importálja az összes parancsot a Server01 számítógép psSession rendszeréből az aktuális munkamenetbe, kivéve azokat a parancsokat, amelyek neve megegyezik az aktuális munkamenet parancsaival.
Mivel ez a parancs nem használja a CommandName paramétert, az importált parancsokhoz szükséges összes formázási adatot is importálja.
2. példa: Adott sztringgel végződő parancsok importálása
$S = New-PSSession https://ps.testlabs.com/powershell
Import-PSSession -Session $S -CommandName *-test -FormatTypeName *
New-Test -Name Test1
Get-Test test1 | Run-Test
Ezek a parancsok a PSSession-ből a helyi munkamenetbe importálják a "-test" végződésű parancsokat, majd bemutatják az importált parancsmagok használatát.
Az első parancs a New-PSSession parancsmaggal hoz létre PSSessiont. Menti a PSSessiont a $S változóban.
A második parancs a Import-PSSession parancsmaggal importálja a parancsokat a PSSession-ből az $S az aktuális munkamenetbe. A CommandName paraméterrel adja meg a Teszt főnévvel és a FormatTypeName paraméterrel rendelkező parancsokat a tesztelési parancsok formázási adatainak importálásához.
A harmadik és negyedik parancs az importált parancsokat használja az aktuális munkamenetben. Mivel az importált parancsok ténylegesen hozzáadva vannak az aktuális munkamenethez, a helyi szintaxis használatával futtathatja őket. Importált parancs futtatásához nem kell a Invoke-Command parancsmagot használnia.
3. példa: Parancsmagok importálása PSSession-ből
$S1 = New-PSSession -ComputerName s1
$S2 = New-PSSession -ComputerName s2
Import-PSSession -Session s1 -Type cmdlet -Name New-Test, Get-Test -FormatTypeName *
Import-PSSession -Session s2 -Type Cmdlet -Name Set-Test -FormatTypeName *
New-Test Test1 | Set-Test -RunType Full
Ez a példa azt mutatja be, hogy ugyanúgy használhat importált parancsmagokat, mint a helyi parancsmagokat.
Ezek a parancsok importálják a New-Test és Get-Test parancsmagokat a Server01 számítógép PSSession rendszeréből, valamint a Set-Test parancsmagot a Server02 számítógépen lévő PSSession parancsmagból.
Annak ellenére, hogy a parancsmagok különböző PSSessions-ból lettek importálva, hiba nélkül átcsíphet egy objektumot az egyik parancsmagból a másikba.
4. példa: Importált parancs futtatása háttérfeladatként
$S = New-PSSession -ComputerName Server01
Import-PSSession -Session $S -CommandName *-test* -FormatTypeName *
$batch = New-Test -Name Batch -AsJob
Receive-Job $batch
Ez a példa bemutatja, hogyan futtathat egy importált parancsot háttérfeladatként.
Mivel az importált parancsok futtatása hosszabb időt vehet igénybe, mint a helyi parancsok, Import-PSSession minden importált parancshoz hozzáad egy AsJob paramétert. Az AsJob paraméterrel háttérfeladatként futtathatja a parancsot.
Az első parancs létrehoz egy PSSession-t a Server01 számítógépen, és menti a PSSession objektumot a $S változóba.
A második parancs Import-PSSession használatával importálja a tesztelési parancsmagokat a PSSessionból az $S az aktuális munkamenetbe.
A harmadik parancs az importált parancsmag New-Test paraméterét használja egy New-Test parancs háttérfeladatként való futtatásához. A parancs menti a New-Test visszaadott feladatobjektumot a $batch változóban.
A negyedik parancs a Receive-Job parancsmagot használja a feladat eredményeinek lekéréséhez a $batch változóban.
5. példa: Parancsmagok és függvények importálása Windows PowerShell-modulból
$S = New-PSSession -ComputerName Server01
Invoke-Command -Session $S {Import-Module TestManagement}
Import-PSSession -Session $S -Module TestManagement
Ez a példa bemutatja, hogyan importálhatja a parancsmagokat és függvényeket egy távoli számítógépen lévő Windows PowerShell-modulból az aktuális munkamenetbe.
Az első parancs létrehoz egy PSSession-t a Server01 számítógépen, és menti azt a $S változóba.
A második parancs a Invoke-Command parancsmaggal futtat egy Import-Module parancsot a PSSessionban $S.
A modult általában egy windowsos PowerShell-profil Import-Module parancsa egészítené ki az összes munkamenethez, de a profilok nem PSSessions-ban futnak.
A harmadik parancs a Import-PSSession paraméterével importálja a modul parancsmagjait és függvényeit az aktuális munkamenetbe.
6. példa: Modul létrehozása ideiglenes fájlban
PS C:\> Import-PSSession $S -CommandName Get-Date, SearchHelp -FormatTypeName * -AllowClobber
Name : tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf
Path : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1
zunz.ttf\tmp_79468106-4e1d-4d90-af97-1154f9317239_
tcw1zunz.ttf.psm1
Description : Implicit remoting for http://server01.corp.fabrikam.com/wsman
Guid : 79468106-4e1d-4d90-af97-1154f9317239
Version : 1.0
ModuleBase : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1
zunz.ttf
ModuleType : Script
PrivateData : {ImplicitRemoting}
AccessMode : ReadWrite
ExportedAliases : {}
ExportedCmdlets : {}
ExportedFunctions : {[Get-Date, Get-Date], [SearchHelp, SearchHelp]}
ExportedVariables : {}
NestedModules : {}
Ez a példa azt mutatja be, hogy Import-PSSession létrehoz egy modult egy ideiglenes fájlban a lemezen. Azt is megmutatja, hogy az összes parancsot függvényekké konvertálja a rendszer, mielőtt importálná őket az aktuális munkamenetbe.
A parancs a Import-PSSession parancsmaggal importál egy Get-Date parancsmagot és egy SearchHelp függvényt az aktuális munkamenetbe.
A Import-PSSession parancsmag egy PSModuleInfo objektumot ad vissza, amely az ideiglenes modult jelöli. A Path tulajdonság értéke azt mutatja, hogy Import-PSSession egy szkriptmodul -fájlt (.psm1) hozott létre ideiglenes helyen. Az ExportedFunctions tulajdonság azt mutatja, hogy a Get-Date parancsmag és a SearchHelp függvény egyaránt függvényként lett importálva.
7. példa: Importált parancs által rejtett parancs futtatása
PS C:\> Import-PSSession $S -CommandName Get-Date -FormatTypeName * -AllowClobber
PS C:\> Get-Command Get-Date -All
CommandType Name Definition
----------- ---- ----------
Function Get-Date ...
Cmdlet Get-Date Get-Date [[-Date] <DateTime>] [-Year <Int32>] [-Month <Int32>]
PS C:\> Get-Date
09074
PS C:\> (Get-Command -Type Cmdlet -Name Get-Date).PSSnapin.Name
Microsoft.PowerShell.Utility
PS C:\> Microsoft.PowerShell.Utility\Get-Date
Sunday, March 15, 2009 2:08:26 PM
Ez a példa bemutatja, hogyan futtathat egy importált parancs által rejtett parancsot.
Az első parancs importál egy Get-Date parancsmagot a PSSession függvényből a $S változóban. Mivel az aktuális munkamenet tartalmaz egy Get-Date parancsmagot, a parancsban szükség van az AllowClobber paraméterre.
A második parancs a parancsmag Get-Command paraméterét használja az aktuális munkamenet összes Get-Date parancsának lekéréséhez. A kimenet azt mutatja, hogy a munkamenet tartalmazza az eredeti Get-Date parancsmagot és egy Get-Date függvényt. A Get-Date függvény az importált Get-Date parancsmagot futtatja a PSSession fájlban $S.
A harmadik parancs egy Get-Date parancsot futtat. Mivel a függvények elsőbbséget élveznek a parancsmagokkal szemben, a Windows PowerShell az importált Get-Date függvényt futtatja, amely egy Julián-dátumot ad vissza.
A negyedik és ötödik parancs bemutatja, hogyan futtathat egy importált parancs által rejtett parancsot minősített névvel.
A negyedik parancs lekéri annak a Windows PowerShell beépülő modulnak a nevét, amely hozzáadta az eredeti Get-Date parancsmagot az aktuális munkamenethez.
Az ötödik parancs a Get-Date parancsmag beépülő modulnevét használja egy Get-Date parancs futtatásához.
További információ a parancsok előzményeiről és a rejtett parancsokról: about_Command_Precedence.
8. példa: Egy adott sztringet tartalmazó parancsok importálása a nevükben
PS C:\> Import-PSSession -Session $S -CommandName **Item** -AllowClobber
Ez a parancs importálja azokat a parancsokat, amelyeknek a neve tartalmazza az elemet a PSSession fájlból $S. Mivel a parancs tartalmazza a CommandName paramétert, de a FormatTypeData paramétert nem, csak a parancs lesz importálva.
Ezt a parancsot akkor használja, ha Import-PSSession használ egy parancs távoli számítógépen való futtatásához, és az aktuális munkamenetben már rendelkezik a parancs formázási adataival.
9. példa: A Modul paraméter használatával felderítheti, hogy mely parancsokat importálták a munkamenetbe
PS C:\> $M = Import-PSSession -Session $S -CommandName *bits* -FormatTypeName *bits*
PS C:\> Get-Command -Module $M
CommandType Name
----------- ----
Function Add-BitsFile
Function Complete-BitsTransfer
Function Get-BitsTransfer
Function Remove-BitsTransfer
Function Resume-BitsTransfer
Function Set-BitsTransfer
Function Start-BitsTransfer
Function Suspend-BitsTransfer
Ez a parancs bemutatja, hogyan használhatja a Get-Command paraméterét annak kiderítésére, hogy mely parancsokat importálta a munkamenetbe egy Import-PSSession parancs.
Az első parancs a Import-PSSession parancsmaggal importálja azokat a parancsokat, amelyek neve "biteket" tartalmaz a PSSessionból a $S változóban. A Import-PSSession parancs egy ideiglenes modult ad vissza, és a parancs menti a modult a $m változóba.
A második parancs a Get-Command parancsmagot használja a modul által exportált parancsok lekérésére a $M változóban.
A Modul paraméter egy sztringértéket vesz fel, amelyet a modul nevéhez terveztek. Modulobjektum beküldésekor azonban a Windows PowerShell a modulobjektumon a ToString metódust használja, amely a modul nevét adja vissza.
A Get-Command parancs a Get-Command $M.Name".
Paraméterek
-AllowClobber
Azt jelzi, hogy ez a parancsmag importálja a megadott parancsokat, még akkor is, ha a parancsok neve megegyezik az aktuális munkamenet parancsaival.
Ha az aktuális munkamenetben egy paranccsal megegyező nevű parancsot importál, az importált parancs elrejti vagy lecseréli az eredeti parancsokat. További információ: about_Command_Precedence.
Alapértelmezés szerint Import-PSSession nem importál olyan parancsokat, amelyek neve megegyezik az aktuális munkamenet parancsaival.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| 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 |
-ArgumentList
A megadott argumentumok (paraméterértékek) használatával kapott parancsok tömbje.
Ha például importálni szeretné a Get-Item parancs variánsát a tanúsítvány (Cert:) meghajtójában a PSSession in $S, írja be a Import-PSSession -Session $S -Command Get-Item -ArgumentList cert:.
Paramétertulajdonságok
| Típus: | Object[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Argumentumok |
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 |
-Certificate
Megadja a formátumfájlok (*) aláírásához használt ügyféltanúsítványt. Format.ps1xml) vagy szkriptmodul-fájlok (.psm1) a Import-PSSession által létrehozott ideiglenes modulban.
Adjon meg egy változót, amely tartalmaz egy tanúsítványt, vagy egy parancsot vagy kifejezést, amely lekéri a tanúsítványt.
Tanúsítvány kereséséhez használja a Get-PfxCertificate parancsmagot, vagy használja a Get-ChildItem parancsmagot a Tanúsítvány (Cert:) meghajtón. Ha a tanúsítvány érvénytelen, vagy nem rendelkezik megfelelő jogosultságtal, a parancs meghiúsul.
Paramétertulajdonságok
| Típus: | X509Certificate2 |
| 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 |
-CommandName
A megadott neveket vagy névmintákat tartalmazó parancsokat adja meg. Helyettesítő karakterek használata engedélyezett. Használja CommandName vagy aliasát, Név.
Alapértelmezés szerint Import-PSSession importálja az összes parancsot a munkamenetből, kivéve azokat a parancsokat, amelyek neve megegyezik az aktuális munkamenet parancsaival. Ez megakadályozza, hogy az importált parancsok elrejtse vagy lecserélje a parancsokat a munkamenetben. Ha minden parancsot szeretne importálni, még azokat is, amelyek más parancsokat rejtenek el vagy cserélnek le, használja az AllowClobber paramétert.
Ha a CommandName paramétert használja, a parancsok formázási fájljai csak akkor lesznek importálva, ha a FormatTypeName paramétert használja. Hasonlóképpen, ha a FormatTypeName paramétert használja, a rendszer csak akkor importál parancsokat, ha a CommandName paramétert használja.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Név |
Paraméterkészletek
(All)
| Position: | 2 |
| 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 |
-CommandType
Megadja a parancsobjektumok típusát. Az alapértelmezett érték a Parancsmag. Használja CommandType vagy aliasát, Típus. A paraméter elfogadható értékei a következők:
-
Alias: A Windows PowerShell-aliasok a távoli munkamenetben. -
All: A távoli munkamenet parancsmagjai és funkciói. -
Application: A távoli munkamenet Elérési út környezeti változójában ($env:path) felsorolt elérési utakon Windows-PowerShell fájlokon kívül minden fájl, beleértve .txt, .exeés .dll fájlokat is. -
Cmdlet: A távoli munkamenet parancsmagjai. A "Parancsmag" az alapértelmezett. -
ExternalScript: A távoli munkamenet Elérési út környezeti változójában ($env:path) felsorolt elérési utak .ps1 fájljai. -
FilterésFunction: A Windows PowerShell a távoli munkamenetben működik. -
Script: A szkript blokkolja a távoli munkamenetet.
Ezek az értékek jelölőalapú számbavételként vannak definiálva. Több érték kombinálásával több jelölőt is beállíthat ezzel a paraméterrel. Az értékek átadhatók a CommandType paraméternek értéktömbként vagy az értékek vesszővel elválasztott sztringjeként. A parancsmag bináris VAGY művelettel egyesíti az értékeket. Az értékek tömbként való átadása a legegyszerűbb lehetőség, és lehetővé teszi a tabulátorkiegészítés használatát is az értékeken.
Paramétertulajdonságok
| Típus: | CommandTypes |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Alias, Function, Filter, Cmdlet, ExternalScript, Application, Script, Workflow, Configuration, All |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Típus |
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 |
-DisableNameChecking
Azt jelzi, hogy ez a parancsmag letiltja azt az üzenetet, amely figyelmeztetést küld, amikor olyan parancsmagot vagy függvényt importál, amelynek neve nem jóváhagyott igét vagy tiltott karaktert tartalmaz.
Alapértelmezés szerint, ha egy importált modul olyan parancsmagokat vagy függvényeket exportál, amelyek neve nem jóváhagyott igéket tartalmaz, a Windows PowerShell a következő figyelmeztető üzenetet jeleníti meg:
"FIGYELMEZTETÉS: Egyes importált parancsnevek nem jóváhagyott parancsokat tartalmaznak, amelyek kevésbé felderíthetők. A jóváhagyott igék listájának megtekintéséhez használja a Részletes paramétert, vagy írja be a Get-Verb."
Ez az üzenet csak figyelmeztetés. A teljes modul továbbra is importálva van, beleértve a nem megfelelő parancsokat is. Bár az üzenet megjelenik a modul felhasználói számára, az elnevezési problémát a modul szerzőjének kell kijavítani.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| 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 |
-FormatTypeName
A Megadott Microsoft .NET-keretrendszertípusok formázási utasításait adja meg. Adja meg a típusneveket. Helyettesítő karakterek használata engedélyezett.
Ennek a paraméternek az értékének olyan típusnak kell lennie, amelyet egy Get-FormatData parancs a parancsok importálásának munkamenetében ad vissza. A távoli munkamenet összes formázási adatának lekéréséhez írja be a *.
Ha a parancs nem tartalmazza a CommandName vagy FormatTypeName paramétert, Import-PSSession importálja a Get-FormatData parancs által a távoli munkamenetben visszaadott összes .NET-keretrendszertípus formázási utasításait.
Ha a FormatTypeName paramétert használja, a rendszer csak akkor importál parancsokat, ha a CommandName paramétert használja.
Hasonlóképpen, ha a CommandName paramétert használja, a parancsok formázási fájljai csak akkor lesznek importálva, ha a FormatTypeName paramétert használja.
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: | 3 |
| 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 |
-FullyQualifiedModule
Az érték lehet egy modul neve, egy teljes modul specifikációja vagy egy modulfájl elérési útja.
Ha az érték egy elérési út, az elérési út teljes mértékben minősített vagy relatív lehet. A relatív elérési út feloldása a használandó utasítást tartalmazó szkripthez képest történik.
Ha az érték név vagy modulspecifikáció, a PowerShell megkeresi a megadott modul PSModulePath.
A modulspecifikáció egy kivonatoló, amely a következő kulcsokkal rendelkezik.
-
ModuleName- Kötelező A modul nevét adja meg. -
GUID- Nem kötelező A modul GUID azonosítóját adja meg. - Emellett Kötelező megadni az alábbi három kulcs közül legalább egyet.
-
ModuleVersion– A modul minimálisan elfogadható verzióját adja meg. -
MaximumVersion– A modul maximálisan elfogadható verzióját adja meg. -
RequiredVersion– A modul pontos, kötelező verzióját adja meg. Ez nem használható a többi Verzió billentyűvel.
-
Nem adhatja meg a Teljesen minősített modul paramétert ugyanabban a parancsban, mint egy Modul paraméter. A két paraméter kölcsönösen kizárja egymást.
Paramétertulajdonságok
| Típus: | |
| 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 |
-Module
A Parancsok tömbje a Windows PowerShell beépülő modulokban és modulokban. Adja meg a beépülő modul és a modul nevét. Helyettesítő karakterek használata nem engedélyezett.
Import-PSSession nem lehet beépülő modulból importálni a szolgáltatókat.
További információ: about_PSSnapins és about_Modules.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSSnapin |
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 |
-Prefix
Megadja az importált parancsok neveiben szereplő főnevek előtagját.
Ezzel a paramétersel elkerülheti azokat a névütközéseket, amelyek akkor fordulhatnak elő, ha a munkamenet különböző parancsai azonos nevűek.
Ha például megadja a Távoli előtagot, majd importál egy Get-Date parancsmagot, a parancsmag a munkamenetben Get-RemoteDatenéven ismert, és nem tévesztendő össze az eredeti Get-Date parancsmaggal.
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 |
-Session
Megadja azt a PSSession, amelyből a parancsmagok importálva vannak. Adjon meg egy változót, amely munkamenet-objektumot vagy munkamenet-objektumot lekérő parancsot tartalmaz, például New-PSSession vagy Get-PSSession parancsot. Csak egy munkamenetet adhat meg. Ez a paraméter kötelező.
Paramétertulajdonságok
| Típus: | PSSession |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
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 |
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
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
PSModuleInfo
Ez a parancsmag ugyanazt a modulobjektumot adja vissza, amelyet New-Module és Get-Module parancsmagok visszaadnak.
Az importált modul azonban ideiglenes, és csak az aktuális munkamenetben létezik. Ha állandó modult szeretne létrehozni a lemezen, használja a Export-PSSession parancsmagot.
Jegyzetek
-
Import-PSSessiona PowerShell-remoting infrastruktúrára támaszkodik. A parancsmag használatához a számítógépet konfigurálni kell WS-Management újraküldéshez. További információ: about_Remote és about_Remote_Requirements. -
Import-PSSessionnem importál változókat vagy PowerShell-szolgáltatókat. - Amikor olyan parancsokat importál, amelyek neve megegyezik az aktuális munkamenet parancsaival, az importált parancsok elrejthetik az aliasokat, a függvényeket és a parancsmagokat a munkamenetben, és lecserélhetik a munkamenet funkcióit és változóit. A névütközések megelőzéséhez használja a előtag paramétert. További információ: about_Command_Precedence.
-
Import-PSSessionaz összes parancsot függvényekké alakítja, mielőtt importálja őket. Ennek eredményeképpen az importált parancsok kissé másképp viselkednek, mint ha megtartanák az eredeti parancstípusukat. Ha például EGY PSSession-ből importál egy parancsmagot, majd importál egy azonos nevű parancsmagot egy modulból vagy beépülő modulból, a PSSession-ból importált parancsmag mindig alapértelmezés szerint fut, mert a függvények elsőbbséget élveznek a parancsmagokkal szemben. Ezzel szemben, ha egy azonos nevű aliast tartalmazó munkamenetbe importál egy aliast, a rendszer mindig az eredeti aliast használja, mert az aliasok elsőbbséget élveznek a függvényekkel szemben. További információ: about_Command_Precedence. -
Import-PSSessionaWrite-Progressparancsmaggal jeleníti meg a parancs előrehaladását. Előfordulhat, hogy a parancs futtatása közben megjelenik a folyamatjelző sáv. - Az importálandó parancsok megkereséséhez
Import-PSSessionaInvoke-Commandparancsmaggal futtat egyGet-Commandparancsot a PSSessionban. A parancsok formázási adatainak lekéréséhez azGet-FormatDataparancsmagot használja. Ezekből a parancsmagokból hibaüzenetek jelenhetnek meg egyImport-PSSessionparancs futtatásakor. EmellettImport-PSSessionnem importálhat parancsokat olyan PSSession-parancsokból, amelyek nem tartalmazzák aGet-Command,Get-FormatData,Select-ObjectésGet-Helpparancsmagokat. - Az importált parancsok ugyanazokra a korlátozásokra vonatkoznak, mint a többi távoli parancsra, beleértve azt is, hogy a program nem indítható el felhasználói felületen, például a Jegyzettömbben.
- Mivel a Windows PowerShell-profilok nem PSSessions rendszerben futnak, a profil által a munkamenethez hozzáadott parancsok nem érhetők el
Import-PSSession. Ha parancsokat szeretne importálni egy profilból, egyInvoke-Commandparanccsal futtassa a profilt manuálisan a PSSessionban a parancsok importálása előtt. - Az
Import-PSSessionáltal létrehozott ideiglenes modul tartalmazhat formázási fájlt, még akkor is, ha a parancs nem importál formázási adatokat. Ha a parancs nem importál formázási adatokat, a létrehozott formázási fájlok nem tartalmaznak formázási adatokat. - A
Import-PSSessionhasználatához az aktuális munkamenet végrehajtási szabályzata nem korlátozható vagy AllSigned, mert azImport-PSSessionáltal létrehozott ideiglenes modul nem aláírt szkriptfájlokat tartalmaz, amelyeket ezek a szabályzatok tiltanak. Ha aImport-PSSessiona helyi számítógép végrehajtási szabályzatának módosítása nélkül szeretné használni, aSet-ExecutionPolicyparaméterével állíthat be kevésbé korlátozó végrehajtási szabályzatot egyetlen folyamathoz. - A Windows PowerShell 2.0-ban a másik munkamenetből importált parancsok súgótémakörei nem tartalmazzák a előtag paraméterrel hozzárendelt előtagot. Ha segítségre van szüksége egy importált parancshoz a Windows PowerShell 2.0-ban, használja az eredeti (nem előtagos) parancsnevet.