Import-PSSession
Mengimpor perintah dari sesi lain ke sesi saat ini.
Sintaks
Import-PSSession
[-Prefix <String>]
[-DisableNameChecking]
[[-CommandName] <String[]>]
[-AllowClobber]
[-ArgumentList <Object[]>]
[-CommandType <CommandTypes>]
[-Module <String[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[[-FormatTypeName] <String[]>]
[-Certificate <X509Certificate2>]
[-Session] <PSSession>
[<CommonParameters>]Deskripsi
Import-PSSession Cmdlet 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 Get-Command dapat ditemukan cmdlet di PSSession.
Import-PSSession Gunakan perintah untuk mengimpor perintah dari shell yang dikustomisasi, seperti shell Microsoft Server Exchange, 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 New-PSSession gunakan cmdlet untuk membuat PSSession. Kemudian, gunakan Import-PSSession cmdlet 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 about_Jobs.
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 Export-PSSession cmdlet .
Import-PSSession Cmdlet 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 Import-Module cmdlet untuk mengimpor modul dari sesi jarak jauh ke sesi saat ini. Fitur ini menggunakan jarak jauh implisit. Ini 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 $SPerintah 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-TestPerintah ini mengimpor perintah dengan nama yang berakhiran "-test" dari PSSession ke sesi lokal, lalu menunjukkan cara menggunakan cmdlet yang diimpor.
Perintah pertama menggunakan New-PSSession cmdlet untuk membuat PSSession. Ini menyimpan PSSession dalam $S variabel.
Perintah kedua menggunakan Import-PSSession cmdlet untuk mengimpor perintah dari PSSession ke dalam $S 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 Invoke-Command cmdlet 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 FullContoh ini menunjukkan bahwa Anda dapat menggunakan cmdlet yang diimpor sama seperti Anda akan menggunakan cmdlet lokal.
Perintah ini mengimpor New-Test cmdlet dan Get-Test dari PSSession di komputer Server01 dan Set-Test cmdlet 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 $batchContoh 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 $S variabel.
Perintah kedua menggunakan Import-PSSession untuk mengimpor cmdlet Pengujian dari PSSession ke dalam $S sesi saat ini.
Perintah ketiga menggunakan parameter AsJob dari cmdlet yang diimpor New-Test untuk menjalankan New-Test perintah sebagai pekerjaan latar belakang. Perintah menyimpan objek pekerjaan yang New-Test dikembalikan dalam $batch variabel.
Perintah keempat menggunakan Receive-Job cmdlet untuk mendapatkan hasil pekerjaan dalam $batch variabel.
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 TestManagementContoh 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 $S variabel.
Perintah kedua menggunakan Invoke-Command cmdlet untuk menjalankan Import-Module perintah di PSSession di $S.
Biasanya, modul akan ditambahkan ke semua sesi oleh Import-Module perintah di profil Windows PowerShell, tetapi profil tidak dijalankan di PSSessions.
Perintah ketiga menggunakan parameter Import-PSSession Modul untuk mengimpor cmdlet dan fungsi dalam modul ke dalam 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 Import-PSSession cmdlet untuk mengimpor Get-Date cmdlet dan fungsi SearchHelp ke dalam sesi saat ini.
Import-PSSession Cmdlet 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 Get-Date cmdlet 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 PMContoh ini menunjukkan cara menjalankan perintah yang disembunyikan oleh perintah yang diimpor.
Perintah pertama mengimpor Get-Date cmdlet dari PSSession dalam $S variabel. Karena sesi saat ini menyertakan Get-Date cmdlet, parameter AllowClobber diperlukan dalam perintah .
Perintah kedua menggunakan parameter Get-Command Semua cmdlet untuk mendapatkan semua Get-Date perintah dalam sesi saat ini. Output menunjukkan bahwa sesi menyertakan cmdlet asli Get-Date dan Get-Date fungsi. Fungsi ini Get-Date menjalankan cmdlet yang diimpor Get-Date di PSSession di $S.
Perintah ketiga menjalankan Get-Date perintah. Karena fungsi lebih diutamakan daripada cmdlet, Windows PowerShell menjalankan fungsi yang diimpor Get-Date , 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 asli Get-Date ke sesi saat ini.
Perintah kelima menggunakan nama Get-Date cmdlet yang di-snap-in-qualified untuk menjalankan Get-Date perintah.
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** -AllowClobberPerintah 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 pada 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-BitsTransferPerintah ini menunjukkan cara menggunakan parameter Get-Command Modul untuk mengetahui perintah mana yang diimpor ke dalam sesi oleh Import-PSSession perintah.
Perintah pertama menggunakan Import-PSSession cmdlet untuk mengimpor perintah yang namanya menyertakan "bit" dari PSSession dalam $S variabel. Perintah Import-PSSession mengembalikan modul sementara, dan perintah menyimpan modul dalam $m variabel.
Perintah kedua menggunakan Get-Command cmdlet untuk mendapatkan perintah yang diekspor oleh modul dalam $M variabel.
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ArgumentList
Menentukan array perintah yang dihasilkan dari menggunakan argumen yang ditentukan (nilai parameter).
Misalnya, untuk mengimpor varian Get-Item perintah dalam drive sertifikat (Cert:) di PSSession di $S, ketik Import-PSSession -Session $S -Command Get-Item -ArgumentList cert:.
| Type: | Object[] |
| Aliases: | Args |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Certificate
Menentukan sertifikat klien yang digunakan untuk menandatangani file format (*. Format.ps1xml) atau file modul skrip (.psm1) dalam modul sementara yang Import-PSSession dibuat.
Masukkan variabel yang berisi sertifikat atau perintah atau ekspresi yang mendapatkan sertifikat.
Untuk menemukan sertifikat, gunakan Get-PfxCertificate cmdlet atau gunakan Get-ChildItem cmdlet di drive Sertifikat (Cert:). Jika sertifikat tidak valid atau tidak memiliki otoritas yang memadai, perintah gagal.
| Type: | X509Certificate2 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandName
Menentukan perintah dengan nama atau pola nama yang ditentukan. Kartubebas 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 .
| Type: | String[] |
| Aliases: | Name |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandType
Menentukan jenis objek perintah. Nilai defaultnya adalah Cmdlet. Gunakan CommandType atau aliasnya, Ketik. 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 Jalur ($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 Jalur ($env:path) dalam sesi jarak jauh.FilterdanFunction: Windows PowerShell berfungsi dalam sesi jarak jauh.Script: Skrip memblokir 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.
| Type: | CommandTypes |
| Aliases: | Type |
| Accepted values: | Alias, Function, Filter, Cmdlet, ExternalScript, Application, Script, Workflow, Configuration, All |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 atau jenis Get-Verb lebih lanjut 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FormatTypeName
Menentukan instruksi pemformatan untuk jenis Microsoft .NET Framework yang ditentukan. Masukkan nama jenis. Kartubebas diizinkan.
Nilai parameter ini harus berupa nama jenis yang dikembalikan oleh Get-FormatData perintah 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 Get-FormatData dikembalikan oleh perintah 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 .
| Type: | String[] |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.- Diperlukan juga 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.
| Type: | ModuleSpecification[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Aliases: | PSSnapin |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 Get-Date cmdlet, cmdlet dikenal dalam sesi sebagai Get-RemoteDate, dan tidak bingung dengan cmdlet asli Get-Date .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | PSSession |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.
Output
Cmdlet ini mengembalikan objek modul yang sama dengan yang New-Module dikembalikan dan Get-Module cmdlet.
Namun, modul yang diimpor bersifat sementara dan hanya ada dalam sesi saat ini. Untuk membuat modul permanen pada disk, gunakan Export-PSSession cmdlet .
Catatan
Import-PSSessionbergantung pada infrastruktur jarak jauh PowerShell. Untuk menggunakan cmdlet ini, komputer harus dikonfigurasi untuk jarak jauh WS-Management. Untuk informasi selengkapnya, lihat about_Remote dan about_Remote_Requirements.Import-PSSessiontidak 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-PSSessionmengonversi 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-PSSessionWrite-Progressmenggunakan cmdlet untuk menampilkan kemajuan perintah. Anda mungkin melihat bilah kemajuan saat perintah sedang berjalan.- Untuk menemukan perintah yang akan diimpor,
Import-PSSessiongunakanInvoke-Commandcmdlet untuk menjalankanGet-Commandperintah di PSSession. Untuk mendapatkan data pemformatan untuk perintah, ia menggunakanGet-FormatDatacmdlet. Anda mungkin melihat pesan kesalahan dari cmdlet ini saat menjalankanImport-PSSessionperintah. Selain itu,Import-PSSessiontidak dapat mengimpor perintah dari PSSession yang tidak menyertakanGet-Commandcmdlet , ,Get-FormatDataSelect-Object, danGet-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, gunakanInvoke-Commandperintah untuk menjalankan profil di PSSession secara manual sebelum mengimpor perintah. - Modul sementara yang
Import-PSSessiondibuat 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 yangImport-PSSessiondibuat berisi file skrip yang tidak ditandatangani yang dilarang oleh kebijakan ini. Untuk menggunakanImport-PSSessiontanpa mengubah kebijakan eksekusi untuk komputer lokal, gunakan parameterSet-ExecutionPolicyCakupan untuk mengatur 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
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk