Set-AzureDeployment
修改部署的狀態、組態設定或升級模式。
注意
本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet，請參閱 Az PowerShell 模組 。
重要
雲端服務（傳統版）現已淘汰給新客戶，將于 2024 年 8 月 31 日淘汰所有客戶。 新的部署應該使用新的 Azure Resource Manager 型部署模型 Azure 雲端服務（延伸支援）。
Syntax
Set-AzureDeployment
[-Upgrade]
[-ServiceName] <String>
[-Package] <String>
[-Configuration] <String>
[-Slot] <String>
[[-Mode] <String>]
[[-Label] <String>]
[[-RoleName] <String>]
[-Force]
[[-ExtensionConfiguration] <ExtensionConfigurationInput[]>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureDeployment
[-Config]
[-ServiceName] <String>
[-Configuration] <String>
[-Slot] <String>
[[-ExtensionConfiguration] <ExtensionConfigurationInput[]>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureDeployment
[-Status]
[-ServiceName] <String>
[-Slot] <String>
[-NewStatus] <String>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Description
Set-AzureDeployment Cmdlet 會修改 Azure 部署的狀態、組態設定或升級模式。 您可以將部署的狀態變更為 [執行中] 或 [已暫止]。 您可以變更部署的 .cscfg 檔案。 您可以設定升級模式和更新組態檔。 使用 Set-AzureWalkUpgradeDomain Cmdlet 來起始升級。
範例
範例 1：變更部署的狀態
PS C:\> Set-AzureDeployment -Status -ServiceName "ContosoService" -Slot "Production" -NewStatus "Running"此命令會將生產環境中名為 ContosoService 的服務部署狀態設定為 [執行中]。
範例 2：將不同的組態檔指派給部署
PS C:\> Set-AzureDeployment -Config -ServiceName "ContosoService" -Slot "Staging" -Configuration "C:\Temp\MyServiceConfig.Cloud.csfg"此命令會為預備環境中名為 ContosoService 的服務部署指派不同的組態檔。
範例 3：將升級模式設定為 [自動]
PS C:\> Set-AzureDeployment -Upgrade -ServiceName "ContosoService" -Mode Auto -Package "C:\packages\ContosoApp.cspkg" -Configuration "C:\Config\ContosoServiceConfig.Cloud.csfg"此命令會將升級模式設定為 Auto，並指定升級套件和新的組態檔。
範例 4：在服務中安裝擴充功能組態
PS C:\> Set-AzureDeployment -Config -ServiceName "ContosoService" -Mode "Automatic" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -Slot "Production" -ExtensionConfiguration "C:\packages\ContosoExtensionConfig.cscfg"此命令會在指定的雲端服務中安裝擴充功能組態，並將其套用至角色。
參數
-Config
指定此 Cmdlet 修改部署的組態。
| Type: | SwitchParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Configuration
指定 .cscfg 組態檔的完整路徑。 您可以指定升級或組態變更的組態檔。
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExtensionConfiguration
指定擴充組態物件的陣列。
| Type: | ExtensionConfigurationInput[] |
| Position: | 9 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
表示 Cmdlet 會執行強制升級。
| Type: | SwitchParameter |
| Position: | 8 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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
指定已升級部署的標籤。
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Mode
指定升級模式。 有效值為：
- 自動
- 手動
- 同時
| Type: | String |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewStatus
指定部署的目標狀態。 有效值為：執行中和暫止。
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Package
指定升級套件檔案的完整路徑。
| Type: | String |
| Position: | 2 |
| 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 |
-RoleName
指定要升級的角色名稱。
| Type: | String |
| Position: | 7 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServiceName
指定部署的 Azure 服務名稱。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Slot
指定要修改之部署的環境。 有效值為：生產與預備。
| Type: | String |
| Position: | 4 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Status
指定此 Cmdlet 會變更部署的狀態。
| Type: | SwitchParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Upgrade
指定此 Cmdlet 升級部署。
| Type: | SwitchParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |