Import-PSSession
Komutları başka bir oturumdan geçerli oturuma aktarır.
Syntax
Import-PSSession
[-Prefix <String>]
[-DisableNameChecking]
[[-CommandName] <String[]>]
[-AllowClobber]
[-ArgumentList <Object[]>]
[-CommandType <CommandTypes>]
[-Module <String[]>]
[-FullyQualifiedModule <ModuleSpecification[]>]
[[-FormatTypeName] <String[]>]
[-Certificate <X509Certificate2>]
[-Session] <PSSession>
[<CommonParameters>]
Description
Import-PSSession
cmdlet, cmdlet'ler, işlevler ve diğer adlar gibi komutlarını yerel veya uzak bir bilgisayardaki PSSession'dan geçerli oturuma aktarır. Cmdlet'in Get-Command
PSSession'da bulabileceği herhangi bir komutu içeri aktarabilirsiniz.
Import-PSSession
Komutları Microsoft Exchange Server kabuğu gibi özelleştirilmiş bir kabuktan veya Windows PowerShell modülleri ve ek bileşenleri içeren bir oturumdan ya da geçerli oturumda olmayan diğer öğelerden içeri aktarmak için bir komut kullanın.
Komutları içeri aktarmak için önce cmdlet'ini New-PSSession
kullanarak bir PSSession oluşturun. Ardından komutlarını Import-PSSession
içeri aktarmak için cmdlet'ini kullanın. Varsayılan olarak, Import-PSSession
geçerli oturumdaki komutlarla aynı adlara sahip komutlar dışındaki tüm komutları içeri aktarır. Tüm komutları içeri aktarmak için AllowClobber parametresini kullanın.
İçeri aktarılan komutları oturumdaki herhangi bir komutu kullandığınız gibi kullanabilirsiniz. İçeri aktarılan bir komut kullandığınızda, komutun içeri aktarılan bölümü, içeri aktarıldığı oturumda örtük olarak çalışır. Ancak, uzak işlemler tamamen Windows PowerShell tarafından işlenir. Diğer oturum (PSSession) bağlantısını açık tutmanız dışında, bunların farkında bile olmanız gerekmez. Kapatırsanız, içeri aktarılan komutlar artık kullanılamaz.
İçeri aktarılan komutların çalıştırılması yerel komutlardan daha uzun sürebileceğinden, Import-PSSession
içeri aktarılan her komuta bir AsJob parametresi ekler. Bu parametre, komutu Windows PowerShell arka plan işi olarak çalıştırmanızı sağlar. Daha fazla bilgi için bkz. İşler hakkında.
kullandığınızdaImport-PSSession
, Windows PowerShell içeri aktarılan komutları yalnızca oturumunuzda bulunan geçici bir modüle ekler ve modülü temsil eden bir nesne döndürür. Gelecek oturumlarda kullanabileceğiniz kalıcı bir modül oluşturmak için cmdlet'ini Export-PSSession
kullanın.
cmdlet'iImport-PSSession
, Windows PowerShell örtük uzaktan iletişim özelliğini kullanır. Komutları geçerli oturuma aktardığınızda, bunlar özgün oturumda veya kaynak bilgisayarda benzer bir oturumda örtük olarak çalışır.
Windows PowerShell 3.0'dan başlayarak, cmdlet'ini Import-Module
kullanarak uzak oturumdaki modülleri geçerli oturuma aktarabilirsiniz. Bu özellik örtük uzaktan iletişim kullanır. Uzak oturumdaki seçili modülleri geçerli oturuma aktarmak için kullanmaya Import-PSSession
eşdeğerdir.
Örnekler
Örnek 1: PSSession'dan tüm komutları içeri aktarma
PS C:\> $S = New-PSSession -ComputerName Server01
PS C:\> Import-PSSession -Session $S
Bu komut, geçerli oturumdaki komutlarla aynı adlara sahip komutlar dışında, Server01 bilgisayarındaki bir PSSession'dan geçerli oturuma tüm komutları içeri aktarır.
Bu komut CommandName parametresini kullanmadığından, içeri aktarılan komutlar için gereken tüm biçimlendirme verilerini de içeri aktarır.
Örnek 2: Belirli bir dizeyle biten komutları içeri aktarma
PS C:\> $S = New-PSSession https://ps.testlabs.com/powershell
PS C:\> Import-PSSession -Session $S -CommandName *-test -FormatTypeName *
PS C:\> New-Test -Name Test1
PS C:\> Get-Test test1 | Run-Test
Bu komutlar, PSSession'dan "-test" ile biten adlara sahip komutları yerel oturuma aktarır ve içeri aktarılan bir cmdlet'in nasıl kullanılacağını gösterir.
İlk komut bir PSSession oluşturmak için cmdlet'ini kullanır New-PSSession
. PSSession değişkenini $S
kaydeder.
İkinci komut, cmdlet'indeki Import-PSSession
PSSession komutlarını geçerli oturuma aktarmak için cmdlet'ini $S
kullanır. Test komutlarının biçimlendirme verilerini içeri aktarmak üzere Test adına ve FormatTypeName parametresine sahip komutları belirtmek için CommandName parametresini kullanır.
Üçüncü ve dördüncü komutlar geçerli oturumda içeri aktarılan komutları kullanır. İçeri aktarılan komutlar aslında geçerli oturuma eklendiğinden, bunları çalıştırmak için yerel söz dizimini kullanırsınız. İçeri aktarılan bir komutu çalıştırmak için cmdlet'ini kullanmanız Invoke-Command
gerekmez.
Örnek 3: PSSession'dan cmdlet'leri içeri aktarma
PS C:\> $S1 = New-PSSession -ComputerName s1
PS C:\> $S2 = New-PSSession -ComputerName s2
PS C:\> Import-PSSession -Session s1 -Type cmdlet -Name New-Test, Get-Test -FormatTypeName *
PS C:\> Import-PSSession -Session s2 -Type Cmdlet -Name Set-Test -FormatTypeName *
PS C:\> New-Test Test1 | Set-Test -RunType Full
Bu örnekte, içeri aktarılan cmdlet'leri yerel cmdlet'ler gibi kullanabileceğiniz gösterilmektedir.
Bu komutlar ve Get-Test
cmdlet'lerini Server01 bilgisayarındaki bir PSSession'dan ve Set-Test
cmdlet'lerini Server02 bilgisayarındaki bir PSSession'dan içeri aktarırNew-Test
.
Cmdlet'ler farklı PSSession'lardan içeri aktarılmış olsa da, bir nesneyi bir cmdlet'ten diğerine hatasız olarak aktarabilirsiniz.
Örnek 4: İçeri aktarılan komutu arka plan işi olarak çalıştırma
PS C:\> $S = New-PSSession -ComputerName Server01
PS C:\> Import-PSSession -Session $S -CommandName *-test* -FormatTypeName *
PS C:\> $batch = New-Test -Name Batch -AsJob
PS C:\> Receive-Job $batch
Bu örnekte, içeri aktarılan bir komutun arka plan işi olarak nasıl çalıştırılacağını gösterir.
İçeri aktarılan komutların çalıştırılması yerel komutlardan daha uzun sürebileceğinden, Import-PSSession
içeri aktarılan her komuta bir AsJob parametresi ekler. AsJob parametresi, komutu arka plan işi olarak çalıştırmanıza olanak tanır.
İlk komut, Server01 bilgisayarında bir PSSession oluşturur ve PSSession nesnesini değişkene $S
kaydeder.
İkinci komut, içindeki PSSession'daki Test cmdlet'lerini $S
geçerli oturuma aktarmak için kullanırImport-PSSession
.
Üçüncü komut, bir komutu arka plan işi olarak çalıştırmak New-Test
için içeri aktarılan New-Test
cmdlet'in AsJob parametresini kullanır. komutu, değişkeninde $batch
döndüren New-Test
iş nesnesini kaydeder.
Dördüncü komut, değişkenindeki Receive-Job
işin sonuçlarını almak için cmdlet'ini $batch
kullanır.
Örnek 5: Windows PowerShell modülünden cmdlet'leri ve işlevleri içeri aktarma
PS C:\> $S = New-PSSession -ComputerName Server01
PS C:\> Invoke-Command -Session $S {Import-Module TestManagement}
PS C:\> Import-PSSession -Session $S -Module TestManagement
Bu örnekte, uzak bilgisayardaki bir Windows PowerShell modülündeki cmdlet'lerin ve işlevlerin geçerli oturuma nasıl aktarıldığı gösterilmektedir.
İlk komut, Server01 bilgisayarında bir PSSession oluşturur ve değişkene $S
kaydeder.
İkinci komut, cmdlet'ini Invoke-Command
kullanarak içindeki PSSession'da $S
bir Import-Module
komut çalıştırır.
Genellikle modül, bir Windows PowerShell profilindeki bir Import-Module
komut tarafından tüm oturumlara eklenir, ancak profiller PSSessions içinde çalıştırılmaz.
Üçüncü komut, modüldeki cmdlet'leri ve işlevleri geçerli oturuma aktarmak için module parametresini Import-PSSession
kullanır.
Örnek 6: Geçici bir dosyada modül oluşturma
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 : {}
Bu örnekte, diskteki geçici bir dosyada bir modül oluşturduğu gösterilmektedir Import-PSSession
. Ayrıca tüm komutların geçerli oturuma aktarılamadan önce işlevlere dönüştürüldüğünü gösterir.
komut, cmdlet'ini Import-PSSession
kullanarak bir cmdlet'i ve SearchHelp işlevini geçerli oturuma aktarır Get-Date
.
Cmdlet, Import-PSSession
geçici modülü temsil eden bir PSModuleInfo nesnesi döndürür. Path özelliğinin değeri, geçici bir konumda bir betik modülü (.psm1) dosyası oluşturduğunu Import-PSSession
gösterir. ExportedFunctions özelliği, cmdlet ve SearchHelp işlevinin her ikisinin de işlev olarak içeri aktarıldığını gösterirGet-Date
.
Örnek 7: İçeri aktarılan bir komut tarafından gizlenen bir komut çalıştırma
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
Bu örnekte, içeri aktarılan bir komut tarafından gizlenen bir komutun nasıl çalıştırılacağını gösterir.
İlk komut, değişkenindeki PSSession'dan bir Get-Date
cmdlet içeri $S
aktarır. Geçerli oturum bir Get-Date
cmdlet içerdiğinden, komutunda AllowClobber parametresi gereklidir.
İkinci komut, geçerli oturumdaki Get-Command
tüm komutları almak için cmdlet'in AllGet-Date
parametresini kullanır. Çıkış, oturumun özgün Get-Date
cmdlet'ini ve bir Get-Date
işlevi içerdiğini gösterir. işlevi, Get-Date
içindeki PSSession içinde içeri aktarılan Get-Date
cmdlet'i $S
çalıştırır.
Üçüncü komut bir Get-Date
komut çalıştırır. İşlevler cmdlet'lerden öncelikli olduğundan, Windows PowerShell bir Julian tarihi döndüren içeri aktarılan Get-Date
işlevi çalıştırır.
Dördüncü ve beşinci komutlar, içeri aktarılan bir komut tarafından gizlenen bir komutu çalıştırmak için tam adın nasıl kullanılacağını gösterir.
Dördüncü komut, özgün Get-Date
cmdlet'i geçerli oturuma ekleyen Windows PowerShell ek bileşeninin adını alır.
Beşinci komut, komutu Get-Date
çalıştırmak için cmdlet'in Get-Date
ek bileşeni adını kullanır.
Komut önceliği ve gizli komutlar hakkında daha fazla bilgi için bkz. about_Command_Precedence.
Örnek 8: Adlarında belirli bir dize bulunan komutları içeri aktarma
PS C:\> Import-PSSession -Session $S -CommandName **Item** -AllowClobber
Bu komut, adları içinde PSSession $S
öğesinden Öğe içeren komutları içeri aktarır. Komut CommandName parametresini içerdiğinden ancak FormatTypeData parametresini içermediğinden, yalnızca komut içeri aktarılır.
Uzak bir bilgisayarda komut çalıştırmak için kullanırken Import-PSSession
ve geçerli oturumda komutun biçimlendirme verilerine zaten sahip olduğunuzda bu komutu kullanın.
Örnek 9: Oturuma hangi komutların aktarıldığını bulmak için Module parametresini kullanın
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
Bu komut, bir Import-PSSession
komut tarafından hangi komutların oturuma aktarıldığını bulmak için Module parametresinin Get-Command
nasıl kullanılacağını gösterir.
İlk komut, cmdlet'ini Import-PSSession
kullanarak adları değişkendeki PSSession'dan $S
"bit" içeren komutları içeri aktarır. Import-PSSession
komutu geçici bir modül döndürür ve komutu modülü değişkene $m
kaydeder.
İkinci komut, değişkeninde Get-Command
modül tarafından dışarı aktarılan komutları almak için cmdlet'ini $M
kullanır.
Module parametresi, modül adı için tasarlanmış bir dize değeri alır. Ancak, bir modül nesnesi gönderdiğinizde Windows PowerShell modül nesnesinde toString yöntemini kullanır ve bu yöntem modül adını döndürür.
Get-Command
komutu " ile eşdeğerdirGet-Command $M.Name
.
Parametreler
-AllowClobber
Bu cmdlet'in, geçerli oturumdaki komutlarla aynı adlara sahip olsalar bile belirtilen komutları içeri aktardığını gösterir.
Geçerli oturumda komutla aynı ada sahip bir komutu içeri aktarırsanız, içeri aktarılan komut özgün komutları gizler veya değiştirir. Daha fazla bilgi için bkz. about_Command_Precedence.
Varsayılan olarak, Import-PSSession
geçerli oturumdaki komutlar ile aynı ada sahip komutları içeri aktarmaz.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ArgumentList
Belirtilen bağımsız değişkenlerin (parametre değerleri) kullanılmasından kaynaklanan komut dizisini belirtir.
Örneğin, sertifikadaki komutun değişkenini Get-Item
içeri aktarmak için (Cert:) sürücüsündeki PSSession'da $S
yazın 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
Biçim dosyalarını (*) imzalamak için kullanılan istemci sertifikasını belirtir. Oluşturan geçici modülde Format.ps1xml) veya betik modülü Import-PSSession
dosyaları (.psm1).
Sertifikayı içeren bir değişken veya sertifikayı alan bir komut veya ifade girin.
Sertifikayı bulmak için cmdlet'ini Get-PfxCertificate
veya Sertifika'daki cmdlet'i kullanın Get-ChildItem
(Sertifika:) Sürücü. Sertifika geçerli değilse veya yeterli yetkiye sahip değilse, komut başarısız olur.
Type: | X509Certificate2 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandName
Belirtilen adlara veya ad desenlerine sahip komutları belirtir. Joker karakterlere izin verilir. CommandName veya diğer adı olan Name'i kullanın.
Varsayılan olarak, Import-PSSession
geçerli oturumdaki komutlarla aynı adlara sahip komutlar dışında oturumdaki tüm komutları içeri aktarır. Bu, içeri aktarılan komutların oturumdaki komutları gizlemesini veya değiştirmesini engeller. Diğer komutları gizleyen veya değiştirenler bile olmak üzere tüm komutları içeri aktarmak için AllowClobber parametresini kullanın.
CommandName parametresini kullanırsanız, FormatTypeName parametresini kullanmadığınız sürece komutların biçimlendirme dosyaları içeri aktarılmaz. Benzer şekilde, FormatTypeName parametresini kullanırsanız, CommandName parametresini kullanmadığınız sürece hiçbir komut içeri aktarılmamaktadır.
Type: | String[] |
Aliases: | Name |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandType
Komut nesnelerinin türünü belirtir. Varsayılan değer Cmdlet'tir. CommandType veya diğer adı olan Type'i kullanın. Bu parametrenin kabul edilebilir değerleri şunlardır:
- Diğer ad. Uzak oturumdaki Windows PowerShell diğer adları.
- Tüm. Uzak oturumdaki cmdlet'ler ve işlevler.
- Uygulama. .txt, .exe ve .dll dosyaları da dahil olmak üzere uzak oturumdaki Yol ortam değişkeninde (
$env:path
) listelenen yollarda Windows-PowerShell dışındaki tüm dosyalar. - Cmdlet. Uzak oturumdaki cmdlet'ler. "Cmdlet" varsayılan değerdir.
- ExternalScript. Uzak oturumdaki Yol ortam değişkeninde () listelenen yollardaki dosyaları .ps1
$env:path
. - Filter ve Function. Windows PowerShell uzak oturumda çalışır.
- Komut dosyası. Betik, uzak oturumdaki blokları.
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
Bu cmdlet'in, adı onaylanmamış bir fiil veya yasaklanmış karakter içeren bir cmdlet veya işlevi içeri aktardığınızda sizi uyaran iletiyi gizlediğini gösterir.
Varsayılan olarak, içeri aktardığınız bir modül adlarında onaylanmamış fiiller bulunan cmdlet'leri veya işlevleri dışarı aktardığında, Windows PowerShell aşağıdaki uyarı iletisini görüntüler:
"UYARI: İçeri aktarılan bazı komut adları onaylanmamış fiiller içerir ve bu da onları daha az bulunabilir hale getirir. Onaylanan fiillerin listesini görmek için daha fazla ayrıntı veya tür Get-Verb
için Verbose parametresini kullanın."
Bu ileti yalnızca bir uyarıdır. Uyumlu olmayan komutlar da dahil olmak üzere modülün tamamı yine içeri aktarılır. İleti modül kullanıcılarına görüntülense de, adlandırma sorunu modül yazarı tarafından düzeltilmelidir.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FormatTypeName
Belirtilen Microsoft .NET Framework türleri için biçimlendirme yönergelerini belirtir. Tür adlarını girin. Joker karakterlere izin verilir.
Bu parametrenin değeri, komutların içeri aktarıldığı oturumda bir komut tarafından döndürülen bir Get-FormatData
türün adı olmalıdır. Uzak oturumdaki tüm biçimlendirme verilerini almak için yazın *
.
Komut CommandName veya FormatTypeName parametresini içermiyorsa, Import-PSSession
uzak oturumda bir Get-FormatData
komut tarafından döndürülen tüm .NET Framework türleri için biçimlendirme yönergelerini içeri aktarır.
FormatTypeName parametresini kullanırsanız, CommandName parametresini kullanmadığınız sürece hiçbir komut içeri aktarılmamaktadır.
Benzer şekilde, CommandName parametresini kullanırsanız, FormatTypeName parametresini kullanmadığınız sürece komutların biçimlendirme dosyaları içeri aktarılmaz.
Type: | String[] |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FullyQualifiedModule
ModuleSpecification nesneleri biçiminde belirtilen adlara sahip modülleri belirtir (PowerShell SDK'sında ModuleSpecification Constructor'ın (Hashtable) Açıklamalar bölümünde açıklanmıştır. Örneğin, FullyQualifiedModule parametresi şu biçimde belirtilen bir modül adını kabul eder:
@{ModuleName = "modulename"; ModuleVersion = "version_number"}
veya@{ModuleName = "modulename"; ModuleVersion = "version_number"; Guid = "GUID"}
.
ModuleName ve ModuleVersion gereklidir, ancak Guid isteğe bağlıdır.
Bir Module parametresiyle aynı komutta FullyQualifiedModule parametresini belirtemezsiniz. İki parametre birbirini dışlar.
Type: | ModuleSpecification[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Module
Windows PowerShell ek bileşenleri ve modüllerindeki komutların dizisini ve dizisini belirtir. Ek bileşen ve modül adlarını girin. Joker karakterlere izin verilmez.
Import-PSSession
bir ek bileşenden sağlayıcıları içeri aktaramaz.
Daha fazla bilgi için bkz. about_PSSnapins ve about_Modules.
Type: | String[] |
Aliases: | PSSnapin |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prefix
İçeri aktarılan komutların adlarındaki adlara bir ön ek belirtir.
Oturumdaki farklı komutlar aynı ada sahip olduğunda oluşabilecek ad çakışmalarını önlemek için bu parametreyi kullanın.
Örneğin, Uzak ön ekini belirtir ve ardından bir Get-Date
cmdlet'i içeri aktarırsanız, cmdlet oturumda olarak Get-RemoteDate
bilinir ve özgün Get-Date
cmdlet ile karıştırılmaz.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Session
Cmdlet'lerin içeri aktarıldığı PSSession'ı belirtir. Oturum nesnesi veya veya komutu gibi bir oturum nesnesi alan bir komut içeren bir New-PSSession
Get-PSSession
değişken girin. Yalnızca bir oturum belirtebilirsiniz. Bu parametre zorunludur.
Type: | PSSession |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
Import-PSSession
ve Get-Module
cmdlet'lerinin döndürdüğü New-Module
modül nesnesini döndürür.
Ancak, içeri aktarılan modül geçicidir ve yalnızca geçerli oturumda bulunur. Diskte kalıcı bir modül oluşturmak için cmdlet'ini Export-PSSession
kullanın.
Notlar
Import-PSSession
PowerShell uzaktan iletişim altyapısını kullanır. Bu cmdlet'i kullanmak için bilgisayarın uzaktan iletişim WS-Management için yapılandırılması gerekir. Daha fazla bilgi için bkz. about_Remote ve about_Remote_Requirements.Import-PSSession
değişkenleri veya PowerShell sağlayıcılarını içeri aktarmaz.- Geçerli oturumdaki komutlarla aynı adlara sahip komutları içeri aktardığınızda, içeri aktarılan komutlar oturumdaki diğer adları, işlevleri ve cmdlet'leri gizleyebilir ve oturumdaki işlevleri ve değişkenleri değiştirebilir. Ad çakışmalarını önlemek için Prefix parametresini kullanın. Daha fazla bilgi için bkz. about_Command_Precedence.
Import-PSSession
tüm komutları içeri aktarmadan önce işlevlere dönüştürür. Sonuç olarak, içeri aktarılan komutlar özgün komut türlerini korurlarsa, bundan biraz farklı davranırlar. Örneğin, PSSession'dan bir cmdlet'i içeri aktarıp bir modülden veya ek bileşenden aynı ada sahip bir cmdlet'i içeri aktarırsanız, pssession'dan içeri aktarılan cmdlet her zaman varsayılan olarak çalışır çünkü işlevler cmdlet'lerden önceliklidir. Buna karşılık, diğer adı aynı ada sahip bir diğer ada sahip bir oturuma diğer adı içeri aktarırsanız, diğer ad işlevlerden öncelikli olduğundan özgün diğer ad her zaman kullanılır. Daha fazla bilgi için bkz. about_Command_Precedence.Import-PSSession
komutunWrite-Progress
ilerleme durumunu görüntülemek için cmdlet'ini kullanır. Komut çalışırken ilerleme çubuğunu görebilirsiniz.- İçeri aktarılacak komutları bulmak için cmdlet'ini
Import-PSSession
Invoke-Command
kullanarak PSSession'da birGet-Command
komut çalıştırın. Komutların biçimlendirme verilerini almak için cmdlet'iniGet-FormatData
kullanır. Bir komut çalıştırdığınızdaImport-PSSession
bu cmdlet'lerden hata iletileri görebilirsiniz. Ayrıca,Import-PSSession
, ,Get-FormatData
Select-Object
veGet-Help
cmdlet'lerini içermeyenGet-Command
bir PSSession'dan komutlar içeri aktarılamaz. - İçeri aktarılan komutlar, Not Defteri gibi bir kullanıcı arabirimiyle program başlatamama dahil olmak üzere diğer uzak komutlarla aynı sınırlamalara sahiptir.
- Windows PowerShell profilleri PSSessions içinde çalıştırılmadığından, bir profilin oturuma eklediği komutlar tarafından
Import-PSSession
kullanılamaz. Bir profilden komutları içeri aktarmak için, komutları içeri aktarmadan önce PSSession'da profili el ile çalıştırmak için komutunuInvoke-Command
kullanın. - Oluşturulan geçici modül
Import-PSSession
, komut biçimlendirme verilerini içeri aktarmasa bile bir biçimlendirme dosyası içerebilir. Komut biçimlendirme verilerini içeri aktarmazsa, oluşturulan biçimlendirme dosyaları biçimlendirme verileri içermez. - kullanmak
Import-PSSession
için, oluşturan geçici modülImport-PSSession
bu ilkeler tarafından yasaklanan imzalanmamış betik dosyaları içerdiğinden geçerli oturumdaki yürütme ilkesi Kısıtlı veya AllSigned olamaz. Yerel bilgisayarın yürütme ilkesini değiştirmeden kullanmakImport-PSSession
üzere, tek bir işlem için daha az kısıtlayıcı bir yürütme ilkesi ayarlamak üzere 'nin Scope parametresiniSet-ExecutionPolicy
kullanın. - Windows PowerShell 2.0'da, başka bir oturumdan içeri aktarılan komutların yardım konuları, Prefix parametresini kullanarak atadığınız ön eki içermez. Windows PowerShell 2.0'da içeri aktarılan komutla ilgili yardım almak için özgün (ön eki olmayan) komut adını kullanın.