Remove-PSSession
Bir veya daha fazla PowerShell oturumlarını (PSSessions) kapatır.
Sözdizimi
Remove-PSSession
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
[-Session] <PSSession[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
-ContainerId <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
-VMId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
-VMName <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
-InstanceId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
-Name <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSSession
[-ComputerName] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdlet, Remove-PSSession
geçerli oturumdaki PowerShell oturumlarını (PSSessions) kapatır. PSSessions içinde çalışan tüm komutları durdurur, PSSession'ı sona erdirir ve PSSession'un kullandığı kaynakları serbest bırakır. PSSession uzak bir bilgisayara bağlıysa, bu cmdlet yerel ve uzak bilgisayarlar arasındaki bağlantıyı da kapatır.
PSSession'ı kaldırmak için oturumun Adı, Bilgisayar Adı, Kimliği veya InstanceID değerini girin.
PSSession'ı bir değişkene kaydettiyseniz, oturum nesnesi değişkende kalır, ancak PSSession'un durumu Kapalı olur.
Örnekler
Örnek 1: Oturumları kimliklerine göre kaldırma
Remove-PSSession -Id 1, 2
Bu komut, ve 2
kimlikleri olan PSSessions'ı 1
kaldırır.
Örnek 2: Geçerli oturumdaki tüm oturumları kaldırma
Get-PSSession | Remove-PSSession
Remove-PSSession -Session (Get-PSSession)
$s = Get-PSSession
Remove-PSSession -Session $s
Bu komutlar geçerli oturumdaki tüm PSSessions'ı kaldırır. Üç komut biçimi farklı görünse de, aynı etkiye sahiptir.
Örnek 3: Oturumları ada göre kapatma
$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession
Bu komutlar, ile Serv
başlayan adlara sahip bilgisayarlara bağlı PSSessions'ı kapatır.
Örnek 4: Bağlantı noktasına bağlı oturumları kapatma
Get-PSSession | where {$_.port -eq 90} | Remove-PSSession
Bu komut, 90 numaralı bağlantı noktasına bağlı PSSessions'ı kapatır. PsSessions'ı ComputerName, Name, InstanceID ve ID dışındaki özelliklere göre tanımlamak için bu komut biçimini kullanabilirsiniz.
Örnek 5: Örnek kimliğine göre oturumu kapatma
Get-PSSession | Format-Table ComputerName, InstanceID -AutoSize
ComputerName InstanceId
------------ ----------------
Server01 875d231b-2788-4f36-9f67-2e50d63bb82a
localhost c065ffa0-02c4-406e-84a3-dacb0d677868
Server02 4699cdbc-61d5-4e0d-b916-84f82ebede1f
Server03 4e5a3245-4c63-43e4-88d0-a7798bfc2414
TX-TEST-01 fc4e9dfa-f246-452d-9fa3-1adbdd64ae85
Remove-PSSession -InstanceID fc4e9dfa-f246-452d-9fa3-1adbdd64ae85
Bu komutlar, bir PSSession'un örnek kimliğine veya RemoteRunspaceID'ye göre nasıl kapatılmaya yönelik olduğunu gösterir.
İlk komut, geçerli oturumdaki Get-PSSession
PSSessions'ı almak için cmdlet'ini kullanır.
PsSessions'ı cmdlet'ine göndermek için bir işlem hattı işleci (|
) kullanır ve bu da bir tablodaki ComputerName ve InstanceID özelliklerini biçimlendirir.Format-Table
AutoSize parametresi, sütunları görüntülenmek üzere sıkıştırır.
Sonuçta elde edilen ekrandan kapatılacak PSSession'ı tanımlayabilir ve bu PSSession'un InstanceID değerini kopyalayıp ikinci komuta yapıştırabilirsiniz.
İkinci komut, belirtilen örnek kimliğiyle Remove-PSSession
PSSession'ı kaldırmak için cmdlet'ini kullanır.
Örnek 6: Geçerli oturumdaki tüm oturumları silecek bir işlev oluşturma
Function EndPSS { Get-PSSession | Remove-PSSession }
Bu işlev geçerli oturumdaki tüm PSSession'ları kapatır. Bu işlevi PowerShell profilinize ekledikten sonra, tüm oturumları silmek için yazın EndPSS
.
Parametreler
-ComputerName
Bilgisayar adlarının bir dizisini belirtir. Bu cmdlet, belirtilen bilgisayarlara bağlı PSSessions'ı kapatır. Joker karakterlere izin verilir.
Bir veya daha fazla uzak bilgisayarın NetBIOS adını, IP adresini veya tam etki alanı adını yazın. Yerel bilgisayarı belirtmek için bilgisayar adını, localhost
veya bir nokta (.
) yazın.
Tür: | String[] |
Diğer adlar: | Cn |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | True |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Diğer adlar: | cf |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ContainerId
Kapsayıcıların kimlik dizisini belirtir. Bu cmdlet, belirtilen kapsayıcıların her biri için oturumları kaldırır. docker ps
Kapsayıcı kimliklerinin listesini almak için komutunu kullanın. Daha fazla bilgi için docker ps komutunun yardımına bakın.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Id
Oturumların kimlik dizisini belirtir. Bu cmdlet, belirtilen kimliklerle PSSessions'ı kapatır.
Virgülle ayırarak bir veya daha fazla kimlik yazın veya aralık işlecini (..
) kullanarak bir kimlik aralığı belirtin.
Id, geçerli oturumdaki PSSession değerini benzersiz olarak tanımlayan bir tamsayıdır. Anımsamak ve yazmak InstanceId değerinden daha kolaydır, ancak yalnızca geçerli oturumda benzersizdir. PSSession kimliğini bulmak için cmdlet'ini Get-PSSession
parametresiz çalıştırın.
Tür: | Int32[] |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-InstanceId
Örnek kimlikleri dizisini belirtir. Bu cmdlet, belirtilen örnek kimliklerine sahip PSSessions'ı kapatır.
Örnek kimliği, geçerli oturumda pssession öğesini benzersiz olarak tanımlayan bir GUID'dir. Tek bir bilgisayarda çalışan birden çok oturum varsa bile örnek kimliği benzersizdir.
Örnek kimliği, pssession temsil eden nesnesinin InstanceID özelliğinde depolanır. Geçerli oturumda PSSessions InstanceID değerini bulmak için yazınGet-PSSession | Format-Table Name, ComputerName, InstanceId
.
Tür: | Guid[] |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Name
Oturumların kolay adlarından oluşan bir dizi belirtir. Bu cmdlet, belirtilen kolay adlara sahip PSSessions'ı kapatır. Joker karakterlere izin verilir.
PSSession'un kolay adı benzersiz olmadığından, Ad parametresini kullandığınızda komutta WhatIf veya Confirm parametresini Remove-PSSession
de kullanmayı göz önünde bulundurun.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | True |
-Session
Kapatacak PSSessions oturum nesnelerini belirtir. PSSessions içeren bir değişken veya veya komutu gibi PSSessions oluşturan veya alan bir New-PSSession
Get-PSSession
komut girin. Ayrıca bir veya daha fazla oturum nesnesini öğesine de yöneltebilirsiniz Remove-PSSession
.
Tür: | PSSession[] |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-VMId
Sanal makinelerin kimlik dizisini belirtir. Bu cmdlet, belirtilen sanal makinelerin her biriyle etkileşimli bir oturum başlatır. Kullanabileceğiniz sanal makineleri görmek için aşağıdaki komutu kullanın:
Get-VM | Select-Object -Property Name, ID
Tür: | Guid[] |
Diğer adlar: | VMGuid |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-VMName
Sanal makinelerin ad dizisini belirtir. Bu cmdlet, belirtilen sanal makinelerin her biriyle etkileşimli bir oturum başlatır. Kullanabileceğiniz sanal makineleri görmek için cmdlet'ini Get-VM
kullanın.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Tür: | SwitchParameter |
Diğer adlar: | wi |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
Oturum nesnesini bu cmdlet'e yöneltebilirsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
Notlar
Windows PowerShell için aşağıdaki diğer adları Remove-PSSession
içerir:
rsn
Id parametresi zorunludur. Geçerli oturumdaki tüm PSSessions'ı silmek için yazın
Get-PSSession | Remove-PSSession
.PSSession, uzak bilgisayara kalıcı bir bağlantı kullanır. Veri paylaşan bir dizi komut çalıştırmak için bir PSSession oluşturun. Daha fazla bilgi için yazın
Get-Help about_PSSessions
.PSSessions geçerli oturuma özgü. Oturumu sonlandırdığınızda, bu oturumda oluşturduğunuz PSSessions zorla kapatılır.
İlişkili Bağlantılar
PowerShell