Export-PSSession
Exporterar kommandon från en annan session och sparar dem i en PowerShell-modul.
Syntax
Export-PSSession
[-Session] <PSSession>
[-OutputModule] <string>
[[-CommandName] <string[]>]
[[-FormatTypeName] <string[]>]
[-Force]
[-Encoding <string>]
[-AllowClobber]
[-ArgumentList <Object[]>]
[-CommandType <CommandTypes>]
[-Module <string[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[-Certificate <X509Certificate2>]
[<CommonParameters>]
Description
Cmdleten Export-PSSession
hämtar cmdletar, funktioner, alias och andra kommandotyper från en annan PowerShell-session (PSSession) på en lokal dator eller fjärrdator och sparar dem i en PowerShell-modul. Om du vill lägga till kommandona från modulen i den aktuella sessionen använder du cmdleten Import-Module
.
Till skillnad från Import-PSSession
, som importerar kommandon från en annan PSSession till den aktuella sessionen, Export-PSSession
sparar kommandona i en modul. Kommandona importeras inte till den aktuella sessionen.
Om du vill exportera kommandon använder du cmdleten New-PSSession
för att skapa en PSSession som har de kommandon som du vill exportera. Använd sedan cmdleten Export-PSSession
för att exportera kommandona.
För att förhindra konflikter med kommandonamn är standardvärdet för Export-PSSession
att exportera alla kommandon, förutom kommandon som finns i den aktuella sessionen. Du kan använda parametern CommandName för att ange de kommandon som ska exporteras.
Cmdleten Export-PSSession
använder den implicita fjärrkommunikationsfunktionen i PowerShell. När du importerar kommandon till den aktuella sessionen körs de implicit i den ursprungliga sessionen eller i en liknande session på den ursprungliga datorn.
Exempel
Exempel 1: Exportera kommandon från en PSSession
Det här exemplet skapar en ny PSSession från den lokala datorn till Server01-datorn. Alla kommandon, förutom de som finns i den aktuella sessionen, exporteras till modulen Med namnet Server01 på den lokala datorn. Exporten innehåller formateringsdata för kommandona.
$S = New-PSSession -ComputerName Server01
Export-PSSession -Session $S -OutputModule Server01
Kommandot New-PSSession
skapar en PSSession på Server01-datorn. PSSession lagras i variabeln $S
. Kommandot Export-PSSession
exporterar $S
variabelns kommandon och formateringsdata till Server01-modulen.
Exempel 2: Exportera kommandona Hämta och Ange
Det här exemplet exporterar alla Get
kommandon och Set
från en server.
$S = New-PSSession -ConnectionUri https://exchange.microsoft.com/mailbox -Credential exchangeadmin01@hotmail.com -Authentication Negotiate
Export-PSSession -Session $S -Module exch* -CommandName Get-*, Set-* -FormatTypeName * -OutputModule $PSHOME\Modules\Exchange -Encoding ASCII
Dessa kommandon exporterar Get
kommandona och Set
från en Snapin-modul för Microsoft Exchange Server på en fjärrdator till en Exchange-modul i $PSHOME\Modules
katalogen på den lokala datorn.
Om du placerar modulen $PSHOME\Modules
i katalogen blir den tillgänglig för alla användare av datorn.
Exempel 3: Exportera kommandon från en fjärrdator
Det här exemplet exporterar cmdletar från en PSSession på en fjärrdator och sparar dem i en modul på den lokala datorn. Cmdletarna från modulen läggs till i den aktuella sessionen så att de kan användas.
$S = New-PSSession -ComputerName Server01 -Credential Server01\User01
Export-PSSession -Session $S -OutputModule TestCmdlets -Type Cmdlet -CommandName *test* -FormatTypeName *
Remove-PSSession $S
Import-Module TestCmdlets
Get-Help Test*
Test-Files
Kommandot New-PSSession
skapar en PSSession på Server01-datorn och sparar den i variabeln $S
. Kommandot Export-PSSession
exporterar de cmdletar vars namn börjar med Test från PSSession in $S
till TestCmdlets-modulen på den lokala datorn.
Cmdleten Remove-PSSession
tar bort PSSession från $S
den aktuella sessionen. Det här kommandot visar att PSSession inte behöver vara aktiv för att använda de kommandon som importerades från sessionen. Cmdleten Import-Module
lägger till cmdletarna i modulen TestCmdlets i den aktuella sessionen. Kommandot kan köras i valfri session när som helst.
Cmdleten Get-Help
får hjälp för cmdletar vars namn börjar med Test. När kommandona i en modul har lagts till i den aktuella sessionen kan du använda Get-Help
cmdletarna och Get-Command
för att lära dig mer om de importerade kommandona. Cmdleten Test-Files
exporterades från Server01-datorn och lades till i sessionen. Cmdleten Test-Files
körs i en fjärrsession på den dator som kommandot importerades från. PowerShell skapar en session med information som lagras i modulen TestCmdlets.
Exempel 4: Exportera och klona kommandon i den aktuella sessionen
I det här exemplet exporteras kommandon som lagras i en variabel till den aktuella sessionen.
Export-PSSession -Session $S -AllowClobber -OutputModule AllCommands
Det här Export-PSSession
kommandot exporterar alla kommandon och all formatering av data från PSSession i variabeln $S
till den aktuella sessionen. Parametern AllowClobber innehåller kommandon med samma namn som kommandon i den aktuella sessionen.
Exempel 5: Exportera kommandon från en stängd PSSession
Det här exemplet visar hur du kör de exporterade kommandona med särskilda alternativ när PSSession som skapade de exporterade kommandona stängs.
Om den ursprungliga fjärrsessionen stängs när en modul importeras använder modulen alla öppna fjärrsessioner som ansluter till den ursprungliga datorn. Om det inte finns någon aktuell session på den ursprungliga datorn, kommer modulen att återupprätta en session.
Om du vill köra exporterade kommandon med särskilda alternativ i en fjärrsession måste du skapa en fjärrsession med dessa alternativ innan du importerar modulen. Använd cmdleten New-PSSession
med parametern SessionOption
$Options = New-PSSessionOption -NoMachineProfile
$S = New-PSSession -ComputerName Server01 -SessionOption $Options
Export-PSSession -Session $S -OutputModule Server01
Remove-PSSession $S
New-PSSession -ComputerName Server01 -SessionOption $Options
Import-Module Server01
Cmdleten New-PSSessionOption
skapar ett PSSessionOption-objekt och sparar objektet i variabeln $Options
. Kommandot New-PSSession
skapar en PSSession på Server01-datorn.
Parametern SessionOption använder objektet som lagras i $Options
. Sessionen lagras i variabeln $S
.
Cmdleten Export-PSSession
exporterar kommandon från PSSession till $S
Server01-modulen.
Cmdleten Remove-PSSession
tar bort PSSession i variabeln $S
.
Cmdleten New-PSSession
skapar en ny PSSession som ansluter till Server01-datorn. Parametern SessionOption använder objektet som lagras i $Options
. Cmdleten Import-Module
importerar kommandona från Server01-modulen. Kommandona i modulen körs i PSSession på Server01-datorn.
Parametrar
-AllowClobber
Exporterar de angivna kommandona, även om de har samma namn som kommandon i den aktuella sessionen.
Om du exporterar ett kommando med samma namn som ett kommando i den aktuella sessionen döljer eller ersätter det exporterade kommandot de ursprungliga kommandona. Mer information finns i about_Command_Precedence.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ArgumentList
Exporterar varianten av kommandot som resulterar från att använda de angivna argumenten (parametervärden).
Om du till exempel vill exportera -varianten Get-Item
av kommandot i certifikatenheten (Cert:) i PSSession i $S
skriver du Export-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
Anger det klientcertifikat som används för att signera formatfilerna (*. Format.ps1xml) eller skriptmodulfiler (.psm1) i modulen som Export-PSSession
skapar. Ange en variabel som innehåller ett certifikat eller ett kommando eller uttryck som hämtar certifikatet.
Om du vill hitta ett certifikat använder du cmdleten Get-PfxCertificate
eller använder cmdleten Get-ChildItem
på certifikatenheten (Cert:). Om certifikatet inte är giltigt eller inte har tillräcklig behörighet misslyckas kommandot.
Type: | X509Certificate2 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandName
Exporterar endast kommandona med de angivna namnen eller namnmönstren. Jokertecken tillåts. Använd CommandName eller dess alias, Name.
Som standard Export-PSSession
exporteras alla kommandon från PSSession förutom kommandon som har samma namn som kommandon i den aktuella sessionen. Detta förhindrar att kommandon döljs eller ersätts av kommandon i den aktuella sessionen. Om du vill exportera alla kommandon, även de som döljer eller ersätter andra kommandon, använder du parametern AllowClobber .
Om du använder parametern CommandName exporteras inte formateringsfilerna för kommandona om du inte använder parametern FormatTypeName . Om du använder parametern FormatTypeName exporteras inga kommandon om du inte använder parametern CommandName .
Type: | String[] |
Aliases: | Name |
Position: | 2 |
Default value: | All commands in the session. |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-CommandType
Exporterar endast de angivna typerna av kommandoobjekt. Använd CommandType eller dess alias, Typ.
Godkända värden för den här parametern är följande:
Alias
: Alla PowerShell-alias i den aktuella sessionen.All
: Alla kommandotyper. Det motsvararGet-Command -Name *
.Application
: Alla filer förutom PowerShell-filer i sökvägar som anges i variabeln Sökvägsmiljö ($env:path
), inklusive .txt, .exe och .dll filer.Cmdlet
: Cmdletarna i den aktuella sessionen. Cmdlet är standardvärdet.Configuration
: En PowerShell-konfiguration. Mer information finns i about_Session_Configurations.ExternalScript
: Alla .ps1-filer i sökvägarna som anges i variabeln Sökvägsmiljö ($env:path
).Filter
ochFunction
: Alla PowerShell-funktioner.Script
Skriptblock i den aktuella sessionen.Workflow
Ett PowerShell-arbetsflöde. Mer information finns i about_Workflows.
Dessa värden definieras som en flaggbaserad uppräkning. Du kan kombinera flera värden för att ange flera flaggor med hjälp av den här parametern. Värdena kan skickas till parametern CommandType som en matris med värden eller som en kommaavgränsad sträng av dessa värden. Cmdleten kombinerar värdena med hjälp av en binär-OR-åtgärd. Att skicka värden som en matris är det enklaste alternativet och du kan även använda tab-completion på värdena.
Type: | CommandTypes |
Aliases: | Type |
Accepted values: | Alias, All, Application, Cmdlet, Configuration, ExternalScript, Filter, Function, Script, Workflow |
Position: | Named |
Default value: | All commands in the session. |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encoding
Anger typen av kodning för målfilen. Standardvärdet är UTF8
.
Godkända värden för den här parametern är följande:
ASCII
: Använder ASCII(7-bitars) teckenuppsättning.BigEndianUnicode
: Använder UTF-16 med storslutsbyteordningen.Default
; Använder den kodning som motsvarar systemets aktiva kodsida.OEM
: Använder kodningen som motsvarar systemets aktuella OEM-kodsida.Unicode
: Använder UTF-16 med lite endiansk byteordning.UTF7
: Använder UTF-7.UTF8
: Använder UTF-8.UTF32
: Använder UTF-32 med lite endiansk byteordning.
Type: | String |
Accepted values: | ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32 |
Position: | Named |
Default value: | UTF8 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Skriver över en eller flera befintliga utdatafiler, även om filen har det skrivskyddade attributet.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FormatTypeName
Exporterar endast formateringsinstruktioner för de angivna Microsoft .NET Framework-typerna. Ange typnamnen. Som standard Export-PSSession
exporteras formateringsinstruktioner för alla .NET Framework-typer som inte finns i namnområdet System.Management.Automation .
Värdet för den här parametern måste vara namnet på en typ som returneras av ett Get-FormatData
kommando i sessionen som kommandona importeras från. Om du vill hämta alla formateringsdata i fjärrsessionen skriver du *
.
Om du använder parametern FormatTypeName exporteras inga kommandon om du inte använder parametern CommandName .
Om du använder parametern CommandName exporteras inte formateringsfilerna för kommandona om du inte använder parametern FormatTypeName .
Type: | String[] |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FullyQualifiedModule
Värdet kan vara ett modulnamn, en fullständig modulspecifikation eller en sökväg till en modulfil.
När värdet är en sökväg kan sökvägen vara fullständigt kvalificerad eller relativ. En relativ sökväg matchas i förhållande till skriptet som innehåller instruktionen using.
När värdet är ett namn eller en modulspecifikation söker PowerShell i PSModulePath efter den angivna modulen.
En modulspecifikation är en hashtable som har följande nycklar.
ModuleName
- Obligatoriskt Anger modulnamnet.GUID
- Valfritt Anger GUID för modulen.- Det är också Obligatoriskt att ange minst en av de tre nycklarna nedan.
ModuleVersion
– Anger en lägsta godtagbar version av modulen.MaximumVersion
– Anger den maximala godkända versionen av modulen.RequiredVersion
– Anger en exakt, nödvändig version av modulen. Detta kan inte användas med de andra versionsnycklarna.
Du kan inte ange parametern FullyQualifiedModule i samma kommando som en modulparameter . de två parametrarna är ömsesidigt uteslutande.
Type: | ModuleSpecification[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Module
Exporterar endast kommandona i de angivna PowerShell-snapin-modulerna och modulerna. Ange snapin-modulnamnen och modulnamnen. Jokertecken är inte tillåtna.
Mer information finns i Import-Module
och about_PSSnapins.
Type: | String[] |
Aliases: | PSSnapin |
Position: | Named |
Default value: | All commands in the session. |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputModule
Anger en valfri sökväg och ett namn för modulen som skapats av Export-PSSession
. Standardsökvägen är $HOME\Documents\WindowsPowerShell\Modules
. Den här parametern krävs.
Om modulunderkatalogen eller någon av filerna som Export-PSSession
skapar redan finns misslyckas kommandot. Om du vill skriva över befintliga filer använder du force-parametern.
Type: | String |
Aliases: | PSPath, ModuleName |
Position: | 1 |
Default value: | $HOME\Documents\WindowsPowerShell\Modules |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Session
Anger PSSession som kommandona exporteras från. Ange en variabel som innehåller ett sessionsobjekt eller ett kommando som hämtar ett sessionsobjekt, till exempel ett Get-PSSession
kommando. Den här parametern krävs.
Type: | PSSession |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
None
Du kan inte skicka objekt till den här cmdleten.
Utdata
Den här cmdleten returnerar en lista över filer som utgör modulen som den skapade.
Kommentarer
Windows PowerShell innehåller följande alias för Export-PSSession
:
epsn
Export-PSSession
förlitar sig på PowerShell-fjärrkommunikationsinfrastrukturen. Om du vill använda den här cmdleten måste datorn konfigureras för fjärrkommunikation. Mer information finns i about_Remote_Requirements.
Du kan inte använda Export-PSSession
för att exportera en PowerShell-provider.
Exporterade kommandon körs implicit i PSSession som de exporterades från. Information om hur du kör kommandona via fjärranslutning hanteras helt av PowerShell. Du kan köra de exporterade kommandona precis som du skulle köra lokala kommandon.
Export-ModuleMember
samlar in och sparar information om PSSession i modulen som den exporterar. Om PSSession som kommandona exporterades från stängs när du importerar modulen, och det inte finns några aktiva PSSessioner till samma dator, försöker kommandona i modulen återskapa PSSession. Om försöken att återskapa PSSession misslyckas körs inte de exporterade kommandona.
Sessionsinformationen som Export-ModuleMember
samlar in och sparar i modulen innehåller inte sessionsalternativ, till exempel de som du anger i $PSSessionOption
inställningsvariabeln eller med parametern SessionOption i New-PSSession
cmdletarna , Enter-PSSession
eller Invoke-Command
. Om den ursprungliga PSSessionen stängs när du importerar modulen använder modulen en annan PSSession till samma dator, om en är tillgänglig. Om du vill att de importerade kommandona ska köras i en korrekt konfigurerad session skapar du en PSSession med de alternativ som du vill använda innan du importerar modulen.
Om du vill hitta de kommandon som ska exporteras Export-PSSession
använder du cmdleten Invoke-Command
för att köra ett Get-Command
kommando i PSSession. För att hämta och spara formateringsdata för kommandona använder den Get-FormatData
cmdletarna och Export-FormatData
. Du kan se felmeddelanden från Invoke-Command
, Get-Command
, Get-FormatData
och Export-FormatData
när du kör ett Export-PSSession
kommando. Export-PSSession
Det går inte heller att exportera kommandon från en session som inte innehåller Get-Command
cmdletarna , Get-FormatData
, Select-Object
och Get-Help
.
Export-PSSession
använder cmdleten Write-Progress
för att visa förloppet för kommandot. Du kan se förloppsindikatorn medan kommandot körs.
Exporterade kommandon har samma begränsningar som andra fjärrkommandon, inklusive oförmågan att starta ett program med ett användargränssnitt, till exempel Anteckningar.
Eftersom PowerShell-profiler inte körs i PSSessioner är kommandona som en profil lägger till i en session inte tillgängliga för Export-PSSession
. Om du vill exportera kommandon från en profil använder du ett Invoke-Command
kommando för att köra profilen i PSSession manuellt innan du exporterar kommandon.
Modulen som Export-PSSession
skapar kan innehålla en formateringsfil, även om kommandot inte importerar formateringsdata. Om kommandot inte importerar formateringsdata innehåller formateringsfiler som skapas inte formateringsdata.
Relaterade länkar
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för