Remove-PSSession
Bir veya daha fazla PowerShell oturumlarını (PSSessions) kapatır.
Syntax
Id (Varsayılan)
Remove-PSSession
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Session
Remove-PSSession
[-Session] <PSSession[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ContainerId
Remove-PSSession
-ContainerId <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
VMId
Remove-PSSession
-VMId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
VMName
Remove-PSSession
-VMName <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InstanceId
Remove-PSSession
-InstanceId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Name
Remove-PSSession
-Name <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ComputerName
Remove-PSSession
[-ComputerName] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Remove-PSSession cmdlet'i geçerli oturumda PowerShell oturumlarını (PSSessions) kapatır.
PSSessionsiçinde çalışan tüm komutları durdurur, PSSessionsona erdirir ve PSSession 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.
bir PSSessionkaldırmak için, oturumun Adı, ComputerName, Idveya InstanceId girin.
PSSession bir değişkene kaydettiyseniz, oturum nesnesi değişkende kalır, ancak PSSession durumu Kapalı olur.
Örnekler
Örnek 1: Oturumları kimliklerine göre kaldırma
Remove-PSSession -Id 1, 2
Bu komut, kimlikleri ve 1olan 2 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, mevcut oturumdaki tüm PSSessions'yi kaldırır. Üç komut biçimi farklı görünse de, aynı etkiye sahiptir.
Örnek 3: Oturumları isimle kapatma
$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession
ile başlayan adlara sahip bilgisayarlara bağlı olan Serv'i kapatan bu komutlardı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ı olan PSSessions'i kapatır. ComputerName, Name, InstanceIdve Iddışındaki özelliklere göre PSSessions 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
PSSession'i örnek kimliğine veya RemoteRunspaceID'ye göre nasıl kapatabileceğiniz gösterilmektedir.
İlk komut, geçerli oturumda Get-PSSession almak için cmdlet'ini kullanır.
|
cmdlet'ine göndermek için bir işlem hattı işleci (Format-Table) kullanır ve bu cmdlet' ComputerName biçimlendirir ve bir tablodaki InstanceId özelliklerini.
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 PSSessionInstanceId kopyalayıp ikinci komuta yapıştırabilirsiniz.
İkinci komut, belirtilen örnek kimliğine sahip Remove-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 oturumda her PSSession’i kapatır. Bu işlevi PowerShell profilinize ekledikten sonra, tüm oturumları silmek için EndPSSyazın.
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ı, localhostveya bir nokta (.) yazın.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
| Diğer adlar: | Cn |
Parametre kümeleri
ComputerName
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
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 |
-ContainerId
Kapsayıcıların kimlik numaraları dizisini belirtir. Bu cmdlet, belirtilen kapsayıcıların her biri için oturumları kaldırır. Kapsayıcı kimliklerinin listesini almak için docker ps komutunu kullanın. Daha fazla bilgi için docker ps komutla ilgili yardıma bakın.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ContainerId
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Id
Oturum kimliklerinden oluşan bir diziyi 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.
Kimlik, geçerli oturumdaki PSSession benzersiz olarak tanımlayan bir tamsayıdır. Hatırlaması ve yazması, InstanceIdkoduna göre daha kolaydır, ancak sadece geçerli oturumda benzersizdir.
PSSessionkimliğini bulmak için Get-PSSession cmdlet'ini parametresiz çalıştırın.
Parametre özellikleri
| Tür: | Int32[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
Id
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-InstanceId
Örnek kimlikleri dizisini belirtir. Bu cmdlet, belirtilen örnek kimliklerine sahip olan PSSessions kapatır.
Geçerli oturumdaki bir PSSession'i benzersiz olarak tanımlayan örnek kimliği bir GUID'dir. Tek bir bilgisayarda çalışan birden çok oturum varsa bile örnek kimliği benzersizdir.
Örnek kimliği, PSSessiontemsil eden nesnesinin InstanceId özelliğinde depolanır. Geçerli oturumda PSSessionsInstanceId bulmak için Get-PSSession | Format-Table Name, ComputerName, InstanceIdyazın.
Parametre özellikleri
| Tür: | Guid[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
InstanceId
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Name
Oturumların tanıtıcı adlarından oluşan bir dizi belirtir. Bu cmdlet, belirtilen arkadaşça adlara sahip PS Oturumları kapatır. Joker karakterlere izin verilir.
Bir PSSession'ın arkadaşça ismi benzersiz olmayabileceğinden, Name parametresini kullandığınızda, komutunda ayrıca WhatIf veya Remove-PSSession parametresini de kullanmayı göz önünde bulundurun.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
Name
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Session
Kapatılacak PSSessions oturum nesnelerini belirtir.
PSSessions'i içerebilen bir değişken veya ya da New-PSSession komutu gibi Get-PSSession'ü oluşturabilen veya alabilen bir komut girin. Ayrıca, bir veya daha fazla oturum nesnesini Remove-PSSession'a yönlendirebilirsiniz.
Parametre özellikleri
| Tür: | |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
Session
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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
Parametre özellikleri
| Tür: | Guid[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | VMGuid |
Parametre kümeleri
VMId
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 Get-VM cmdlet'ini kullanın.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
VMName
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
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 |
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
PSSession
Oturum nesnesini bu cmdlet'e yöneltebilirsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
Notlar
PowerShell, Remove-PSSessioniçin aşağıdaki diğer adları içerir:
Tüm platformlar:
rsn
ID'si parametresi zorunludur. Geçerli oturumdaki tüm PSSessions silmek için
Get-PSSession | Remove-PSSessionyazın.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
Get-Help about_PSSessionsyazın.PSSessions belirli oturuma özgüdür. Oturumu sonlandırdığınızda, o oturumda oluşturduğunuz PSSessions zorla kapatılır.