你当前正在访问 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 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

重要

新客户的云服务(经典版)现已弃用,并将于 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