Group-BrokerSession
Groups and counts sessions with the same value for a specified property.
Syntax
Group-BrokerSession
[[-SessionKey] <Guid>]
[-AgentVersion <String>]
[-AnonymousUserId <String>]
[-ApplicationInUse <String>]
[-AppState <SessionAppState>]
[-AppStateLastChangeTime <DateTime>]
[-AutonomouslyBrokered <Boolean>]
[-BrokeringDuration <Int32>]
[-BrokeringTime <DateTime>]
[-BrokeringUserName <String>]
[-BrokeringUserSID <String>]
[-CatalogName <String>]
[-CbpVersion <CBPVersion>]
[-ClientAddress <String>]
[-ClientName <String>]
[-ClientPlatform <String>]
[-ClientProductId <Int32>]
[-ClientVersion <String>]
[-ConnectedViaHostName <String>]
[-ConnectedViaIP <String>]
[-ConnectionMode <ConnectionMode>]
[-ControllerDNSName <String>]
[-DesktopGroupName <String>]
[-DesktopGroupUid <Int32>]
[-DesktopKind <DesktopKind>]
[-DesktopSID <String>]
[-DesktopUid <Int32>]
[-DeviceId <String>]
[-DNSName <String>]
[-EntitlementPolicyRuleUid <Int32>]
[-EstablishmentDuration <Int32>]
[-EstablishmentTime <DateTime>]
[-HardwareId <String>]
[-Hidden <Boolean>]
[-HostedMachineName <String>]
[-HostingServerName <String>]
[-HypervisorConnectionName <String>]
[-IdleDuration <TimeSpan>]
[-IdleSince <DateTime>]
[-ImageOutOfDate <Boolean>]
[-InMaintenanceMode <Boolean>]
[-IPAddress <String>]
[-IsAnonymousUser <Boolean>]
[-IsPhysical <Boolean>]
[-LaunchedViaHostName <String>]
[-LaunchedViaIP <String>]
[-LaunchedViaPublishedName <String>]
[-LaunchedViaWorkspace <Boolean>]
[-LogoffInProgress <Boolean>]
[-LogonInProgress <Boolean>]
[-MachineName <String>]
[-MachineSummaryState <DesktopSummaryState>]
[-MachineUid <Int32>]
[-Metadata <String>]
[-OSType <String>]
[-PersistUserChanges <PersistUserChanges>]
[-PowerState <PowerState>]
[-PreferredZoneName <String>]
[-PreferredZoneUid <Guid>]
[-Protocol <String>]
[-ProvisioningType <ProvisioningType>]
[-ReceiverIPAddress <String>]
[-ReceiverName <String>]
[-SecureIcaActive <Boolean>]
[-SessionId <Int32>]
[-SessionReconnection <SessionReconnection>]
[-SessionState <SessionState>]
[-SessionStateChangeTime <DateTime>]
[-SessionSupport <SessionSupport>]
[-SessionType <SessionType>]
[-StartTime <DateTime>]
[-TenantId <Guid>]
[-UntrustedUserName <String>]
[-UserFullName <String>]
[-UserName <String>]
[-UserSID <String>]
[-UserUPN <String>]
[-ZoneName <String>]
[-ZoneUid <Guid>]
[-ApplicationUid <Int32>]
[-SharedDesktopUid <Int32>]
-Property <String>
[-ReturnTotalRecordCount]
[-MaxRecordCount <Int32>]
[-Skip <Int32>]
[-SortBy <String>]
[-Filter <String>]
[-FilterScope <Guid>]
[<CitrixCommonParameters>]
[<CommonParameters>]
<!--NeedCopy-->
Group-BrokerSession
[-Uid] <Int64>
-Property <String>
[<CitrixCommonParameters>]
[<CommonParameters>]
<!--NeedCopy-->
Description
Filters sessions using the specified criteria, then groups and counts matching sessions with the same value for a particular property. The number of sessions in the group, and the property value for the group, is output. For example:
Group-BrokerSession -Property SessionState
Count Name
----- ----
43 Active
17 NonBrokeredSession
3 Disconnected
Filtering supports the same options as the [Get-BrokerSession](Get-BrokerSession) cmdlet, and allows filtering on both machine and session properties.
Group-BrokerSession is similar to the standard PowerShell Group-Object, but is faster than piping the output of [Get-BrokerSession](Get-BrokerSession) into Group-Object when working with many machines.
Note that the MaxRecordCount, ReturnTotalRecordCount, Skip, and SortBy parameters apply to GroupInfo records output rather than the filtered sessions.
<!--NeedCopy-->
Examples
EXAMPLE 1
Group sessions on machines from the dg1 group by session state.
Group-BrokerSession -Property SessionState -DesktopGroupName dg1
<!--NeedCopy-->
EXAMPLE 2
List alphabetically the names of the clients connected to the site, but only show clients whose names starts with ‘ThinClient’.
Group-BrokerSession -Property ClientName -ClientName 'ThinClient*' -SortBy Name
<!--NeedCopy-->
Parameters
-Uid
Gets session by its Uid.
| Type: | Int64 |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Property
Selects the property by which matching sessions are grouped.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SessionKey
Gets session having the specified unique key.
| Type: | Guid |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AgentVersion
Gets sessions with a specific Virtual Desktop Agent version.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AnonymousUserId
Gets sessions associated with the specified user ID.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationInUse
Gets sessions running specific applications (identified by their SDK Name property).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AppState
Gets sessions by their app state.
Valid values are PreLogon, PreLaunched, Active, Desktop, Lingering and NoApps.
| Type: | SessionAppState |
| Accepted values: | PreLogon, PreLaunched, Active, Desktop, Lingering, NoApps |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AppStateLastChangeTime
Get sessions by their app state change time.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AutonomouslyBrokered
Gets sessions according to whether they are autonomously brokered or not. Autonomously brokered sessions are HDX sessions established by direct connection without being brokered.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BrokeringDuration
Gets session with a specific time taken to broker. In general, Citrix recommends using -Filter and relative comparisons.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BrokeringTime
Get sessions brokered at a specific time. In general, Citrix recommends using -Filter and relative comparisons.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BrokeringUserName
Get sessions by brokering user.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BrokeringUserSID
Get sessions by brokering user SID.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CatalogName
Gets sessions on machines from a specific catalog name.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CbpVersion
The version of CBP that the VDA is currently registered with. This will be null when the VDA is not registered.
| Type: | CBPVersion |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClientAddress
Get sessions by client IP address.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClientName
Get sessions by client name.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClientPlatform
Get sessions by client platform.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClientProductId
Get sessions by client product ID.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClientVersion
Get sessions by client version.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectedViaHostName
Get sessions by host name of the incoming connection. This is usually a proxy or Citrix Access Gateway server.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectedViaIP
Get sessions by IP address of the incoming connection.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionMode
Gets sessions by the way in which the most recent connection to the session was established.
Valid modes are Brokered, Unbrokered, LeasedConnection, VdaHighAvailabilityMode, ThirdPartyBroker, and ThirdPartyBrokerWithLicensing.
| Type: | ConnectionMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ControllerDNSName
Gets sessions that are hosted on machines which are registered with a specific controller.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DesktopGroupName
Gets sessions from a desktop group with the specified name.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DesktopGroupUid
Gets sessions from a desktop group with the specified UID.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DesktopKind
Gets sessions on a desktop of a particular kind.
Valid values are Private and Shared.
| Type: | DesktopKind |
| Accepted values: | Private, Shared |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DesktopSID
Get sessions by desktop SID.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DesktopUid
Get sessions by desktop Uid.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceId
Get sessions by client device id.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DNSName
Gets sessions by their machine’s DNS name.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EntitlementPolicyRuleUid
Gets sessions where the user was granted the entitlement to launch the session from the specified entitlement policy rule.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EstablishmentDuration
Gets sessions which took a specific time to establish. In general, Citrix recommends using -Filter and relative comparisons.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EstablishmentTime
Gets sessions which became established at a particular time. In general, Citrix recommends using -Filter and relative comparisons.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HardwareId
Get sessions by client hardware id.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Hidden
Get sessions by whether they are hidden or not. Hidden sessions are treated as though they do not exist when brokering sessions; a hidden session cannot be reconnected to, but a new session may be launched using the same entitlement.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostedMachineName
Gets sessions by their machine’s name as known to its hypervisor.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostingServerName
Gets sessions hosted by a machine with a specific name of the hosting hypervisor server.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HypervisorConnectionName
Gets sessions hosted by a machine with a specific name of the hosting hypervisor connection.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdleDuration
Gets sessions that have been idle for the specified period
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdleSince
Time at which session went idle
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ImageOutOfDate
Gets sessions hosted by a machine with a specific ImageOutOfDate setting.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InMaintenanceMode
Gets sessions hosted by a machine with a specific InMaintenanceMode setting.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPAddress
Gets sessions hosted by a machine with a specific IP address.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsAnonymousUser
Gets sessions depending on whether they were established anonymously ($true) or not ($false). An anonymous session is established without user credentials and a temporary local user account is used.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsPhysical
Gets sessions hosted on machines where the flag indicating if the machine can be power managed by the Citrix Broker Service matches the requested value. Where the power state of the machine cannot be controlled, specify $true, otherwise $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LaunchedViaHostName
Get sessions by the host name of the StoreFront server from which a user launches a session.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LaunchedViaIP
Get sessions by the IP address of the StoreFront server from which a user launches a session.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LaunchedViaPublishedName
Gets sessions originally launched using a resource having a name matching the specified published name.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LaunchedViaWorkspace
Gets sessions by whether they were launched via Citrix Workspace or not.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Introduced in: | Citrix Virtual Apps and Desktop 7 2206 |
-LogoffInProgress
Gets sessions by whether they are in the process of being logged off or not.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogonInProgress
Gets sessions by whether they are still executing user logon processing or not.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MachineName
Gets sessions by their machine name (in the form DOMAIN\machine).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MachineSummaryState
Gets sessions on a machine with a specific summary state.
Valid values are Off, Unregistered, Available, Disconnected, Preparing, and InUse.
| Type: | DesktopSummaryState |
| Accepted values: | Off, Unregistered, Available, Disconnected, InUse, Preparing |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MachineUid
Gets sessions on a machine with the specified UID.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Metadata
Gets records with matching metadata entries.
The value being compared with is a concatenation of the key name, a colon, and the value. For example: -Metadata “abc:x*” matches records with a metadata entry having a key name of “abc” and a value starting with the letter “x”.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OSType
Gets sessions with a specific type of operating system.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistUserChanges
Gets sessions where the user changes are persisted in a particular manner. Values can be:
- OnLocal - User changes are persisted locally.
- Discard - User changes are discarded.
| Type: | PersistUserChanges |
| Accepted values: | OnLocal, Discard, OnPvd |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PowerState
Gets sessions on machines in the specified power state.
Valid values are Unmanaged, Unknown, Unavailable, On, Suspended, TurningOn, TurningOff, Suspending, and Resuming.
| Type: | PowerState |
| Accepted values: | Unmanaged, Unknown, Unavailable, Off, On, Suspended, TurningOn, TurningOff, Suspending, Resuming, NotSupported, VirtualMachineNotFound |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PreferredZoneName
Gets sessions originally launched with the specified preferred zone name.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PreferredZoneUid
Gets sessions originally launched with the specified preferred zone Uid.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
Get sessions by connection protocol. Valid values are HDX, RDP and Console.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProvisioningType
Gets sessions hosted on machines provisioned in a particular manner. Values can be:
- Manual - No automated provisioning.
- PVS - Machine provisioned by PVS (machine may be physical, blade, VM,…).
- MCS - Machine provisioned by MCS (machine must be VM).
| Type: | ProvisioningType |
| Accepted values: | Manual, PVS, MCS |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReceiverIPAddress
Gets sessions with the specified client IP address supplied by Receiver (for example, StoreFront) when the session was launched, or reconnected.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReceiverName
Gets sessions with the specified client name supplied by Receiver (for example, StoreFront) when the session was launched, or reconnected.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SecureIcaActive
Get sessions by their use of SecureICA.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SessionId
Deprecated.
Gets sessions by session ID, a unique identifier that Remote Desktop Services uses to track the session but it is only unique on that machine.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SessionReconnection
Get sessions by their session reconnection (roaming) behavior. Possible values are:
Always, DisconnectedOnly, and SameEndpointOnly.
| Type: | SessionReconnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SessionState
Get sessions by their state.
Valid values are Other, PreparingNewSession, Connected, Active, Disconnected, Reconnecting, NonBrokeredSession, and Unknown.
| Type: | SessionState |
| Accepted values: | PreparingSession, Connected, Active, Disconnected, Reconnecting, NonBrokeredSession, Unknown, Other |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SessionStateChangeTime
Get sessions by their last state change time. In general, Citrix recommends using -Filter and relative comparisons.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SessionSupport
Gets sessions hosted on machines which support the required pattern of sessions. Values can be:
- SingleSession - Single-session only machine.
- MultiSession - Multi-session capable machine.
| Type: | SessionSupport |
| Accepted values: | SingleSession, MultiSession |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SessionType
Gets sessions by their type.
Valid values are Application and Desktop.
| Type: | SessionType |
| Accepted values: | Desktop, Application |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartTime
Gets sessions by their start time. In general, Citrix recommends using -Filter and relative comparisons.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantId
Gets sessions associated with the specified tenant.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UntrustedUserName
Gets sessions by the untrusted user name reported directly from the machine.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserFullName
Gets sessions by user’s full name (usually ‘first-name last-name’).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserName
Get sessions by user name (in the form DOMAIN\user).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserSID
Get sessions by user’s Windows SID.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserUPN
Gets sessions by user’s User Principal Name (in the form user@domain).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ZoneName
Gets sessions hosted by machines located in the zone with the specified name.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ZoneUid
Gets sessions hosted by machines located in the zone with the specified UID.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationUid
Gets sessions running the application with the specified Uid.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SharedDesktopUid
Gets sessions by SharedDesktop Uid.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReturnTotalRecordCount
When specified, this causes the cmdlet to output an error record containing the number of records available. This error record is additional information and does not affect the objects written to the output pipeline. See about_Broker_Filtering for details.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxRecordCount
Specifies the maximum number of records to return.
| Type: | Int32 |
| Position: | Named |
| Default value: | 250 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Skip
Skips the specified number of records before returning results. Also reduces the count returned by -ReturnTotalRecordCount.
| Type: | Int32 |
| Position: | Named |
| Default value: | 0 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SortBy
Sorts the results by the specified list of properties. The list is a set of property names separated by commas, semi-colons, or spaces. Optionally, prefix each name with a + or - to indicate ascending or descending order. Ascending order is assumed if no prefix is present.
| Type: | String |
| Position: | Named |
| Default value: | The default sort order is by name or unique identifier. |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
Gets records that match a PowerShell style filter expression. See about_Broker_Filtering for details.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FilterScope
Gets only results allowed by the specified scope id.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Introduced in: | Citrix Virtual Apps and Desktop 7 2106 |
CitrixCommonParameters
This cmdlet supports the common Citrix parameters: -AdminAddress, -AdminClientIP, -BearerToken, -TraceParent, -TraceState and -VirtualSiteId. For more information, see about_CitrixCommonParameters.
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
None
You cannot pipe input into this cmdlet.
Outputs
Citrix.Broker.Admin.SDK.GroupInfo
Each GroupInfo object represents one group, and contains the following properties:
- Count: The count of sessions in this group.
- Name: The value of the property the sessions were grouped by (as a string).
If you do not specify -SortBy, groups are sorted with the largest count first.
Notes
To compare dates or times, use -Filter and relative comparisons. For more information, see about_Broker_Filtering and the examples.