Aracılığıyla paylaş


Import-PSSession

Komutları başka bir oturumdan geçerli oturuma aktarır.

Sözdizimi

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'i 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.

Komutları Microsoft Exchange Server kabuğu gibi özelleştirilmiş bir kabuktan veya Windows PowerShell modülleri ve ek bileşenleri içeren bir oturumdan veya geçerli oturumda bulunmayan diğer öğelerden içeri aktarmak için bir Import-PSSession 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 oturumla (PSSession) bağlantıyı 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ıza olanak tanır. Daha fazla bilgi için bkz. İşler hakkında.

kullandığınızda Import-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'i Import-PSSession , Windows PowerShell'in ö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

$S = New-PSSession -ComputerName Server01
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

$S = New-PSSession https://ps.testlabs.com/powershell
Import-PSSession -Session $S -CommandName *-test -FormatTypeName *
New-Test -Name Test1
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, pssession oluşturmak için cmdlet'ini kullanır New-PSSession . PSSession değişkenini $S kaydeder.

İkinci komut, komutlarını PSSession'dan geçerli oturuma aktarmak için cmdlet'ini $S kullanırImport-PSSession. Test komutlarının biçimlendirme verilerini içeri aktarmak üzere Test adı ve FormatTypeName parametresiyle 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

$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

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ı PSSessions'tan içeri aktarılmış olsa da, bir cmdlet'ten diğerine hatasız bir nesne aktarabilirsiniz.

Örnek 4: İçeri aktarılan bir komutu arka plan işi olarak çalıştırma

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

Bu örnek, 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

$S = New-PSSession -ComputerName Server01
Invoke-Command -Session $S {Import-Module TestManagement}
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şkenine $S kaydeder.

İkinci komut cmdlet'ini Invoke-Command kullanarak içindeki $SPSSession'da bir Import-Module komut çalıştırır.

Genellikle modül bir Windows PowerShell profilindeki bir Import-Module komutla 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 Import-PSSession , diskteki geçici bir dosyada bir modül oluşturulur. Ayrıca, tüm komutların geçerli oturuma aktarilmeden önce işlevlere dönüştürüldüğünü gösterir.

komut, cmdlet'ini Import-PSSession kullanarak bir Get-Date cmdlet'i ve SearchHelp işlevini geçerli oturuma aktarır.

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'in ve SearchHelp işlevinin 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şkendeki 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 All Get-Date parametresini kullanır. Çıkış, oturumun özgün Get-Date cmdlet'ini ve bir Get-Date işlevi içerdiğini gösterir. İşlev, Get-Date içindeki PSSession'da 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 Jülyen 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şen-nitelenmiş 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ında PSSession $Söğesinden Öğe bulunan 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.

Komutunu uzak bilgisayarda ç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 komutla oturuma hangi komutların aktarıldığını bulmak için modül parametresinin Get-Command nasıl kullanılacağını gösterir.

İlk komut, cmdlet'ini kullanarak adları değişkendeki Import-PSSession 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şkenindeki 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.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ArgumentList

Belirtilen bağımsız değişkenlerin (parametre değerleri) kullanılmasından kaynaklanan bir komut dizisini belirtir.

Örneğin, içindeki PSSession'daki $Ssertifika (Cert:) sürücüsündeki komutun değişkenini Get-Item içeri aktarmak için yazınImport-PSSession -Session $S -Command Get-Item -ArgumentList cert:.

Tür:Object[]
Diğer adlar:Args
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Sertifika bulmak için cmdlet'ini Get-PfxCertificate veya Sertifika (Sertifika:) sürücüsündeki cmdlet'ini kullanın Get-ChildItem . Sertifika geçerli değilse veya yeterli yetkiye sahip değilse, komut başarısız olur.

Tür:X509Certificate2
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CommandName

Belirtilen adlara veya ad desenlerine sahip komutları belirtir. Joker karakterlere izin verilir. CommandName veya diğer adı Olan Ad'ı 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ılmaz.

Tür:String[]
Diğer adlar:Name
Position:2
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CommandType

Komut nesnelerinin türünü belirtir. Varsayılan değer Cmdlet'tir. CommandType veya diğer adını kullanın, Tür. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • Alias: Uzak oturumdaki Windows PowerShell diğer adları.
  • All: Uzak oturumdaki cmdlet'ler ve işlevler.
  • Application: .txt, .exe ve .dll dosyaları dahil olmak üzere uzak oturumdaki Yol ortam değişkeninde ($env:path) listelenen yollardaki Windows-PowerShell dosyaları dışındaki tüm dosyalar.
  • Cmdlet: Uzak oturumdaki cmdlet'ler. "Cmdlet" varsayılan değerdir.
  • ExternalScript: Uzak oturumdaki Yol ortam değişkeninde ($env:path) listelenen yollardaki .ps1 dosyaları.
  • Filter ve Function: Uzak oturumdaki Windows PowerShell işlevleri.
  • Script: Betik, uzak oturumda engeller.

Bu değerler, bayrak tabanlı bir numaralandırma olarak tanımlanır. Bu parametreyi kullanarak birden çok bayrak ayarlamak için birden çok değeri birlikte birleştirebilirsiniz. Değerler CommandType parametresine bir değer dizisi veya bu değerlerin virgülle ayrılmış dizesi olarak geçirilebilir. cmdlet'i bir ikili OR işlemi kullanarak değerleri birleştirir. Değerleri dizi olarak geçirmek en basit seçenektir ve değerler üzerinde sekme tamamlama özelliğini kullanmanıza da olanak tanır.

Tür:CommandTypes
Diğer adlar:Type
Kabul edilen değerler:Alias, Function, Filter, Cmdlet, ExternalScript, Application, Script, Workflow, Configuration, All
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DisableNameChecking

Bu cmdlet'in, adı onaylanmamış bir fiil veya yasaklanmış karakter içeren bir cmdlet'i 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ı, daha az bulunabilir hale getirebilecek onaylanmamış fiiller içerir. Onaylanan fiillerin listesini görmek için daha fazla ayrıntı veya tür Get-Verb için Verbose parametresini kullanın."

Bir 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.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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ığı oturumdaki bir Get-FormatData komut tarafından döndürülen 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 oturumdaki 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ılmaz.

Benzer şekilde, CommandName parametresini kullanırsanız, FormatTypeName parametresini kullanmadığınız sürece komutların biçimlendirme dosyaları içeri aktarılmaz.

Tür:String[]
Position:3
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-FullyQualifiedModule

Değer bir modül adı, tam modül belirtimi veya modül dosyasının yolu olabilir.

Değer bir yol olduğunda, yol tam veya göreli olabilir. Göreli yol, using deyimini içeren betike göre çözümlenir.

Değer bir ad veya modül belirtimi olduğunda PowerShell , PSModulePath'de belirtilen modülü arar.

Modül belirtimi, aşağıdaki anahtarlara sahip bir karma tablodur.

  • ModuleName - Gerekli Modül adını belirtir.
  • GUID - İsteğe Bağlı Modülün GUID değerini belirtir.
  • Ayrıca aşağıdaki üç anahtardan en az birini belirtmek gerekir .
    • ModuleVersion - Modülün kabul edilebilir en düşük sürümünü belirtir.
    • MaximumVersion - Modülün kabul edilebilir en yüksek sürümünü belirtir.
    • RequiredVersion - Modülün tam, gerekli bir sürümünü belirtir. Bu, diğer Sürüm anahtarlarıyla kullanılamaz.

Bir Module parametresiyle aynı komutta FullyQualifiedModule parametresini belirtemezsiniz. İki parametre birbirini dışlar.

Tür:ModuleSpecification[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Module

Windows PowerShell ek bileşenlerinde ve modüllerinde komutların dizisini ve dizisini belirtir. Ek bileşen ve modül adlarını girin. Joker karakterlere izin verilmez.

Import-PSSession sağlayıcılar bir ek bileşenden içeri aktarılamaz.

Daha fazla bilgi için bkz . about_PSSnapins ve about_Modules.

Tür:String[]
Diğer adlar:PSSnapin
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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çeri aktarırsanız, cmdlet oturumda olarak Get-RemoteDatebilinir ve özgün Get-Date cmdlet ile karıştırılmaz.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Session

Cmdlet'lerin içeri aktarıldığı PSSession'ı belirtir. Veya komutu gibi bir oturum nesnesi alan bir oturum nesnesi veya komut içeren bir New-PSSession Get-PSSession değişken girin. Yalnızca bir oturum belirtebilirsiniz. Bu parametre zorunludur.

Tür:PSSession
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

PSModuleInfo

Bu cmdlet, 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 WS-Management uzaktan iletişim 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 koruyacaklarından biraz farklı davranır. Örneğin, PSSession'dan bir cmdlet içeri aktarır ve ardından bir modülden veya ek bileşenden aynı ada sahip bir cmdlet'i içeri aktarırsanız, işlevler cmdlet'lerden öncelikli olduğundan PSSession'dan içeri aktarılan cmdlet her zaman varsayılan olarak çalışır. Buna karşılık, bir diğer adı aynı ada sahip bir oturuma aktarırsanız, diğer adlar 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 komutun Write-Progress ilerleme durumunu görüntülemek için cmdlet'ini kullanır. Komut çalışırken ilerleme çubuğunu görebilirsiniz.
  • İçeri aktarılacak Import-PSSession komutları bulmak için cmdlet'ini Invoke-Command kullanarak PSSession'da bir Get-Command komut çalıştırır. Komutların biçimlendirme verilerini almak için cmdlet'ini Get-FormatData kullanır. Bir komut çalıştırdığınızda Import-PSSession bu cmdlet'lerden hata iletileri görebilirsiniz. Ayrıca, Import-PSSession , , Get-FormatDataSelect-Objectve Get-Help cmdlet'lerini içermeyen Get-Commandbir PSSession'dan komutlar içeri aktarılamaz.
  • İçeri aktarılan komutlar, Not Defteri gibi bir kullanıcı arabirimiyle program başlatamama gibi 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-PSSessionkullanılamaz. Bir profilden komutları içeri aktarmak için, komutları içeri aktarmadan önce PSSession'da profili el ile çalıştırmak için komutunu Invoke-Command kullanın.
  • Oluşturan 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.
  • öğesini kullanmak Import-PSSessioniçin, oluşturan geçici modül Import-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 kullanmak Import-PSSession üzere, tek bir işlem için daha az kısıtlayıcı bir yürütme ilkesi ayarlamak üzere'in Scope parametresini Set-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 bir komutla ilgili yardım almak için özgün (ön eki olmayan) komut adını kullanın.