共用方式為

Set-AzureDeployment

  • 參考
模組:
Azure

修改部署的狀態、組態設定或升級模式。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。

重要

針對新客戶目前已取代 Azure 雲端服務 (傳統)，而針對所有客戶，該服務將從 2024 年 8 月 31 日起完全淘汰。 新部署應該使用 Azure Resource Manager 型的新部署模型 Azure 雲端服務 (延伸支援)。

語法

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 修改部署的組態。

類型:SwitchParameter
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Configuration

指定 .cscfg 組態檔的完整路徑。 您可以指定升級或組態變更的組態檔。

類型:String
Position:3
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ExtensionConfiguration

指定擴充組態物件的陣列。

類型:ExtensionConfigurationInput[]
Position:9
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Force

表示 Cmdlet 會執行強制升級。

類型:SwitchParameter
Position:8
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InformationAction

指定此 Cmdlet 如何回應資訊事件。

此參數可接受的值為：

  • 繼續
  • 忽略
  • 詢問
  • SilentlyContinue
  • 停止
  • 暫止
類型:ActionPreference
別名:infa
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InformationVariable

指定資訊變數。

類型:String
別名:iv
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Label

指定已升級部署的標籤。

類型:String
Position:6
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Mode

指定升級模式。 有效值為：

  • 自動
  • 手動
  • 同時
類型:String
Position:5
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-NewStatus

指定部署的目標狀態。 有效值為：執行中和暫止。

類型:String
Position:3
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Package

指定升級套件檔案的完整路徑。

類型:String
Position:2
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。

類型:AzureSMProfile
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RoleName

指定要升級的角色名稱。

類型:String
Position:7
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ServiceName

指定部署的 Azure 服務名稱。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Slot

指定要修改之部署的環境。 有效值為：生產與預備。

類型:String
Position:4
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Status

指定此 Cmdlet 會變更部署的狀態。

類型:SwitchParameter
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Upgrade

指定此 Cmdlet 升級部署。

類型:SwitchParameter
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False