PSSession'a girin (Microsoft.PowerShell.Core)

PSSession'a girin

Modül:

Microsoft.PowerShell.Core

Uzak bilgisayarla etkileşimli bir oturum başlatır.

Sözdizimi

Enter-PSSession
     [-ComputerName] <String>
     [-EnableNetworkAccess]
     [[-Credential] <PSCredential>]
     [-ConfigurationName <String>]
     [-Port <Int32>]
     [-UseSSL]
     [-ApplicationName <String>]
     [-SessionOption <PSSessionOption>]
     [-Authentication <AuthenticationMechanism>]
     [-CertificateThumbprint <String>]
     [<CommonParameters>]

Enter-PSSession
     [-HostName] <String>
     [-Options <Hashtable>]
     [-Port <Int32>]
     [-UserName <String>]
     [-KeyFilePath <String>]
     [-Subsystem <String>]
     [-ConnectingTimeout <Int32>]
     [-SSHTransport]
     [<CommonParameters>]

Enter-PSSession
     [[-Session] <PSSession>]
     [<CommonParameters>]

Enter-PSSession
     [[-ConnectionUri] <Uri>]
     [-EnableNetworkAccess]
     [[-Credential] <PSCredential>]
     [-ConfigurationName <String>]
     [-AllowRedirection]
     [-SessionOption <PSSessionOption>]
     [-Authentication <AuthenticationMechanism>]
     [-CertificateThumbprint <String>]
     [<CommonParameters>]

Enter-PSSession
     [-InstanceId <Guid>]
     [<CommonParameters>]

Enter-PSSession
     [[-Id] <Int32>]
     [<CommonParameters>]

Enter-PSSession
     [-Name <String>]
     [<CommonParameters>]

Enter-PSSession
     [-VMId] <Guid>
     [-Credential] <PSCredential>
     [-ConfigurationName <String>]
     [<CommonParameters>]

Enter-PSSession
     [-VMName] <String>
     [-Credential] <PSCredential>
     [-ConfigurationName <String>]
     [<CommonParameters>]

Enter-PSSession
     [-ContainerId] <String>
     [-ConfigurationName <String>]
     [-RunAsAdministrator]
     [<CommonParameters>]

Tanım

Enter-PSSession cmdlet'i tek bir uzak bilgisayarla etkileşimli bir oturum başlatır. Oturum sırasında yazdığınız komutlar, sanki doğrudan uzak bilgisayara yazıyormuşsunuz gibi uzak bilgisayarda çalışır. Aynı anda yalnızca bir etkileşimli oturuma sahip olabilirsiniz.

Genellikle uzak bilgisayarın adını belirtmek için BilgisayarAdı parametresini kullanırsınız. Ancak etkileşimli oturum için New-PSSession cmdlet'ini kullanarak oluşturduğunuz bir oturumu da kullanabilirsiniz. Ancak bağlantıyı kesmek veya yeniden bağlanmak için Disconnect-PSSession, Connect-PSSession veya Receive-PSSession cmdlet'lerini kullanamazsınız etkileşimli bir oturum.

PowerShell 6.0'dan itibaren uzak bir bilgisayarla bağlantı kurmak için Secure Shell'i (SSH) kullanabilirsiniz. Yerel bilgisayarda SSH'ye sahip olmanız ve uzak bilgisayarın bir PowerShell SSH uç noktasıyla yapılandırılması gerekir. SSH tabanlı PowerShell uzaktan oturumunun avantajı, birden fazla platformda (Windows, Linux, macOS) çalışmasıdır. SSH tabanlı uzaktan iletişim için uzak bilgisayarı ve ilgili bağlantı bilgilerini belirtmek üzere Ana BilgisayarAdı parametre kümesini kullanırsınız. PowerShell SSH uzaktan iletişiminin nasıl kurulacağı hakkında daha fazla bilgi için bkz. SSH Üzerinden PowerShell Uzaktan İletişim.

Etkileşimli oturumu sonlandırmak ve uzak bilgisayarla bağlantıyı kesmek için Exit-PSSession cmdlet'ini kullanın veya exit yazın.

Örnekler

Örnek 1: Etkileşimli bir oturum başlatın

PS> Enter-PSSession
[localhost]: PS>

Bu komut, yerel bilgisayarda etkileşimli bir oturum başlatır. Komut istemi, komutları artık farklı bir oturumda çalıştırdığınızı gösterecek şekilde değişir.

Girdiğiniz komutlar yeni oturumda çalışır ve sonuçlar varsayılan oturuma metin olarak döndürülür.

Örnek 2: Etkileşimli bir oturumla çalışma

İlk komut, uzak bir bilgisayar olan Server01 ile etkileşimli bir oturum başlatmak için Enter-PSSession cmdlet'ini kullanır. Oturum başladığında, komut istemi bilgisayar adını içerecek şekilde değişir.

İkinci komut PowerShell işlemini alır ve çıktıyı Process.txt dosyasına yönlendirir. Komut uzak bilgisayara gönderilir ve dosya uzak bilgisayara kaydedilir.

Üçüncü komut, etkileşimli oturumu sonlandırmak ve bağlantıyı kapatmak için Çıkış anahtar sözcüğünü kullanır. Dördüncü komut, Process.txt dosyasının uzak bilgisayarda olduğunu doğrular. Yerel bilgisayardaki Get-ChildItem ("dir") komutu dosyayı bulamıyor.

PS C:\> Enter-PSSession -ComputerName Server01
[Server01]: PS C:\>
[Server01]: PS C:\> Get-Process PowerShell > C:\ps-test\Process.txt
[Server01]: PS C:\> exit
PS C:\>
PS C:\> dir C:\ps-test\Process.txt
Get-ChildItem : Cannot find path 'C:\ps-test\Process.txt' because it does not exist.
At line:1 char:4
+ dir <<<<  c:\ps-test\Process.txt

Bu komut, uzak bir bilgisayarla etkileşimli bir oturumda nasıl çalışılacağını gösterir.

Örnek 3: Oturum parametresini kullanın

PS> $s = New-PSSession -ComputerName Server01
PS> Enter-PSSession -Session $s
[Server01]: PS>

Bu komutlar, etkileşimli oturumu mevcut bir PowerShell oturumunda (PSSession) çalıştırmak için Enter-PSSession'un Session parametresini kullanır.

Örnek 4: Etkileşimli bir oturum başlatın ve Bağlantı Noktası ve Kimlik Bilgisi parametrelerini belirtin

PS> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS>

Bu komut, Server01 bilgisayarıyla etkileşimli bir oturum başlatır. Bağlantı noktasını belirtmek için Bağlantı Noktası parametresini ve uzak bilgisayara bağlanma iznine sahip bir kullanıcının hesabını belirtmek için Kimlik Bilgisi parametresini kullanır.

Örnek 5: Etkileşimli bir oturumu durdurma

PS> Enter-PSSession -ComputerName Server01
[Server01]: PS> Exit-PSSession
PS>

Bu örnek etkileşimli bir oturumun nasıl başlatılacağını ve durdurulacağını gösterir. İlk komut, Server01 bilgisayarıyla etkileşimli bir oturum başlatmak için Enter-PSSession cmdlet'ini kullanır.

İkinci komut, oturumu sonlandırmak için Exit-PSSession cmdlet'ini kullanır. Etkileşimli oturumu sonlandırmak için Çıkış anahtar sözcüğünü de kullanabilirsiniz. Exit-PSSession ve Exit aynı etkiye sahiptir.

Örnek 6: SSH kullanarak etkileşimli bir oturum başlatın

PS> Enter-PSSession -HostName UserA@LinuxServer01

Bu örnek, Secure Shell (SSH) kullanılarak etkileşimli bir oturumun nasıl başlatılacağını gösterir. SSH uzak bilgisayarda parola kullanacak şekilde yapılandırılmışsa, bir parola girmeniz istenir. Aksi takdirde anahtar tabanlı kullanıcı kimlik doğrulamasını kullanmanız gerekir.

Örnek 7: Bağlantı noktası ve kullanıcı kimlik doğrulama anahtarıyla SSH kullanarak etkileşimli bir oturum başlatın

PS> Enter-PSSession -HostName UserA@LinuxServer02:22 -KeyFilePath c:\sshkeys\userAKey_rsa

Bu örnek, SSH kullanarak etkileşimli bir oturumun nasıl başlatılacağını gösterir. Kullanıcı adı ve SSH bağlantı noktası numarası, HostName parametresinin değerinin bir parçası olarak belirtilir. KeyFilePath parametresi, uzak bilgisayardaki kullanıcının kimliğini doğrulamak için kullanılan RSA anahtarının konumunu belirtir.

Örnek 8: SSH seçeneklerini kullanarak etkileşimli bir oturum başlatın

$options = @{
    Port=22
    User = 'UserA'
    Host = 'LinuxServer02'
}
Enter-PSSession -KeyFilePath c:\sshkeys\userAKey_rsa -Options $options

Bu örnek, SSH kullanarak etkileşimli bir oturumun nasıl başlatılacağını gösterir. Seçenekler parametresi, uzak sistemle bağlantı kurmak için temel ssh komutuna seçenek olarak iletilen değerlerin karma tablosunu alır.

Parametreler

-AllowRedirection

Bu bağlantının alternatif bir Tekdüzen Kaynak Tanımlayıcısına (URI) yeniden yönlendirilmesine izin verir. Varsayılan olarak yeniden yönlendirmeye izin verilmez.

ConnectionURI parametresini kullandığınızda uzak hedef, farklı bir URI'ye yeniden yönlendirme talimatı döndürebilir. Varsayılan olarak PowerShell bağlantıları yönlendirmez ancak bağlantıyı yeniden yönlendirmesine izin vermek için bu parametreyi kullanabilirsiniz.

MaximumConnectionRedirectionCount oturum seçeneği değerini değiştirerek bağlantının yeniden yönlendirilme sayısını da sınırlayabilirsiniz. New-PSSessionOption cmdlet'inin MaximumRedirection parametresini kullanın veya $PSSessionOption tercih değişkeninin MaximumConnectionRedirectionCount özelliğini ayarlayın. Varsayılan değer 5'tir.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ApplicationName

Bağlantı URI'sinin uygulama adı bölümünü belirtir. Komutta ConnectionURI parametresini kullanmadığınızda uygulama adını belirtmek için bu parametreyi kullanın.

Varsayılan değer, yerel bilgisayardaki $PSSessionApplicationName tercih değişkeninin değeridir. Bu tercih değişkeni tanımlanmamışsa varsayılan değer WSMAN'dir. Bu değer çoğu kullanım için uygundur. Daha fazla bilgi için bkz. about_Preference_Variables.

WinRM hizmeti, bağlantı isteğine hizmet verecek bir dinleyici seçmek için uygulama adını kullanır. Bu parametrenin değeri, uzak bilgisayardaki dinleyicinin URLPrefix özelliğinin değeriyle eşleşmelidir.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Authentication

Kullanıcının kimlik bilgilerini doğrulamak için kullanılan mekanizmayı belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

• Varsayılan
• Temel
• Kredisp
• Özet
• Kerberos
• Pazarlık etmek
• Örtülü Kimlik Bilgileriyle Anlaşma Yapın

Varsayılan değer Varsayılan'dır.

CredSSP kimlik doğrulaması yalnızca Windows Vista, Windows Server 2008 ve Windows işletim sisteminin sonraki sürümlerinde kullanılabilir.

Bu parametrenin değerleri hakkında daha fazla bilgi için bkz. AuthenticationMechanism Enum.

Tip :

AuthenticationMechanism

Kabul edilen değerler:

Varsayılan, Temel, Anlaşma, Anlaşma Yap,ImplicitCredential, Credssp, Digest, Kerberos

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-CertificateThumbprint

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikanın sertifika parmak izini girin.

Sertifikalar, istemci sertifikası tabanlı kimlik doğrulamada kullanılır. Yalnızca yerel kullanıcı hesaplarıyla eşlenebilirler; etki alanı hesaplarıyla çalışmazlar.

Sertifika almak için PowerShell Cert: sürücüsündeki Get-Item veya Get-ChildItem komutunu kullanın.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ComputerName

Bir bilgisayar adını belirtir. Bu cmdlet, belirtilen uzak bilgisayarla etkileşimli bir oturum başlatır. Yalnızca bir bilgisayar adı girin. Varsayılan yerel bilgisayardır.

Bilgisayarın NetBIOS adını, IP adresini veya tam etki alanı adını yazın. Ayrıca bir bilgisayar adını Enter-PSSession'a yönlendirebilirsiniz.

BilgisayarAdı parametresinin değerinde bir IP adresi kullanmak için komutun Kimlik Bilgisi parametresini içermesi gerekir. Ayrıca bilgisayarın HTTPS aktarımı için yapılandırılması veya uzak bilgisayarın IP adresinin yerel bilgisayardaki WinRM TrustedHosts listesine dahil edilmesi gerekir. TrustedHosts listesine bilgisayar adı ekleme talimatları için about_Remote_Troubleshooting bölümündeki "Güvenilen Ana Bilgisayar Listesine Bilgisayar Nasıl Eklenir" konusuna bakın.

Tip :

String

Takma adlar:

Cn

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-ConfigurationName

Etkileşimli oturum için kullanılan oturum yapılandırmasını belirtir.

Bir oturum yapılandırması için bir yapılandırma adı veya tam kaynak URI'sini girin. Yalnızca yapılandırma adını belirtirseniz aşağıdaki şema URI'si eklenir: http://schemas.microsoft.com/powershell.

SSH ile kullanıldığında bu, sshd_config'te tanımlandığı gibi hedefte kullanılacak alt sistemi belirtir. SSH için varsayılan değer powershell alt sistemidir.

Bir oturumun oturum yapılandırması uzak bilgisayarda bulunur. Belirtilen oturum yapılandırması uzak bilgisayarda mevcut değilse komut başarısız olur.

Varsayılan değer, yerel bilgisayardaki $PSSessionConfigurationName tercih değişkeninin değeridir. Bu tercih değişkeni ayarlanmamışsa varsayılan değer Microsoft.PowerShell'dir. Daha fazla bilgi için bkz. about_Preference_Variables.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-ConnectingTimeout

İlk SSH bağlantısının tamamlanması için izin verilen süreyi milisaniye cinsinden belirtir. Bağlantı belirtilen süre içinde tamamlanmazsa bir hata döndürülür.

Bu parametre PowerShell 7,2'de tanıtıldı

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

sınırsız

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ConnectionUri

Oturumun bağlantı uç noktasını tanımlayan bir URI belirtir. URI tam olarak nitelenmiş olmalıdır. Bu dizenin formatı aşağıdaki gibidir:

<Transport>://<ComputerName>:<Port>/<ApplicationName>

Varsayılan değer aşağıdaki gibidir:

http://localhost:5985/WSMAN

Bir ConnectionURI belirtmezseniz UseSSL, BilgisayarAdı, Bağlantı Noktası ve ConnectionURI değerlerini belirtmek için >ApplicationName parametrelerini kullanın.

URI'nin Aktarım segmenti için geçerli değerler HTTP ve HTTPS'dir. Aktarım segmenti ile bir bağlantı URI'si belirtirseniz ancak bir bağlantı noktası belirtmezseniz, oturum standart bağlantı noktaları kullanılarak oluşturulur: HTTP için 80 ve HTTPS için 443. PowerShell uzaktan iletişimi için varsayılan bağlantı noktalarını kullanmak üzere HTTP için bağlantı noktası 5985'i veya HTTPS için 5986 bağlantı noktasını belirtin.

Hedef bilgisayar bağlantıyı farklı bir URI'ye yönlendirirse PowerShell, komutta AllowRedirection parametresini kullanmadığınız sürece yeniden yönlendirmeyi engeller.

Tip :

Uri

Takma adlar:

URI, CU

Konum:

1

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-ContainerId

Bir kapsayıcının kimliğini belirtir.

Tip :

String

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabını belirtir. Varsayılan geçerli kullanıcıdır.

User01 veya Domain01\User01 gibi bir kullanıcı adı yazın veya Get-Credential tarafından oluşturulan bir PSCredential nesnesi girin kod > cmdlet'i seçin. Bir kullanıcı adı yazarsanız parolayı girmeniz istenir.

Kimlik bilgileri bir PSCredential nesnesinde, parola ise SecureString olarak depolanır.

Tip :

PSCredential'ı

Konum:

1

Varsayılan değer:

Geçerli kullanıcı

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-EnableNetworkAccess

Bu cmdlet'in geridöngü oturumlarına etkileşimli bir güvenlik belirteci eklediğini belirtir. Etkileşimli belirteç, geridöngü oturumunda diğer bilgisayarlardan veri alan komutları çalıştırmanıza olanak tanır. Örneğin, XML dosyalarını uzak bilgisayardan yerel bilgisayara kopyalayan bir komutu oturumda çalıştırabilirsiniz.

Geridöngü oturumu, aynı bilgisayarda başlayıp biten bir PSSession'dur. Geridöngü oturumu oluşturmak için BilgisayarAdı parametresini atlayın veya değerini olarak ayarlayın. (nokta), localhost veya yerel bilgisayarın adı.

Varsayılan olarak geridöngü oturumları, uzak bilgisayarlarda kimlik doğrulaması yapmak için yeterli izni sağlayamayabilecek bir ağ belirteci kullanılarak oluşturulur.

EnableNetworkAccess parametresi yalnızca geri döngü oturumlarında etkilidir. Uzak bilgisayarda bir oturum oluştururken EnableNetworkAccess'i kullanırsanız komut başarılı olur ancak parametre dikkate alınmaz.

Ayrıca, oturum kimlik bilgilerini diğer bilgisayarlara devreden Kimlik Doğrulama parametresinin CredSSP değerini kullanarak bir geridöngü oturumunda uzaktan erişime izin verebilirsiniz.

Bu parametre Windows PowerShell 3,0'da kullanılmaya başlandı.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-HostName

Secure Shell (SSH) tabanlı bağlantı için bilgisayar adını belirtir. Bu, uzak bilgisayarla bağlantının Windows WinRM yerine SSH kullanılarak yapılması dışında BilgisayarAdı parametresine benzer. Bu parametre, kullanıcı@anasistem adı:bağlantı noktası formunu kullanarak ana bilgisayar adı parametre değerinin bir parçası olarak kullanıcı adının ve/veya bağlantı noktasının belirtilmesini destekler. Ana bilgisayar adının bir parçası olarak belirtilen kullanıcı adı ve/veya bağlantı noktası, belirtilmişse -KullanıcıAdı ve -Port parametrelerine göre önceliklidir. Bu, bazılarının belirli kullanıcı adlarına ve/veya bağlantı noktalarına sahip olduğu, diğerlerinin ise -KullanıcıAdı ve -Port parametreler.

Bu parametre PowerShell 6,0'da tanıtıldı.

Tip :

String

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Id

Mevcut bir oturumun kimliğini belirtir. Enter-PSSession, etkileşimli oturum için belirtilen oturumu kullanır.

Bir oturumun kimliğini bulmak için Get-PSSession cmdlet'ini kullanın.

Tip :

Int32

Konum:

0

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-InstanceId

Mevcut bir oturumun örnek kimliğini belirtir. Enter-PSSession, etkileşimli oturum için belirtilen oturumu kullanır.

Örnek kimliği bir GUID'dir. Bir oturumun örnek kimliğini bulmak için Get-PSSession cmdlet'ini kullanın. Mevcut bir oturumu belirtmek için Oturum, Ad veya Kimlik parametrelerini de kullanabilirsiniz. Veya geçici bir oturum başlatmak için BilgisayarAdı parametresini kullanabilirsiniz.

Tip :

Rehber

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-KeyFilePath

Uzak bilgisayardaki bir kullanıcının kimliğini doğrulamak için Secure Shell (SSH) tarafından kullanılan anahtar dosya yolunu belirtir.

SSH, temel şifre kimlik doğrulamasına alternatif olarak kullanıcı kimlik doğrulamasının özel/genel anahtarlar aracılığıyla gerçekleştirilmesine olanak tanır. Uzak bilgisayar anahtar kimlik doğrulaması için yapılandırılmışsa bu parametre, kullanıcıyı tanımlayan anahtarı sağlamak için kullanılabilir.

Bu parametre PowerShell 6,0'da tanıtıldı.

Tip :

String

Takma adlar:

IdentityFilePath

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Name

Mevcut bir oturumun kolay adını belirtir. Enter-PSSession, etkileşimli oturum için belirtilen oturumu kullanır.

Belirttiğiniz ad birden fazla oturumla eşleşiyorsa komut başarısız olur. Mevcut bir oturumu belirtmek için Oturum, InstanceID veya ID parametrelerini de kullanabilirsiniz. Veya geçici bir oturum başlatmak için BilgisayarAdı parametresini kullanabilirsiniz.

Bir oturum için kolay bir ad oluşturmak üzere New-PSSession cmdlet'inin Ad parametresini kullanın.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Options

Uzak SSH tabanlı bir oturuma bağlanırken kullanılan SSH seçeneklerinin karma tablosunu belirtir. Olası seçenekler, ssh komutunun Unix tabanlı sürümü tarafından desteklenen herhangi bir değerdir.

Parametreler tarafından açıkça iletilen tüm değerler, Seçenekler karma tablosunda iletilen değerlere göre önceliklidir. Örneğin, Bağlantı Noktası parametresinin kullanılması, Seçenekler karma tablosunda iletilen tüm Bağlantı Noktası anahtar/değer çiftini geçersiz kılar.

Tip :

Karma tablo

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Port

Bu komut için kullanılan uzak bilgisayardaki ağ bağlantı noktasını belirtir.

PowerShell 6.0'da bu parametre, Secure Shell (SSH) bağlantılarını destekleyen Ana BilgisayarAdı parametre kümesine dahil edilmiştir.

WinRM (BilgisayarAdı parametre kümesi)

Uzak bir bilgisayara bağlanmak için uzak bilgisayarın, bağlantının kullandığı bağlantı noktasını dinlemesi gerekir. Varsayılan bağlantı noktaları, HTTP için WinRM bağlantı noktası olan 5985 ve HTTPS için WinRM bağlantı noktası olan 5986'dır.

Alternatif bir bağlantı noktası kullanmadan önce uzak bilgisayardaki WinRM dinleyicisini bu bağlantı noktasını dinleyecek şekilde yapılandırmanız gerekir. Dinleyiciyi yapılandırmak için aşağıdaki komutları kullanın:

winrm delete winrm/config/listener?Address=*+Transport=HTTP

winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}

Zorunlu olmadıkça Bağlantı Noktası parametresini kullanmayın. Komuttaki bağlantı noktası ayarı, komutun çalıştığı tüm bilgisayarlar veya oturumlar için geçerlidir. Alternatif bağlantı noktası ayarı, komutun tüm bilgisayarlarda çalışmasını engelleyebilir.

SSH (Ana BilgisayarAdı parametre kümesi)

Uzak bir bilgisayara bağlanmak için uzak bilgisayarın SSH hizmeti (SSHD) ile yapılandırılması ve bağlantının kullandığı bağlantı noktasını dinlemesi gerekir. SSH için varsayılan bağlantı noktası 22'dir.

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-RunAsAdministrator

PSSession'un yönetici olarak çalıştığını belirtir.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Session

Etkileşimli oturum için kullanılacak bir PowerShell oturumunu (PSSession) belirtir. Bu parametre bir oturum nesnesi alır. Bir PSSession belirtmek için Ad, InstanceID veya ID parametrelerini de kullanabilirsiniz.

New-PSSession veya Get-PSSession komutu gibi, bir oturum nesnesi veya oturum nesnesi oluşturan veya alan bir komut içeren bir değişken girin. Ayrıca bir oturum nesnesini Enter-PSSession'a yönlendirebilirsiniz. Bu parametreyi kullanarak yalnızca bir PSSession gönderebilirsiniz. Birden fazla PSSession içeren bir değişken girerseniz komut başarısız olur.

Exit-PSSession veya EXIT anahtar kelimesini kullandığınızda etkileşimli oturum sona erer ancak oluşturduğunuz PSSession açık ve kullanıma hazır kalır.

Tip :

PSSession

Konum:

0

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-SessionOption

Oturum için gelişmiş seçenekleri ayarlar. New-PSSessionOption cmdlet'ini kullanarak oluşturduğunuz gibi bir SessionOption nesnesi veya anahtarların oturum seçeneği adları ve değerlerin oturum olduğu bir karma tablo girin seçenek değerleri.

Seçeneklerin varsayılan değerleri, eğer ayarlanmışsa, $PSSessionOption tercih değişkeninin değerine göre belirlenir. Aksi halde, varsayılan değerler oturum yapılandırmasında ayarlanan seçenekler tarafından belirlenir.

Oturum seçeneği değerleri, $PSSessionOption tercih değişkeninde ve oturum yapılandırmasında ayarlanan oturumlar için varsayılan değerlerden önceliklidir. Ancak oturum yapılandırmasında belirlenen maksimum değerler, kotalar veya sınırlar üzerinde öncelik taşımazlar.

Varsayılan değerler de dahil olmak üzere oturum seçeneklerinin açıklaması için bkz. New-PSSessionOption. $PSSessionOption tercih değişkeni hakkında bilgi için bkz. about_Preference_Variables. Oturum yapılandırmaları hakkında daha fazla bilgi için bkz. about_Session_Configurations.

Tip :

PSSessionOption

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-SSHTransport

Uzak bağlantının Secure Shell (SSH) kullanılarak kurulduğunu belirtir.

Varsayılan olarak PowerShell, uzak bir bilgisayara bağlanmak için Windows WinRM'yi kullanır. Bu anahtar, PowerShell'i SSH tabanlı bir uzak bağlantı kurmak için HostName parametre kümesini kullanmaya zorlar.

Bu parametre PowerShell 6,0'da tanıtıldı.

Tip :

SwitchParameter

Kabul edilen değerler:

doğru

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Subsystem

Yeni PSSession için kullanılan SSH alt sistemini belirtir.

Bu, sshd_config'de tanımlandığı gibi hedefte kullanılacak alt sistemi belirtir. Alt sistem, önceden tanımlanmış parametrelerle belirli bir PowerShell sürümünü başlatır. Belirtilen alt sistem uzak bilgisayarda mevcut değilse komut başarısız olur.

Bu parametre kullanılmazsa varsayılan powershell alt sistemidir.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

Powershell

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-UserName

Uzak bilgisayarda oturum oluşturmak için kullanılan hesabın kullanıcı adını belirtir. Kullanıcı kimlik doğrulama yöntemi, uzak bilgisayarda Secure Shell'in (SSH) nasıl yapılandırıldığına bağlıdır.

SSH, temel parola kimlik doğrulaması için yapılandırılmışsa, sizden kullanıcı parolası istenir.

SSH, anahtar tabanlı kullanıcı kimlik doğrulaması için yapılandırılmışsa, sizden parola istenmez. SSH anahtar dosyasına giden yolu sağlamalısınız. Kullanıcı anahtarı dosyası SSH tarafından bilinen bir konumda bulunuyorsa KeyFilePath parametresine gerek yoktur. Kullanıcı kimlik doğrulaması, kullanıcı adına göre otomatik olarak gerçekleşir. Daha fazla bilgi için anahtar tabanlı kullanıcı kimlik doğrulamasıyla ilgili SSH belgelerine bakın.

KullanıcıAdı parametresi belirtilmemişse, oturum açmış olan mevcut kullanıcı adı kullanılır.

Bu parametre PowerShell 6,0'da tanıtıldı.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-UseSSL

Bu cmdlet'in uzak bilgisayarla bağlantı kurmak için Güvenli Yuva Katmanı (SSL) protokolünü kullandığını belirtir. Varsayılan olarak SSL kullanılmaz.

WS-Management, ağ üzerinden iletilen tüm PowerShell içeriğini şifreler. UseSSL parametresi, verileri HTTP bağlantısı yerine HTTPS bağlantısı üzerinden gönderen ek bir korumadır.

Bu parametreyi kullanırsanız ancak komut için kullanılan bağlantı noktasında SSL yoksa komut başarısız olur.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-VMId

Bir sanal makinenin kimliğini belirtir.

Tip :

Rehber

Takma adlar:

VMGuid

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-VMName

Bir sanal makinenin adını belirtir.

Tip :

String

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

Girişler

Dize

Bir bilgisayar adını bu cmdlet'e dize olarak aktarabilirsiniz.

PSSession

Bir oturum nesnesini bu cmdlet'e aktarabilirsiniz.

Çıkışlar

Yok

Bu cmdlet hiçbir çıktı döndürmez.

Notlar

PowerShell, Enter-PSSession için aşağıdaki takma adları içerir:

• Tüm platformlar:

  etsn

Uzak bir bilgisayara bağlanmak için uzak bilgisayardaki Yöneticiler grubunun üyesi olmanız gerekir. Yerel bilgisayarda etkileşimli bir oturum başlatmak için PowerShell'i Yönetici olarak çalıştır seçeneğiyle başlatmanız gerekir.

Enter-PSSession'ı kullandığınızda, etkileşimli oturum için uzak bilgisayardaki kullanıcı profiliniz kullanılır. PowerShell modülleri ekleme ve komut istemini değiştirme komutları da dahil olmak üzere uzak kullanıcı profilindeki komutlar, uzak istem görüntülenmeden önce çalışır.

Enter-PSSession, etkileşimli oturum için yerel bilgisayardaki kullanıcı arayüzü kültürü ayarını kullanır. Yerel kullanıcı arayüzü kültürünü bulmak için $UICulture otomatik değişkenini kullanın.

Enter-PSSession, Get-Command, Out-Default ve Exit-PSSession cmdlet'lerini gerektirir. Bu cmdlet'ler uzak bilgisayardaki oturum yapılandırmasına dahil değilse Enter-PSSession komutları başarısız olur.

Komutları uzak bilgisayara göndermeden önce ayrıştırıp yorumlayan Invoke-Command'dan farklı olarak Enter-PSSession, komutları yorumlanmadan doğrudan uzak bilgisayara gönderir.

Girmek istediğiniz oturum bir komutu işlemekle meşgulse PowerShell'in Enter-PSSession komutuna yanıt vermesinden önce bir gecikme olabilir. Oturum uygun olur olmaz bağlanırsınız. PSSession'a Girin komutunu iptal etmek için CTRL+C tuşlarına basın.

Ana BilgisayarAdı parametre kümesi PowerShell 6.0'dan itibaren dahil edilmiştir. Secure Shell'e (SSH) dayalı PowerShell uzaktan iletişimi sağlamak için eklendi. Hem SSH hem de PowerShell birden fazla platformda (Windows, Linux, macOS) desteklenir ve PowerShell uzaktan iletişimi, PowerShell ve SSH'nin yüklenip yapılandırıldığı bu platformlar üzerinde çalışır. Bu, WinRM'yi temel alan önceki Windows'a özel uzaktan iletişimden farklıdır ve WinRM'ye özgü özelliklerin ve sınırlamaların çoğu geçerli değildir. Örneğin, WinRM tabanlı kotalar, oturum seçenekleri, özel uç nokta yapılandırması ve bağlantıyı kesme/yeniden bağlanma özellikleri şu anda desteklenmemektedir. PowerShell SSH uzaktan iletişiminin nasıl kurulacağı hakkında daha fazla bilgi için bkz. SSH Üzerinden PowerShell Uzaktan İletişim.

PowerShell 7.1'den önce, SSH üzerinden uzaktan iletişim, ikinci atlama uzak oturumlarını desteklemiyordu. Bu yetenek WinRM kullanan oturumlarla sınırlıydı. PowerShell 7.1, Enter-PSSession ve Enter-PSHostProcess'in herhangi bir etkileşimli uzak oturumdan çalışmasına olanak tanır.

ssh yürütülebilir dosyası, yapılandırma verilerini aşağıdaki kaynaklardan aşağıdaki sırayla alır:

1. komut satırı seçenekleri
2. kullanıcının yapılandırma dosyası (~/.ssh/config)
3. sistem çapında yapılandırma dosyası (/etc/ssh/ssh_config)

Aşağıdaki cmdlet parametreleri ssh parametrelerine ve seçeneklerine eşlenir:

Parametreler tarafından açıkça iletilen tüm değerler, Seçenekler karma tablosunda iletilen değerlere göre önceliklidir. ssh_config dosyaları hakkında daha fazla bilgi için bkz. ssh_config(5).