Get-RDUserSession

Mis à jour: juin 2015

S'applique à: Windows 10, Windows Server Technical Preview

Get-RDUserSession

Gets a list of all user sessions in a collection or in a Remote Desktop deployment.

Syntaxe

Parameter Set: Default
Get-RDUserSession [[-CollectionName] <String[]> ] [[-ConnectionBroker] <String> ] [-InformationAction <System.Management.Automation.ActionPreference]> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String]> ] [ <CommonParameters>]

Description détaillée

The Get-RDUserSession cmdlet gets a list of all user sessions in a collection or in a Remote Desktop deployment.

Paramètres

-CollectionName<String[]>

Specifies an array that contains the name of the virtual desktop collection that contains the user sessions. If this parameter does not appear, the cmdlet returns all user sessions across all virtual desktop collections.

Alias	none
Requis ?	false
Position ?	1
Valeur par défaut	none
Accepter l'entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-ConnectionBroker<String>

Specifies the Remote Desktop Connection Broker (RD Connection Broker) server for this Remote Desktop deployment. Remote users connect to this server to obtain views of available RemoteApp programs, session-based desktops, and virtual desktops. If this parameter does not appear, the default value is the fully qualified domain name (FQDN) of the local host.

Alias	none
Requis ?	false
Position ?	2
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-InformationAction<System.Management.Automation.ActionPreference]>

Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend

Alias	infa
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-InformationVariable<System.String]>

Specifies a variable in which to store an information event message.

Alias	iv
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez  . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.

Sorties

Le type de sortie correspond au type des objets que l'applet de commande émet.

• Microsoft.RemoteDesktopServices.Management.RDUserSession

Exemples

Example 1: Retrieve a list of user sessions in a collection

This command lists user sessions in a collection that is associated with the RD Connection Broker server named rdcb.contoso.com.

PS C:\> Get-RDUserSession -ConnectionBroker "rdcb.contoso.com"

Example 2: Retrieve a list of user sessions in multiple collections

This command lists user sessions in the collections named Session Collection and Virtual Desktop Collection. The cmdlet associates these collections with the RD  Connection Broker server named rdcb.contoso.com.

PS C:\> Get-RDUserSession -ConnectionBroker "rdcb.contoso.com" -CollectionName @("Session Collection","Virtual Desktop Collection")