Remove-RdsSessionHost
Entfernt einen Sitzungshost aus einem Hostpool.
Syntax
Default (Standardwert)
Remove-RdsSessionHost
[-TenantName] <String>
[-HostPoolName] <String>
[-Name] <String>
[-Force]
[<CommonParameters>]
Beschreibung
Mit dem Cmdlet Remove-RdsSessionHost wird ein registrierter Sitzungshost aus dem Hostpool entfernt. Um den Sitzungshost erneut in einem Hostpool zu registrieren, müssen Sie den Agenten mit gültigen Registrierungsinformationen für diesen Hostpool neu installieren.
Dieser Befehl schlägt fehl, wenn der Sitzungshost über aktive Benutzersitzungen verfügt. Um das Entfernen des Sitzungshosts abzuschließen, müssen Sie zunächst alle Benutzer mit dem Cmdlet Invoke-RdsUserSessionLogoff vom Sitzungshost abmelden oder das Cmdlet Remove-RdsSessionHost mit dem Parameter Force erneut ausführen.
Wenn Sie diesen Befehl ausführen, um einen Sitzungshost aus einem persistenten Hostpool zu entfernen, wird die Benutzerzuweisung ebenfalls entfernt. Dies ist die einzige Möglichkeit, einen Benutzer einem neuen Sitzungshost in einem persistenten Hostpool neu zuzuweisen.
Beispiele
Beispiel 1: Entfernen eines Sitzungshosts ohne aktive Sitzungen
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com"
Mit diesem Befehl wird ein Sitzungshost aus einem Hostpool entfernt. Wenn Sie das Cmdlet Remove-RdsSessionHost ohne den Schalter Erzwingen ausführen, ist dies nur erfolgreich, wenn auf dem angegebenen Sitzungshost keine aktiven Sitzungen vorhanden sind. Um zu erzwingen, dass sich die Benutzer vom Sitzungshost abmelden, können Sie das Cmdlet Invoke-RdsUserSessionLogoff ausführen.
Beispiel 2: Entfernen eines Sitzungshosts mit dem Force Switch
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -Force
Mit diesem Befehl wird ein Sitzungshost aus einem Hostpool entfernt. Wenn Sie das Cmdlet Remove-RdsSessionHost mit der Option Force ausführen, wird der Sitzungshost sofort zusammen mit den Sitzungsinformationen des Benutzers aus der Datenbank entfernt. Dadurch werden die Benutzer nicht automatisch abgemeldet und können dazu führen, dass ein Benutzer seinen Sitzungsstatus verliert, wenn er versehentlich von seiner Sitzung getrennt wird, bevor er eine Abmeldung durchführt.
Parameter
-Force
Erzwingt das Entfernen des Sitzungshosts, auch wenn auf dem Sitzungshost Benutzersitzungsobjekte enthalten sind.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-HostPoolName
Name des HostPools.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Name des SessionHosts.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | SitzungsHostname |
Parametersätze
(All)
| Position: | 2 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-TenantName
Name des Mieters.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.