Citrix Virtual Apps and Desktops SDK


Creates a new StoreFront address configuration, specifying a single address.


New-BrokerStorefrontAddress -Name <String> -Url <String> -Enabled <Boolean> -Description <String> [<CommonParameters>]


Detailed Description

Use this command when you want to create a new StoreFront configuration byte array from scratch, rather than modifying an existing one. You must define the URL for the StoreFront, and some additional details.

This command does not, by itself, have any persistent effects within XenDesktop. To make the change persistent, the new configuration byte array must first be transformed into a machine configuration within the Citrix Broker Service. To do this, use the New-BrokerMachineConfiguration command. You can then use the Add-BrokerMachineConfiguration and Set-BrokerMachineConfiguration commands to fully associate the new configuration with a delivery group.


Name Description Required? Pipeline Input Default Value
Name Specifies the name of the new StoreFront. true false  
Url Specifies the URL to the StoreFront, such as “”. true false  
Enabled Specifies if the new StoreFront address should be enabled for user access. true false  
Description Specifies a human-readable description of the new StoreFront. true false  

Input Type


Return Values


The new configuration set, with all of the given modifications applied.


Example 1

C:\PS> $configuration = New-BrokerStorefrontAddress -Url "" -Description "This StoreFront delivers my corporate applications" -Name "StoreFront1" -Enabled $true

C:\PS> Get-BrokerStorefrontAddress -ByteArray $configuration

Name               Url                                       Enabled Description

----               ---                                       ------- -----------

StoreFront1           True This StoreFront delivers my corporate applications.



This example shows a new configuration byte array being created to specify a single StoreFront address. The configuration byte array is then provided as input to the Get-BrokerStorefrontAddress command, which interprets and outputs the same fields.