Export-Console
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ır
Add-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
Bir yol dizesini bu cmdlet'e yöneltebilirsiniz.
Çıkışlar
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
$ConsoleFileNameotomatik olarak depolanır. yeni bir konsol dosyası belirtmek için path parametresini
Export-Consolekullandığınızda değeri
$ConsoleFileNamegü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.
İlişkili Bağlantılar
Geri Bildirim
Gönderin ve geri bildirimi görüntüleyin