Export-Console

Modul:
Microsoft.PowerShell.Core Module

Mengekspor nama snap-in dalam sesi saat ini ke file konsol.

Sintaks

Default (Default) 

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

Deskripsi

cmdlet Export-Console 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.psc1

Perintah ini mengekspor nama snap-in Windows PowerShell dalam sesi saat ini ke file ConsoleS1.psc1 di folder Konsol folder penginstalan Windows PowerShell, $PSHOME.

Contoh 2: Mengekspor nama snap-in ke file konsol terbaru

Export-Console

Perintah 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.psc1

Perintah ini menambahkan NewPSSnapin snap-in Windows PowerShell 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 cmdlet Add-PSSnapin 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 file NewPSSnapinConsole.psc1.

Perintah ketiga memulai Windows PowerShell dengan file NewPSSnapinConsole.psc1. 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 file Console01.psc1 di direktori saat ini.

Perintah kedua menampilkan konten file Console01.psc1 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-Console

Contoh ini menunjukkan cara menggunakan variabel otomatis $ConsoleFileName untuk menentukan file konsol yang akan diperbarui jika Anda menggunakan Export-Console tanpa nilai parameter Jalur.

Perintah pertama menggunakan parameter PSConsoleFile powershell.exe untuk membuka Windows PowerShell dengan file Console01.psc1.

Perintah kedua menggunakan cmdlet Add-PSSnapin untuk menambahkan snap-in MySnapin Windows PowerShell ke sesi saat ini.

Perintah ketiga menggunakan cmdlet Export-Console untuk mengekspor nama semua snap-in Windows PowerShell dalam sesi ke file NewConsole.psc1.

Perintah keempat menampilkan variabel $ConsoleFileName. 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 cmdlet Export-Console tanpa parameter Jalur. Perintah ini mengekspor nama semua snap-in Windows PowerShell dalam sesi saat ini ke file yang terakhir digunakan, NewConsole.psc1.

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-NoClobber

Menunjukkan bahwa cmdlet ini tidak menimpa file konsol yang ada. Secara default, jika file terjadi di jalur yang ditentukan, Export-Console menimpa file tanpa peringatan.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:NoOverwrite

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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 membuat 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 menimpa file konsol yang terakhir digunakan dalam sesi ini. Jalur file konsol yang terakhir digunakan disimpan dalam nilai variabel otomatis $ConsoleFileName. Untuk informasi selengkapnya, lihat tentang_Variabel_Automatis.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:PSPath

Kumpulan parameter

(All)
Position:0
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

Anda dapat memasukkan string jalur ke cmdlet ini.

Output

FileInfo

Cmdlet ini membuat file yang berisi alias yang diekspor.

Catatan

  • Ketika file konsol (.psc1) digunakan untuk memulai sesi, nama file konsol secara otomatis disimpan dalam variabel otomatis $ConsoleFileName. Nilai $ConsoleFileName diperbarui saat Anda menggunakan parameter PathExport-Console 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>.psc1

    Anda 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.