Remove-RdsSessionHost
Rimuove un host sessione da un pool di host.
Sintassi
Default (impostazione predefinita).
Remove-RdsSessionHost
[-TenantName] <String>
[-HostPoolName] <String>
[-Name] <String>
[-Force]
[<CommonParameters>]
Descrizione
Il cmdlet Remove-RdsSessionHost rimuove un host di sessione registrato dal pool di host. Per registrare nuovamente l'host della sessione in un pool di host, è necessario reinstallare l'agente con informazioni di registrazione valide per tale pool di host.
Questo comando avrà esito negativo se l'host della sessione ha sessioni utente attive. Per completare la rimozione dell'host di sessione, è necessario prima disconnettere tutti gli utenti dall'host di sessione utilizzando il cmdlet Invoke-RdsUserSessionLogoff o eseguire nuovamente il cmdlet Remove-RdsSessionHost con il parametro Force.
Quando si esegue questo comando per rimuovere un host di sessione da un pool di host persistente, viene rimossa anche l'assegnazione dell'utente. Questo è l'unico modo per riassegnare un utente a un nuovo host di sessione in un pool di host persistente.
Esempio
Esempio 1: rimuovere un host di sessione che non dispone di sessioni attive
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com"
Questo comando rimuove un host di sessione da un pool di host. Eseguendo il cmdlet Remove-RdsSessionHost senza l'opzione Forza, l'operazione avrà esito positivo solo se non sono presenti sessioni attive nell'host di sessione specificato. Per forzare gli utenti a disconnettersi dall'host della sessione, è possibile eseguire il cmdlet Invoke-RdsUserSessionLogoff.
Esempio 2: Rimuovere un host di sessione utilizzando l'interruttore di forza
PS C:\> Remove-RdsSessionhost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -Force
Questo comando rimuove un host di sessione da un pool di host. Eseguendo il cmdlet Remove-RdsSessionHost con l'opzione Forza, l'host della sessione verrà immediatamente rimosso dal database, insieme alle informazioni sulla sessione utente. In questo modo, gli utenti non vengono disconnessi automaticamente e può comportare la perdita dello stato di sessione da parte di un utente se viene disconnesso accidentalmente dalla sessione prima di eseguire una disconnessione.
Parametri
-Force
Forza la rimozione dell'host di sessione, anche se con l'host di sessione sono presenti oggetti sessione utente.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-HostPoolName
Nome HostPool.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Name
Nome SessionHost.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | SessionHostName |
Set di parametri
(All)
| Posizione: | 2 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-TenantName
Nome dell'inquilino.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.