Export-Console
Mengekspor nama snap-in dalam sesi saat ini ke file konsol.
Sintaks
Export-Console
[[-Path] <String>]
[-Force]
[-NoClobber]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Deskripsi
Export-Console Cmdlet mengekspor nama snap-in Windows PowerShell dalam sesi saat ini ke file konsol Windows PowerShell (.psc1). Anda dapat menggunakan cmdlet ini untuk menyimpan snap-in untuk digunakan dalam sesi mendatang.
Untuk menambahkan snap-in dalam file konsol .psc1 ke sesi, mulai Windows PowerShell (PowerShell.exe) di baris perintah dengan menggunakan Cmd.exe atau sesi Windows PowerShell lainnya, lalu gunakan parameter PSConsoleFile dari PowerShell.exe untuk menentukan file konsol.
Untuk informasi selengkapnya tentang snap-in Windows PowerShell, lihat about_PSSnapins.
Contoh
Contoh 1: Mengekspor nama snap-in dalam sesi saat ini
PS C:\> Export-Console -Path $pshome\Consoles\ConsoleS1.psc1Perintah ini mengekspor nama snap-in Windows PowerShell dalam sesi saat ini ke ConsoleS1.psc1 file di folder Konsol folder penginstalan Windows PowerShell, $pshome.
Contoh 2: Mengekspor nama snap-in ke file konsol terbaru
Export-ConsolePerintah ini mengekspor nama snap-in Windows PowerShell dari sesi saat ini ke file konsol Windows PowerShell yang terakhir digunakan dalam sesi saat ini. Ini menimpa isi file sebelumnya.
Jika Anda belum mengekspor file konsol selama sesi saat ini, Anda dimintai izin untuk melanjutkan lalu dimintai nama file.
Contoh 3: Menambahkan snap-in dan mengekspor nama snap-in
Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1Perintah ini menambahkan snap-in Windows PowerShell NewPSSnapin ke sesi saat ini, mengekspor nama snap-in Windows PowerShell dalam sesi saat ini ke file konsol, lalu memulai sesi Windows PowerShell dengan file konsol.
Perintah pertama menggunakan Add-PSSnapin cmdlet untuk menambahkan snap-in NewPSSnapin ke sesi saat ini. Anda hanya dapat menambahkan snap-in Windows PowerShell yang terdaftar di sistem Anda.
Perintah kedua mengekspor nama snap-in Windows PowerShell ke NewPSSnapinConsole.psc1 file.
Perintah ketiga memulai Windows PowerShell dengan NewPSSnapinConsole.psc1 file . Karena file konsol menyertakan nama snap-in Windows PowerShell, cmdlet dan penyedia dalam snap-in tersedia dalam sesi saat ini.
Contoh 4: Mengekspor nama snap-in ke lokasi tertentu
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>Perintah ini mengekspor nama snap-in Windows PowerShell dalam sesi saat ini ke Console01.psc1 file di direktori saat ini.
Perintah kedua menampilkan konten Console01.psc1 file di Notepad.
Contoh 5: Tentukan file konsol yang akan diperbarui
powershell.exe -PSConsoleFile Console01.psc1
Add-PSSnapin MySnapin
Export-Console NewConsole.psc1
$ConsoleFileName
Add-PSSnapin SnapIn03
Export-ConsoleContoh ini menunjukkan cara menggunakan $ConsoleFileName variabel otomatis untuk menentukan file konsol yang akan diperbarui jika Anda menggunakan Export-Console tanpa nilai parameter Jalur .
Perintah pertama menggunakan parameter PSConsoleFile dari PowerShell.exe untuk membuka Windows PowerShell dengan Console01.psc1 file .
Perintah kedua menggunakan Add-PSSnapin cmdlet untuk menambahkan snap-in MySnapin Windows PowerShell ke sesi saat ini.
Perintah ketiga menggunakan Export-Console cmdlet untuk mengekspor nama semua snap-in Windows PowerShell dalam sesi ke NewConsole.psc1 file.
Perintah keempat menampilkan $ConsoleFileName variabel . Ini berisi file konsol yang terakhir digunakan. Output sampel menunjukkan bahwa NewConsole.ps1 adalah file yang terakhir digunakan.
Perintah kelima menambahkan SnapIn03 ke konsol saat ini.
Perintah keenam menggunakan Export-Console cmdlet tanpa parameter Path . Perintah ini mengekspor nama semua snap-in Windows PowerShell dalam sesi saat ini ke file yang terakhir digunakan, NewConsole.psc1.
Parameter
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
| Jenis: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Nilai default: | False |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Force
Menunjukkan bahwa cmdlet ini menimpa data dalam file konsol tanpa peringatan, bahkan jika file memiliki atribut baca-saja. Atribut baca-saja diubah dan tidak diatur ulang ketika perintah selesai.
| Jenis: | SwitchParameter |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-NoClobber
Menunjukkan bahwa cmdlet ini tidak menimpa file konsol yang ada. Secara default, jika file terjadi di jalur yang ditentukan, Export-Console timpa file tanpa peringatan.
| Jenis: | SwitchParameter |
| Alias: | NoOverwrite |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-Path
Menentukan jalur dan nama file untuk file konsol (*.psc1). Masukkan jalur dan nama opsional.
Karakter kartubebas tidak diizinkan.
Jika Anda hanya menentukan nama file, Export-Console buat file yang memiliki nama tersebut dan ekstensi nama file .psc1 di direktori saat ini.
Parameter ini diperlukan kecuali Anda telah membuka Windows PowerShell dengan parameter PSConsoleFile atau mengekspor file konsol selama sesi saat ini. Ini juga diperlukan ketika Anda menggunakan parameter NoClobber untuk mencegah file konsol saat ini ditimpa.
Jika Anda menghilangkan parameter ini, Export-Console timpa file konsol yang terakhir digunakan dalam sesi ini. Jalur file konsol yang terakhir digunakan disimpan dalam nilai variabel otomatis $ConsoleFileName. Untuk informasi selengkapnya, lihat about_Automatic_Variables.
| Jenis: | String |
| Alias: | PSPath |
| Position: | 0 |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | True |
| Terima karakter wildcard: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
| Jenis: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Nilai default: | False |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
Input
Anda dapat menyalurkan string jalur ke cmdlet ini.
Output
Cmdlet ini membuat file yang berisi alias yang diekspor.
Catatan
Saat file konsol (
.psc1) digunakan untuk memulai sesi, nama file konsol secara otomatis disimpan dalam$ConsoleFileNamevariabel otomatis. Nilai$ConsoleFileNamediperbarui saat Anda menggunakan parameterExport-ConsoleJalur untuk menentukan file konsol baru. Ketika tidak ada file konsol yang digunakan, $ConsoleFileName tidak memiliki nilai ($null).Untuk menggunakan file konsol Windows PowerShell dalam sesi baru, gunakan sintaks berikut untuk memulai Windows PowerShell:
powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1Anda juga dapat menyimpan snap-in Windows PowerShell untuk sesi mendatang dengan menambahkan perintah Add-PSSnapin ke profil Windows PowerShell Anda. Untuk informasi selengkapnya, lihat about_Profiles.
