你当前正在访问 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 |