< Back

New-AzureDeployment

Wed Jan 30, 2019 5:48 pm

NAME New-AzureDeployment



SYNOPSIS

Creates a deployment from a service.





SYNTAX

New-AzureDeployment [-ServiceName] <String> [-Package] <String> [-Configuration] <String> [-Slot] <String> [[-Label] <String>] [[-Name] <String>]

[-DoNotStart] [-TreatWarningsAsError] [-ExtensionConfiguration <ExtensionConfigurationInput[]>] [-Profile <AzureSMProfile>] [-InformationAction

<ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]





DESCRIPTION

The New-AzureDeployment cmdlet creates an Azure deployment from a service that comprises web roles and worker roles. This cmdlet creates a deployment

based on a package file (.cspkg) and a service configuration file (.cscfg). Specify a name that is unique within deployment environment.



Use the New-AzureVM cmdlet to create a deployment based on Azure virtual machines.





PARAMETERS

-ServiceName <String>

Specifies the name of the Azure service for the deployment.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Package <String>

Specifies the path or URI of a .cspkg file in storage within the same subscription or project.



Required? true

Position? 1

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Configuration <String>

Specifies the full path of a service configuration file.



Required? true

Position? 2

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Slot <String>

Specifies the environment where this cmdlet creates the deployment. Valid values are: Staging and Production. The default value is Production.



Required? true

Position? 3

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Label <String>

Specifies a label name for the deployment. If you do not specify a label, this cmdlet uses a GUID.



Required? false

Position? 4

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

Specifies a deployment name. If you do not specify a name, this cmdlet uses a GUID.



Required? false

Position? 5

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DoNotStart [<SwitchParameter>]

Specifies that this cmdlet does not start the deployment.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-TreatWarningsAsError [<SwitchParameter>]

Specifies that warning messages are errors. If you specify this parameter, a warning message causes the deployment to fail.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-ExtensionConfiguration <ExtensionConfigurationInput[]>

Specifies an array of extension configuration objects.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Profile <AzureSMProfile>

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InformationAction <ActionPreference>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InformationVariable <String>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



NOTES









-------------------------- Example 1: Create a deployment --------------------------



PS C:\\>New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package

"https://contosostorage.blob.core.window ... kage.cspkg" -Configuration "C:\\packages\\ContosoConfiguration.cscfg" -Label

"ContosoDeployment"



This command creates a production deployment based on a package named ContosoPackage.cspkg and a configuration named ContosoConfiguration.cscfg. The

command specifies a label for the deployment. It does not specify a name. This cmdlet creates a GUID as the name.

-------------------------- Example 2: Create a deployment based on an extension configuration --------------------------



PS C:\\>New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package

"https://contosostorage.blob.core.window ... kage.cspkg" -Configuration "C:\\packages\\ContosoConfiguration.cscfg"

-ExtensionConfiguration "C:\\packages\\ContosoExtensionConfig.cscfg"



This command creates a production deployment based on a package and configuration. The command specifies an extension configuration named

ContosoExtensionConfig.cscfg. This cmdlet creates GUIDs as the name and the label.



RELATED LINKS

Get-AzureDeployment

Get-AzureDeploymentEvent

Remove-AzureDeployment

New-AzureVM

Remove-AzureDeployment

Set-AzureDeployment