Export-Console

  • Referência
Módulo:
Microsoft.PowerShell.Core

Exporta os nomes dos snap-ins na sessão atual para um ficheiro de consola.

Syntax

Export-Console
      [[-Path] <String>]
      [-Force]
      [-NoClobber]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O Export-Console cmdlet exporta os nomes dos snap-ins Windows PowerShell na sessão atual para um ficheiro de consola Windows PowerShell (.psc1). Pode utilizar este cmdlet para guardar os snap-ins para utilização em sessões futuras.

Para adicionar os snap-ins no ficheiro de consola .psc1 a uma sessão, inicie Windows PowerShell (PowerShell.exe) na linha de comandos com Cmd.exe ou outra sessão de Windows PowerShell e, em seguida, utilize o parâmetro PSConsoleFile de PowerShell.exe para especificar o ficheiro da consola.

Para obter mais informações sobre Windows PowerShell snap-ins, consulte about_PSSnapins.

Exemplos

Exemplo 1: Exportar os nomes dos snap-ins na sessão atual

PS C:\> Export-Console -Path $pshome\Consoles\ConsoleS1.psc1

Este comando exporta os nomes de Windows PowerShell snap-ins na sessão atual para o ConsoleS1.psc1 ficheiro na pasta Consolas da pasta de instalação do Windows PowerShell, $pshome.

Exemplo 2: exportar os nomes dos snap-ins para o ficheiro de consola mais recente

Export-Console

Este comando exporta os nomes de Windows PowerShell snap-ins da sessão atual para o ficheiro de consola do Windows PowerShell utilizado mais recentemente na sessão atual. Substitui o conteúdo do ficheiro anterior.

Se não exportou um ficheiro de consola durante a sessão atual, ser-lhe-á pedida permissão para continuar e, em seguida, ser-lhe-á pedido um nome de ficheiro.

Exemplo 3: Adicionar um snap-in e exportar os nomes dos snap-ins

Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1

Estes comandos adicionam o snap-in NewPSSnapin Windows PowerShell à sessão atual, exportam os nomes dos Windows PowerShell snap-ins na sessão atual para um ficheiro de consola e, em seguida, iniciam uma sessão de Windows PowerShell com o ficheiro da consola.

O primeiro comando utiliza o Add-PSSnapin cmdlet para adicionar o snap-in NewPSSnapin à sessão atual. Só pode adicionar Windows PowerShell snap-ins registados no seu sistema.

O segundo comando exporta os Windows PowerShell nomes de snap-in para o NewPSSnapinConsole.psc1 ficheiro.

O terceiro comando começa Windows PowerShell com o NewPSSnapinConsole.psc1 ficheiro. Uma vez que o ficheiro de consola inclui o Windows PowerShell nome de snap-in, os cmdlets e fornecedores no snap-in estão disponíveis na sessão atual.

Exemplo 4: Exportar nomes de snap-ins para uma localização especificada

PS C:\> export-console -path Console01
PS C:\> notepad console01.psc1
<?xml version="1.0" encoding="utf-8"?>
<PSConsoleFile ConsoleSchemaVersion="1.0">
  <PSVersion>2.0</PSVersion>
  <PSSnapIns>
     <PSSnapIn Name="NewPSSnapin" />
  </PSSnapIns>
</PSConsoleFile>

Este comando exporta os nomes das Windows PowerShell snap-ins na sessão atual para o Console01.psc1 ficheiro no diretório atual.

O segundo comando apresenta o conteúdo do Console01.psc1 ficheiro no Bloco de Notas.

Exemplo 5: Determinar o ficheiro da consola a atualizar

powershell.exe -PSConsoleFile Console01.psc1
Add-PSSnapin MySnapin
Export-Console NewConsole.psc1
$ConsoleFileName
Add-PSSnapin SnapIn03
Export-Console

Este exemplo mostra como utilizar a $ConsoleFileName variável automática para determinar o ficheiro de consola que será atualizado se utilizar Export-Console sem um valor de parâmetro Caminho .

O primeiro comando utiliza o parâmetro PSConsoleFile de PowerShell.exe para abrir Windows PowerShell com o Console01.psc1 ficheiro.

O segundo comando utiliza o Add-PSSnapin cmdlet para adicionar o snap-in mySnapin Windows PowerShell à sessão atual.

O terceiro comando utiliza o Export-Console cmdlet para exportar os nomes de todas as Windows PowerShell snap-ins na sessão para o NewConsole.psc1 ficheiro.

O quarto comando apresenta a $ConsoleFileName variável. Contém o ficheiro de consola utilizado mais recentemente. A saída de exemplo mostra que NewConsole.ps1 é o ficheiro utilizado mais recentemente.

O quinto comando adiciona SnapIn03 à consola atual.

O sexto comando utiliza o Export-Console cmdlet sem um parâmetro Path . Este comando exporta os nomes de todas as Windows PowerShell snap-ins na sessão atual para o ficheiro utilizado mais recentemente, NewConsole.psc1.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Indica que este cmdlet substitui os dados num ficheiro de consola sem aviso, mesmo que o ficheiro tenha o atributo só de leitura. O atributo só de leitura é alterado e não é reposto quando o comando é concluído.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NoClobber

Indica que este cmdlet não substitui um ficheiro de consola existente. Por predefinição, se ocorrer um ficheiro no caminho especificado, Export-Console substitui o ficheiro sem aviso prévio.

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Path

Especifica um caminho e um nome de ficheiro para o ficheiro de consola (*.psc1). Introduza um caminho e um nome opcionais. Os carateres universais não são permitidos.

Se especificar apenas um nome de ficheiro, Export-Console cria um ficheiro com esse nome e a extensão de nome de ficheiro .psc1 no diretório atual.

Este parâmetro é necessário, a menos que tenha aberto Windows PowerShell com o parâmetro PSConsoleFile ou exportado um ficheiro de consola durante a sessão atual. Também é necessário quando utiliza o parâmetro NoClobber para impedir que o ficheiro de consola atual seja substituído.

Se omitir este parâmetro, Export-Console substitui o ficheiro de consola utilizado mais recentemente nesta sessão. O caminho do ficheiro de consola utilizado mais recentemente é armazenado no valor da variável automática $ConsoleFileName. Para obter mais informações, veja about_Automatic_Variables.

Type:String
Aliases:PSPath
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Pode encaminhar uma cadeia de caminho para este cmdlet.

Saídas

FileInfo

Este cmdlet cria um ficheiro que contém os aliases exportados.

Notas

  • Quando um ficheiro de consola (.psc1) é utilizado para iniciar a sessão, o nome do ficheiro da consola é armazenado automaticamente na $ConsoleFileName variável automática. O valor de $ConsoleFileName é atualizado quando utiliza o parâmetro Caminho de para especificar um novo ficheiro de Export-Console consola. Quando não é utilizado nenhum ficheiro de consola, $ConsoleFileName não tem valor ($null).

    Para utilizar um ficheiro de consola Windows PowerShell numa nova sessão, utilize a seguinte sintaxe para iniciar Windows PowerShell:

    powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1

    Também pode guardar Windows PowerShell snap-ins para futuras sessões ao adicionar um comando Add-PSSnapin ao seu perfil de Windows PowerShell. Para obter mais informações, veja about_Profiles.