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
Az Import-PSSession parancsmag parancsmagokat, például parancsmagokat, függvényeket és aliasokat importál egy helyi vagy távoli számítógép PSSession-jából az aktuális munkamenetbe. Importálhat minden olyan parancsot, amelyet a Get-Command parancsmag a PSSessionban talál.
Az Import-PSSession paranccsal parancsokat importálhat egy testre szabott rendszerhéjból, például egy Microsoft Exchange Server-rendszerhéjból, vagy egy 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 az Import-PSSession parancsmagot. Alapértelmezés szerint Import-PSSession importálja az összes parancsot, 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ó: about_Jobs.
Ha Import-PSSessionhasznál, 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.
Az 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ű az Import-PSSession használatával a kiválasztott modulok távoli munkamenetből az aktuális munkamenetbe való importálásához.
Példák
1. példa: Az összes parancs importálása PSSession-ből
PS C:\> $S = New-PSSession -ComputerName Server01
PS C:\> 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
PS C:\> $S = New-PSSession https://ps.testlabs.com/powershell
PS C:\> Import-PSSession -Session $S -CommandName *-test -FormatTypeName *
PS C:\> New-Test -Name Test1
PS C:\> 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 az $S PSSession parancsmagjából 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
PS C:\> $S1 = New-PSSession -ComputerName s1
PS C:\> $S2 = New-PSSession -ComputerName s2
PS C:\> Import-PSSession -Session s1 -Type cmdlet -Name New-Test, Get-Test -FormatTypeName *
PS C:\> Import-PSSession -Session s2 -Type Cmdlet -Name Set-Test -FormatTypeName *
PS C:\> 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
PS C:\> $S = New-PSSession -ComputerName Server01
PS C:\> Import-PSSession -Session $S -CommandName *-test* -FormatTypeName *
PS C:\> $batch = New-Test -Name Batch -AsJob
PS C:\> 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 az $S psSession parancsmagjaiból az aktuális munkamenetbe.
A harmadik parancs az importált New-Test parancsmag AsJob 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
PS C:\> $S = New-PSSession -ComputerName Server01
PS C:\> Invoke-Command -Session $S {Import-Module TestManagement}
PS C:\> 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 az Invoke-Command parancsmaggal futtat egy Import-Module parancsot a PSSessionban a $S.
A modult általában egy Import-Module parancs fogja hozzáadni az összes munkamenethez egy Windows PowerShell-profilban, de a profilok nem PSSessions-ban futnak.
A harmadik parancs a Import-PSSession modul paraméterével importálja a modul parancsmagjait és funkcióit 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_tcw1zunz.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_tcw1zunz.ttf
ModuleType : Script
PrivateData : {ImplicitRemoting}
AccessMode : ReadWrite
ExportedAliases : {}
ExportedCmdlets : {}
ExportedFunctions : {[Get-Date, Get-Date], [SearchHelp, SearchHelp]}
ExportedVariables : {}
NestedModules : {}
Ez a példa azt mutatja, 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.
Az 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 (.psm1) fájlt 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 Get-Command parancsmag All 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 in $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ő modulját használja egy Get-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* -AllowClobber
Ez a parancs importálja azokat a parancsokat, amelyeknek a neve "Item" (Elem) az $S PSSession eleméből származik. 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álatával futtat egy parancsot egy távoli számítógépen, é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-Commandmodul 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, amelyeknek a neve "biteket" tartalmaz a PSSessionból a $S változóban. Az 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 egyenértékű a "Get-Command $M.Name" paranccsal.
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) abban az ideiglenes modulban, amelyet Import-PSSession hoz létre.
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:
- Álnév. A Windows PowerShell-aliasok a távoli munkamenetben.
- Összes. A távoli munkamenet parancsmagjai és funkciói.
- Alkalmazás. A távoli munkamenet Elérési út környezeti változójában ($env:path) felsorolt elérési utakban lévő összes fájl Windows-PowerShell kivételével, beleértve a .txt, .exeés .dll fájlokat.
- Parancsmag. A távoli munkamenet parancsmagjai. A "Parancsmag" az alapértelmezett.
- ExternalScript. Az .ps1 fájlok a távoli munkamenet Elérési út környezeti változójában ($env:path) felsorolt elérési utakban.
- Szűrés és függvény. A Windows PowerShell a távoli munkamenetben működik.
- Forgatókönyv. A szkript blokkok a távoli munkamenetben.
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 *parancsot.
Ha a parancs nem tartalmazza a CommandName vagy FormatTypeName paramétert, Importálás-PSSession importálási formázási utasításokat az Get-FormatData parancs által a távoli munkamenetben visszaadott összes .NET-keretrendszertípushoz.
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
Olyan modulokat határoz meg, amelyek neve
A FullyQualifiedModule paraméter nem adható meg 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: | ModuleSpecification[] |
| 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 importálhat szolgáltatókat beépülő modulból.
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
Import-PSSession 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-PSSession a Windows 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-PSSession nem importál változókat vagy Windows 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-PSSession az 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-PSSession a Write-Progress parancsmaggal 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-PSSession a Invoke-Command parancsmaggal futtat egy Get-Command parancsot a PSSessionban. A parancsok formázási adatainak lekéréséhez az Get-FormatData parancsmagot használja. Ezekből a parancsmagokból hibaüzenetek jelenhetnek meg egy Import-PSSession parancs futtatásakor. Emellett Import-PSSession nem tud parancsokat importálni olyan PSSession-parancsokból, amelyek nem tartalmazzák a Get-Command, a Get-FormatData, a Select-Object és a Get-Help parancsmagokat.
- 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, egy Invoke-Command paranccsal futtassa a profilt manuálisan a PSSessionban a parancsok importálása előtt.
- Az Import-PSSession
ideiglenes modul formázási fájlt 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
Import-PSSession használatához az aktuális munkamenet végrehajtási szabályzata nem korlátozható vagy allSigned, mert az importálás-PSSessionideiglenes modul nem aláírt szkriptfájlokat tartalmaz, amelyeket ezek a házirendek tiltanak. Ha Importálás-PSSession a helyi számítógép végrehajtási házirendjének módosítása nélkül szeretné használni, a Set-ExecutionPolicy Hatókör paraméterével állítsa be a 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.