Export-Console

  • Başvuru
Modül:
Microsoft.PowerShell.Core

Geçerli oturumdaki ek bileşen adlarını bir konsol dosyasına aktarır.

Syntax

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

Description

Cmdlet, Export-Console geçerli oturumdaki Windows PowerShell ek bileşenlerinin adlarını bir Windows PowerShell konsol dosyasına (.psc1) aktarır. Ek bileşenleri gelecek oturumlarda kullanmak üzere kaydetmek için bu cmdlet'i kullanabilirsiniz.

.psc1 konsol dosyasındaki ek bileşenleri bir oturuma eklemek için, Cmd.exe veya başka bir Windows PowerShell oturumu kullanarak komut satırında Windows PowerShell (PowerShell.exe) başlatın ve konsol dosyasını belirtmek için PowerShell.exe PSConsoleFile parametresini kullanın.

Windows PowerShell ek bileşenleri hakkında daha fazla bilgi için bkz. about_PSSnapins.

Örnekler

Örnek 1: Geçerli oturumdaki ek bileşen adlarını dışarı aktarma

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

Bu komut, geçerli oturumdaki ConsoleS1.psc1 Windows PowerShell ek bileşenlerinin adlarını Windows PowerShell yükleme klasörünün Konsollar klasöründeki dosyaya $pshomeaktarır.

Örnek 2: Ek bileşen adlarını en son konsol dosyasına dışarı aktarma

Export-Console

Bu komut, geçerli oturumdaki Windows PowerShell ek bileşenlerinin adlarını geçerli oturumda en son kullanılan Windows PowerShell konsol dosyasına aktarır. Önceki dosya içeriğinin üzerine yazar.

Geçerli oturum sırasında bir konsol dosyasını dışarı aktarmadıysanız, devam etmek için izniniz istenir ve ardından bir dosya adı istenir.

Örnek 3: Ek bileşen ekleme ve ek bileşen adlarını dışarı aktarma

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

Bu komutlar NewPSSnapin Windows PowerShell ek bileşenini geçerli oturuma ekler, geçerli oturumdaki Windows PowerShell ek bileşenlerinin adlarını bir konsol dosyasına aktarır ve ardından konsol dosyasıyla bir Windows PowerShell oturumu başlatır.

İlk komut, geçerli oturuma NewPSSnapin ek bileşenini eklemek için cmdlet'ini kullanır Add-PSSnapin . Yalnızca sisteminizde kayıtlı Windows PowerShell ek bileşenleri ekleyebilirsiniz.

İkinci komut, Windows PowerShell ek bileşen adlarını dosyaya NewPSSnapinConsole.psc1 aktarır.

Üçüncü komut, dosyayla NewPSSnapinConsole.psc1 Windows PowerShell başlar. Konsol dosyası Windows PowerShell ek bileşeni adını içerdiğinden, ek bileşendeki cmdlet'ler ve sağlayıcılar geçerli oturumda kullanılabilir.

Örnek 4: Ek bileşen adlarını belirtilen bir konuma dışarı aktarma

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>

Bu komut, geçerli oturumdaki Windows PowerShell ek bileşenlerinin adlarını geçerli dizindeki dosyaya Console01.psc1 aktarır.

İkinci komut, dosyanın içeriğini Console01.psc1 Not Defteri'nde görüntüler.

Örnek 5: Güncelleştirilecek konsol dosyasını belirleme

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

Bu örnekte, Path parametre değeri olmadan kullanırsanız güncelleştirilecek konsol dosyasını belirlemek için otomatik değişkenin nasıl $ConsoleFileName kullanılacağı Export-Console gösterilmektedir.

İlk komut, dosyayla Windows PowerShell açmak için PowerShell.exe PSConsoleFile parametresini Console01.psc1 kullanır.

İkinci komut, geçerli oturuma MySnapin Windows PowerShell ek bileşenini eklemek için cmdlet'ini kullanırAdd-PSSnapin.

Üçüncü komut, oturumdaki Export-Console tüm Windows PowerShell ek bileşenlerinin adlarını dosyaya aktarmak için cmdlet'ini NewConsole.psc1 kullanır.

Dördüncü komut değişkenini $ConsoleFileName görüntüler. En son kullanılan konsol dosyasını içerir. Örnek çıktı, NewConsole.ps1 en son kullanılan dosya olduğunu gösterir.

Beşinci komut SnapIn03'ü geçerli konsola ekler.

Altıncı komut, cmdlet'ini Export-ConsolePath parametresi olmadan kullanır. Bu komut, geçerli oturumdaki tüm Windows PowerShell ek bileşenlerinin adlarını en son kullanılan dosyasına NewConsole.psc1aktarır.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-Force

Dosya salt okunur özniteliğine sahip olsa bile, bu cmdlet'in bir konsol dosyasındaki verilerin üzerine uyarı vermeden yazdığını gösterir. Salt okunur öznitelik değiştirilir ve komut tamamlandığında sıfırlanmaz.

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

-NoClobber

Bu cmdlet'in var olan bir konsol dosyasının üzerine yazmadığını gösterir. Varsayılan olarak, belirtilen yolda bir dosya oluşursa, Export-Console uyarı olmadan dosyanın üzerine yazar.

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

-Path

Konsol dosyası () için bir yol ve dosya*.psc1 adı belirtir. İsteğe bağlı bir yol ve ad girin. Joker karakterlere izin verilmez.

Yalnızca bir dosya adı belirtirseniz, Export-Console geçerli dizinde bu ada ve .psc1 dosya adı uzantısına sahip bir dosya oluşturur.

PsConsoleFile parametresiyle Windows PowerShell açmadıysanız veya geçerli oturum sırasında bir konsol dosyasını dışarı aktarmadıysanız bu parametre gereklidir. Geçerli konsol dosyasının üzerine yazılmasını önlemek için NoClobber parametresini kullandığınızda da gereklidir.

Bu parametreyi atlarsanız, Export-Console bu oturumda en son kullanılan konsol dosyasının üzerine yazar. En son kullanılan konsol dosyasının yolu $ConsoleFileName otomatik değişkeninin değerinde depolanır. Daha fazla bilgi için bkz. about_Automatic_Variables.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

String

Bir yol dizesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

FileInfo

Bu cmdlet, dışarı aktarılan diğer adları içeren bir dosya oluşturur.

Notlar

  • Oturumu başlatmak için bir konsol dosyası (.psc1) kullanıldığında, konsol dosyasının adı otomatik değişkende $ConsoleFileName otomatik olarak depolanır. yeni bir konsol dosyası belirtmek için path parametresini Export-Console kullandığınızda değeri $ConsoleFileName güncelleştirilir. Konsol dosyası kullanılmadığında, $ConsoleFileName değeri ($null) yoktur.

    Yeni bir oturumda Windows PowerShell konsol dosyası kullanmak için, Windows PowerShell başlatmak için aşağıdaki söz dizimini kullanın:

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

    ayrıca Windows PowerShell profilinize Add-PSSnapin komutu ekleyerek Windows PowerShell ek bileşenlerini gelecekteki oturumlar için kaydedebilirsiniz. Daha fazla bilgi için bkz. about_Profiles.