Remove-RdsSessionHost

  • Referens
Modul:
WindowsVirtualDesktopPowershell

Tar bort en sessionsvärd från en värdpool.

Syntax

Remove-RdsSessionHost
      [-TenantName] <String>
      [-HostPoolName] <String>
      [-Name] <String>
      [-Force]
      [<CommonParameters>]

Description

Cmdleten Remove-RdsSessionHost tar bort en registrerad sessionsvärd från värdpoolen. Om du vill registrera sessionsvärden till en värdpool igen måste du installera om agenten med giltig registreringsinformation för värdpoolen.

Det här kommandot misslyckas om sessionsvärden har aktiva användarsessioner. För att slutföra borttagningen av sessionsvärden måste du först logga ut alla användare från sessionsvärden med hjälp av cmdleten Invoke-RdsUserSessionLogoff eller köra cmdleten Remove-RdsSessionHost igen med parametern Force.

När du kör det här kommandot för att ta bort en sessionsvärd från en beständig värdpool tas även användartilldelningen bort. Det här är det enda sättet att tilldela om en användare till en ny sessionsvärd i en beständig värdpool.

Exempel

Exempel 1: Ta bort en sessionsvärd som inte har några aktiva sessioner

PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com"

Det här kommandot tar bort en sessionsvärd från en värdpool. Genom att köra cmdleten Remove-RdsSessionHost utan Force-växeln lyckas den bara om det inte finns några aktiva sessioner på den angivna sessionsvärden. Om du vill tvinga användarna att logga ut från sessionsvärden kan du köra cmdleten Invoke-RdsUserSessionLogoff.

Exempel 2: Ta bort en sessionsvärd med hjälp av force-växeln

PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -Force

Det här kommandot tar bort en sessionsvärd från en värdpool. Genom att köra Remove-RdsSessionHost-cmdleten med force-växeln tas sessionsvärden omedelbart bort från databasen, tillsammans med användarsessionsinformationen. Detta loggar inte automatiskt ut användarna och kan leda till att en användare förlorar sitt sessionstillstånd om de av misstag kopplas från sessionen innan de utför en utloggning.

Parametrar

-Force

Tvingar borttagningen av sessionsvärden, även om det finns användarsessionsobjekt som finns hos sessionsvärden.

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

-HostPoolName

HostPool-namn.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

SessionHost-namn.

Type:String
Aliases:SessionHostName
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TenantName

Klientorganisationens namn.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Indata

System.String

Utdata

System.Object