Export-PSSession

Sintassi

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>]

Descrizione

Il Export-PSSession cmdlet ottiene cmdlet, funzioni, alias e altri tipi di comando da un'altra sessione di PowerShell (PSSession) in un computer locale o remoto e li salva in un modulo di PowerShell. Per aggiungere i comandi dal modulo alla sessione corrente, usare il Import-Module cmdlet .

A differenza di Import-PSSession, che importa i comandi da un'altra sessione PSSession nella sessione corrente, Export-PSSession salva i comandi in un modulo. I comandi non vengono importati nella sessione corrente.

Per esportare i comandi, usare il New-PSSession cmdlet per creare una sessione PSSession con i comandi da esportare. Usare quindi il Export-PSSession cmdlet per esportare i comandi.

Per evitare conflitti di nomi di comando, l'impostazione predefinita per Export-PSSession consiste nell'esportare tutti i comandi, ad eccezione dei comandi presenti nella sessione corrente. È possibile usare il parametro CommandName per specificare i comandi da esportare.

Il Export-PSSession cmdlet usa la funzionalità di comunicazione remota implicita di PowerShell. Quando si importano i comandi nella sessione corrente, vengono eseguiti implicitamente nella sessione originale o in una sessione simile nel computer di origine.

Esempio

Esempio 1: Esportare i comandi da una sessione PSSession

In questo esempio viene creata una nuova sessione PSSession dal computer locale al computer Server01. Tutti i comandi, ad eccezione di quelli presenti nella sessione corrente, vengono esportati nel modulo denominato Server01 nel computer locale. L'esportazione include i dati di formattazione per i comandi.

$S = New-PSSession -ComputerName Server01
Export-PSSession -Session $S -OutputModule Server01

Il New-PSSession comando crea una sessione PSSession nel computer Server01. La sessione PSSession viene archiviata nella $S variabile . Il Export-PSSession comando esporta i $S comandi della variabile e i dati di formattazione nel modulo Server01.

Esempio 2: Esportare i comandi Get e Set

In questo esempio vengono esportati tutti i Get comandi e Set da un 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

Questi comandi esportano i Get comandi e Set da uno snap-in di Microsoft Exchange Server in un computer remoto in un modulo di Exchange nella $PSHOME\Modules directory del computer locale. L'inserimento del $PSHOME\Modules modulo nella directory rende accessibile a tutti gli utenti del computer.

Esempio 3: Esportare i comandi da un computer remoto

Questo esempio esporta i cmdlet da una sessione PSSession in un computer remoto e li salva in un modulo nel computer locale. I cmdlet del modulo vengono aggiunti alla sessione corrente in modo che possano essere usati.

$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

Il New-PSSession comando crea una sessione PSSession nel computer Server01 e la salva nella $S variabile . Il Export-PSSession comando esporta i cmdlet i cui nomi iniziano con Test dalla sessione PSSession in $S nel modulo TestCmdlets nel computer locale.

Il Remove-PSSession cmdlet elimina la sessione PSSession in $S dalla sessione corrente. Questo comando mostra che la sessione PSSession non deve essere attiva per usare i comandi importati dalla sessione. Il Import-Module cmdlet aggiunge i cmdlet nel modulo TestCmdlets alla sessione corrente. Il comando può essere eseguito in qualsiasi sessione in qualsiasi momento.

Il Get-Help cmdlet ottiene la Guida per i cmdlet i cui nomi iniziano con Test. Dopo aver aggiunto i comandi in un modulo alla sessione corrente, è possibile usare i Get-Help cmdlet e Get-Command per ottenere informazioni sui comandi importati. Il Test-Files cmdlet è stato esportato dal computer Server01 e aggiunto alla sessione. Il Test-Files cmdlet viene eseguito in una sessione remota nel computer da cui è stato importato il comando. PowerShell crea una sessione dalle informazioni archiviate nel modulo TestCmdlets.

Esempio 4: Esportare e clobber comandi nella sessione corrente

In questo esempio vengono esportati i comandi archiviati in una variabile nella sessione corrente.

Export-PSSession -Session $S -AllowClobber -OutputModule AllCommands

Questo Export-PSSession comando esporta tutti i comandi e tutti i dati di formattazione dalla sessione PSSession nella $S variabile nella sessione corrente. Il parametro AllowClobber include comandi con gli stessi nomi dei comandi nella sessione corrente.

Esempio 5: Esportare i comandi da una sessione PSSession chiusa

In questo esempio viene illustrato come eseguire i comandi esportati con opzioni speciali quando la sessione PSSession che ha creato i comandi esportati viene chiusa.

Se la sessione remota originale viene chiusa quando viene importato un modulo, il modulo userà qualsiasi sessione remota aperta che si connette al computer di origine. Se non è presente alcuna sessione corrente nel computer di origine, il modulo ristabilirà una sessione.

Per eseguire comandi esportati con opzioni speciali in una sessione remota, è necessario creare una sessione remota con tali opzioni prima di importare il modulo. Usare il New-PSSession cmdlet con il parametro 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

Il New-PSSessionOption cmdlet crea un oggetto PSSessionOption e salva l'oggetto nella $Options variabile . Il New-PSSession comando crea una sessione PSSession nel computer Server01. Il parametro SessionOption usa l'oggetto archiviato in $Options. La sessione viene archiviata nella $S variabile .

Il Export-PSSession cmdlet esporta i comandi dalla sessione PSSession nel $S modulo Server01. Il Remove-PSSession cmdlet elimina la sessione PSSession nella $S variabile .

Il New-PSSession cmdlet crea una nuova sessione PSSession che si connette al computer Server01. Il parametro SessionOption usa l'oggetto archiviato in $Options. Il Import-Module cmdlet importa i comandi dal modulo Server01. I comandi nel modulo vengono eseguiti nella sessione PSSession nel computer Server01.

Parametri

-AllowClobber

-ArgumentList

-Certificate

-CommandName

-CommandType

-Encoding

-Force

-FormatTypeName

-FullyQualifiedModule

-Module

-OutputModule

-Session

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

FileInfo

Questo cmdlet restituisce un elenco di file che comprendono il modulo creato.

Note

Export-PSSession si basa sull'infrastruttura remota di PowerShell. Per usare questo cmdlet, il computer deve essere configurato per la comunicazione remota. Per altre informazioni, vedere about_Remote_Requirements.

Non è possibile usare Export-PSSession per esportare un provider di PowerShell.

I comandi esportati vengono eseguiti in modo implicito nella sessione PSSession da cui sono stati esportati. I dettagli dell'esecuzione remota dei comandi vengono gestiti interamente da PowerShell. È possibile eseguire i comandi esportati nello stesso modo dei comandi locali.

Export-ModuleMember acquisisce e salva informazioni sulla sessione PSSession nel modulo esportato. Se la sessione PSSession da cui sono stati esportati i comandi viene chiusa quando si importa il modulo e non sono presenti sessioni PSSession attive nello stesso computer, i comandi nel modulo tentano di ricreare la sessione PSSession. Se i tentativi di ricreare la sessione PSSession hanno esito negativo, i comandi esportati non verranno eseguiti.

Le informazioni sulla sessione acquisite Export-ModuleMember e salvate nel modulo non includono opzioni di sessione, ad esempio quelle specificate nella $PSSessionOption variabile di preferenza o usando il parametro SessionOption dei New-PSSessioncmdlet , Enter-PSSessiono Invoke-Command . Se la sessione PSSession originale è chiusa quando si importa il modulo, il modulo userà un'altra sessione PSSession nello stesso computer, se disponibile. Per consentire ai comandi importati di essere eseguiti in una sessione configurata correttamente, creare una sessione PSSession con le opzioni desiderate prima di importare il modulo.

Per trovare i comandi da esportare, Export-PSSession usa il Invoke-Command cmdlet per eseguire un Get-Command comando nella sessione PSSession. Per ottenere e salvare i dati di formattazione per i comandi, usa i Get-FormatData cmdlet e Export-FormatData . È possibile che vengano visualizzati messaggi di errore da Invoke-Command, Get-CommandGet-FormatData, e Export-FormatData quando si esegue un Export-PSSession comando. Inoltre, Export-PSSession non è possibile esportare i comandi da una sessione che non include i Get-Commandcmdlet , Get-FormatData, Select-Objecte Get-Help .

Export-PSSession usa il Write-Progress cmdlet per visualizzare lo stato di avanzamento del comando. È possibile che venga visualizzato l'indicatore di stato durante l'esecuzione del comando.

I comandi esportati hanno le stesse limitazioni degli altri comandi remoti, inclusa l'impossibilità di avviare un programma con un'interfaccia utente, ad esempio il Blocco note.

Poiché i profili di PowerShell non vengono eseguiti in PSSessions, i comandi aggiunti da un profilo a una sessione non sono disponibili per Export-PSSession. Per esportare i comandi da un profilo, usare un Invoke-Command comando per eseguire manualmente il profilo nella sessione PSSession prima di esportare i comandi.

Il modulo che Export-PSSession crea può includere un file di formattazione, anche se il comando non importa i dati di formattazione. I file di formattazione creati non conterranno dati di formattazione se il comando non li importa.

Collegamenti correlati

• about_Command_Precedence
• about_PSSessions
• about_PSSnapins
• about_Remote_Requirements
• Import-Module
• Import-PSSession
• Invoke-Command
• New-PSSession
• New-PSSessionOption
• Remove-PSSession