XenApp Commands CTP2 Release Notes

Notes

The tools provided in the PowerShell Tool Pack are provided "as is" without warranty of any kind. While these tools may be used in conjunction with XenApp server farms, they are not considered part of the XenApp product nor are they covered under any XenApp license or technical support agreement. Citrix releases these tools as a Technology Preview to the Citrix community because these might be the foundation of future releases of similar technology; however, Citrix makes no guarantee of forward compatibility. These tools have not undergone the release and testing processes typically followed for released products. Consequently, Citrix does not recommend that you use these tools in your production environments. Use of these tools is at your own risk.

Targeted Platforms

This Tool Pack runs on the following platforms:

· XenApp 5.0 for Windows Server 2008 x64.

· XenApp 5.0 for Windows Server 2008 x32.

· XenApp 5.0 for Windows Server 2003 x64.

· XenApp 5.0 for Windows Server 2003 x32.

The following platforms were not targeted for this Tool Pack, but might be functional:

· Presentation Server 4.5 for Windows Server 2003 x64 with HRP3 installed.

· Presentation Server 4.5 for Windows Server 2003 x32 with HRP3 installed.

PreRequisites

· PowerShell 1.0 or later

· .NET Framework 3.5 SP1

Features

This release provides the following management functionality that is provided by the Access Management Console’s Presentation Server extension:

· Application publishing

· Farm and Server configuration

· Administrators

· Zones

This release also includes features of XenApp Advanced Configuration:

· Policies

· Printer Management

· Load Management

This release does not cover functionality outside the scope of those components, such as Hotfix Management, Report Center, Licensing and Diagnostic Facility features. Features that were removed during the XenApp 5.0 release are also not supported, such as Resource Manager and Monitoring Configuration.

This release includes the following cmdlets:

· Get-XAAccount

· Get-XAAccountAuthority

· Disable-XAAdministrator

· Enable-XAAdministrator

· Get-XAAdministrator

· New-XAAdministrator

· Remove-XAAdministrator

· Set-XAAdministrator

· Get-XAAdministratorFolder

· Set-XAAdministratorFolder

· Add-XAAdministratorPrivilege

· Get-XAAdministratorPrivilege

· Remove-XAAdministratorPrivilege

· Copy-XAApplication

· Disable-XAApplication

· Enable-XAApplication

· Get-XAApplication

· Move-XAApplication

· New-XAApplication

· Remove-XAApplication

· Rename-XAApplication

· Set-XAApplication

· Add-XAApplicationAccount

· Remove-XAApplicationAccount

· Add-XAApplicationFileType

· Remove-XAApplicationFileType

· Get-XAApplicationIconStream

· Get-XAApplicationReport

· Add-XAApplicationServer

· Remove-XAApplicationServer

· Get-XAAppliedPolicy

· Get-XAAutoReplicatedPrinterDriver

· New-XAAutoReplicatedPrinterDriver

· Remove-XAAutoReplicatedPrinterDriver

· Get-XAClientModule

· Get-XAClientPrinter

· New-XAClientPrinter

· Remove-XAClientPrinter

· Reset-XAClientPrinter

· Clear-XAConfigurationLog

· Get-XAConfigurationLog

· Test-XAConfigurationLog

· Get-XAFarm

· Get-XAFarmConfiguration

· Set-XAFarmConfiguration

· Get-XAFileType

· Update-XAFileType

· Copy-XAFolder

· Get-XAFolder

· Move-XAFolder

· New-XAFolder

· Remove-XAFolder

· Rename-XAFolder

· Get-XAHmrTest

· New-XAHmrTest

· Remove-XAHmrTest

· Rename-XAHmrTest

· Set-XAHmrTest

· New-XAIcaFile

· Get-XAIconStream

· Import-XALegacyApplication

· Test-XALicenseServer

· Get-XALoadEvaluator

· New-XALoadEvaluator

· Remove-XALoadEvaluator

· Rename-XALoadEvaluator

· Set-XALoadEvaluator

· Get-XAMemoryOptimization

· Get-XAOfflineLicense

· Disable-XAPolicy

· Enable-XAPolicy

· Get-XAPolicy

· New-XAPolicy

· Remove-XAPolicy

· Rename-XAPolicy

· Set-XAPolicy

· Get-XAPolicyConfiguration

· Set-XAPolicyConfiguration

· Get-XAPolicyFilter

· Set-XAPolicyFilter

· Get-XAPrinter

· Update-XAPrinter

· Get-XAPrinterDriver

· Replicate-XAPrinterDriver

· Get-XAPrinterDriverCompatibility

· New-XAPrinterDriverCompatibility

· Remove-XAPrinterDriverCompatibility

· Set-XAPrinterDriverCompatibility

· Get-XAPrinterDriverMapping

· New-XAPrinterDriverMapping

· Remove-XAPrinterDriverMapping

· Set-XAPrinterDriverMapping

· Get-XAPrintServer

· Import-XAPrintServer

· Remove-XAPrintServer

· Get-XAProfileApplication

· Get-XAResultantPolicy

· Get-XAServer

· Move-XAServer

· Remove-XAServer

· Get-XAServerConfiguration

· Set-XAServerConfiguration

· Set-XAServerEdition

· Get-XAServerLoad

· Reset-XAServerLoadEvaluator

· Set-XAServerLoadEvaluator

· Disable-XAServerLogOn

· Enable-XAServerLogOn

· Set-XAServerZone

· Connect-XASession

· Disconnect-XASession

· Get-XASession

· Stop-XASession

· Send-XASessionMessage

· Add-XASessionPrinter

· Get-XASessionPrinter

· Remove-XASessionPrinter

· Set-XASessionPrinter

· Get-XASessionProcess

· Stop-XASessionProcess

· Get-XAStreamingSession

· Get-XAVirtualIPRange

· New-XAVirtualIPRange

· Remove-XAVirtualIPRange

· Get-XAZone

· Rename-XAZone

Changes in CTP2:

· Added a prefix "XA" to all cmdlet nouns. This will avoid potential naming conflicts with other snap-ins. Note that any conflicts could still be resolved by prefixing the cmdlet name with the snap-in name (e.g. Citrix.XenApp.Commands\Get-XAIconStream), but having a prefix greatly reduces the risk.

· Improve consistency in cmdlet parameters and property names of output types. For example, remove the "Is" prefix for boolean types, remove non-standard abbreviations, such as App, etc.

· Improve pipeline support, in particular to fix issues with parameter binding by property name and to be able to support null values for set-* and new-* cmdlets. Some parameter names were changed to avoid ambiguity when performing pipeline binding. For example, in Get-XALoadEvaluator, instead of just having a parameter Name, it is now more specific: LoadEvaluatorName. The same concept was applied to all cmdlets.

· Enhance support for 4.5 platforms. In particular for policy management.

· Fix typos in the cmdlets help. Also add more examples and parameter descriptions where none were provided.

· Add missing properties for sessions and fix date time properties in session objects to only provide the information when supported by the session state (instead of showing an invalid default date value).

· Improve the usability of Set-XAServerEdition. Previously, a string was expected where exact values were used to determine the edition type. This has been changed to use an enum type plus another parameter set to indicate custom.

· Reworked the account enumeration cmdlets to add more information and to allow specifying account types to be enumerated. Also, set the display name as the default parameter set, since resolving accounts by name is the most frequent use case.

· Added cmdlets to get the configuration log and the memory optimizations for servers.

· Fix compatibility with 4.5 CPU management settings. Instead of providing 2 separate sets of properties, now the latest set supports both versions.

· Check for duplicate names when creating new policies and load evaluators.

· Implement case insensitive search for policies, load evaluators and HMR tests.

· Rename Attach-Server and Detach-Server to Set-XAServerLoadEvaluator and Reset-XAServerLoadEValuator to use standard verbs and for consistency with other cmdlets.

· Rename Duplicate-App to Copy-XAApplication to use standard verb (even though semantics are not the same).

· Add indication that a parameter is mandatory in the cmdlet help.

· Validate allowed and denied lists for policies so that an item cannot be in both lists.

· Rework administration permissions to use more consistent names, to remove unsupported legacy items and to improve usability by splitting permissions into farm and folder privileges.

· Rename Search-Policy to Get-XAAppliedPolicy to use a standard verb.

· Improve usability of Get-XAFileType, by automatically extracting program name from full path and adding an "exe" extension if none provided.

· Fix defaults for new published applications so the window type is 1024x768 and the color depth is TrueColor.

· Remove unsupported icon format from new published applications to fix app enumeration issues with Web Interface and PN Agent.

· Modify Test-XALicenseServer to return a boolean value to indicate the test results. This will allow executing the cmdlet while setting the ErrorAction to SilentlyContinue and still get the test results.

· Remove the application associations (Servers, Accounts, File types, Icon) from application enumeration (Get-XAApplication). Also, remove the –Full parameter and always return all applicable settings for each application type. This change improves application enumeration performance and is more consistent with PowerShell guidelines, where associations are obtained using other cmdlets (Get-XAServer, Get-XAAccount. Etc). This change also allows the Get-XAApplication to work better with PowerShell 2.0 remoting (by not introducing complex nested objects). To be able to obtain all application data, a new cmdlet is defined in this release: Get-XAApplicationReport. The output of this cmdlet can be sent to Export-CliXml to export all application data. Then, the objects obtained by importing this data using Import-CliXml can be sent to New-XAApplication which will publish all the applications in the current farm.

· Split the CommandLine parameter for app publishing into CommandLineExecutable and CommandLineArguments.

· Add option to copy privileges from parent folder to New-XAFolder. Also, add a Copy-XAFolder cmdlet that copies the source folder privileges.

· Sign all binaries with digital signature (Authenticode).