Export-PSSession
Exporterar kommandon från en annan session och sparar dem i en PowerShell-modul.
Syntax
Export-PSSession
[-OutputModule] <String>
[-Force]
[-Encoding <Encoding>]
[[-CommandName] <String[]>]
[-AllowClobber]
[-ArgumentList <Object[]>]
[-CommandType <CommandTypes>]
[-Module <String[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[[-FormatTypeName] <String[]>]
[-Certificate <X509Certificate2>]
[-Session] <PSSession>
[<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 Server01Kommandot 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 ASCIIDessa 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-FilesKommandot 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 AllCommandsDet 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 Server01Cmdleten 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 $Sskriver 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).FilterochFunction: Alla PowerShell-funktioner.ScriptSkriptblock i den aktuella sessionen.WorkflowEtt 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 utf8NoBOM.
Godkända värden för den här parametern är följande:
ascii: Använder kodningen för ASCII-teckenuppsättningen (7-bitars).bigendianunicode: Kodar i UTF-16-format med hjälp av den stora byteordningen.bigendianutf32: Kodar i UTF-32-format med hjälp av storslutsbyteordningen.oem: Använder standardkodning för MS-DOS och konsolprogram.unicode: Kodar i UTF-16-format med hjälp av den lite endianska byteordningen.utf7: Kodar i UTF-7-format.utf8: Kodar i UTF-8-format.utf8BOM: Kodar i UTF-8-format med Byte Order Mark (BOM)utf8NoBOM: Kodar i UTF-8-format utan Byte Order Mark (BOM)utf32: Kodar i UTF-32-format.
Från och med PowerShell 6.2 tillåter kodningsparametern även numeriska ID:n för registrerade kodsidor (till exempel -Encoding 1251) eller strängnamn för registrerade kodsidor (till exempel -Encoding "windows-1251"). Mer information finns i .NET-dokumentationen för Encoding.CodePage.
| Type: | Encoding |
| Accepted values: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | Named |
| Default value: | UTF8NoBOM |
| 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
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-PSSessioncmdletarna , Enter-PSSessioneller 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-FormatDataoch 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-Commandcmdletarna , Get-FormatData, Select-Objectoch 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
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: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för