Publish-AzureServiceProject
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
Publish-AzureServiceProject
Publish the current service to Windows Azure.
Parameter Set: Default
Publish-AzureServiceProject [-AffinityGroup <String> ] [-Force] [-Launch] [-Location <String> ] [-ServiceName <String> ] [-Slot <String> ] [-StorageAccountName <String> ] [-Subscription <String> ] [-TimeoutSeconds <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
This topic describes the cmdlet in the .6.19 version of the Windows Azure PowerShell module. To find out the version of the module you're using, from the Windows Azure PowerShell console, type (get-module azure).version.
The Publish-AzureServiceProject cmdlet publishes the current service to the cloud. You can specify publishing configuration (such as Subscription, StorageAccountName, Location, Slot) on the command line, or in local settings through the Set-AzureServiceProject cmdlet.
-AffinityGroup<String>
Specifies the affinity group that you want the service to use.
Aliases |
ag |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Force
Publishes the service without prompting for confirmation.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Launch
Opens a browser window so you can view the application after it is deployed.
Aliases |
ln |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Location<String>
The region in which the application will be hosted. Possible values are: Anywhere Asia, Anywhere Europe, Anywhere US, East Asia, East US, North Central US, North Europe, South Central US, Southeast Asia, West Europe, West US. If no Location is specified, the location specified in the last call to Set-AzureServiceProject will be used. If no Location was ever specified, the Location will be randomly chosen from 'North Central US' and 'South Central US' locations.
Aliases |
l |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ServiceName<String>
Specifies the name to be used for the service when publishing to Windows Azure. The name determines part of the label in the cloudapp.net subdomain that is used to address the service when hosted in Windows Azure (that is, name.cloudapp.net). Any name specified while publishing the service overrides the name given when the service was created. (See the New-AzureServiceProject cmdlet).
Aliases |
sv |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Slot<String>
The deployment slot to be used for this service. Possible values are 'Staging' and 'Production'. If no slot is specified, the slot provided in the last call to Set-AzureDeploymentSlot is used. If no slot has ever been specified, the 'Production' slot is used.
Aliases |
sl |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-StorageAccountName<String>
Specifies the Windows Azure storage account name to be used while publishing the service. This value is not used until the service is published. When this parameter is not specified, the value is obtained from the last Set-AzureServiceProject command. If no storage account was ever specified, a storage account matching the name of the service will be used. If no such storage account exists, the cmdlet attempts to create a new one. However, the attempt may fail if a storage account matching the service name exists in another subscription.
Aliases |
st |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Subscription<String>
Specifies the Windows Azure subscription name to be used while deploying this service. When this parameter is not specified, the value is obtained from the last Set-AzureServiceProject command issued for this service. If no subscription has ever been specified, the value defaults to the first subscription listed in the current Windows Azure publish profile.
Aliases |
sn |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-TimeoutSeconds<Int32>
Specifies the timeout for service deployment operations, in seconds.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Publish a service project with default values
This example publishes the current service, using the current service settings and the current Azure publish profile.
PS C:\> Publish-AzureServiceProject
Create a deployment package
Creates a deployment package (.cspkg) file in the service directory and does not publish to Windows Azure.
PS C:\> Publish-AzureServiceProject -PackageOnly