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 $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 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 Full
Contoh 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 $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 $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 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 $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 PM
Contoh 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** -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 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-BitsTransfer
Perintah 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.Filter
danFunction
: 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-PSSession
bergantung 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-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
Write-Progress
menggunakan cmdlet untuk menampilkan kemajuan perintah. Anda mungkin melihat bilah kemajuan saat perintah sedang berjalan.- Untuk menemukan perintah yang akan diimpor,
Import-PSSession
gunakanInvoke-Command
cmdlet untuk menjalankanGet-Command
perintah di PSSession. Untuk mendapatkan data pemformatan untuk perintah, ia menggunakanGet-FormatData
cmdlet. Anda mungkin melihat pesan kesalahan dari cmdlet ini saat menjalankanImport-PSSession
perintah. Selain itu,Import-PSSession
tidak dapat mengimpor perintah dari PSSession yang tidak menyertakanGet-Command
cmdlet , ,Get-FormatData
Select-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-Command
perintah untuk menjalankan profil di PSSession secara manual sebelum mengimpor perintah. - Modul sementara yang
Import-PSSession
dibuat 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-PSSession
dibuat berisi file skrip yang tidak ditandatangani yang dilarang oleh kebijakan ini. Untuk menggunakanImport-PSSession
tanpa mengubah kebijakan eksekusi untuk komputer lokal, gunakan parameterSet-ExecutionPolicy
Cakupan 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
https://aka.ms/ContentUserFeedback.
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:Kirim dan lihat umpan balik untuk