Product Documentation

Group-BrokerMachine

Oct 12, 2015

Groups and counts machines with the same value for a specified property.

Syntax

Group-BrokerMachine [-Uid] <Int32> -Property <String> [-AdminAddress <String>] [<CommonParameters>]

Group-BrokerMachine -Property <String> [[-MachineName] <String>] [-AgentVersion <String>] [-AllocationType <AllocationType>] [-ApplicationInUse <String>] [-AssignedClientName <String>] [-AssignedIPAddress <String>] [-AssociatedUserFullName <String>] [-AssociatedUserName <String>] [-AssociatedUserSID <String>] [-AssociatedUserUPN <String>] [-CatalogName <String>] [-CatalogUid <Int32>] [-CatalogUUID <Guid>] [-ColorDepth <ColorDepth>] [-ControllerDNSName <String>] [-DeliveryType <DeliveryType>] [-Description <String>] [-DesktopCondition <String>] [-DesktopGroupName <String>] [-DesktopGroupUid <Int32>] [-DesktopGroupUUID <Guid>] [-DesktopKind <DesktopKind>] [-DesktopUid <Int32>] [-DNSName <String>] [-FaultState <MachineFaultState>] [-FunctionalLevel <FunctionalLevel>] [-HostedMachineId <String>] [-HostedMachineName <String>] [-HostingServerName <String>] [-HypervisorConnectionName <String>] [-HypervisorConnectionUid <Int32>] [-HypHypervisorConnectionUid <Guid>] [-IconUid <Int32>] [-ImageOutOfDate <Boolean>] [-InMaintenanceMode <Boolean>] [-IPAddress <String>] [-IsAssigned <Boolean>] [-IsPhysical <Boolean>] [-LastConnectionFailure <ConnectionFailureReason>] [-LastConnectionTime <DateTime>] [-LastConnectionUser <String>] [-LastDeregistrationReason <DeregistrationReason>] [-LastDeregistrationTime <DateTime>] [-LastErrorReason <String>] [-LastErrorTime <DateTime>] [-LastHostingUpdateTime <DateTime>] [-LoadIndex <Int32>] [-MachineInternalState <MachineInternalState>] [-Metadata <String>] [-OSType <String>] [-OSVersion <String>] [-PersistUserChanges <PersistUserChanges>] [-PowerActionPending <Boolean>] [-PowerState <PowerState>] [-ProvisioningType <ProvisioningType>] [-PublishedApplication <String>] [-PublishedName <String>] [-PvdStage <PvdStage>] [-RegistrationState <RegistrationState>] [-ScheduledReboot <ScheduledReboot>] [-SecureIcaRequired <Boolean>] [-SessionAutonomouslyBrokered <Boolean>] [-SessionClientAddress <String>] [-SessionClientName <String>] [-SessionClientVersion <String>] [-SessionConnectedViaHostName <String>] [-SessionConnectedViaIP <String>] [-SessionCount <Int32>] [-SessionDeviceId <String>] [-SessionHardwareId <String>] [-SessionHidden <Boolean>] [-SessionKey <Guid>] [-SessionLaunchedViaHostName <String>] [-SessionLaunchedViaIP <String>] [-SessionProtocol <String>] [-SessionSecureIcaActive <Boolean>] [-SessionsEstablished <Int32>] [-SessionSmartAccessTag <String>] [-SessionsPending <Int32>] [-SessionStartTime <DateTime>] [-SessionState <SessionState>] [-SessionStateChangeTime <DateTime>] [-SessionSupport <SessionSupport>] [-SessionUid <Int64>] [-SessionUserName <String>] [-SessionUserSID <String>] [-SID <String>] [-SummaryState <DesktopSummaryState>] [-SupportedPowerActions <String[]>] [-Tag <String>] [-UUID <Guid>] [-VMToolsState <VMToolsState>] [-WillShutdownAfterUse <Boolean>] [-WindowsConnectionSetting <WindowsConnectionSetting>] [-AssignedUserSID <String>] [-ReturnTotalRecordCount] [-MaxRecordCount <Int32>] [-Skip <Int32>] [-SortBy <String>] [-Filter <String>] [-AdminAddress <String>] [<CommonParameters>]

Detailed Description

Filters machines using the specified criteria, then groups and counts matching machines with the same value for a particular property. The number of machines in the group, and the property value for the group, is output. For example:

C:\PS> Group-BrokerMachine -Property SummaryState

Count Name

----- ----

43 Available

17 InUse

3 Disconnected

Filtering supports the same options as the Get-BrokerMachine cmdlet, and allows filtering on both machine and session properties.

Group-BrokerMachine is similar to the standard PowerShell Group-Object, but is faster than piping the output of Get-BrokerMachine 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 machines.

Related topics

Get-BrokerMachine

Group-Object

Parameters

-Uid<Int32>

Gets a machine with a specific UID.

Required? true
Default Value  
Accept Pipeline Input? false

-Property<String>

Selects the property by which matching machines are grouped.

Required? true
Default Value  
Accept Pipeline Input? false

-MachineName<String>

Gets machines with a specific machine name (in the form domain\machine).

Required? false
Default Value  
Accept Pipeline Input? false

-AgentVersion<String>

Gets machines with a specific Virtual Delivery Agent version.

Required? false
Default Value  
Accept Pipeline Input? false

-AllocationType<AllocationType>

Gets machines from catalogs with the specified allocation type.

Required? false
Default Value  
Accept Pipeline Input? false

-ApplicationInUse<String>

Gets machines running a specified published application. String comparisons are case-insensitive.

Required? false
Default Value  
Accept Pipeline Input? false

-AssignedClientName<String>

Gets machines that have been assigned to the specific client name.

Required? false
Default Value  
Accept Pipeline Input? false

-AssignedIPAddress<String>

Gets machines that have been assigned to the specific client IP address.

Required? false
Default Value  
Accept Pipeline Input? false

-AssociatedUserFullName<String>

Gets machines with an associated user identified by their full name (usually 'first-name last-name').

Associated users are all current users of a desktop, plus the assigned users for private desktops.

Required? false
Default Value  
Accept Pipeline Input? false

-AssociatedUserName<String>

Gets machines with an associated user identified by their user name (in the form 'domain\user').

Associated users are all current users of a desktop, plus the assigned users for private desktops.

Required? false
Default Value  
Accept Pipeline Input? false

-AssociatedUserSID<String>

Gets machines with an associated user identified by their Windows SID.

Associated users are all current users of a desktop, plus the assigned users for private desktops.

Required? false
Default Value  
Accept Pipeline Input? false

-AssociatedUserUPN<String>

Gets machiness with an associated user identified by their User Principle Name (in the form 'user@domain').

Associated users are all current users of a desktop, plus the assigned users for private desktops.

Required? false
Default Value  
Accept Pipeline Input? false

-CatalogName<String>

Gets machines from the catalog with the specific name.

Required? false
Default Value  
Accept Pipeline Input? false

-CatalogUid<Int32>

Gets machines from the catalog with the specific UID.

Required? false
Default Value  
Accept Pipeline Input? false

-CatalogUUID<Guid>

Gets machines from the catalog with the specific UUID.

Required? false
Default Value  
Accept Pipeline Input? false

-ColorDepth<ColorDepth>

Gets machines configured with a specific color depth.

Valid values are FourBit, EightBit, SixteenBit, and TwentyFourBit.

Required? false
Default Value  
Accept Pipeline Input? false

-ControllerDNSName<String>

Gets machines by the DNS name of the controller they are registered with.

Required? false
Default Value  
Accept Pipeline Input? false

-DeliveryType<DeliveryType>

Gets machines of a particular delivery type.

Valid values are AppsOnly, DesktopsOnly, DesktopsAndApps

Required? false
Default Value  
Accept Pipeline Input? false

-Description<String>

Get machines by description.

Required? false
Default Value  
Accept Pipeline Input? false

-DesktopCondition<String>

Gets machines with an outstanding desktop condition.

Valid values are:

o CPU: Indicates the machine has high CPU usage

o ICALatency: Indicates the network latency is high

o UPMLogonTime: Indicates that the profile load time was high

Required? false
Default Value  
Accept Pipeline Input? false

-DesktopGroupName<String>

Gets machines from a desktop group with the specified name.

Required? false
Default Value  
Accept Pipeline Input? false

-DesktopGroupUid<Int32>

Gets machines from a desktop group with a specific UID.

Required? false
Default Value  
Accept Pipeline Input? false

-DesktopGroupUUID<Guid>

Gets machines from a desktop group with a specific UUID.

Required? false
Default Value  
Accept Pipeline Input? false

-DesktopKind<DesktopKind>

Deprecated: Use AllocationType parameter.

Gets machines of a particular kind.

Valid values are Private, Shared.

Required? false
Default Value  
Accept Pipeline Input? false

-DesktopUid<Int32>

Gets the machine that corresponds to the desktop with the specific UID.

Required? false
Default Value  
Accept Pipeline Input? false

-DNSName<String>

Gets machines with the specific DNS name.

Required? false
Default Value  
Accept Pipeline Input? false

-FaultState<MachineFaultState>

Gets machines currently in the specified fault state.

Required? false
Default Value  
Accept Pipeline Input? false

-FunctionalLevel<FunctionalLevel>

Gets machines with a specific FunctionalLevel.

Valid values are L5, L7

Required? false
Default Value  
Accept Pipeline Input? false

-HostedMachineId<String>

Gets machines with the specific machine ID known to the hypervisor.

Required? false
Default Value  
Accept Pipeline Input? false

-HostedMachineName<String>

Gets machines with the specific machine name known to the hypervisor.

Required? false
Default Value  
Accept Pipeline Input? false

-HostingServerName<String>

Gets machines by the name of the hosting hypervisor server.

Required? false
Default Value  
Accept Pipeline Input? false

-HypervisorConnectionName<String>

Gets machines with the specific name of the hypervisor connection hosting them.

Required? false
Default Value  
Accept Pipeline Input? false

-HypervisorConnectionUid<Int32>

Gets machines with the specific UID of the hypervisor connection hosting them.

Required? false
Default Value  
Accept Pipeline Input? false

-HypHypervisorConnectionUid<Guid>

Gets machines with the specific UUID of the hypervisor connection hosting them.

Required? false
Default Value  
Accept Pipeline Input? false

-IconUid<Int32>

Gets machines by configured icon. Note that machines with a null IconUid use the icon of the desktop group.

Required? false
Default Value  
Accept Pipeline Input? false

-ImageOutOfDate<Boolean>

Gets machines depending on whether their disk image is out of date or not (for machines provisioned using MCS only).

Required? false
Default Value  
Accept Pipeline Input? false

-InMaintenanceMode<Boolean>

Gets machines by whether they are in maintenance mode or not.

Required? false
Default Value  
Accept Pipeline Input? false

-IPAddress<String>

Gets machines with a specific IP address.

Required? false
Default Value  
Accept Pipeline Input? false

-IsAssigned<Boolean>

Gets machines according to whether they are assigned or not. Machines may be assigned to one or more users or groups, a client IP address or a client endpoint name.

Required? false
Default Value  
Accept Pipeline Input? false

-IsPhysical<Boolean>

Gets machines according to whether they can be power managed by XenDesktop or not.

Required? false
Default Value  
Accept Pipeline Input? false

-LastConnectionFailure<ConnectionFailureReason>

Gets machines with a specific reason for the last recorded connection failure. This value is None if the last connection was successful or if there has been no attempt to connect to the machine yet.

Valid values are None, SessionPreparation, RegistrationTimeout, ConnectionTimeout, Licensing, Ticketing, and Other.

Required? false
Default Value  
Accept Pipeline Input? false

-LastConnectionTime<DateTime>

Gets machines to which a user session connection occurred at a specific time. This is the time that the broker detected that the connection attempt either succeeded or failed.

Required? false
Default Value  
Accept Pipeline Input? false

-LastConnectionUser<String>

Gets machines where a specific user name last attempted a connection (in the form 'domain\user').

Required? false
Default Value  
Accept Pipeline Input? false

-LastDeregistrationReason<DeregistrationReason>

Gets machines whose broker last recorded a specific deregistration reason.

Valid values are $null, AgentShutdown, AgentSuspended, AgentRequested, IncompatibleVersion, AgentAddressResolutionFailed, AgentNotContactable, AgentWrongActiveDirectoryOU, EmptyRegistrationRequest, MissingRegistrationCapabilities, MissingAgentVersion, InconsistentRegistrationCapabilities, NotLicensedForFeature, UnsupportedCredentialSecurityVersion, InvalidRegistrationRequest, SingleMultiSessionMismatch, FunctionalLevelTooLowForCatalog, FunctionalLevelTooLowForDesktopGroup, PowerOff, DesktopRestart, DesktopRemoved, AgentRejectedSettingsUpdate, SendSettingsFailure, SessionAuditFailure, SessionPrepareFailure, ContactLost, SettingsCreationFailure, UnknownError and BrokerRegistrationLimitReached.

Required? false
Default Value  
Accept Pipeline Input? false

-LastDeregistrationTime<DateTime>

Gets machines by the time that they were last deregistered.

Required? false
Default Value  
Accept Pipeline Input? false

-LastErrorReason<String>

Gets machines with the specified last error reason.

Required? false
Default Value  
Accept Pipeline Input? false

-LastErrorTime<DateTime>

Gets machines with the specified last error time.

Required? false
Default Value  
Accept Pipeline Input? false

-LastHostingUpdateTime<DateTime>

Gets machines with a specific time that the hosting information was last updated.

Required? false
Default Value  
Accept Pipeline Input? false

-LoadIndex<Int32>

Gets machines by their current load index.

Required? false
Default Value  
Accept Pipeline Input? false

-MachineInternalState<MachineInternalState>

Gets machines with the specified internal state.

Required? false
Default Value  
Accept Pipeline Input? false

-Metadata<String>

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".

Required? false
Default Value  
Accept Pipeline Input? false

-OSType<String>

Gets machines by the type of operating system they are running.

Required? false
Default Value  
Accept Pipeline Input? false

-OSVersion<String>

Gets machines by the version of the operating system they are running.

Required? false
Default Value  
Accept Pipeline Input? false

-PersistUserChanges<PersistUserChanges>

Gets machines according to the location where user changes are persisted. Values can be:

o OnLocal - User changes are persisted locally.

o Discard - User changes are discarded.

o OnPvd - User changes are persisted on the Pvd.

Required? false
Default Value  
Accept Pipeline Input? false

-PowerActionPending<Boolean>

Gets machines depending on whether a power action is pending or not.

Valid values are $true or $false.

Required? false
Default Value  
Accept Pipeline Input? false

-PowerState<PowerState>

Gets machines with a specific power state.

Valid values are Unmanaged, Unknown, Unavailable, Off, On, Suspended, TurningOn, TurningOff, Suspending, and Resuming.

Required? false
Default Value  
Accept Pipeline Input? false

-ProvisioningType<ProvisioningType>

Specifies the provisioning type for the catalog. Values can be:

o Manual - No provisioning.

o PVS - Machine provisioned by PVS (machine may be physical, blade, VM,...).

o MCS - Machine provisioned by MCS (machine must be VM).

Required? false
Default Value  
Accept Pipeline Input? false

-PublishedApplication<String>

Gets machines with a specific application published to them (identified by its browser name).

Required? false
Default Value  
Accept Pipeline Input? false

-PublishedName<String>

Gets desktops with a specific published name.

Required? false
Default Value  
Accept Pipeline Input? false

-PvdStage<PvdStage>

Gets machines at a specific personal vDisk stage.

Valid values are None, Requested, PoweringOn and Working.

Required? false
Default Value  
Accept Pipeline Input? false

-RegistrationState<RegistrationState>

Gets machines in a specific registration state.

Valid values are Unregistered, Initializing, Registered, and AgentError.

Required? false
Default Value  
Accept Pipeline Input? false

-ScheduledReboot<ScheduledReboot>

Gets machines according to their current status with respect to any scheduled reboots (for either scheduled desktop group reboots or image rollout purposes). Valid values are:

o None - No reboot currently scheduled.

o Pending - Reboot scheduled but machine still available for use.

o Draining - Reboot scheduled. New logons are disabled, but reconnections to existing sessions are allowed.

o InProgress - Machine is actively being rebooted.

o Natural - Natural reboot in progress. Machine is awaiting a restart.

Required? false
Default Value  
Accept Pipeline Input? false

-SecureIcaRequired<Boolean>

Gets machines configured with a particular SecureIcaRequired setting. Note that the machine setting of $null indicates that the desktop group value is used.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionAutonomouslyBrokered<Boolean>

Gets machines with the autonomously brokered session flag.

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionClientAddress<String>

Gets machines with a specific client IP address.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionClientName<String>

Gets machines with a specific client name.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionClientVersion<String>

Gets machines with a specific client version.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionConnectedViaHostName<String>

Gets machines with a specific host name of the incoming connection. This is usually a proxy or Citrix Access Gateway server.

Session properties are always null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionConnectedViaIP<String>

Gets machines with a specific IP address of the incoming connection.

Session properties are always null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionCount<Int32>

Gets machines according to the total number of both pending and established user sessions on the machine.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionDeviceId<String>

Gets machines with a specific client device ID.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionHardwareId<String>

Gets machines with a specific client hardware ID.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionHidden<Boolean>

Gets machines by whether their sessions are hidden or not. Hidden sessions are treated as though they do not exist when launching sessions using XenDesktop; a hidden session cannot be reconnected to, but a new session may be launched using the same entitlement.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionKey<Guid>

Gets machine running the session with the specified unique key.

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionLaunchedViaHostName<String>

Gets machines with a specific host name of the Web Interface server from which the user launched the session.

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionLaunchedViaIP<String>

Gets machines with a specific IP address of the Web Interface server from which the user launched the session.

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionProtocol<String>

Gets machines with connections using a specific protocol, for example 'HDX', or 'RDP'.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionSecureIcaActive<Boolean>

Gets machines depending on whether the current session uses SecureICA or not.

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionsEstablished<Int32>

Gets machines according to the number of established user sessions present on the machine.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionSmartAccessTag<String>

Gets session machines where the session has the specific SmartAccess tag.

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionsPending<Int32>

Get machines according to the number of pending user sessions for the machine.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionStartTime<DateTime>

Gets machines with a specific session start time.

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionState<SessionState>

Gets machines with a specific session state.

Valid values are $null, Other, PreparingSession, Connected, Active, Disconnected, Reconnecting, NonBrokeredSession, and Unknown.

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionStateChangeTime<DateTime>

Gets machines whose sessions last changed state at a specific time.

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionSupport<SessionSupport>

Gets machines that have the specified session capability. Values can be:

o SingleSession - Single-session only machine.

o MultiSession - Multi-session capable machine.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionUid<Int64>

Gets single-session machines with a specific session UID ($null for no session).

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionUserName<String>

Gets machines with a specific user name for the current session (in the form 'domain\user').

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SessionUserSID<String>

Gets machines with a specific SID of the current session user.

Session properties are always $null for multi-session machines.

Required? false
Default Value  
Accept Pipeline Input? false

-SID<String>

Gets machines with a specific machine SID.

Required? false
Default Value  
Accept Pipeline Input? false

-SummaryState<DesktopSummaryState>

Gets machines with a specific summary state.

Valid values are Off, Unregistered, Available, Disconnected, and InUse.

Required? false
Default Value  
Accept Pipeline Input? false

-SupportedPowerActions<String[]>

A list of power actions supported by this machine.

Required? false
Default Value  
Accept Pipeline Input? false

-Tag<String>

Gets machines where the session has the given SmartAccess tag.

Required? false
Default Value  
Accept Pipeline Input? false

-UUID<Guid>

Gets machines with the specified value of UUID.

Required? false
Default Value  
Accept Pipeline Input? false

-VMToolsState<VMToolsState>

Gets machines with a specific VM tools state.

Valid values are NotPresent, Unknown, NotStarted, and Running.

Required? false
Default Value  
Accept Pipeline Input? false

-WillShutdownAfterUse<Boolean>

Gets machines depending on whether they shut down after use or not.

Required? false
Default Value  
Accept Pipeline Input? false

-WindowsConnectionSetting<WindowsConnectionSetting>

Gets machines according to their current Windows connection setting (logon mode). Valid values are:

o LogonEnabled - All logons are enabled.

o Draining - New logons are disabled, but reconnections to existing sessions are allowed.

o DrainingUntilRestart - Same as Draining, but setting reverts to LogonEnabled when machine next restarts.

o LogonDisabled - All logons and reconnections are disabled.

This is a Windows setting and is not controlled by XenDesktop. It applies only to multi-session machines; for single-session machines its value is always LogonEnabled.

Required? false
Default Value  
Accept Pipeline Input? false

-AssignedUserSID<String>

Gets machines with the specific SID of the user to whom the desktop is assigned.

Required? false
Default Value  
Accept Pipeline Input? false

-ReturnTotalRecordCount<SwitchParameter>

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.

Required? false
Default Value False
Accept Pipeline Input? false

-MaxRecordCount<Int32>

Specifies the maximum number of records to return.

Required? false
Default Value 250
Accept Pipeline Input? false

-Skip<Int32>

Skips the specified number of records before returning results. Also reduces the count returned by -ReturnTotalRecordCount.

Required? false
Default Value 0
Accept Pipeline Input? false

-SortBy<String>

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.

Required? false
Default Value The default sort order is by name or unique identifier.
Accept Pipeline Input? false

-Filter<String>

Gets records that match a PowerShell style filter expression. See about_Broker_Filtering for details.

Required? false
Default Value  
Accept Pipeline Input? false

-AdminAddress<String>

Specifies the address of a XenDesktop controller that the PowerShell snapin will connect to. This can be provided as a host name or an IP address.

Required? false
Default Value Localhost. Once a value is provided by any cmdlet, this value will become the default.
Accept Pipeline Input? false

Input Type

None You cannot pipe input into this cmdlet.

Return Values

Citrix.Broker.Admin.SDK.GroupInfo

Each GroupInfo object represents one group, and contains the following properties:

-- Count: The count of machines in this group.

-- Name: The value of the property the machines 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.

Examples

-------------------------- EXAMPLE 1 --------------------------

C:\PS> Group-BrokerMachine -Property SummaryState -DesktopGroupName dg1

Group machines from the dg1 group by summary state.

-------------------------- EXAMPLE 2 --------------------------

C:\PS> Group-BrokerMachine -Property LastConnectionFailure -Filter { LastConnectionFailure -ne "None" -and LastConnectionTime -ge '-7' } -MaxRecordCount 1

For machines where the last connection attempt failed, list the most common reason for failure, ignoring connections that failed over a week ago.

-------------------------- EXAMPLE 3 --------------------------

C:\PS> Group-BrokerMachine -Property HostingServerName -DesktopCondition ICALatency -SortBy Name

List alphabetically the hypervisor servers hosting machines that are currently experiencing high network latency.