你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

New-AzureDeployment

从服务创建部署。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时,建议不要使用旧的 PowerShell 模块,因为计划将停用 ASM。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

重要

新客户的云服务(经典版)现已弃用,并将于 2024 年 8 月 31 日对所有客户停用。 新部署应使用基于 Azure 资源管理器 的新部署模型 Azure 云服务(扩展支持)。

语法

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>]

说明

New-AzureDeployment cmdlet 从包含 Web 角色和辅助角色的服务创建 Azure 部署。 此 cmdlet 基于包文件(.cspkg)和服务配置文件(.cscfg)创建部署。 指定部署环境中唯一的名称。

使用 New-AzureVM cmdlet 基于 Azure 虚拟机创建部署。

示例

示例 1:创建部署

PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -Label "ContosoDeployment"

此命令基于名为 ContosoPackage.cspkg 的包和名为 ContosoConfiguration.cscfg 的配置创建生产部署。 该命令指定部署的标签。 它不指定名称。 此 cmdlet 创建 GUID 作为名称。

示例 2:基于扩展配置创建部署

PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -ExtensionConfiguration "C:\packages\ContosoExtensionConfig.cscfg"

此命令基于包和配置创建生产部署。 该命令指定名为 ContosoExtensionConfig.cscfg 的扩展配置。 此 cmdlet 创建 GUID 作为名称和标签。

参数

-Configuration

指定服务配置文件的完整路径。

类型:String
Position:2
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-DoNotStart

指定此 cmdlet 不启动部署。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ExtensionConfiguration

指定扩展配置对象的数组。

类型:ExtensionConfigurationInput[]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为:

  • 继续
  • 忽略
  • 询问
  • SilentlyContinue
  • 停止
  • Suspend
类型:ActionPreference
别名:infa
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InformationVariable

指定信息变量。

类型:String
别名:iv
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Label

指定部署的标签名称。 如果未指定标签,则此 cmdlet 使用 GUID。

类型:String
Position:4
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定部署名称。 如果未指定名称,则此 cmdlet 使用 GUID。

类型:String
别名:DeploymentName
Position:5
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Package

指定同一订阅或项目中存储中 .cspkg 文件的路径或 URI。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ServiceName

指定部署的 Azure 服务的名称。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Slot

指定此 cmdlet 创建部署的环境。 有效值为:过渡和生产。 默认值为“生产”。

类型:String
Position:3
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-TreatWarningsAsError

指定警告消息是错误。 如果指定此参数,则警告消息会导致部署失败。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False