Remove-RdsSessionHost
Tar bort en sessionsvärd från en värdpool.
Syntax
Default (Standard)
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 om sessionsvärden till en värdpool 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. Om du vill 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 force-parametern.
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 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 växeln Force 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-omkopplaren
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 cmdleten Remove-RdsSessionHost med forceringsväxeln tas sessionsvärden omedelbart bort från databasen, tillsammans med information om användarsessionen. Detta loggar inte ut användarna automatiskt och kan leda till att en användare förlorar sitt sessionstillstånd om de av misstag kopplas bort från sessionen innan de utför en utloggning.
Parametrar
-Force
Tvingar fram borttagning av sessionsvärden, även om det finns användarsessionsobjekt som finns med sessionsvärden.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-HostPoolName
Namn på HostPool.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 1 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Name
SessionHost-namn.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Värdnamn för session |
Parameteruppsättningar
(All)
| Position: | 2 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-TenantName
Klientorganisationens namn.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.