Export-Console

Modül:
Microsoft.PowerShell.Core Module

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

Syntax

Default (Varsayılan) 

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

Description

Export-Console cmdlet'i 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 ' i (powershell.exe) başlatın ve ardından konsol dosyasını belirtmek için psConsoleFile powershell.exe 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 Windows PowerShell ek bileşenlerinin adlarını Windows PowerShell yükleme klasörünün Konsollar klasöründeki ConsoleS1.psc1 dosyasına aktarır $PSHOME.

Ö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, NewPSSnapin ek bileşenini geçerli oturuma eklemek için Add-PSSnapin cmdlet'ini kullanır. Yalnızca sisteminizde kayıtlı Windows PowerShell ek bileşenleri ekleyebilirsiniz.

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

Üçüncü komut Windows PowerShell'i NewPSSnapinConsole.psc1 dosyasıyla başlatır. 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 Console01.psc1 dosyasına aktarır.

İkinci komut, Console01.psc1 dosyasının içeriğini 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, $ConsoleFileName parametre değeri olmadan Export-Console kullanırsanız güncelleştirilecek konsol dosyasını belirlemek için otomatik değişkeninin nasıl kullanılacağı gösterilmektedir.

İlk komut, windows PowerShell'i dosyasıyla açmak için powershell.exeConsole01.psc1 parametresini kullanır.

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

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

Dördüncü komut $ConsoleFileName değişkenini 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'i geçerli konsola ekler.

Altıncı komut, Export-Console parametresi olmadan cmdlet'ini kullanır. Bu komut, geçerli oturumdaki tüm Windows PowerShell ek bileşenlerinin adlarını NewConsole.psc1en son kullanılan dosyaya aktarır.

Parametreler

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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 özniteliği değiştirilir ve komut tamamlandığında sıfırlanmaz.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:NoOverwrite

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Path

Konsol dosyası için bir yol ve dosya adı belirtir (*.psc1). İ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.

Windows PowerShell'i PSConsoleFile parametresiyle 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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:PSPath

Parametre kümeleri

(All)
Position:0
Zorunlu:False
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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 olarak $ConsoleFileName otomatik değişkeninde depolanır. yeni bir konsol dosyası belirtmek için $ConsoleFileNamePath parametresini kullandığınızda Export-Console değeri güncelleştirilir. Konsol dosyası kullanılmadığında, $ConsoleFileName değeri yoktur ($null).

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

    powershell.exe -PSConsoleFile <ConsoleFile>.psc1

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