Citrix Virtual Apps and Desktops SDK

Add-BrokerStorefrontAddress

August 9, 2024

Contributed by:

Introduced in: Citrix Virtual Apps and Desktop 7 2112

Modifies a StoreFront address configuration by adding an additional StoreFront address to it.

Syntax

Add-BrokerStorefrontAddress
   [-ByteArray] <Byte[]>
   -Name <String>
   -Url <String>
   -Enabled <Boolean>
   -Description <String>
   [<CommonParameters>]
<!--NeedCopy-->

Description

Use this command to transform an existing StoreFront configuration into a new configuration, where the new configuration contains one additional address. The original configuration is supplied as an input, along with the properties of the new StoreFront address being added. The cmdlet outputs the modified configuration, which can then be passed to the Citrix Broker Service using the Add-BrokerMachineConfiguration command.

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.

Examples

EXAMPLE 1

This command transforms the configuration byte array specified by $originalConfiguration, adds the new StoreFront details, and stores the resulting configuration in $newConfiguration.

$newConfiguration = Add-BrokerStorefrontAddress -ByteArray $originalConfiguration -Url "https://mysite.com/Citrix/StoreWeb" -Description "This StoreFront delivers my corporate applications" -Name "StoreFront1" -Enabled $true
<!--NeedCopy-->

Parameters

-ByteArray

Specifies the initial configuration, on which the new configuration is based. All of the addresses in the original configuration are also present in the new configuration, along with the additional address specified. This configuration byte array is obtained from an earlier call to New-BrokerStorefrontAddress, or from Get-BrokerMachineConfiguration.

Type:	Byte[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True (ByValue)
Accept wildcard characters:	False

-Name

Specifies the name of the new StoreFront.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Url

Specifies the URL to the StoreFront, such as “https://mysite.com/Citrix/StoreWeb”.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Enabled

Specifies if the new StoreFront address should be enabled for user access.

Type:	Boolean
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Specifies a human-readable description of the new StoreFront.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Byte[]

This cmdlet accepts configurations as pipeline input, as an alternative to supplying the ByteArray parameter.

Outputs

Byte[]

This cmdlet outputs the new, modified configuration. This differs from the original configuration in that it contains the additional StoreFront address.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Add-BrokerStorefrontAddress

August 9, 2024

Contributed by:

August 9, 2024

Contributed by:

Add-BrokerStorefrontAddress

Syntax

Description

Examples

EXAMPLE 1

Parameters

-ByteArray

-Name

-Url

-Enabled

-Description

CommonParameters

Inputs

Byte[]

Outputs

Byte[]

Related Links

In this article