Remove-RdsSessionHost
Supprime un hôte de session d’un pool d’hôtes.
Syntaxe
Default (Par défaut)
Remove-RdsSessionHost
[-TenantName] <String>
[-HostPoolName] <String>
[-Name] <String>
[-Force]
[<CommonParameters>]
Description
L’applet de commande Remove-RdsSessionHost supprime un hôte de session inscrit du pool d’hôtes. Pour réinscrire l’hôte de session dans un pool d’hôtes, vous devez réinstaller l’agent avec des informations d’enregistrement valides pour ce pool d’hôtes.
Cette commande échoue si l’hôte de session dispose de sessions utilisateur actives. Pour terminer la suppression de l’hôte de session, vous devez d’abord fermer la session de tous les utilisateurs de l’hôte de session à l’aide de l’applet de commande Invoke-RdsUserSessionLogoff ou réexécuter l’applet de commande Remove-RdsSessionHost avec le paramètre Force.
Lors de l’exécution de cette commande pour supprimer un hôte de session d’un pool d’hôtes persistants, l’attribution d’utilisateur est également supprimée. Il s’agit de la seule façon de réaffecter un utilisateur à un nouvel hôte de session dans un pool d’hôtes persistant.
Exemples
Exemple 1 : Supprimer un hôte de session qui n’a pas de sessions actives
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com"
Cette commande supprime un hôte de session d’un pool d’hôtes. En exécutant l’applet de commande Remove-RdsSessionHost sans le commutateur Force, elle ne réussira que s’il n’y a pas de sessions actives sur l’hôte de session spécifié. Pour forcer les utilisateurs à se déconnecter de l’hôte de session, vous pouvez exécuter l’applet de commande Invoke-RdsUserSessionLogoff.
Exemple 2 : Supprimer un hôte de session à l’aide du commutateur forcé
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -Force
Cette commande supprime un hôte de session d’un pool d’hôtes. En exécutant l’applet de commande Remove-RdsSessionHost avec le commutateur Forcer, l’hôte de session est immédiatement supprimé de la base de données, ainsi que les informations de session utilisateur. Cela n’a pas pour effet de déconnecter automatiquement les utilisateurs et peut entraîner la perte de l’état de leur session s’il est accidentellement déconnecté de sa session avant d’effectuer une déconnexion.
Paramètres
-Force
Force la suppression de l’hôte de session, même si des objets de session utilisateur sont contenus avec l’hôte de session.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-HostPoolName
Nom du HostPool.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Name
SessionNom d’hôte.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Nom de l'hôte de session |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-TenantName
Nom du locataire.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.