Import-PSSession
Importuje příkazy z jiné relace do aktuální relace.
Syntaxe
Import-PSSession
[-Prefix <String>]
[-DisableNameChecking]
[[-CommandName] <String[]>]
[-AllowClobber]
[-ArgumentList <Object[]>]
[-CommandType <CommandTypes>]
[-Module <String[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[[-FormatTypeName] <String[]>]
[-Certificate <X509Certificate2>]
[-Session] <PSSession>
[<CommonParameters>]
Description
Rutina Import-PSSession
importuje příkazy , jako jsou rutiny, funkce a aliasy, z psSession na místním nebo vzdáleném počítači do aktuální relace. Můžete importovat libovolný příkaz, který může rutina Get-Command
najít v psSession.
Import-PSSession
Příkaz použijte k importu příkazů z přizpůsobeného prostředí, jako je prostředí Microsoft Exchange Serveru, nebo z relace, která obsahuje moduly Windows PowerShellu a moduly snap-in nebo jiné prvky, které nejsou v aktuální relaci.
Pokud chcete importovat příkazy, nejprve pomocí rutiny New-PSSession
vytvořte příkaz PSSession. Potom pomocí rutiny Import-PSSession
naimportujte příkazy. Ve výchozím nastavení importuje všechny příkazy s výjimkou příkazů se Import-PSSession
stejnými názvy jako příkazy v aktuální relaci. K importu všech příkazů použijte parametr AllowClobber .
Importované příkazy můžete použít stejně jako jakýkoli příkaz v relaci. Když použijete importovaný příkaz, importovaná část příkazu se implicitně spustí v relaci, ze které byl importován. Vzdálené operace se ale zpracovávají výhradně prostředím Windows PowerShell. Nemusíte o nich ani vědět, s tím rozdílem, že musíte zachovat připojení k druhé relaci (PSSession). Pokud ho zavřete, importované příkazy už nebudou k dispozici.
Vzhledem k tomu, že importované příkazy můžou trvat déle než místní příkazy, Import-PSSession
přidá do každého importovaného příkazu parametr AsJob . Tento parametr umožňuje spustit příkaz jako úlohu prostředí Windows PowerShell na pozadí. Další informace najdete v tématu Informace o úlohách.
Při použití Import-PSSession
windows PowerShell přidá importované příkazy do dočasného modulu, který existuje pouze ve vaší relaci, a vrátí objekt, který představuje modul. Pokud chcete vytvořit trvalý modul, který můžete použít v budoucích relacích, použijte rutinu Export-PSSession
.
Rutina Import-PSSession
používá implicitní funkci vzdálené komunikace prostředí Windows PowerShell. Když importujete příkazy do aktuální relace, spustí se implicitně v původní relaci nebo v podobné relaci na původním počítači.
Počínaje Windows PowerShellem 3.0 můžete pomocí Import-Module
rutiny importovat moduly ze vzdálené relace do aktuální relace. Tato funkce používá implicitní vzdálené komunikace. Je ekvivalentní použití Import-PSSession
k importu vybraných modulů ze vzdálené relace do aktuální relace.
Příklady
Příklad 1: Import všech příkazů z psSession
$S = New-PSSession -ComputerName Server01
Import-PSSession -Session $S
Tento příkaz naimportuje všechny příkazy z psSession na počítači Serveru01 do aktuální relace s výjimkou příkazů se stejnými názvy jako příkazy v aktuální relaci.
Protože tento příkaz nepoužívá parametr CommandName , importuje také všechna formátovací data požadovaná pro importované příkazy.
Příklad 2: Import příkazů, které končí určitým řetězcem
$S = New-PSSession https://ps.testlabs.com/powershell
Import-PSSession -Session $S -CommandName *-test -FormatTypeName *
New-Test -Name Test1
Get-Test test1 | Run-Test
Tyto příkazy importují příkazy s názvy, které končí na "-test" z psSession do místní relace, a pak ukazují, jak používat importovanou rutinu.
První příkaz použije rutinu New-PSSession
k vytvoření psSession. Uloží psSession v $S
proměnné.
Druhý příkaz pomocí rutiny Import-PSSession
importuje příkazy z psSession do $S
aktuální relace. Pomocí parametru CommandName určí příkazy se podstatným jménem test a parametrem FormatTypeName k importu formátovacích dat pro příkazy Test.
Třetí a čtvrtý příkazy používají importované příkazy v aktuální relaci. Vzhledem k tomu, že importované příkazy se skutečně přidají do aktuální relace, použijete k jejich spuštění místní syntaxi. Ke spuštění importovaného příkazu nemusíte tuto rutinu Invoke-Command
používat.
Příklad 3: Import rutin z PSSession
$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
Tento příklad ukazuje, že importované rutiny můžete použít stejně jako místní rutiny.
Tyto příkazy naimportují New-Test
rutiny Get-Test
z psSession na počítači Server01 a rutiny Set-Test
z psSession na počítači se serverem Server02.
I když se rutiny naimportovaly z různých psSessions, můžete objekt z jedné rutiny do druhé převést bez chyby.
Příklad 4: Spuštění importovaného příkazu jako úlohy na pozadí
$S = New-PSSession -ComputerName Server01
Import-PSSession -Session $S -CommandName *-test* -FormatTypeName *
$batch = New-Test -Name Batch -AsJob
Receive-Job $batch
Tento příklad ukazuje, jak spustit importovaný příkaz jako úlohu na pozadí.
Vzhledem k tomu, že importované příkazy můžou trvat déle než místní příkazy, Import-PSSession
přidá do každého importovaného příkazu parametr AsJob . Parametr AsJob umožňuje spustit příkaz jako úlohu na pozadí.
První příkaz vytvoří na počítači Server01 psSession a uloží objekt PSSession do $S
proměnné.
Druhý příkaz používá Import-PSSession
k importu testovacích rutin z psSession do $S
aktuální relace.
Třetí příkaz používá parametr AsJob importované New-Test
rutiny ke spuštění New-Test
příkazu jako úlohu na pozadí. Příkaz uloží objekt úlohy, který New-Test
se vrátí do $batch
proměnné.
Čtvrtý příkaz pomocí rutiny Receive-Job
získá výsledky úlohy v $batch
proměnné.
Příklad 5: Import rutin a funkcí z modulu Windows PowerShellu
$S = New-PSSession -ComputerName Server01
Invoke-Command -Session $S {Import-Module TestManagement}
Import-PSSession -Session $S -Module TestManagement
Tento příklad ukazuje, jak importovat rutiny a funkce z modulu Windows PowerShellu na vzdáleném počítači do aktuální relace.
První příkaz vytvoří na počítači Server01 psSession a uloží ho $S
do proměnné.
Druhý příkaz používá rutinu Invoke-Command
ke spuštění Import-Module
příkazu v psSession in $S
.
Modul se obvykle přidá do všech relací příkazem Import-Module
v profilu Windows PowerShellu, ale profily se nespustí v psSessions.
Třetí příkaz používá parametr Import-PSSession
Module pro import rutin a funkcí v modulu do aktuální relace.
Příklad 6: Vytvoření modulu v dočasném souboru
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 : {}
Tento příklad ukazuje, že Import-PSSession
vytvoří modul v dočasném souboru na disku. Ukazuje také, že všechny příkazy se před importem do aktuální relace převedou na funkce.
Příkaz používá rutinu Import-PSSession
k importu Get-Date
rutiny a funkce SearchHelp do aktuální relace.
Rutina Import-PSSession
vrátí objekt PSModuleInfo , který představuje dočasný modul. Hodnota path vlastnost ukazuje, že Import-PSSession
vytvořil skript modul (.psm1) soubor v dočasném umístění. Vlastnost ExportedFunctions ukazuje, že rutina Get-Date
a funkce SearchHelp byly importovány jako funkce.
Příklad 7: Spuštění příkazu, který je skrytý importovaným příkazem
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
Tento příklad ukazuje, jak spustit příkaz, který je skrytý importovaným příkazem.
První příkaz naimportuje rutinu Get-Date
z psSession v $S
proměnné. Vzhledem k tomu, že aktuální relace obsahuje rutinu Get-Date
, je v příkazu vyžadován parametr AllowClobber .
Druhý příkaz pomocí parametru All rutiny Get-Command
získá všechny Get-Date
příkazy v aktuální relaci. Výstup ukazuje, že relace obsahuje původní Get-Date
rutinu Get-Date
a funkci. Funkce Get-Date
spustí importovanou Get-Date
rutinu v psSession in $S
.
Třetí příkaz spustí Get-Date
příkaz. Vzhledem k tomu, že funkce mají přednost před rutinami, spustí Prostředí Windows PowerShell importovanou Get-Date
funkci, která vrátí julianské datum.
Čtvrté a páté příkazy ukazují, jak pomocí kvalifikovaného názvu spustit příkaz, který je skrytý importovaným příkazem.
Čtvrtý příkaz získá název modulu snap-in Prostředí Windows PowerShell, který do aktuální relace přidal původní Get-Date
rutinu.
Pátý příkaz používá ke spuštění příkazu kvalifikovaný název Get-Date
modulu snap-in rutiny Get-Date
.
Další informace o prioritách příkazů a skrytých příkazech najdete v tématu about_Command_Precedence.
Příklad 8: Import příkazů s určitým řetězcem v jejich názvech
PS C:\> Import-PSSession -Session $S -CommandName **Item** -AllowClobber
Tento příkaz naimportuje příkazy, jejichž názvy zahrnují položku z psSession in $S
. Protože příkaz obsahuje parametr CommandName , ale nikoli FormatTypeData , importuje se pouze příkaz.
Tento příkaz použijte, pokud používáte Import-PSSession
ke spuštění příkazu na vzdáleném počítači a už máte formátovací data pro příkaz v aktuální relaci.
Příklad 9: Použití parametru Modulu ke zjištění, které příkazy byly importovány do relace
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
Tento příkaz ukazuje, jak pomocí parametru Get-Command
Modulu zjistit, které příkazy byly importovány do relace příkazemImport-PSSession
.
První příkaz používá rutinu k importu Import-PSSession
příkazů, jejichž názvy obsahují "bity" z PSSession v $S
proměnné. Příkaz Import-PSSession
vrátí dočasný modul a příkaz uloží modul do $m
proměnné.
Druhý příkaz pomocí rutiny Get-Command
získá příkazy exportované modulem v $M
proměnné.
Parametr Module má řetězcovou hodnotu, která je určená pro název modulu. Když však odešlete objekt modulu, windows PowerShell použije metodu ToString na objektu modulu, která vrátí název modulu.
Příkaz Get-Command
je ekvivalentem " Get-Command $M.Name
.
Parametry
-AllowClobber
Označuje, že tato rutina importuje zadané příkazy, i když mají stejné názvy jako příkazy v aktuální relaci.
Pokud importujete příkaz se stejným názvem jako příkaz v aktuální relaci, importovaný příkaz skryje nebo nahradí původní příkazy. Další informace najdete v tématu about_Command_Precedence.
Ve výchozím nastavení neimportuje příkazy se Import-PSSession
stejným názvem jako příkazy v aktuální relaci.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ArgumentList
Určuje pole příkazů, které mají za následek použití zadaných argumentů (hodnot parametrů).
Chcete-li například importovat variantu Get-Item
příkazu v jednotce certifikátu (Cert:) v psSession v $S
, zadejte Import-PSSession -Session $S -Command Get-Item -ArgumentList cert:
.
Typ: | Object[] |
Aliasy: | Args |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Certificate
Určuje klientský certifikát, který se používá k podepsání souborů formátu (*. Format.ps1xml) nebo soubory modulu skriptu (.psm1) v dočasném modulu, který Import-PSSession
vytvoří.
Zadejte proměnnou obsahující certifikát nebo příkaz nebo výraz, který certifikát získá.
Pokud chcete najít certifikát, použijte rutinu Get-PfxCertificate
nebo použijte rutinu Get-ChildItem
na jednotce Certificate (Cert:). Pokud certifikát není platný nebo nemá dostatečnou autoritu, příkaz selže.
Typ: | X509Certificate2 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-CommandName
Určuje příkazy se zadanými názvy nebo vzory názvů. Jsou povoleny zástupné cardy. Použijte CommandName nebo jeho alias, Název.
Ve výchozím nastavení importuje všechny příkazy z relace s výjimkou příkazů se Import-PSSession
stejnými názvy jako příkazy v aktuální relaci. Tím zabráníte importovaným příkazům skrýt nebo nahradit příkazy v relaci. Pokud chcete importovat všechny příkazy, i ty, které skryjí nebo nahrazují jiné příkazy, použijte parametr AllowClobber .
Pokud použijete parametr CommandName , formátovací soubory pro příkazy se neimportují, pokud nepoužíváte parametr FormatTypeName . Podobně platí, že pokud použijete parametr FormatTypeName , nebudou importovány žádné příkazy, pokud nepoužíváte parametr CommandName .
Typ: | String[] |
Aliasy: | Name |
Position: | 2 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-CommandType
Určuje typ objektů příkazů. Výchozí hodnota je Rutina. Použijte CommandType nebo jeho alias, Type. Tento parametr přijímá tyto hodnoty:
Alias
: Aliasy Windows PowerShellu ve vzdálené relaci.All
: Rutiny a funkce ve vzdálené relaci.Application
: Všechny jiné soubory než soubory Windows-PowerShellu v cestách, které jsou uvedeny v proměnné prostředí Cesta ($env:path
) ve vzdálené relaci, včetně .txt, .exe a .dll souborů.Cmdlet
: Rutiny ve vzdálené relaci. Výchozí hodnota je rutina.ExternalScript
: Soubory .ps1 v cestách uvedených v proměnné prostředí Path ($env:path
) ve vzdálené relaci.Filter
aFunction
: Funkce Windows PowerShellu ve vzdálené relaci.Script
: Bloky skriptu ve vzdálené relaci.
Tyto hodnoty jsou definovány jako výčet založený na příznaku. Pomocí tohoto parametru můžete zkombinovat více hodnot a nastavit více příznaků. Hodnoty lze předat parametru CommandType jako pole hodnot nebo jako řetězec oddělený čárkami těchto hodnot. Rutina zkombinuje hodnoty pomocí binární operace OR. Předání hodnot jako pole je nejjednodušší možností a také umožňuje použít pro hodnoty dokončování tabulátoru.
Typ: | CommandTypes |
Aliasy: | Type |
Přípustné hodnoty: | Alias, Function, Filter, Cmdlet, ExternalScript, Application, Script, Workflow, Configuration, All |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DisableNameChecking
Označuje, že tato rutina potlačí zprávu, která vás upozorní při importu rutiny nebo funkce, jejíž název obsahuje neschválené sloveso nebo zakázaný znak.
Pokud modul, který importujete, ve výchozím nastavení exportuje rutiny nebo funkce, které mají ve svých názvech neschválené příkazy, zobrazí Windows PowerShell následující zprávu s upozorněním:
UPOZORNĚNÍ: Některé importované názvy příkazů obsahují neschválené příkazy, které by mohly být méně zjistitelné. Pokud chcete zobrazit seznam schválených sloves, použijte parametr Podrobné pro další podrobnosti nebo typ Get-Verb
.
Tato zpráva je pouze upozornění. Kompletní modul se stále importuje, včetně nevyhovujících příkazů. I když se zpráva zobrazuje uživatelům modulu, měl by problém s pojmenováním vyřešit autor modulu.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-FormatTypeName
Určuje pokyny pro formátování pro zadané typy rozhraní Microsoft .NET Framework. Zadejte názvy typů. Jsou povoleny zástupné cardy.
Hodnota tohoto parametru musí být název typu, který je vrácen příkazem Get-FormatData
v relaci, ze které se příkazy importují. Chcete-li získat všechna formátovací data ve vzdálené relaci, zadejte *
.
Pokud příkaz neobsahuje parametr CommandName nebo FormatTypeName , Import-PSSession
importuje pokyny pro formátování pro všechny typy rozhraní .NET Framework vrácené příkazem Get-FormatData
ve vzdálené relaci.
Pokud použijete parametr FormatTypeName , nebudou importovány žádné příkazy, pokud nepoužíváte parametr CommandName .
Podobně pokud použijete parametr CommandName , formátovací soubory pro příkazy se neimportují, pokud nepoužíváte parametr FormatTypeName .
Typ: | String[] |
Position: | 3 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-FullyQualifiedModule
Hodnota může být název modulu, úplná specifikace modulu nebo cesta k souboru modulu.
Pokud je hodnota cesta, může být cesta plně kvalifikovaná nebo relativní. Relativní cesta je vyřešena vzhledem ke skriptu, který obsahuje příkaz using.
Pokud je hodnota název nebo specifikace modulu, PowerShell vyhledá zadaný modul v psModulePath .
Specifikace modulu je hashovatelná tabulka s následujícími klíči.
ModuleName
- Povinný argument Určuje název modulu.GUID
- Volitelné určuje identifikátor GUID modulu.- Je také povinné zadat aspoň jeden ze tří následujících klíčů.
ModuleVersion
– Určuje minimální přijatelnou verzi modulu.MaximumVersion
– Určuje maximální přijatelnou verzi modulu.RequiredVersion
– Určuje přesnou požadovanou verzi modulu. Tuto možnost nelze použít s jinými klíči verze.
Parametr FullyQualifiedModule nelze zadat ve stejném příkazu jako parametr Module. Oba parametry se vzájemně vylučují.
Typ: | ModuleSpecification[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Module
Určuje a pole příkazů v modulech a modulech Windows PowerShellu. Zadejte názvy modulů a modulů. Zástupné dokumentace nejsou povoleny.
Import-PSSession
Aplikace nemůže importovat zprostředkovatele z modulu snap-in.
Další informace najdete v tématu about_PSSnapins a about_Modules.
Typ: | String[] |
Aliasy: | PSSnapin |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Prefix
Určuje předponu podstatných jmen v názvech importovaných příkazů.
Tento parametr použijte, chcete-li zabránit konfliktům názvů, ke kterým může dojít, když mají různé příkazy v relaci stejný název.
Pokud například zadáte předponu Remote a pak naimportujete rutinu Get-Date
, rutina se v relaci označuje jako Get-RemoteDate
a nezaměňuje se s původní Get-Date
rutinou.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Session
Určuje psSession , ze které se rutiny importují. Zadejte proměnnou obsahující objekt relace nebo příkaz, který získá objekt relace, například New-PSSession
příkaz nebo Get-PSSession
příkaz. Můžete zadat pouze jednu relaci. Tento parametr je povinný.
Typ: | PSSession |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
None
Do této rutiny nemůžete roušit objekty.
Výstupy
Tato rutina vrátí stejný objekt modulu, který New-Module
a Get-Module
rutiny vrátí.
Importovaný modul je však dočasný a existuje pouze v aktuální relaci. Pokud chcete vytvořit trvalý modul na disku, použijte rutinu Export-PSSession
.
Poznámky
Windows PowerShell obsahuje následující aliasy pro Import-PSSession
:
ipsn
Import-PSSession
spoléhá na infrastrukturu vzdálené komunikace PowerShellu. Chcete-li použít tuto rutinu, musí být počítač nakonfigurován pro vzdálené komunikace služby WS-Management. Další informace najdete v tématu about_Remote a about_Remote_Requirements.Import-PSSession
neimportuje proměnné ani zprostředkovatele PowerShellu.Při importu příkazů se stejnými názvy jako příkazy v aktuální relaci mohou importované příkazy skrýt aliasy, funkce a rutiny v relaci a mohou nahradit funkce a proměnné v relaci. Chcete-li zabránit konfliktům názvů, použijte parametr Prefix . Další informace najdete v tématu about_Command_Precedence.
Import-PSSession
převede všechny příkazy na funkce, než je naimportuje. V důsledku toho se importované příkazy chovají trochu jinak, než kdyby si zachovaly původní typ příkazu. Pokud například importujete rutinu z psSession a pak importujete rutinu se stejným názvem z modulu nebo modulu snap-in, rutina importovaná z PSSession se ve výchozím nastavení vždy spustí, protože funkce mají přednost před rutinami. Pokud naopak naimportujete alias do relace se stejným názvem, použije se vždy původní alias, protože aliasy mají přednost před funkcemi. Další informace najdete v tématu about_Command_Precedence.Import-PSSession
používá rutinuWrite-Progress
k zobrazení průběhu příkazu. Během spuštění příkazu se může zobrazit indikátor průběhu.Pokud chcete najít příkazy k importu,
Import-PSSession
pomocíInvoke-Command
rutiny spustíGet-Command
příkaz v příkazu PSSession. K získání formátovacích dat pro příkazy se používá rutinaGet-FormatData
. Při spuštěníImport-PSSession
příkazu se můžou zobrazovat chybové zprávy z těchto rutin.Import-PSSession
Také nelze importovat příkazy z PSSession, která neobsahujeGet-Command
,Get-FormatData
,Select-Object
aGet-Help
rutiny.Importované příkazy mají stejná omezení jako jiné vzdálené příkazy, včetně nemožnosti spustit program s uživatelským rozhraním, jako je Poznámkový blok.
Vzhledem k tomu, že profily Prostředí Windows PowerShell nejsou spuštěny v psSessions, příkazy, které profil přidá do relace, nejsou k dispozici
Import-PSSession
pro . Pokud chcete importovat příkazy z profilu, před importem příkazů použijteInvoke-Command
příkaz ke spuštění profilu v nástroji PSSession.Dočasný modul, který
Import-PSSession
vytvoří, může obsahovat formátovací soubor, i když příkaz neimportuje formátovaná data. Pokud příkaz neimportuje formátovací data, nebudou žádné vytvořené soubory formátování obsahovat formátovací data.Chcete-li použít
Import-PSSession
, zásady spuštění v aktuální relaci nelze omezit nebo AllSigned, protože dočasný modul, kterýImport-PSSession
vytvoří obsahuje nepodepsané soubory skriptu, které jsou zakázány těmito zásadami. Pokud chcete použítImport-PSSession
beze změny zásad spouštění pro místní počítač, použijte parametrSet-ExecutionPolicy
Scope pro nastavení méně omezující zásady provádění pro jeden proces.Témata nápovědy k příkazům importovaným z jiné relace ve Windows PowerShellu 2.0 nezahrnují předponu, kterou přiřadíte pomocí parametru Prefix . Pokud chcete získat nápovědu k importovanému příkazu v prostředí Windows PowerShell 2.0, použijte původní název příkazu (bez předpony).