Remove-RdsSessionHost
Odebere hostitele relace z fondu hostitelů.
Syntaxe
Default (Výchozí)
Remove-RdsSessionHost
[-TenantName] <String>
[-HostPoolName] <String>
[-Name] <String>
[-Force]
[<CommonParameters>]
Description
Rutina Remove-RdsSessionHost odebere registrovaného hostitele relace z fondu hostitelů. Chcete-li znovu zaregistrovat hostitele relace do fondu hostitelů, musíte znovu nainstalovat agenta s platnými registračními informacemi pro tento fond hostitelů.
Tento příkaz selže, pokud má hostitel relace aktivní uživatelské relace. Chcete-li dokončit odebrání hostitele relace, musíte nejprve odhlásit všechny uživatele z hostitele relace pomocí rutiny Invoke-RdsUserSessionLogoff nebo znovu spustit rutinu Remove-RdsSessionHost s parametrem Force.
Při spuštění tohoto příkazu k odebrání hostitele relace z trvalého fondu hostitelů se odebere také přiřazení uživatele. Jedná se o jediný způsob, jak znovu přiřadit uživatele k novému hostiteli relace v trvalém fondu hostitelů.
Příklady
Příklad 1: Odebrání hostitele relace, který nemá žádné aktivní relace
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com"
Tento příkaz odebere hostitele relace z fondu hostitelů. Spuštěním rutiny Remove-RdsSessionHost bez přepínače Vynutit dojde k úspěchu pouze v případě, že na určeném hostiteli relace nejsou žádné aktivní relace. Pokud chcete vynutit, aby se uživatelé odhlásili z hostitele relace, můžete spustit rutinu Invoke-RdsUserSessionLogoff.
Příklad 2: Odebrání hostitele relace pomocí přepínače vynucení
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -Force
Tento příkaz odebere hostitele relace z fondu hostitelů. Spuštěním rutiny Remove-RdsSessionHost s přepínačem Vynutit bude hostitel relace okamžitě odebrán z databáze spolu s informacemi o relaci uživatele. Tím nedojde k automatickému odhlášení uživatelů a může to mít za následek, že uživatel ztratí stav relace, pokud se před provedením odhlášení omylem odpojí od své relace.
Parametry
-Force
Vynutí odebrání hostitele relace, i když hostitel relace obsahuje objekty uživatelské relace.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-HostPoolName
Název fondu hostitelů.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Name
Název SessionHost.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Název hostitele relace |
Sady parametrů
(All)
| Position: | 2 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-TenantName
Název klienta.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.