Import-PSSession

Modul:

Microsoft.PowerShell.Utility Module

Mengimpor perintah dari sesi lain ke sesi saat ini.

Sintaks

Default (Default)

Import-PSSession
    [-Prefix <String>]
    [-DisableNameChecking]
    [[-CommandName] <String[]>]
    [-AllowClobber]
    [-ArgumentList <Object[]>]
    [-CommandType <CommandTypes>]
    [-Module <String[]>]
    [-FullyQualifiedModule <ModuleSpecification[]>]
    [[-FormatTypeName] <String[]>]
    [-Certificate <X509Certificate2>]
    [-Session] <PSSession>
    [<CommonParameters>]

Deskripsi

cmdlet Import-PSSession mengimpor perintah , seperti cmdlet, fungsi, dan alias, dari PSSession pada komputer lokal atau jarak jauh ke sesi saat ini. Anda dapat mengimpor perintah apa pun yang dapat ditemukan cmdlet Get-Command di PSSession.

Gunakan perintah Import-PSSession untuk mengimpor perintah dari shell yang dikustomisasi, seperti shell Microsoft Exchange Server, atau dari sesi yang menyertakan modul Windows PowerShell dan snap-in atau elemen lain yang tidak ada dalam sesi saat ini.

Untuk mengimpor perintah, pertama-tama gunakan cmdlet New-PSSession untuk membuat PSSession. Kemudian, gunakan cmdlet Import-PSSession untuk mengimpor perintah. Secara default, Import-PSSession mengimpor semua perintah kecuali untuk perintah yang memiliki nama yang sama dengan perintah dalam sesi saat ini. Untuk mengimpor semua perintah, gunakan parameter AllowClobber.

Anda dapat menggunakan perintah yang diimpor seperti yang akan Anda gunakan perintah apa pun dalam sesi. Saat Anda menggunakan perintah yang diimpor, bagian yang diimpor dari perintah berjalan secara implisit dalam sesi tempat perintah diimpor. Namun, operasi jarak jauh ditangani sepenuhnya oleh Windows PowerShell. Anda bahkan tidak perlu menyadarinya, kecuali bahwa Anda harus menjaga koneksi ke sesi lain (PSSession) terbuka. Jika Anda menutupnya, perintah yang diimpor tidak lagi tersedia.

Karena perintah yang diimpor mungkin membutuhkan waktu lebih lama untuk dijalankan daripada perintah lokal, Import-PSSession menambahkan parameter AsJob ke setiap perintah yang diimpor. Parameter ini memungkinkan Anda menjalankan perintah sebagai pekerjaan latar belakang Windows PowerShell. Untuk informasi selengkapnya, lihat tentang_Pekerjaan.

Saat Anda menggunakan Import-PSSession, Windows PowerShell menambahkan perintah yang diimpor ke modul sementara yang hanya ada di sesi Anda dan mengembalikan objek yang mewakili modul. Untuk membuat modul persisten yang dapat Anda gunakan di sesi mendatang, gunakan cmdlet Export-PSSession.

Cmdlet Import-PSSession menggunakan fitur jarak jauh implisit Windows PowerShell. Saat Anda mengimpor perintah ke sesi saat ini, perintah berjalan secara implisit dalam sesi asli atau dalam sesi serupa pada komputer asal.

Dimulai di Windows PowerShell 3.0, Anda dapat menggunakan cmdlet Import-Module untuk mengimpor modul dari sesi jarak jauh ke sesi saat ini. Fitur ini menggunakan jarak jauh implisit. Setara dengan menggunakan Import-PSSession untuk mengimpor modul yang dipilih dari sesi jarak jauh ke sesi saat ini.

Contoh

Contoh 1: Mengimpor semua perintah dari PSSession

$S = New-PSSession -ComputerName Server01
Import-PSSession -Session $S

Perintah ini mengimpor semua perintah dari PSSession pada komputer Server01 ke dalam sesi saat ini, kecuali untuk perintah yang memiliki nama yang sama dengan perintah dalam sesi saat ini.

Karena perintah ini tidak menggunakan parameter CommandName, perintah ini juga mengimpor semua data pemformatan yang diperlukan untuk perintah yang diimpor.

Contoh 2: Mengimpor perintah yang diakhir dengan string tertentu

$S = New-PSSession https://ps.testlabs.com/powershell
Import-PSSession -Session $S -CommandName *-test -FormatTypeName *
New-Test -Name Test1
Get-Test test1 | Run-Test

Perintah ini mengimpor perintah dengan nama yang berakhiran "-test" dari PSSession ke sesi lokal, lalu menunjukkan cara menggunakan cmdlet yang diimpor.

Perintah pertama menggunakan cmdlet New-PSSession untuk membuat PSSession. Ini menyimpan PSSession dalam variabel $S.

Perintah kedua menggunakan cmdlet Import-PSSession untuk mengimpor perintah dari PSSession dalam $S ke sesi saat ini. Ini menggunakan parameter CommandName untuk menentukan perintah dengan kata benda Uji dan parameter FormatTypeName untuk mengimpor data pemformatan untuk perintah Uji.

Perintah ketiga dan keempat menggunakan perintah yang diimpor dalam sesi saat ini. Karena perintah yang diimpor benar-benar ditambahkan ke sesi saat ini, Anda menggunakan sintaks lokal untuk menjalankannya. Anda tidak perlu menggunakan cmdlet Invoke-Command untuk menjalankan perintah yang diimpor.

Contoh 3: Mengimpor cmdlet dari PSSession

$S1 = New-PSSession -ComputerName s1
$S2 = New-PSSession -ComputerName s2
Import-PSSession -Session s1 -Type Cmdlet -Name New-Test, Get-Test -FormatTypeName *
Import-PSSession -Session s2 -Type Cmdlet -Name Set-Test -FormatTypeName *
New-Test Test1 | Set-Test -RunType Full

Contoh ini menunjukkan bahwa Anda dapat menggunakan cmdlet yang diimpor sama seperti Anda akan menggunakan cmdlet lokal.

Perintah ini mengimpor cmdlet New-Test dan Get-Test dari PSSession di komputer Server01 dan cmdlet Set-Test dari PSSession di komputer Server02.

Meskipun cmdlet diimpor dari PSSessions yang berbeda, Anda dapat menyalurkan objek dari satu cmdlet ke cmdlet lainnya tanpa kesalahan.

Contoh 4: Jalankan perintah yang diimpor sebagai pekerjaan latar belakang

$S = New-PSSession -ComputerName Server01
Import-PSSession -Session $S -CommandName *-test* -FormatTypeName *
$batch = New-Test -Name Batch -AsJob
Receive-Job $batch

Contoh ini menunjukkan cara menjalankan perintah yang diimpor sebagai pekerjaan latar belakang.

Karena perintah yang diimpor mungkin membutuhkan waktu lebih lama untuk dijalankan daripada perintah lokal, Import-PSSession menambahkan parameter AsJob ke setiap perintah yang diimpor. Parameter AsJob memungkinkan Anda menjalankan perintah sebagai pekerjaan latar belakang.

Perintah pertama membuat PSSession di komputer Server01 dan menyimpan objek PSSession dalam variabel $S.

Perintah kedua menggunakan Import-PSSession untuk mengimpor cmdlet Pengujian dari PSSession dalam $S ke sesi saat ini.

Perintah ketiga menggunakan parameter AsJob dari cmdlet New-Test yang diimpor untuk menjalankan perintah New-Test sebagai pekerjaan latar belakang. Perintah menyimpan objek pekerjaan yang New-Test kembali dalam variabel $batch.

Perintah keempat menggunakan cmdlet Receive-Job untuk mendapatkan hasil pekerjaan dalam variabel $batch.

Contoh 5: Mengimpor cmdlet dan fungsi dari modul Windows PowerShell

$S = New-PSSession -ComputerName Server01
Invoke-Command -Session $S {Import-Module TestManagement}
Import-PSSession -Session $S -Module TestManagement

Contoh ini menunjukkan cara mengimpor cmdlet dan fungsi dari modul Windows PowerShell pada komputer jarak jauh ke sesi saat ini.

Perintah pertama membuat PSSession di komputer Server01 dan menyimpannya dalam variabel $S.

Perintah kedua menggunakan cmdlet Invoke-Command untuk menjalankan perintah Import-Module di PSSession di $S.

Biasanya, modul akan ditambahkan ke semua sesi oleh perintah Import-Module di profil Windows PowerShell, tetapi profil tidak dijalankan di PSSessions.

Perintah ketiga menggunakan parameter ModulImport-PSSession untuk mengimpor cmdlet dan fungsi dalam modul ke sesi saat ini.

Contoh 6: Membuat modul dalam file sementara

PS C:\> Import-PSSession $S -CommandName Get-Date, SearchHelp -FormatTypeName * -AllowClobber

Name              : tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf
Path              : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1
zunz.ttf\tmp_79468106-4e1d-4d90-af97-1154f9317239_
tcw1zunz.ttf.psm1
Description       : Implicit remoting for http://server01.corp.fabrikam.com/wsman
Guid              : 79468106-4e1d-4d90-af97-1154f9317239
Version           : 1.0
ModuleBase        : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1
zunz.ttf
ModuleType        : Script
PrivateData       : {ImplicitRemoting}
AccessMode        : ReadWrite
ExportedAliases   : {}
ExportedCmdlets   : {}
ExportedFunctions : {[Get-Date, Get-Date], [SearchHelp, SearchHelp]}
ExportedVariables : {}
NestedModules     : {}

Contoh ini menunjukkan bahwa Import-PSSession membuat modul dalam file sementara pada disk. Ini juga menunjukkan bahwa semua perintah dikonversi menjadi fungsi sebelum diimpor ke sesi saat ini.

Perintah menggunakan cmdlet Import-PSSession untuk mengimpor cmdlet Get-Date dan fungsi SearchHelp ke dalam sesi saat ini.

Cmdlet Import-PSSession mengembalikan objek PSModuleInfo yang mewakili modul sementara. Nilai properti Jalur menunjukkan bahwa Import-PSSession membuat file modul skrip (.psm1) di lokasi sementara. Properti ExportedFunctions menunjukkan bahwa cmdlet Get-Date dan fungsi SearchHelp keduanya diimpor sebagai fungsi.

Contoh 7: Jalankan perintah yang disembunyikan oleh perintah yang diimpor

PS C:\> Import-PSSession $S -CommandName Get-Date -FormatTypeName * -AllowClobber

PS C:\> Get-Command Get-Date -All

CommandType   Name       Definition
-----------   ----       ----------
Function      Get-Date   ...
Cmdlet        Get-Date   Get-Date [[-Date] <DateTime>] [-Year <Int32>] [-Month <Int32>]

PS C:\> Get-Date
09074

PS C:\> (Get-Command -Type Cmdlet -Name Get-Date).PSSnapin.Name
Microsoft.PowerShell.Utility

PS C:\> Microsoft.PowerShell.Utility\Get-Date
Sunday, March 15, 2009 2:08:26 PM

Contoh ini menunjukkan cara menjalankan perintah yang disembunyikan oleh perintah yang diimpor.

Perintah pertama mengimpor cmdlet Get-Date dari PSSession dalam variabel $S. Karena sesi saat ini menyertakan cmdlet Get-Date, parameter AllowClobber diperlukan dalam perintah.

Perintah kedua menggunakan parameter Semua cmdlet Get-Command untuk mendapatkan semua perintah Get-Date dalam sesi saat ini. Output menunjukkan bahwa sesi mencakup cmdlet Get-Date asli dan fungsi Get-Date. Fungsi Get-Date menjalankan cmdlet Get-Date yang diimpor di PSSession di $S.

Perintah ketiga menjalankan perintah Get-Date. Karena fungsi lebih diutamakan daripada cmdlet, Windows PowerShell menjalankan fungsi Get-Date yang diimpor, yang mengembalikan tanggal Julian.

Perintah keempat dan kelima menunjukkan cara menggunakan nama yang memenuhi syarat untuk menjalankan perintah yang disembunyikan oleh perintah yang diimpor.

Perintah keempat mendapatkan nama snap-in Windows PowerShell yang menambahkan cmdlet Get-Date asli ke sesi saat ini.

Perintah kelima menggunakan nama snap-in-qualified cmdlet Get-Date untuk menjalankan perintah Get-Date.

Untuk informasi selengkapnya tentang perintah prioritas dan perintah tersembunyi, lihat about_Command_Precedence.

Contoh 8: Mengimpor perintah yang memiliki string tertentu dalam namanya

PS C:\> Import-PSSession -Session $S -CommandName **Item** -AllowClobber

Perintah ini mengimpor perintah yang namanya menyertakan Item dari PSSession di $S. Karena perintah menyertakan parameter CommandName tetapi bukan parameter FormatTypeData, hanya perintah yang diimpor.

Gunakan perintah ini saat Anda menggunakan Import-PSSession untuk menjalankan perintah di komputer jarak jauh dan Anda sudah memiliki data pemformatan untuk perintah dalam sesi saat ini.

Contoh 9: Gunakan parameter Modul untuk menemukan perintah mana yang diimpor ke dalam sesi

PS C:\> $M = Import-PSSession -Session $S -CommandName *bits* -FormatTypeName *bits*
PS C:\> Get-Command -Module $M
CommandType     Name
-----------     ----
Function        Add-BitsFile
Function        Complete-BitsTransfer
Function        Get-BitsTransfer
Function        Remove-BitsTransfer
Function        Resume-BitsTransfer
Function        Set-BitsTransfer
Function        Start-BitsTransfer
Function        Suspend-BitsTransfer

Perintah ini menunjukkan cara menggunakan parameter ModulGet-Command untuk mengetahui perintah mana yang diimpor ke sesi oleh perintah Import-PSSession.

Perintah pertama menggunakan cmdlet Import-PSSession untuk mengimpor perintah yang namanya menyertakan "bit" dari PSSession dalam variabel $S. Perintah Import-PSSession mengembalikan modul sementara, dan perintah menyimpan modul dalam variabel $m.

Perintah kedua menggunakan cmdlet Get-Command untuk mendapatkan perintah yang diekspor oleh modul dalam variabel $M.

Parameter Modul mengambil nilai string, yang dirancang untuk nama modul. Namun, saat Anda mengirimkan objek modul, Windows PowerShell menggunakan metode ToString pada objek modul, yang mengembalikan nama modul.

Perintah Get-Command setara dengan Get-Command $M.Name".

Parameter

-AllowClobber

Menunjukkan bahwa cmdlet ini mengimpor perintah yang ditentukan, bahkan jika mereka memiliki nama yang sama dengan perintah dalam sesi saat ini.

Jika Anda mengimpor perintah dengan nama yang sama dengan perintah dalam sesi saat ini, perintah yang diimpor menyembunyikan atau mengganti perintah asli. Untuk informasi selengkapnya, lihat about_Command_Precedence.

Secara default, Import-PSSession tidak mengimpor perintah yang memiliki nama yang sama dengan perintah dalam sesi saat ini.

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

-ArgumentList

Menentukan array perintah yang dihasilkan dari menggunakan argumen yang ditentukan (nilai parameter).

Misalnya, untuk mengimpor varian perintah Get-Item di drive sertifikat (Cert:) di PSSession di $S, ketik Import-PSSession -Session $S -Command Get-Item -ArgumentList Cert:.

Properti parameter

Jenis:	Object[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Argumen

Kumpulan parameter

(All)

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

-Certificate

Menentukan sertifikat klien yang digunakan untuk menandatangani file format (*. Format.ps1xml) atau file modul skrip (.psm1) dalam modul sementara yang Import-PSSession buat.

Masukkan variabel yang berisi sertifikat atau perintah atau ekspresi yang mendapatkan sertifikat.

Untuk menemukan sertifikat, gunakan cmdlet Get-PfxCertificate atau gunakan cmdlet Get-ChildItem di drive Sertifikat (Cert:). Jika sertifikat tidak valid atau tidak memiliki otoritas yang memadai, perintah gagal.

Properti parameter

Jenis:	X509Certificate2
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

-CommandName

Menentukan perintah dengan nama atau pola nama yang ditentukan. Kartu liar diizinkan. Gunakan CommandName atau aliasnya, Nama.

Secara default, Import-PSSession mengimpor semua perintah dari sesi, kecuali untuk perintah yang memiliki nama yang sama dengan perintah dalam sesi saat ini. Ini mencegah perintah yang diimpor menyembunyikan atau mengganti perintah dalam sesi. Untuk mengimpor semua perintah, bahkan perintah yang menyembunyikan atau mengganti perintah lain, gunakan parameter AllowClobber.

Jika Anda menggunakan parameter CommandName, file pemformatan untuk perintah tidak diimpor kecuali Anda menggunakan parameter FormatTypeName . Demikian pula, jika Anda menggunakan parameter FormatTypeName, tidak ada perintah yang diimpor kecuali Anda menggunakan parameter CommandName.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Nama

Kumpulan parameter

(All)

Position:	2
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-CommandType

Menentukan jenis objek perintah. Nilai defaultnya adalah Cmdlet. Gunakan CommandType atau aliasnya, jenis . Nilai yang dapat diterima untuk parameter ini adalah:

• Alias: Alias Windows PowerShell dalam sesi jarak jauh.
• All: Cmdlet dan fungsi dalam sesi jarak jauh.
• Application: Semua file selain file Windows-PowerShell di jalur yang tercantum dalam variabel lingkungan PATH ($Env:PATH) dalam sesi jarak jauh, termasuk file .txt, .exe, dan .dll.
• Cmdlet: Cmdlet dalam sesi jarak jauh. "Cmdlet" adalah default.
• ExternalScript: File .ps1 di jalur yang tercantum dalam variabel lingkungan PATH ($Env:PATH) dalam sesi jarak jauh.
• Filter dan Function: Windows PowerShell berfungsi dalam sesi jarak jauh.
• Script: File skrip yang dapat diakses dalam sesi jarak jauh.

Nilai-nilai ini didefinisikan sebagai enumerasi berbasis bendera. Anda dapat menggabungkan beberapa nilai bersama-sama untuk mengatur beberapa bendera menggunakan parameter ini. Nilai dapat diteruskan ke parameter CommandType sebagai array nilai atau sebagai string yang dipisahkan koma dari nilai tersebut. Cmdlet akan menggabungkan nilai menggunakan operasi biner-OR. Meneruskan nilai sebagai array adalah opsi paling sederhana dan juga memungkinkan Anda menggunakan penyelesaian tab pada nilai.

Properti parameter

Jenis:	CommandTypes
Nilai default:	None
Nilai yang diterima:	Alias, Function, Filter, Cmdlet, ExternalScript, Application, Script, Workflow, Configuration, All
Mendukung wildcard:	False
DontShow:	False
Alias:	Tipe

Kumpulan parameter

(All)

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

-DisableNameChecking

Menunjukkan bahwa cmdlet ini menekan pesan yang memperingatkan Anda ketika Anda mengimpor cmdlet atau fungsi yang namanya menyertakan kata kerja yang tidak disetujui atau karakter yang dilarang.

Secara default, ketika modul yang Anda impor mengekspor cmdlet atau fungsi yang memiliki kata kerja yang tidak disetujui dalam namanya, Windows PowerShell menampilkan pesan peringatan berikut:

"PERINGATAN: Beberapa nama perintah yang diimpor termasuk kata kerja yang tidak disetujui yang mungkin membuatnya kurang dapat ditemukan. Gunakan parameter Verbose untuk detail lebih lanjut atau ketik Get-Verb untuk melihat daftar kata kerja yang disetujui."

Pesan ini hanyalah peringatan. Modul lengkap masih diimpor, termasuk perintah yang tidak sesuai. Meskipun pesan ditampilkan kepada pengguna modul, masalah penamaan harus diperbaiki oleh penulis modul.

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

-FormatTypeName

Menentukan instruksi pemformatan untuk jenis Microsoft .NET Framework yang ditentukan. Masukkan nama jenis. Kartu liar diizinkan.

Nilai parameter ini harus berupa nama jenis yang dikembalikan oleh perintah Get-FormatData dalam sesi tempat perintah diimpor. Untuk mendapatkan semua data pemformatan dalam sesi jarak jauh, ketik *.

Jika perintah tidak menyertakan parameter CommandName atau FormatTypeName, Import-PSSession mengimpor instruksi pemformatan untuk semua jenis .NET Framework yang dikembalikan oleh perintah Get-FormatData dalam sesi jarak jauh.

Jika Anda menggunakan parameter FormatTypeName , tidak ada perintah yang diimpor kecuali Anda menggunakan parameter CommandName.

Demikian pula, jika Anda menggunakan parameter CommandName, file pemformatan untuk perintah tidak diimpor kecuali Anda menggunakan parameter FormatTypeName.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	3
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-FullyQualifiedModule

Nilainya dapat berupa nama modul, spesifikasi modul lengkap, atau jalur ke file modul.

Ketika nilai adalah jalur, jalur dapat sepenuhnya memenuhi syarat atau relatif. Jalur relatif diselesaikan relatif terhadap skrip yang berisi pernyataan penggunaan.

Saat nilainya adalah spesifikasi nama atau modul, PowerShell mencari PSModulePath untuk modul yang ditentukan.

Spesifikasi modul adalah hashtable yang memiliki kunci berikut.

• ModuleName - Diperlukan Menentukan nama modul.
• GUID - Opsional Menentukan GUID modul.
• Ini juga Diperlukan untuk menentukan setidaknya salah satu dari tiga kunci di bawah ini.
  • ModuleVersion - Menentukan versi minimum modul yang dapat diterima.
  • MaximumVersion - Menentukan versi maksimum modul yang dapat diterima.
  • RequiredVersion - Menentukan versi modul yang tepat dan diperlukan. Ini tidak dapat digunakan dengan kunci Versi lainnya.

Anda tidak dapat menentukan parameter FullyQualifiedModule dalam perintah yang sama dengan parameter Modul. Dua parameter saling eksklusif.

Properti parameter

Jenis:	ModuleSpecification[]
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

-Module

Menentukan dan array perintah dalam snap-in dan modul Windows PowerShell. Masukkan nama snap-in dan modul. Kartubebas tidak diizinkan.

Import-PSSession tidak dapat mengimpor penyedia dari snap-in.

Untuk informasi selengkapnya, lihat about_PSSnapins dan about_Modules.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	PSSnapin

Kumpulan parameter

(All)

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

-Prefix

Menentukan awalan ke kata benda dalam nama perintah yang diimpor.

Gunakan parameter ini untuk menghindari konflik nama yang mungkin terjadi ketika perintah yang berbeda dalam sesi memiliki nama yang sama.

Misalnya, jika Anda menentukan prefiks Remote dan kemudian mengimpor cmdlet Get-Date, cmdlet dikenal dalam sesi sebagai Get-RemoteDate, dan tidak bingung dengan cmdlet Get-Date asli.

Properti parameter

Jenis:	String
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

-Session

Menentukan PSSession tempat cmdlet diimpor. Masukkan variabel yang berisi objek sesi atau perintah yang mendapatkan objek sesi, seperti perintah New-PSSession atau Get-PSSession. Anda hanya dapat menentukan satu sesi. Parameter ini diperlukan.

Properti parameter

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

Kumpulan parameter

(All)

Position:	0
Wajib:	True
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

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

PSModuleInfo

Cmdlet ini mengembalikan objek modul yang sama dengan yang New-Module dan cmdlet Get-Module kembali. Namun, modul yang diimpor bersifat sementara dan hanya ada dalam sesi saat ini. Untuk membuat modul permanen pada disk, gunakan cmdlet Export-PSSession.

Catatan

• Import-PSSession bergantung pada infrastruktur jarak jauh PowerShell. Untuk menggunakan cmdlet ini, komputer harus dikonfigurasi untuk WS-Management jarak jauh. Untuk informasi selengkapnya, lihat about_Remote dan about_Remote_Requirements.
• Import-PSSession tidak mengimpor variabel atau penyedia PowerShell.
• Saat Anda mengimpor perintah yang memiliki nama yang sama dengan perintah dalam sesi saat ini, perintah yang diimpor dapat menyembunyikan alias, fungsi, dan cmdlet dalam sesi dan dapat menggantikan fungsi dan variabel dalam sesi. Untuk mencegah konflik nama, gunakan parameter Awalan . Untuk informasi selengkapnya, lihat about_Command_Precedence.
• Import-PSSession mengonversi semua perintah menjadi fungsi sebelum mengimpornya. Akibatnya, perintah yang diimpor bertingkah sedikit berbeda dari yang mereka lakukan jika mereka mempertahankan jenis perintah aslinya. Misalnya, jika Anda mengimpor cmdlet dari PSSession lalu mengimpor cmdlet dengan nama yang sama dari modul atau snap-in, cmdlet yang diimpor dari PSSession selalu berjalan secara default karena fungsi lebih diutamakan daripada cmdlet. Sebaliknya, jika Anda mengimpor alias ke dalam sesi yang memiliki alias dengan nama yang sama, alias asli selalu digunakan, karena alias lebih diutamakan daripada fungsi. Untuk informasi selengkapnya, lihat about_Command_Precedence.
• Import-PSSession menggunakan cmdlet Write-Progress untuk menampilkan kemajuan perintah. Anda mungkin melihat bilah kemajuan saat perintah sedang berjalan.
• Untuk menemukan perintah yang akan diimpor, Import-PSSession menggunakan cmdlet Invoke-Command untuk menjalankan perintah Get-Command di PSSession. Untuk mendapatkan data pemformatan untuk perintah, ia menggunakan cmdlet Get-FormatData. Anda mungkin melihat pesan kesalahan dari cmdlet ini saat menjalankan perintah Import-PSSession. Selain itu, Import-PSSession tidak dapat mengimpor perintah dari PSSession yang tidak menyertakan cmdlet Get-Command, Get-FormatData, Select-Object, dan Get-Help.
• Perintah yang diimpor memiliki batasan yang sama dengan perintah jarak jauh lainnya, termasuk ketidakmampuan untuk memulai program dengan antarmuka pengguna, seperti Notepad.
• Karena profil Windows PowerShell tidak dijalankan di PSSessions, perintah yang ditambahkan profil ke sesi tidak tersedia untuk Import-PSSession. Untuk mengimpor perintah dari profil, gunakan perintah Invoke-Command untuk menjalankan profil di PSSession secara manual sebelum mengimpor perintah.
• Modul sementara yang Import-PSSession buat mungkin menyertakan file pemformatan, meskipun perintah tidak mengimpor data pemformatan. Jika perintah tidak mengimpor data pemformatan, file pemformatan apa pun yang dibuat tidak akan berisi data pemformatan.
• Untuk menggunakan Import-PSSession, kebijakan eksekusi dalam sesi saat ini tidak dapat Dibatasi atau AllSigned, karena modul sementara yang Import-PSSession buat berisi file skrip yang tidak ditandatangani yang dilarang oleh kebijakan ini. Untuk menggunakan Import-PSSession tanpa mengubah kebijakan eksekusi untuk komputer lokal, gunakan parameter CakupanSet-ExecutionPolicy untuk menetapkan kebijakan eksekusi yang kurang ketat untuk satu proses.
• Di Windows PowerShell 2.0, topik bantuan untuk perintah yang diimpor dari sesi lain tidak menyertakan awalan yang Anda tetapkan dengan menggunakan parameter Awalan . Untuk mendapatkan bantuan untuk perintah yang diimpor di Windows PowerShell 2.0, gunakan nama perintah asli (tidak diawali).

Link Terkait

• Export-PSSession