New-BrokerStorefrontAddress
Creates a new StoreFront address configuration, specifying a single address.
Syntax
New-BrokerStorefrontAddress
-Name <String>
-Url <String>
-Enabled <Boolean>
-Description <String>
[<CommonParameters>]
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.
Examples
EXAMPLE 1
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.
$configuration = New-BrokerStorefrontAddress -Url "https://mysite.com/Citrix/StoreWeb" -Description "This StoreFront delivers my corporate applications" -Name "StoreFront1" -Enabled $true
Get-BrokerStorefrontAddress -ByteArray $configuration
Name Url Enabled Description
---- --- ------- -----------
StoreFront1 https://mysite.com/Citrix/StoreWeb True This StoreFront delivers my corporate applications.
Parameters
-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
None
You can't pipe objects to this cmdlet.
Outputs
\[\]
The new configuration set, with all of the given modifications applied.