< Back
New-AzureDeployment
Post
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
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