Skip to content

Set-Brokerdesktopgroup

Adjusts the settings of a broker desktop group.

Syntax

Set-BrokerDesktopGroup [-InputObject] <DesktopGroup[]> [-PassThru] [-AllowReconnectInMaintenanceMode <Boolean>] [-AppDisks <Guid[]>] [-AppProtectionKeyLoggingRequired <Boolean>] [-AppProtectionScreenCaptureRequired <Boolean>] [-AutomaticPowerOnForAssigned <Boolean>] [-AutomaticPowerOnForAssignedDuringPeak <Boolean>] [-AutomaticRestartForUntaggedMachines <Boolean>] [-AutoscaleLogOffWarningMessage <String>] [-AutoscaleLogOffWarningTitle <String>] [-AutoscaleMaxSecondsBeforeForcedLogOffDuringOffPeak <Int32>] [-AutoscaleMaxSecondsBeforeForcedLogOffDuringPeak <Int32>] [-AutoscalingEnabled <Boolean>] [-ColorDepth <ColorDepth>] [-DeliveryType <DeliveryType>] [-Description <String>] [-DisconnectOffPeakIdleSessionAfterSeconds <Int32>] [-DisconnectPeakIdleSessionAfterSeconds <Int32>] [-Enabled <Boolean>] [-IconUid <Int32>] [-InMaintenanceMode <Boolean>] [-IsRemotePC <Boolean>] [-LicenseModel <LicenseModel>] [-LogoffOffPeakDisconnectedSessionAfterSeconds <Int32>] [-LogoffPeakDisconnectedSessionAfterSeconds <Int32>] [-MachineCost <Decimal>] [-MachineLogOnType <MachineLogOnType>] [-MinimumFunctionalLevel <FunctionalLevel>] [-OffPeakBufferSizePercent <Int32>] [-OffPeakDisconnectAction <SessionChangeHostingAction>] [-OffPeakDisconnectTimeout <Int32>] [-OffPeakExtendedDisconnectAction <SessionChangeHostingAction>] [-OffPeakExtendedDisconnectTimeout <Int32>] [-OffPeakLogOffAction <SessionChangeHostingAction>] [-OffPeakLogOffTimeout <Int32>] [-PeakBufferSizePercent <Int32>] [-PeakDisconnectAction <SessionChangeHostingAction>] [-PeakDisconnectTimeout <Int32>] [-PeakExtendedDisconnectAction <SessionChangeHostingAction>] [-PeakExtendedDisconnectTimeout <Int32>] [-PeakLogOffAction <SessionChangeHostingAction>] [-PeakLogOffTimeout <Int32>] [-PowerOffDelay <Int32>] [-ProductCode <String>] [-ProtocolPriority <String[]>] [-PublishedName <String>] [-ResourceLeasingEnabled <Boolean>] [-RestrictAutoscaleTagUid <Int32>] [-ReuseMachinesWithoutShutdownInOutage <Boolean>] [-SecureIcaRequired <Boolean>] [-SettlementPeriodBeforeAutoShutdown <TimeSpan>] [-SettlementPeriodBeforeUse <TimeSpan>] [-ShutdownDesktopsAfterUse <Boolean>] [-TimeZone <String>] [-TurnOnAddedMachine <Boolean>] [-ZonePreferences <ZonePreference[]>] [-LoggingId <Guid>] [-AdminAddress <String>] [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [<CommonParameters>]

Set-BrokerDesktopGroup [-Name] <String> [-PassThru] [-AllowReconnectInMaintenanceMode <Boolean>] [-AppDisks <Guid[]>] [-AppProtectionKeyLoggingRequired <Boolean>] [-AppProtectionScreenCaptureRequired <Boolean>] [-AutomaticPowerOnForAssigned <Boolean>] [-AutomaticPowerOnForAssignedDuringPeak <Boolean>] [-AutomaticRestartForUntaggedMachines <Boolean>] [-AutoscaleLogOffWarningMessage <String>] [-AutoscaleLogOffWarningTitle <String>] [-AutoscaleMaxSecondsBeforeForcedLogOffDuringOffPeak <Int32>] [-AutoscaleMaxSecondsBeforeForcedLogOffDuringPeak <Int32>] [-AutoscalingEnabled <Boolean>] [-ColorDepth <ColorDepth>] [-DeliveryType <DeliveryType>] [-Description <String>] [-DisconnectOffPeakIdleSessionAfterSeconds <Int32>] [-DisconnectPeakIdleSessionAfterSeconds <Int32>] [-Enabled <Boolean>] [-IconUid <Int32>] [-InMaintenanceMode <Boolean>] [-IsRemotePC <Boolean>] [-LicenseModel <LicenseModel>] [-LogoffOffPeakDisconnectedSessionAfterSeconds <Int32>] [-LogoffPeakDisconnectedSessionAfterSeconds <Int32>] [-MachineCost <Decimal>] [-MachineLogOnType <MachineLogOnType>] [-MinimumFunctionalLevel <FunctionalLevel>] [-OffPeakBufferSizePercent <Int32>] [-OffPeakDisconnectAction <SessionChangeHostingAction>] [-OffPeakDisconnectTimeout <Int32>] [-OffPeakExtendedDisconnectAction <SessionChangeHostingAction>] [-OffPeakExtendedDisconnectTimeout <Int32>] [-OffPeakLogOffAction <SessionChangeHostingAction>] [-OffPeakLogOffTimeout <Int32>] [-PeakBufferSizePercent <Int32>] [-PeakDisconnectAction <SessionChangeHostingAction>] [-PeakDisconnectTimeout <Int32>] [-PeakExtendedDisconnectAction <SessionChangeHostingAction>] [-PeakExtendedDisconnectTimeout <Int32>] [-PeakLogOffAction <SessionChangeHostingAction>] [-PeakLogOffTimeout <Int32>] [-PowerOffDelay <Int32>] [-ProductCode <String>] [-ProtocolPriority <String[]>] [-PublishedName <String>] [-ResourceLeasingEnabled <Boolean>] [-RestrictAutoscaleTagUid <Int32>] [-ReuseMachinesWithoutShutdownInOutage <Boolean>] [-SecureIcaRequired <Boolean>] [-SettlementPeriodBeforeAutoShutdown <TimeSpan>] [-SettlementPeriodBeforeUse <TimeSpan>] [-ShutdownDesktopsAfterUse <Boolean>] [-TimeZone <String>] [-TurnOnAddedMachine <Boolean>] [-ZonePreferences <ZonePreference[]>] [-LoggingId <Guid>] [-AdminAddress <String>] [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [<CommonParameters>]

Detailed Description

The Set-BrokerDesktopGroup cmdlet is used to disable or enable an existing broker desktop group or to alter its settings.

Parameters

Name Description Required? Pipeline Input Default Value
InputObject Specifies the desktop groups to adjust. true true (ByValue)
Name Specifies the desktop groups to adjust, based on their Name property. true true (ByPropertyName)
PassThru This cmdlet does not generate any output, unless you use the PassThru parameter, in which case it returns the affected record. false false False
AllowReconnectInMaintenanceMode Whether the maintenance mode allows session reconnect to various Session support types. false false
AppDisks Specifies the application disks to be used by machines in the desktop group. false false
AppProtectionKeyLoggingRequired Specifies whether key logging app protection is required. false false
AppProtectionScreenCaptureRequired Specifies whether screen capture app protection is required. false false
AutomaticPowerOnForAssigned Specifies whether assigned desktops in the desktop group should be automatically started at the start of peak time periods. Only relevant for groups whose DesktopKind is Private. false false
AutomaticPowerOnForAssignedDuringPeak Specifies whether assigned desktops in the desktop group should be automatically started throughout peak time periods. Only relevant for groups whose DesktopKind is Private and which have AutomaticPowerOnForAssigned set to true. false false
AutomaticRestartForUntaggedMachines Indicates whether untagged single-session machines belonging to a desktop group configured for restrict Autoscale and shutdown after use should restart after untainting. false false
AutoscaleLogOffWarningMessage Specifies the warning message to display to users in active sessions prior to Autoscale issuing a logoff request. false false
AutoscaleLogOffWarningTitle Specifies the warning message dialog title displayed prior to Autoscale issuing a logoff request. false false
AutoscaleMaxSecondsBeforeForcedLogOffDuringOffPeak Specifies the minimum seconds that need to elapse before Autoscale logs off the active sessions on the draining machines belonging to the delivery group during off-peak time. This property will override the power-off delay behavior if it is configured to a value greater than zero. false false
AutoscaleMaxSecondsBeforeForcedLogOffDuringPeak Specifies the minimum seconds that need to elapse before Autoscale logs off the active sessions on the draining machines belonging to the delivery group peak time. This property will override the power-off delay behavior if it is configured to a value greater than zero. false false
AutoscalingEnabled Specifies whether machines in this desktop group can be Autoscaled. false false
ColorDepth Specifies the color depth that the ICA session should use for desktops in this group. Valid values are FourBit, EightBit, SixteenBit, and TwentyFourBit. false false
DeliveryType Specifies whether desktops, applications, or both, can be delivered from machines contained within the desktop group. Desktop groups with a DesktopKind of Private cannot be used to deliver both desktops and applications.
When changing the delivery type to desktops only, there must be no remaining desktop-hosted applications associated with the group, or application-specific assignment/entitlement policy rules for the group.
When changing the delivery type to applications only, there must be no remaining client-hosted applications associated with the group, or desktop-specific assignment/entitlement policy rules for the group.
Valid values are DesktopsOnly, AppsOnly, and DesktopsAndApps.
false false
Description A description for this desktop group useful for administrators of the site. false false
DisconnectOffPeakIdleSessionAfterSeconds Specifies the time in seconds after which an idle session belonging to the delivery group is disconnected during off-peak time. false false
DisconnectPeakIdleSessionAfterSeconds Specifies the time in seconds after which an idle session belonging to the delivery group is disconnected during peak time. false false
Enabled Whether the desktop group should be in the enabled state; disabled desktop groups do not appear to users. false false
IconUid The UID of the broker icon to be displayed to users for their desktop(s) in this desktop group. false false
InMaintenanceMode Whether the desktop should be put into maintenance mode; a desktop group in maintenance mode will not allow users to connect or reconnect to their desktops. false false
IsRemotePC Supplies a new value for IsRemotePC.
IsRemotePC can only be enabled when:
o SessionSupport is SingleSession
o DeliveryType is DesktopsOnly
o DesktopKind is Private
IsRemotePC can be switched from true to false only if no RemotePC relationship exists between a catalog and this desktop group.
false false
LicenseModel The license model for this desktop group. If none is specified, then the site-wide license model is used. false false
LogoffOffPeakDisconnectedSessionAfterSeconds Specifies the time in seconds after which a disconnected session belonging to the delivery group is terminated during off-peak time. false false
LogoffPeakDisconnectedSessionAfterSeconds Specifies the time in seconds after which a disconnected session belonging to the delivery group is terminated during peak time. false false
MachineCost The per-hour instance cost of machines in this desktop group. false false
MachineLogOnType Specifies the login type for the desktop group. Values can be:
o ActiveDirectory - Perform Active Directory login on the machine.
o LocalMappedAccount - Perform local mapped account login on the machine.
false false
MinimumFunctionalLevel The new minimum FunctionalLevel required for machines to work successfully in the desktop group. If this is higher than the FunctionalLevel of any machines already in the desktop group, they will immediately cease to function. false false
OffPeakBufferSizePercent The percentage of single-session machines that are kept available in an idle state, or for multi-session machines, the percentage of the total load capacity to be kept available outside peak hours. false false
OffPeakDisconnectAction The action to be performed after a configurable period of a user session disconnecting outside peak hours. Possible values are Nothing, Suspend, or Shutdown. false false
OffPeakDisconnectTimeout The number of minutes before the configured action should be performed after a user session disconnects outside peak hours. false false
OffPeakExtendedDisconnectAction The action to be performed after a second configurable period of a user session disconnecting outside peak hours. Possible values are Nothing, Suspend, or Shutdown. false false
OffPeakExtendedDisconnectTimeout The number of minutes before the second configured action should be performed after a user session disconnects outside peak hours. false false
OffPeakLogOffAction The action to be performed after a configurable period of a user session ending outside peak hours. Possible values are Nothing, Suspend, or Shutdown. false false
OffPeakLogOffTimeout The number of minutes before the configured action should be performed after a user session ends outside peak hours. false false
PeakBufferSizePercent The percentage of single-session machines that are kept available in an idle state, or for multi-session machines, the percentage of the total load capacity to be kept available in peak hours. false false
PeakDisconnectAction The action to be performed after a configurable period of a user session disconnecting in peak hours. Possible values are Nothing, Suspend, or Shutdown. false false
PeakDisconnectTimeout The number of minutes before the configured action should be performed after a user session disconnects in peak hours. false false
PeakExtendedDisconnectAction The action to be performed after a second configurable period of a user session disconnecting in peak hours. Possible values are Nothing, Suspend, or Shutdown. false false
PeakExtendedDisconnectTimeout The number of minutes before the second configured action should be performed after a user session disconnects in peak hours. false false
PeakLogOffAction The action to be performed after a configurable period of a user session ending in peak hours. Possible values are Nothing, Suspend, or Shutdown. false false
PeakLogOffTimeout The number of minutes before the configured action should be performed after a user session ends in peak hours. false false
PowerOffDelay The number of minutes following a power-on operation that Auto Scale will wait before attemping to power off that same machine. Possible values are in the range 0 - 60. false false
ProductCode The licensing product code for this desktop group. If none is specified, then the site-wide product code is used. false false
ProtocolPriority A list of protocol names in the order in which they should be attempted for use during connection. false false
PublishedName The name that will be displayed to users for their desktop(s) in this desktop group. false false
ResourceLeasingEnabled Indicates if this desktop group is enabled for resource leasing. false false
RestrictAutoscaleTagUid If set to a Tag UID, only machines that have this tag will be auto scaled. false false
ReuseMachinesWithoutShutdownInOutage Specifies whether power cycle operations are required during outage for pooled machines. false false
SecureIcaRequired Whether HDX connections to desktops in the new desktop group require the use of a secure protocol. false false
SettlementPeriodBeforeAutoShutdown Time after a session ends during which automatic shutdown requests (for example, shutdown after use, idle pool management) are deferred. Any outstanding shutdown request takes effect after the settlement period expires. This is typically used to configure time to allow logoff scripts to complete. false false
SettlementPeriodBeforeUse Idle period before a machine can be selected to host a new session after registration or the end of a previous session. This is typically used to allow a machine to become idle following processing associated with start-up or logoff actions. A machine may still be selected during the idle period if no other machine is available for immediate use. false false
ShutdownDesktopsAfterUse Whether desktops in this desktop group should be automatically shut down when each user session completes (only relevant to power-managed desktops). false false
TimeZone The time zone in which this desktop group's machines reside.
The time zone must be specified for any of the group's automatic power management settings to take effect. Automatic power management operations include pool management (power time schemes), reboot schedules, session disconnect and logoff actions, and powering on assigned machines etc.
false false
TurnOnAddedMachine This flag specifies whether the Broker Service should attempt to power on machines when they are added to the desktop group. false false
ZonePreferences Ordered list of zone preferences to be applied when launching resources from this desktop group. Valid zone preference values are UserLocation, UserHome, UserHomeOnly and ApplicationHome.
The list can have zero or more entries subject to the following restrictions: Zone preferences can only be applied to groups having a DesktopKind of Shared; the same zone preference value cannot occur in the list more than once; the UserHome and UserHomeOnly values are mutually exclusive and cannot both appear in the list.
false false
LoggingId Specifies the identifier of the high level operation that this cmdlet call forms a part of. Desktop Studio and Desktop Director typically create High Level Operations. PowerShell scripts can also wrap a series of cmdlet calls in a High Level Operation by way of the Start-LogHighLevelOperation and Stop-LogHighLevelOperation cmdlets. false false
AdminAddress 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. false false Localhost. Once a value is provided by any cmdlet, this value will become the default.
BearerToken Specifies the bearer token assigned to the calling user false false
TraceParent Specifies the trace parent assigned for internal diagnostic tracing use false false
TraceState Specifies the trace state assigned for internal diagnostic tracing use false false
VirtualSiteId Specifies the virtual site the PowerShell snap-in will connect to. false false

Input Type

Citrix.Broker.Admin.Sdk.Desktopgroup

You can pipe the desktop groups to be adjusted to Set-BrokerDesktopGroup.

Return Values

None Or Citrix.Broker.Admin.Sdk.Desktopgroup

This cmdlet does not generate any output, unless you use the PassThru parameter, in which case it generates a Citrix.Broker.Admin.SDK.DesktopGroup object.

Examples

Example 1

C:\PS> Set-BrokerDesktopGroup EMEA\* -InMaintenanceMode $true -PassThru

Description

Sets all desktop groups with names starting "EMEA" into maintenance mode, returning the set of desktop groups.

Example 2

C:\PS> Get-BrokerDesktopGroup -InMaintenanceMode $true | Set-BrokerDesktopGroup -Enabled $false

Description

Disable all desktop groups that are in maintenance mode.

Was this article helpful?