Kaldırma-PSSession (Microsoft.PowerShell.Core)

PSSession'ı Kaldır

Modül:: Microsoft.PowerShell.Core

Bir veya daha fazla PowerShell oturumunu (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>]

Tanım

Remove-PSSession cmdlet'i geçerli oturumdaki PowerShell oturumlarını (PSSessions) kapatır. PSSessions'ta çalışan tüm komutları durdurur, PSSession'u sonlandırır 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.

Bir PSSession'u kaldırmak için Ad, BilgisayarAdı, Kimlik veya Örnek Kimliği'ni girin oturumun.

PSSession'u bir değişkene kaydettiyseniz, oturum nesnesi değişkende kalır ancak PSSession'un durumu Kapalı olur.

Örnekler

Örnek 1: Oturumları kimliğe göre kaldırma

Remove-PSSession -Id 1, 2

Bu komut, 1 ve 2 kimliklerine sahip PSSessions'ı kaldırır.

Örnek 2: Geçerli oturumdaki tüm oturumları kaldırın

Get-PSSession | Remove-PSSession
Remove-PSSession -Session (Get-PSSession)
$s = Get-PSSession
Remove-PSSession -Session $s

Bu komutlar geçerli oturumdaki tüm PSSessions'ları kaldırır. Üç komut formatı farklı görünse de aynı etkiye sahiptirler.

Örnek 3: Oturumları ada göre kapatma

$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession

Bu komutlar, adları Serv ile başlayan bilgisayarlara bağlı PSSessions'ı kapatır.

Örnek 4: Bir bağlantı noktasına bağlı oturumları kapatın

Get-PSSession | where {$_.port -eq 90} | Remove-PSSession

Bu komut, 90 numaralı bağlantı noktasına bağlı PSSessions'ı kapatır. Bu komut biçimini, PSSessions'ı ComputerName, dışındaki özelliklere göre tanımlamak için kullanabilirsiniz. >Ad, Örnek Kimliği ve Kimlik.

Örnek 5: Bir oturumu örnek kimliğine göre 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, örnek kimliğine veya RemoteRunspaceID'ye göre bir PSSession'un nasıl kapatılacağını gösterir.

İlk komut, geçerli oturumdaki PSSessions'ı almak için Get-PSSession cmdlet'ini kullanır. PSSessions'ı ComputerNameFormat-Table cmdlet'ine göndermek için bir ardışık düzen operatörü (|) kullanır. > ve InstanceID özelliklerini bir tabloda kullanabilirsiniz. Otomatik Boyutlandırma parametresi, sütunları görüntülenmek üzere sıkıştırır.

Ortaya çıkan ekrandan kapatılacak PSSession'u tanımlayabilir ve bu PSSession'un InstanceID'sini kopyalayıp ikinci komuta yapıştırabilirsiniz.

İkinci komut, belirtilen örnek kimliğine sahip PSSession'u kaldırmak için Remove-PSSession cmdlet'ini kullanır.

Örnek 6: Geçerli oturumdaki tüm oturumları silen bir işlev oluşturun

Function EndPSS { Get-PSSession | Remove-PSSession }

Bu işlev, geçerli oturumdaki her PSSession'u kapatır. Bu işlevi PowerShell profilinize ekledikten sonra tüm oturumları silmek için EndPSS yazı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ı, localhost veya bir noktayı (.) yazı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:: True

-Confirm

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

Tip :: SwitchParameter
Takma adlar:: cf
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: 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. Kapsayıcı kimliklerinin bir listesini almak için docker ps komutunu kullanın. Daha fazla bilgi için docker ps komutunun yardımına bakın.

Tip :: String[]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-Id

Oturum kimliklerinin bir dizisini belirtir. Bu cmdlet, PSSessions'ı belirtilen kimliklerle kapatır. Bir veya daha fazla kimliği virgülle ayırarak yazın veya bir kimlik aralığı belirtmek için aralık operatörünü (..) kullanın.

Kimlik, geçerli oturumdaki PSSession'u benzersiz şekilde tanımlayan bir tamsayıdır. Hatırlanması ve yazılması InstanceId'e göre daha kolaydır ancak yalnızca geçerli oturumda benzersizdir. Bir PSSession'un kimliğini bulmak için Get-PSSession cmdlet'ini parametreler olmadan çalıştırın.

Tip :: Int32[]
Konum:: 0
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-InstanceId

Örnek kimliklerinin bir dizisini belirtir. Bu cmdlet, belirtilen örnek kimliklerine sahip PSSessions'ı kapatır.

Örnek kimliği, geçerli oturumdaki PSSession'u benzersiz şekilde tanımlayan bir GUID'dir. Tek bir bilgisayarda çalışan birden fazla oturumunuz olsa bile örnek kimliği benzersizdir.

Örnek kimliği, bir PSSession'u temsil eden nesnenin InstanceID özelliğinde depolanır. Geçerli oturumdaki PSSessions'ın InstanceID'sini bulmak için Get-PSSession | Format-Tablo Adı, BilgisayarAdı, Örnek Kimliği.

Tip :: Rehber[]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-Name

Oturumların kolay adlarının bir dizisini belirtir. Bu cmdlet, belirtilen kolay adlara sahip PSSessions'ı kapatır. Joker karakterlere izin verilir.

Bir PSSession'un kolay adı benzersiz olmayabileceğinden, Ad parametresini kullandığınızda WhatIf veya Onayla'yı da kullanmayı düşünün Remove-PSSession komutundaki parametresini kullanın.

Tip :: String[]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: True

-Session

Kapatılacak PSSessions'ın oturum nesnelerini belirtir. PSSessions'ı içeren bir değişken veya PSSessions'ı oluşturan veya alan bir komut girin (örneğin, New-PSSession veya Get- PSSession komutu. Ayrıca bir veya daha fazla oturum nesnesini Remove-PSSession'a yönlendirebilirsiniz.

Tip :: PSOturumu[]
Konum:: 0
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-VMId

Sanal makinelerin bir dizi kimliğini 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

Tip :: Rehber[]
Takma adlar:: VMGuid
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-VMName

Sanal makinelerin adlarının bir 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.

Tip :: String[]
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: True
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Tip :: SwitchParameter
Takma adlar:: wi
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

Girişler

PSSession

Bir oturum nesnesini bu cmdlet'e aktarabilirsiniz.

Çıkışlar

Yok

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

Notlar

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

Tüm platformlar:
Id parametresi zorunludur. Geçerli oturumdaki tüm PSSessions'ları silmek için Get-PSSession | Remove-PSSession.
PSSession uzak bir bilgisayara kalıcı bir bağlantı kullanır. Verileri paylaşan bir dizi komutu çalıştırmak için bir PSSession oluşturun. Daha fazla bilgi için PSSessions hakkında Yardım Alın yazın.
PSSessions geçerli oturuma özeldir. Bir oturumu sonlandırdığınızda, o oturumda oluşturduğunuz PSSession'lar zorla kapatılır.