使用此工作，使用 Web Deploy 部署網站或 Web 應用程式。
語法
# IIS web app deploy v0
# Deploy a website or web application using Web Deploy.
- task: IISWebAppDeploymentOnMachineGroup@0
inputs:
WebSiteName: # string. Required. Website Name.
#VirtualApplication: # string. Virtual Application.
Package: '$(System.DefaultWorkingDirectory)\**\*.zip' # string. Required. Package or Folder. Default: $(System.DefaultWorkingDirectory)\**\*.zip.
# Advanced Deployment Options
#SetParametersFile: # string. SetParameters File.
#RemoveAdditionalFilesFlag: false # boolean. Remove Additional Files at Destination. Default: false.
#ExcludeFilesFromAppDataFlag: false # boolean. Exclude Files from the App_Data Folder. Default: false.
#TakeAppOfflineFlag: false # boolean. Take App Offline. Default: false.
#AdditionalArguments: # string. Additional Arguments.
# File Transforms & Variable Substitution Options
#XmlTransformation: false # boolean. XML transformation. Default: false.
#XmlVariableSubstitution: false # boolean. XML variable substitution. Default: false.
#JSONFiles: # string. JSON variable substitution.
輸入
WebSiteName
-
網站名稱
string。 必須的。
指定計算機群組機器上現有網站的名稱。
VirtualApplication
-
虛擬應用程式
string。
指定目標機器上已存在的 Azure 虛擬應用程式名稱。
Package
-
套件或資料夾
string。 必須的。 預設值：$(System.DefaultWorkingDirectory)\**\*.zip。
指定 MSBuild 或壓縮封存盤案所產生的封裝或資料夾檔案路徑。 支援變數（組建 | 版本）和通配符。 例如： $(System.DefaultWorkingDirectory)\**\*.zip 。
SetParametersFile
-
SetParameters 檔案
string。
選擇性。 指定要使用之 SetParameters.xml 檔案的位置。
RemoveAdditionalFilesFlag
-
在目的地 移除其他檔案
boolean。 預設值：false。
選取選項可刪除 Web 應用程式上沒有相符檔案的 Web 應用程式 zip 套件中的檔案。
ExcludeFilesFromAppDataFlag
-
從 App_Data 資料夾排除檔案
boolean。 預設值：false。
選取選項以防止 App_Data 資料夾中的檔案部署至 Web 應用程式。
TakeAppOfflineFlag
-
讓應用程式離線
boolean。 預設值：false。
選取讓 Web 應用程式離線的選項，方法是在同步作業開始之前，將 app_offline.htm 檔案放在 Web 應用程式的根目錄中。 同步作業成功完成之後，將會移除檔案。
AdditionalArguments
-
其他自變數
string。
指定部署 Azure Web 應用程式時所套用的其他 Web Deploy 自變數。 例如，-disableLink:AppPoolExtension 或 -disableLink:ContentExtension。
如需 Web Deploy 自變數的清單，請參閱 Web Deploy 作業設定。
XmlTransformation
-
XML 轉換
boolean。 預設值：false。
指定在 *.config file上針對 *.Release.config 和 *.<EnvironmentName>.config 執行的組態轉換。 組態轉換會在變數替代之前執行。 只有在 Windows 上才支援 XML 轉換。
XmlVariableSubstitution
-
XML 變數替代
boolean。 預設值：false。
指定建置或發行管線中定義的變數。 這些變數會與 appSettings、applicationSettings 和 connectionStrings 區段中的 key 或 name 項目進行比對，並 parameters.xml。 變數替代會在組態轉換之後執行。
注意： 如果發行管線和環境中定義了相同的變數，則環境變數將會取代發行管線變數。
JSONFiles
-
JSON 變數替代
string。
指定 JSON 檔案的新行分隔清單，以取代變數值。 檔名必須相對於根資料夾。
若要取代巢狀或階層式的 JSON 變數，請使用 JSONPath 運算式加以指定。 例如，若要取代下列範例中的 ConnectionString 值，您必須在組建或發行管線中將變數定義為 Data.DefaultConnection.ConnectionString（或在發行管線的階段）。
{
"Data": {
"DefaultConnection": {
"ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
}
}
}
變數替代會在組態轉換之後執行。
注意： 管線變數在替代中排除。
工作控制選項
除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。
輸出變數
沒有。
備註
使用此工作，使用 WebDeploy 部署網站或 Web 應用程式。
需求
| 要求 | 說明 |
|---|---|
| 管線類型 | 傳統版本 |
| 執行於 | Agent、DeploymentGroup |
| 需求 | 沒有 |
| 功能 | 此工作不符合作業中後續工作的任何需求。 |
| 命令限制 | 任意 |
| Settable 變數 | 任意 |
| 代理程式版本 | 2.104.1 或更高版本 |
| 工作類別 | 部署 |