New-AzureDeployment
從服務建立部署。
注意
本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet,請參閱 Az PowerShell 模組 。
重要
雲端服務(傳統版)現已淘汰給新客戶,將于 2024 年 8 月 31 日淘汰所有客戶。 新的部署應該使用新的 Azure Resource Manager 型部署模型 Azure 雲端服務(延伸支援)。
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
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
指定服務組態檔的完整路徑。
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DoNotStart
指定此 Cmdlet 不會啟動部署。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtensionConfiguration
指定擴充組態物件的陣列。
Type: | ExtensionConfigurationInput[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
指定此 Cmdlet 如何回應資訊事件。
此參數可接受的值為:
- 繼續
- 忽略
- 詢問
- SilentlyContinue
- 停止
- 暫止
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
指定資訊變數。
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
指定部署的標籤名稱。 如果您未指定標籤,此 Cmdlet 會使用 GUID。
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定部署名稱。 如果您未指定名稱,此 Cmdlet 會使用 GUID。
Type: | String |
Aliases: | DeploymentName |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Package
指定相同訂用帳戶或專案內儲存體中 .cspkg 檔案的路徑或 URI。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔,此 Cmdlet 會從本機預設設定檔讀取。
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceName
指定部署的 Azure 服務名稱。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Slot
指定此 Cmdlet 建立部署的環境。 有效值為:預備和生產環境。 預設值為 [生產]。
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TreatWarningsAsError
指定警告訊息為錯誤。 如果您指定此參數,警告訊息會導致部署失敗。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |