Aracılığıyla paylaş


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:

PSSession[]

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.