XenApp and XenDesktop 7.6

Move-BrokerApplication

Sep 10, 2014

Move a published application from one admin folder to another

Syntax

Move-BrokerApplication [-InputObject] <Application[]> [-Destination] <AdminFolder> [-NewName

<String>] [-PassThru] [-LoggingId <Guid>] [-AdminAddress <String>] [<CommonParameters>]

Move-BrokerApplication [-Name] <String> [-Destination] <AdminFolder> [-NewName <String>] [-

PassThru] [-LoggingId <Guid>] [-AdminAddress <String>] [<CommonParameters>]

Detailed Description

The Move-BrokerApplication cmdlet moves a published application from one place to another in the tree of admin folders, optionally renaming it in the process (if you only want to change the name of the application for administrative purposes and not its location in the tree, use the Rename-BrokerApplication cmdlet).

The location and name of a published application in this sense is only of interest to the administrator, changes do not affect the end-user experience.

Related topics

New-BrokerApplication

Add-BrokerApplication

Get-BrokerApplication

Remove-BrokerApplication

Rename-BrokerApplication

Set-BrokerApplication

Parameters

-InputObject<Application[]>

The application(s) to be moved

Required?

true

Default Value

Accept Pipeline Input?

true (ByValue)

-Name<String> https://docs.citrix.com

© 1999-2017 Citrix Systems, Inc. All rights reserved.

p.1429

The application(s) to be moved

Required?

Default Value

Accept Pipeline Input?

-Destination<AdminFolder>

The destination location within the admin folder hierarchy

Required?

Default Value

Accept Pipeline Input?

true true (ByPropertyName) true false

-NewName<String>

The new name of the application in its new destination

Required?

Default Value

Accept Pipeline Input?

-PassThru<SwitchParameter>

This cmdlet does not generate any output, unless you use the PassThru parameter, in which case it returns the affected record.

Required?

false

Default Value

Accept Pipeline Input?

False false

-LoggingId<Guid> false false https://docs.citrix.com

© 1999-2017 Citrix Systems, Inc. All rights reserved.

p.1430

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.

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

Citrix.Broker.Admin.SDK.Application You can pipe applications to Move-BrokerApplication.

Return Values

None or Citrix.Broker.Admin.SDK.Application

This cmdlet does not generate any output, unless you use the PassThru parameter, in which case it generates a

Citrix.Broker.Admin.SDK.Application object.

Examples

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

C:\PS> Move-BrokerApplication -Name 'App1' -Destination 'F1\'

Moves the application in the root folder called "App1" to the folder "F1\".

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

C:\PS> Move-BrokerApplication 'F1\App1' 'F2\' -NewName 'Application1'

Moves the application in folder "F1" called "App1" to the folder "F2\", renaming it to "Application1" in the process.

https://docs.citrix.com

© 1999-2017 Citrix Systems, Inc. All rights reserved.

p.1431