Aracılığıyla paylaş


Remove-PSSession

Bir veya daha fazla PowerShell oturumlarını (PSSessions) kapatır.

Syntax

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 2kimlikleri 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 Servbaş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ı, localhostveya bir nokta (. ) yazın.

Type:String[]
Aliases:Cn
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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-PSSessionGet-PSSession komut girin. Ayrıca bir veya daha fazla oturum nesnesini öğesine de yöneltebilirsiniz Remove-PSSession.

Type:PSSession[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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

Type:Guid[]
Aliases:VMGuid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

PSSession

Oturum nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

PowerShell için aşağıdaki diğer adları Remove-PSSessioniçerir:

  • Tüm platformlar:

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