Citrix XenApp 6.x Application Report

Here's a quick and useful one-liner for pulling an Application Report from Citrix XenApp 6.x+. No longer do you pull it from Report Center/Summary database like in Presentation Server now we get to use Powershell!

First run powershell as administrator from a XA65 server, and type in this first:

Add-PSSnapin Citrix*

Then :

Get-XAApplicationReport * | select ApplicationType, DisplayName, FolderPath, 
Enabled, HideWhenDisabled,ContentAddress, CommandLineExecutable, WorkingDirectory,
AnonymousConnectionsAllowed, AddToClientStartMenu, ClientFolder,
StartMenuFolder, AddToClientDesktop, ConnectionsThroughAccessGatewayAllowed,
OtherConnectionsAllowed, AccessSessionConditionsEnabled,
@{n="AccessSessionConditions";e={[string]::join(" ; ",
$_.AccessSessionConditions)}}, InstanceLimit, MultipleInstancesPerUserAllowed,
CpuPriorityLevel, AudioType, AudioRequired, SslConnectionEnabled,
EncryptionLevel, EncryptionRequired, WaitOnPrinterCreation, WindowType,
ColorDepth, TitleBarHidden, MaximizedOnStartup, OfflineAccessAllowed,
CachingOption, AlternateProfiles, RunAsLeastPrivilegedUser,
@{n="Servers";e={[string]::join(" ; ", $_.ServerNames)}},
@{n="WorkerGroups";e={[string]::join(" ; ",
$_.WorkerGroupNames)}}, @{n="Users";e={[string]::join(" ;
", $_.Accounts)}} | Export-Csv c:\app-report.csv

 

Check for your report at c:\app-report.csv

XenApp Powershell Script to Publish Apps from CSV

As part of this Citrix migration project I am currently working on I had the necessity to publish multiple apps and the process was very time consuming and tedious. In order to accelerate and make the process more accurate I developed this script to publish apps from a CSV file. I also included some error checking/handling in the script for errors that I had encountered. Also be aware that for the icons to be correctly identified you will need to run this off the XA server that hosts the exe file with the path as per the "CommandLineExecutable" field.

The CSV file structure was setup as follows:
BrowserName,DisplayName,WorkerGroupNames,Accounts,CommandLineExecutable,WorkingDirectory,FolderPath,ClientFolder
Example App, Example, Test Worker Group, mshorrosh, C:\windows\system32\notepad.exe, c:\windows\system32\, Applications/Test, Test\

And the script....

# Load the snapins 

Add-PSSnapin citrix* -ErrorAction SilentlyContinue 

#import the csv file

$apps = Import-Csv C:\apps.csv

#each line in the csv

foreach($app in $apps)

{

    #test if workergroup provided exists

    try{

        $WG = Get-XAWorkerGroup $app.WorkerGroupNames -ErrorAction Stop

     } catch {

        Write-Host "Error: " $app.BrowserName " resulted in " $_.Exception.Message " please create worker group first"

        break

     }

    #trying to get the executables icon from the CommandLineExecutable

    try{

        $EncodedIconData = Get-CtxIcon $app.CommandLineExecutable -index 0 

    } catch [Exception] {

        Write-Host "Error: Obtaining the icon failed: " $_.Exception.Message

    }

    #checking browsername length, found out it has a limit

    if($app.BrowserName.length -gt 36) 

    {

        Write-Host "Error: BrowserName for " $app.BrowserName " length is to long, must be less than 36 characters, please correct"

    }

    else

    {

    

        $success = $FALSE

        

        #try to publish new app

        try {

        

            $NewApp = New-XAApplication  `

            -ApplicationType "ServerInstalled" `

            -EncodedIconData $EncodedIconData `

            -WorkerGroupNames $app.WorkerGroupNames `

            -BrowserName $app.BrowserName `

            -Enabled $TRUE `

            -Accounts $app.Accounts `

            -WorkingDirectory $app.WorkingDirectory `

            -CommandLineExecutable $app.CommandLineExecutable `

            -FolderPath $app.FolderPath `

            -ClientFolder $app.ClientFolder  `

            -WindowType "100%" `

            -ColorDepth Colors32Bit `

            -InstanceLimit "-1" `

            -AddToClientStartMenu $false `

            -AnonymousConnectionsAllowed $false `

            -DisplayName $app.DisplayName `

            -ErrorAction Stop

            $success = $TRUE

        } catch {

             Write-Host "Error: " $_.Exception.Message

        } finally {

            if($success)

            {

                Write-Host $app.BrowserName "added successfully."

            }

        }

        

        

    }



    

}

Powershell script to rename XenApp Program Neighborhood Paths

Recently there was a organizational change in a company I was working at that required us to change all the program neighborhood paths for all the apps in the XenApp environment. The script below iterates through all the apps in the farm and examines their initial folder in the path for the "Client Folder" aka Program Neighborhood folder and removes the folder from their path. You may edit the different fields that we were inspecting for to suite changes you may need to make in your farm. This script should work for XenApp 6.0+.

Add-PSSnapin Citrix.XenApp.Commands 

$apps = Get-XAApplication
$mode = "Debug" #Change to Real to make changes
$count = 0

foreach($app in $apps)
{
                if($app.ClientFolder -match "AGLNG\\")
                {
                                $original = $app.ClientFolder
                                $temp = $original -replace "AGLNG\\", ""
                                $count +=1

                                if($mode -eq "Debug") 
                                {
                                                Write-Host $app.DisplayName "would have " $original " changed to " $temp 
                                                
                                }
                                elseif($mode -eq "Real")
                                {
                                                Write-Host "Changing " $app " to " $temp
                                                Set-XAApplication $app -ClientFolder $temp
                                                
                                }              

                }
                if($app.ClientFolder -match "ECA\\")
                {
                                $original = $app.ClientFolder
                                $temp = $original -replace "ECA\\", ""
                                $count +=1

                                if($mode -eq "Debug") 
                                {
                                                Write-Host $app.DisplayName "would have " $original " changed to " $temp 
                                                
                                }
                                elseif($mode -eq "Real")
                                {
                                                Write-Host "Changing " $app " to " $temp
                                                Set-XAApplication $app -ClientFolder $temp
                                                
                                }

                }
                if($app.ClientFolder -match "APAC\\")
                {
                                $original = $app.ClientFolder
                                $temp = $original -replace "APAC\\", ""
                                $count +=1

                                if($mode -eq "Debug") 
                                {
                                                Write-Host $app.DisplayName "would have " $original " changed to " $temp 
                                                
                                }
                                elseif($mode -eq "Real")
                                {
                                                Write-Host "Changing " $app " to " $temp
                                                Set-XAApplication $app -ClientFolder $temp
                                                
                                }

                }
}

Write-Host "Total of" $count "applications effected by the PN Folder change."