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 lain, 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 Windows PowerShell snap-in 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-Console

Perintah ini mengekspor nama Windows PowerShell snap-in dari sesi saat ini ke file konsol Windows PowerShell yang terakhir digunakan dalam sesi saat ini. Ini menimpa konten file sebelumnya.

Jika Anda belum mengekspor file konsol selama sesi saat ini, Anda akan 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 Windows PowerShell snap-in 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 Windows PowerShell snap-in yang terdaftar di sistem Anda.

Perintah kedua mengekspor nama snap-in Windows PowerShell ke NewPSSnapinConsole.psc1 file.

Perintah ketiga dimulai 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: Menentukan 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 $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 Windows PowerShell MySnapin 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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 direset ketika perintah selesai.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 paling baru digunakan dalam sesi ini. Jalur file konsol yang terakhir digunakan disimpan dalam nilai variabel otomatis $ConsoleFileName. Untuk informasi selengkapnya, lihat about_Automatic_Variables.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

String

Anda dapat menyalurkan string jalur ke cmdlet ini.

Output

FileInfo

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 $ConsoleFileName variabel otomatis. Nilai $ConsoleFileName diperbarui saat Anda menggunakan parameter Export-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\>.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.