Import-PSSession
Parancsokat importál egy másik munkamenetből az aktuális munkamenetbe.
Syntax
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épen lévő PSSession-ből az aktuális munkamenetbe. Importálhat minden parancsot, amelyet a Get-Command parancsmag a PSSessionban talál.
Import-PSSession Parancsok importálása 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 Import-PSSession parancsmaggal importálja a parancsokat. Alapértelmezés szerint az összes parancsot importálja, Import-PSSession 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 asJob paramétert ad hozzá. Ez a paraméter lehetővé teszi a parancs Windows PowerShell-háttérfeladatként való futtatását. További információkért lásd a feladatokat ismertető szakaszt.
Ha használja Import-PSSession, a Windows PowerShell hozzáadja az importált parancsokat egy olyan 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 remoting 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. Ez egyenértékű a Import-PSSession kiválasztott modulok távoli munkamenetből az aktuális munkamenetbe való importálásával.
Példák
1. példa: Az összes parancs importálása PSSession-ből
$S = New-PSSession -ComputerName Server01
Import-PSSession -Session $SEz 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-TestEzek 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 PSSessionból az aktuális munkamenetbe $S . A CommandName paraméterrel adja meg a Test 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 FullEz a példa azt mutatja be, hogy ugyanúgy használhat importált parancsmagokat, mint a helyi parancsmagokat.
Ezek a parancsok a New-TestGet-Test Kiszolgáló01 számítógépen lévő PSSession-ből és a parancsmagból importálják a Set-Test parancsmagokat a Server02 számítógépen található PSSession-bő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 $batchEz 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 asJob paramétert ad hozzá. 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 a tesztelési parancsmagok PSSession-ből az aktuális munkamenetbe $S való importálására használjaImport-PSSession.
A harmadik parancs az importált New-Test parancsmag AsJob paraméterével futtat egy New-Test parancsot háttérfeladatként. A parancs menti a változóban visszaadott New-Test feladatobjektumot $batch .
A negyedik parancs a Receive-Job parancsmaggal lekéri a feladat eredményeit 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 TestManagementEz 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 a $S változóba.
A második parancs a Invoke-Command parancsmaggal futtat egy Import-Module parancsot a PSSession in $S.
A modult általában egy Windows PowerShell-profil egyik Import-Module parancsa fogja hozzáadni az összes munkamenethez, de a profilok nem PSSessions-ban futnak.
A harmadik parancs a modul modulparaméterévelImport-PSSession 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. Az Elérési út tulajdonság értéke azt mutatja, hogy Import-PSSession egy szkriptmodul (.psm1) fájlt hozott létre egy ideiglenes helyen. Az ExportedFunctions tulajdonság azt mutatja, hogy a Get-Date parancsmag és a SearchHelp függvény is 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 PMEz a példa bemutatja, hogyan futtathat egy importált parancs által rejtett parancsot.
Az első parancs egy Get-Date parancsmagot importál a változó PSSession rendszeréből $S . Mivel az aktuális munkamenet tartalmaz egy Get-Date parancsmagot, az AllowClobber paraméter szükséges a parancsban.
A második parancs a parancsmag All paraméterét használja az Get-Command 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 függvényt Get-Date . A Get-Date függvény az importált Get-Date parancsmagot a PSSession fájlban futtatja.$S
A harmadik parancs futtat egy parancsot Get-Date . Mivel a függvények elsőbbséget élveznek a parancsmagokkal szemben, a Windows PowerShell az importált függvényt Get-Date 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 parancsmag beépülő modulnevét használja a Get-DateGet-Date parancs futtatásához.
A parancsok előzményeiről és a rejtett parancsokról további információt a about_Command_Precedence talál.
8. példa: Egy adott sztringet tartalmazó parancsok importálása a nevükben
PS C:\> Import-PSSession -Session $S -CommandName **Item** -AllowClobberEz 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, Import-PSSession ha távoli számítógépen futtat parancsot, é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-BitsTransferEz a parancs bemutatja, hogyan használhatja a Modul paramétert Get-Command annak kiderítésére, hogy mely parancsokat importálta a munkamenetbe egy Import-PSSession parancs.
Az első parancs a parancsmaggal importálja azokat a Import-PSSession parancsokat, amelyek neve "biteket" tartalmaz a változó PSSession eleméből $S . 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 parancsmaggal szerzi be a modul által exportált parancsokat 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 Modul objektum ToString metódusát 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 nem importál olyan parancsokat, Import-PSSession amelyek neve megegyezik az aktuális munkamenet parancsaival.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ArgumentList
A megadott argumentumok (paraméterértékek) használatával kapott parancsok tömbje.
Ha például a parancs variánsát Get-Item szeretné importálni a PSSession fájlban lévő tanúsítvány (Cert:) meghajtón $S, írja be a következőt Import-PSSession -Session $S -Command Get-Item -ArgumentList cert:: .
| Type: | Object[] |
| Aliases: | Args |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 létrehozott ideiglenes modulban Import-PSSession .
Adjon meg egy változót, amely a tanúsítványt lekérő tanúsítványt vagy parancsot vagy kifejezést tartalmazza.
Tanúsítvány kereséséhez használja a Get-PfxCertificate parancsmagot, vagy használja a Get-ChildItem tanúsítvány (Cert:) meghajtón található parancsmagot. Ha a tanúsítvány érvénytelen, vagy nem rendelkezik megfelelő jogosultságtal, a parancs meghiúsul.
| Type: | X509Certificate2 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandName
A megadott neveket vagy névmintákat tartalmazó parancsokat adja meg. Helyettesítő karakterek használata engedélyezett. Használja a CommandName vagy annak aliasát, a Name parancsot.
Alapértelmezés szerint Import-PSSession az összes parancsot importálja 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. Az összes parancs importálásához használja az AllowClobber paramétert, még azokat is, amelyek más parancsokat rejtenek el vagy cserélnek le.
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.
| Type: | String[] |
| Aliases: | Name |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandType
Megadja a parancsobjektumok típusát. Az alapértelmezett érték a Parancsmag. Használja a CommandType vagy annak aliasát, a Type parancsot. 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 Windows-PowerShell-fájlokon kívüli összes fájl a távoli munkamenet Elérési út környezeti változójában ($env:path) felsorolt elérési utakon, beleértve a .txt, .exe és .dll fájlokat.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 blokkok a távoli munkamenetben.
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.
| Type: | CommandTypes |
| Aliases: | Type |
| Accepted values: | Alias, Function, Filter, Cmdlet, ExternalScript, Application, Script, Workflow, Configuration, All |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 Get-Verb használja a Részletes paramétert.
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FormatTypeName
A megadott Microsoft .NET-keretrendszer-tí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 egy olyan típusnak kell lennie, amelyet egy Get-FormatData parancs a parancsok importálását tartalmazó munkamenetben ad vissza. A távoli munkamenet összes formázási adatának lekéréséhez írja be a következőt *: .
Ha a parancs nem tartalmazza a CommandName vagy a FormatTypeName paramétert, Import-PSSession importálja a formázási utasításokat a távoli munkamenetben egy parancs által visszaadott Get-FormatData összes .NET-keretrendszer típushoz.
Ha a FormatTypeName paramétert használja, a parancsok csak a CommandName paramétert használják.
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.
| Type: | String[] |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 egy név vagy egy modul specifikációja, a PowerShell megkeresi a PSModulePath-t a megadott modulban.
A modulspecifikáció egy kivonatoló, amely a következő kulcsokkal rendelkezik.
ModuleName- A Kötelező a modul nevét adja meg.GUID- Nem kötelező : A modul GUID azonosítója.- Emellett az alábbi három kulcs közül legalább egyet meg kell adnia.
ModuleVersion– A modul minimálisan elfogadható verzióját adja meg.MaximumVersion– Meghatározza a modul maximálisan elfogadható verzióját.RequiredVersion– A modul pontos, kötelező verzióját adja meg. Ez nem használható a többi Verzió billentyűvel.
A Modul paraméterrel azonos parancsban nem adhatja meg a Teljesképűmodule paramétert. A két paraméter kölcsönösen kizárja egymást.
| Type: | ModuleSpecification[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 A szolgáltatók nem importálhatók beépülő modulból.
További információ: about_PSSnapins és about_Modules.
| Type: | String[] |
| Aliases: | PSSnapin |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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-RemoteDateismert, és nem tévesztendő össze az eredeti Get-Date parancsmaggal.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Session
Azt a PSSessiont adja meg, amelyből a parancsmagok importálva vannak. Adjon meg egy változót, amely egy munkamenet-objektumot vagy egy munkamenet-objektumot lekérő parancsot tartalmaz, például egy New-PSSession vagy Get-PSSession egy parancsot. Csak egy munkamenetet adhat meg. Ez a paraméter kötelező.
| Type: | PSSession |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
Ez a parancsmag ugyanazt a modulobjektumot adja vissza, amelyet New-Module a 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 a WS-Management újraküldéséhez. 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 az Előtag paramétert . További információ: about_Command_Precedence.
Import-PSSessionaz importálás előtt az összes parancsot függvényekké alakítja. 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-PSSessionparancsmagWrite-Progresshasználatával 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ó
Import-PSSessionparancsok megkereséséhez aInvoke-Commandparancsmag használatával futtassaGet-Commanda parancsot a PSSessionban. A parancsok formázási adatainak lekéréséhez a parancsmagotGet-FormatDatahasználja. Parancs futtatásakorImport-PSSessionezekből a parancsmagokból hibaüzenetek jelenhetnek meg. Emellett nem importálhat parancsokat olyan PSSession-ből,Import-PSSessionamely nem tartalmazza aGet-Command,Get-FormatData,Select-ObjectésGet-Helpparancsmagokat. - Az importált parancsok ugyanazokra a korlátozásokra vonatkoznak, mint más távoli parancsok, beleértve azt is, hogy a program nem indítható el felhasználói felületen, például Jegyzettömb.
- Mivel a Windows PowerShell-profilok nem PSSessions rendszerben futnak, a profil által a munkamenethez hozzáadott parancsok nem érhetők el.
Import-PSSessionHa parancsokat szeretne importálni egy profilból, aInvoke-Commandparancsok importálása előtt futtassa manuálisan a profilt a PSSessionban. - A létrehozott ideiglenes modul
Import-PSSessionformázási fájlokat is tartalmazhat, 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 használathoz
Import-PSSessionaz aktuális munkamenet végrehajtási szabályzata nem lehet korlátozott vagy AllSigned, mert az ideiglenes modul, amelyImport-PSSessionlétrehoz, nem aláírt szkriptfájlokat tartalmaz, amelyeket ezek a házirendek tiltanak. Ha a helyi számítógép végrehajtási szabályzatának módosítása nélkül szeretné használniImport-PSSession, a Hatókör paraméterrelSet-ExecutionPolicyegy kevésbé korlátozó végrehajtási szabályzatot állíthat be egyetlen folyamathoz. - A Windows PowerShell 2.0-ban a másik munkamenetből importált parancsok súgótémakörei nem tartalmazzák az 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.
Kapcsolódó hivatkozások
Visszajelzés
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ó: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: