Condividi tramite


Disconnect-RdsUserSession

Disconnette un utente dalla sessione attiva corrente.

Sintassi

Default (impostazione predefinita).

Disconnect-RdsUserSession
    [-TenantName] <String>
    [-HostPoolName] <String>
    [-SessionHostName] <String>
    [-SessionId] <Int32>
    [-NoUserPrompt]
    [<CommonParameters>]

Descrizione

Il cmdlet Disconnect-RdsUserSession disconnette l'utente dalla sessione attiva corrente in esecuzione nell'host di sessione specificato. L'utente non è disconnesso, quindi tutte le applicazioni continuano a essere eseguite. L'utente può riconnettersi alla sessione avviando nuovamente una connessione nel client Desktop remoto.

Esempio

Esempio 1: Disconnettere un utente fornendo tutte le informazioni necessarie

PS C:\> Disconnect-RdsUserSession -TenantName "contoso" -HostPoolName "contosoHostPool" -SessionHostName "sh1.contoso.com" -SessionId 1

Questo comando disconnette l'utente sull'host di sessione specificato associato all'ID di sessione fornito. Questo comando richiede che l'utente abbia cercato la sessione utente in precedenza per fornire tutte le informazioni richieste. Eseguendo il cmdlet Disconnect-RdsUserSession senza l'opzione NoUserPrompt, verrà chiesto di confermare la disconnessione dell'utente.

Esempio 2: Disconnettere un utente cercando la sua sessione utente

PS C:\> Get-RdsUserSession -TenantName "contoso" -HostPoolName "contosoHostPool" | where { $_.UserPrincipalName -eq "contoso\user1" } | Disconnect-RdsUserSession -NoUserPrompt

Questo comando usa il cmdlet Get-RdsUserSession per cercare la sessione dell'utente specifico, quindi lo reindirizza al cmdlet Disconnect-RdsUserSession per disconnettere l'utente. Eseguendo il cmdlet Disconnect-RdsUserSession con l'opzione NoUserPrompt, non verrà visualizzata alcuna richiesta aggiuntiva per confermare la disconnessione dell'utente.

Parametri

-HostPoolName

Nome del pool di host.

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

-NoUserPrompt

L'interruttore indica che si desidera disconnettere l'utente senza alcuna conferma aggiuntiva.

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

-SessionHostName

Nome dell'host della sessione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

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

-SessionId

L'ID sessione correlato all'utente che si desidera disconnettere.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:3
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-TenantName

Nome del tenant.

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.

Input

System.String

System.Int32

Output

System.Object