Citrix Virtual Apps and Desktops SDK

Remove-Brokermachineconfiguration

Deletes a machine configuration from the site or removes the association from a desktop group.

Syntax

Remove-BrokerMachineConfiguration [-InputObject] <MachineConfiguration[]> [-Application <Application>] [-DesktopGroup <DesktopGroup>] [-LoggingId <Guid>] [-AdminAddress <String>] [-BearerToken <String>] [<CommonParameters>]

Remove-BrokerMachineConfiguration [-Name] <String> [-Application <Application>] [-DesktopGroup <DesktopGroup>] [-LoggingId <Guid>] [-AdminAddress <String>] [-BearerToken <String>] [<CommonParameters>]
<!--NeedCopy-->

Detailed Description

This cmdlet has three functions:

  • Break associations between desktop groups and machine configurations.
  • Break associations between applications and machine configurations.
  • Remove machine configurations from the system.

If no desktop group or application is specified, then the Remove-MachineConfiguration cmdlet removes the machine configuration from the site.

If a desktop group is specified, then the Remove-MachineConfiguration cmdlet removes the association between the machine configuration and that desktop group. In this case, the machine configuration is not removed from the site.

If an application is specified, then the Remove-MachineConfiguration cmdlet removes the association between the machine configuration and that application. Again, in this case, the machine configuration is not removed from the site.

Parameters

Name Description Required? Pipeline Input Default Value
InputObject Machine configuration to remove. true true (ByValue) None
Name Name of machine configuration for which the remove operation applies. true true (ByPropertyName) None
Application The application from which this machine configuration is to be removed. false true (ByValue) None
DesktopGroup The desktop group from which this machine configuration is to be removed. false true (ByValue) None
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  

Input Type

Citrix.Broker.Admin.Sdk.Machineconfiguration

Machine configuration to remove

Return Values

None

Notes

A machine configuration can only be removed if it is not currently applied to a desktop group.

Examples

Example 1

Remove-BrokerMachineConfiguration -Name UPM\Finance
<!--NeedCopy-->

Description

Removes the machine configuration named “UPM\Finance”.

Example 2

Remove-BrokerMachineConfiguration -Name Receiver\HumanResources -DesktopGroup SharedWorkers
<!--NeedCopy-->

Description

Removes the association of the machine configuration named “Receiver\HumanResources” from the “SharedWorkers” desktop group.

Remove-Brokermachineconfiguration