Import-PSSession
Komutları başka bir oturumdan geçerli oturuma aktarır.
Syntax
Default (Varsayılan)
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ı yerel veya uzak bir bilgisayardaki PSSession'dan geçerli oturuma aktarır.
Get-Command cmdlet'inin PSSession'da bulabileceği herhangi bir komutu içeri aktarabilirsiniz.
Microsoft Exchange Server kabuğu gibi özelleştirilmiş bir kabuktan veya Windows PowerShell modülleri ve ek bileşenleri ya da geçerli oturumda bulunmayan diğer öğeleri içeren bir oturumdan komutları içeri aktarmak için Import-PSSession komutu kullanın.
Komutları içeri aktarmak için önce New-PSSession cmdlet'ini kullanarak pssession oluşturun. Ardından, komutları içeri aktarmak için Import-PSSession cmdlet'ini kullanın. Varsayılan olarak, Import-PSSession geçerli oturumdaki komutlarla aynı adlara sahip komutlar dışında tüm komutları içeri aktarır. Tüm komutları içeri aktarmak için AllowClobber
İç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 olabileceğ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. about_Jobs.
Import-PSSessionkullandığınızda, 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 Export-PSSession cmdlet'ini kullanın.
Import-PSSession cmdlet'i 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, uzak oturumdaki modülleri geçerli oturuma aktarmak için Import-Module cmdlet'ini kullanabilirsiniz. Bu özellik örtük uzaktan iletişim kullanır. Seçilen modülleri uzak oturumdan geçerli oturuma aktarmak için Import-PSSession kullanmakla 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 New-PSSession cmdlet'ini kullanır. PSSession'ı $S değişkenine kaydeder.
İkinci komut, Import-PSSession'daki PSSession komutlarını geçerli oturuma aktarmak için $S cmdlet'ini kullanır. Test komutlarının biçimlendirme verilerini içeri aktarmak üzere Test adı 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 Invoke-Command cmdlet'ini kullanmanız 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 New-Test ve Get-Test cmdlet'lerini Server01 bilgisayardaki pssession'dan ve Set-Test cmdlet'lerini Server02 bilgisayarındaki bir PSSession'dan içeri aktarır.
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 olabileceğ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 $S değişkenine kaydeder.
İkinci komut, Import-PSSession'daki PSSession'daki Test cmdlet'lerini geçerli oturuma aktarmak için $S kullanır.
Üçüncü komut, bir komutunu arka plan işi olarak çalıştırmak için içeri aktarılan New-Test cmdlet'in New-Test parametresini kullanır. komutu, New-Test döndüren iş nesnesini $batch değişkenine kaydeder.
Dördüncü komut, Receive-Job değişkenindeki işin sonuçlarını almak için $batch cmdlet'ini 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 $S değişkenine kaydeder.
İkinci komut, Invoke-Command'deki PSSession'da bir Import-Module komutu çalıştırmak için $S cmdlet'ini kullanır.
Genellikle modül, Windows PowerShell profilindeki bir Import-Module komutuyla 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 Import-PSSession parametresini 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şturduğu gösterilmektedir. Ayrıca, tüm komutların geçerli oturuma aktarilmeden önce işlevlere dönüştürüldüğünü gösterir.
Komut, Import-PSSession cmdlet'ini ve SearchHelp işlevini geçerli oturuma aktarmak için Get-Date cmdlet'ini kullanır.
Import-PSSession cmdlet'i, geçici modülü temsil eden bir PSModuleInfo nesnesi döndürür.
Path özelliğinin değeri, Import-PSSession geçici bir konumda bir betik modülü (.psm1) dosyası oluşturduğunu gösterir. exportedFunctions özelliği, Get-Date cmdlet'inin ve SearchHelp işlevinin işlev olarak içeri aktarıldığını gösterir.
Ö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, Get-Date değişkenindeki PSSession'dan bir $S cmdlet'ini içeri aktarır. Geçerli oturum bir Get-Date cmdlet'i içerdiğinden, komutta AllowClobber parametresi gereklidir.
İkinci komut, geçerli oturumdaki tüm komutlarını almak için Get-Command cmdlet'in Get-Date parametresini kullanır. Çıktı, oturumun özgün Get-Date cmdlet'ini ve bir Get-Date işlevini içerdiğini gösterir.
Get-Date işlevi, Get-Dateiçindeki PSSession'da içeri aktarılan $S cmdlet'ini çalıştırır.
Üçüncü komut bir Get-Date komutu ç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şlevini ç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, geçerli oturuma özgün Get-Date cmdlet'ini ekleyen Windows PowerShell ek bileşeninin adını alır.
Beşinci komut, bir Get-Date komutu çalıştırmak için Get-Date cmdlet'in 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ı $S'deki PSSession öğ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 Import-PSSession kullanırken 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 komutuyla hangi komutların oturuma aktarıldığını bulmak için Get-CommandImport-PSSession parametresinin nasıl kullanılacağını gösterir.
İlk komut, adları Import-PSSession değişkenindeki PSSession'dan "bit" içeren komutları içeri aktarmak için $S cmdlet'ini kullanır.
Import-PSSession komutu geçici bir modül döndürür ve komutu modülü $m değişkenine kaydeder.
İkinci komut, Get-Command değişkeninde modül tarafından dışarı aktarılan komutları almak için $M cmdlet'ini 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 modül adını döndüren ToString yöntemini kullanır.
Get-Command komutu Get-Command $M.Name" ile eşdeğerdir.
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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ArgumentList
Belirtilen bağımsız değişkenlerin (parametre değerleri) kullanılmasından kaynaklanan bir komut dizisini belirtir.
Örneğin, Get-Item komutunun değişkenini $SPSSession'daki sertifika (Cert:) sürücüsüne aktarmak için Import-PSSession -Session $S -Command Get-Item -ArgumentList Cert:yazın.
Parametre özellikleri
| Tür: | Object[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Argümanlar |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Certificate
Biçim dosyalarını (*) imzalamak için kullanılan istemci sertifikasını belirtir. Format.ps1xml) veya .psm1 oluşturduğu geçici modülde betik modülü dosyaları (Import-PSSession).
Sertifikayı içeren bir değişken veya sertifikayı alan bir komut veya ifade girin.
Sertifika bulmak için Get-PfxCertificate cmdlet'ini veya Sertifika (Sertifika:) sürücüsündeki Get-ChildItem cmdlet'ini kullanın. Sertifika geçerli değilse veya yeterli yetkiye sahip değilse, komut başarısız olur.
Parametre özellikleri
| Tür: | X509Certificate2 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-CommandName
Belirtilen adlara veya ad desenlerine sahip komutları belirtir. Joker karakterlere izin verilir. CommandName veya diğer adını Namekullanı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
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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | İsim |
Parametre kümeleri
(All)
| Position: | 2 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 parametre için kabul edilebilir değerler şunlardır:
-
Alias: Uzak oturumdaki Windows PowerShell diğer adları. -
All: Uzak oturumdaki cmdlet'ler ve işlevler. -
Application: .txt, .exeve .dll dosyaları dahil olmak üzere uzak oturumdaki PATH 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 PATH ortam değişkeninde (.ps1) listelenen yollardaki dosyaları$Env:PATH. -
FilterveFunction: Uzak oturumdaki Windows PowerShell işlevleri. -
Script: Uzak oturumda erişilebilen betik dosyaları.
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.
Parametre özellikleri
| Tür: | CommandTypes |
| Default value: | None |
| Kabul edilen değerler: | Alias, Function, Filter, Cmdlet, ExternalScript, Application, Script, Workflow, Configuration, All |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Türü |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 ayrıntılı bilgi için Verbose parametresini kullanın veya Get-Verb yazı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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 Get-FormatData komutu tarafından döndürülen bir türün adı olmalıdır. Uzak oturumdaki tüm biçimlendirme verilerini almak için *yazın.
Komut CommandName veya FormatTypeName parametresi içermiyorsa, Import-PSSession uzak oturumdaki bir Get-FormatData komutu 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 3 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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, belirtilen modülü psmodulepath
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 için Gerekli
. -
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 ve gerekli bir sürümünü belirtir. Bu, diğer Sürüm anahtarlarıyla kullanılamaz.
-
Modülü parametresiyle aynı komutta FullyQualifiedModule parametresini belirtemezsiniz. İki parametre birbirini dışlar.
Parametre özellikleri
| Tür: | |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 bir ek bileşenden sağlayıcıları içeri aktaramaz.
Daha fazla bilgi için bkz. about_PSSnapins ve about_Modules.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSSnapin |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 sonra bir Get-Date cmdlet'ini içeri aktarırsanız, cmdlet oturumda Get-RemoteDateolarak bilinir ve özgün Get-Date cmdlet'iyle karıştırılmaz.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Session
Cmdlet'lerin içeri aktarıldığı PSSession belirtir.
New-PSSession veya Get-PSSession komutu gibi bir oturum nesnesi veya oturum nesnesi alan bir komut içeren bir değişken girin. Yalnızca bir oturum belirtebilirsiniz. Bu parametre gereklidir.
Parametre özellikleri
| Tür: | PSSession |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
PSModuleInfo
Bu cmdlet, New-Module ve Get-Module cmdlet'lerinin döndürdüğü 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 Export-PSSession cmdlet'ini 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-PSSessiondeğ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 Ön Ek 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 ilerleme durumunu görüntülemek içinWrite-Progresscmdlet'ini kullanır. Komut çalışırken ilerleme çubuğunu görebilirsiniz. - İçeri aktarılacak komutları bulmak için
Import-PSSessionInvoke-Commandcmdlet'ini kullanarak PSSession'da birGet-Commandkomutu çalıştırır. Komutların biçimlendirme verilerini almak içinGet-FormatDatacmdlet'ini kullanır. birImport-PSSessionkomutu çalıştırdığınızda bu cmdlet'lerden hata iletileri görebilirsiniz. Ayrıca,Import-PSSessionGet-Command,Get-FormatData,Select-ObjectveGet-Helpcmdlet'lerini içermeyen bir PSSession'dan komutları içeri aktaramaz. - İç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
Import-PSSessioniçin kullanılamaz. Bir profilden komutları içeri aktarmak içinInvoke-Commandkomutunu kullanarak komutları içeri aktarmadan önce PSSession'da profili el ile çalıştırın. -
Import-PSSessiontarafından oluşturulan geçici modül, 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. -
Import-PSSessionkullanmak için,Import-PSSessionoluşturulan geçici modül bu ilkeler tarafından yasaklanan imzalanmamış betik dosyaları içerdiğinden geçerli oturumdaki yürütme ilkesi Kısıtlanmış veya Tümü İmzalı olamaz. Yerel bilgisayarın yürütme ilkesini değiştirmedenImport-PSSessionkullanmak için, tek bir işlem için daha az kısıtlayıcı bir yürütme ilkesi ayarlamak üzereSet-ExecutionPolicyparametresini kullanın. - Windows PowerShell 2.0'da, başka bir oturumdan içeri aktarılan komutlara yönelik yardım konuları, Öneki 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.
