發行動作以部署適用於 Release Management 的應用程式

您可以加入發行動作以定義每個發行階段的部署序列。 每個動作都會使用特定的工具，搭配一組引數執行命令。

如果您尚未建立版本的路徑，請移至 這裡 這麼做。

從工具箱中拖曳發行動作，將它加入至您的部署序列。 使用工具箱中所列的任何預先定義發行動作，或建立您自己的自訂發行動作。

將發行動作加入至序列之後，您就可以視需要編輯組態變數。 如需預先定義之發行動作及其組態變數的詳細資訊，請移至這裡。 了解版本動作 這裡所使用的工具。

加入自訂發行動作

您可以加入新的發行動作並且選擇想要讓這個動作使用的工具。 或者，您也可以複製現有的動作並且使用該動作做為建立自訂發行動作的基礎。 您無法編輯現有的發行動作。

1. 在 Release Management 用戶端中，開啟 [詳細目錄] 頁面 (如果沒有出現此頁面，請要求 [可管理詳細目錄] 權限)。

2. 複製您想要編輯的動作，或加入新的動作。

   

3. 根據動作的需求，選取您想要使用的工具。 如果預先定義的工具無法針對部署序列中的該步驟完成您所需的動作，請選擇 [新增] 以加入您的自訂工具。

4. 在 [執行] 區段中，以必要的格式輸入任何必要的引數及其語彙基元。 您必須將這個前置字元和後置字元加入至每個參數：__。 每當您刪除或加入引數及其語彙基元時，它們就會顯示在 [參數] 清單中。

   例如，假設您加入下列引數及語彙基元：-servername __servername__ -switch __onoff__。 現在，servername 和 onoff 就會顯示在參數清單中。

若要停用發行動作

• 如果有一些您不想要讓小組使用的動作，請停用這些動作。 從 [詳細目錄] 頁面開啟動作，並且選擇 [停用] 按鈕。

若要重新啟用發行動作

• 開啟 [非現用] 清單、開啟動作，然後選擇 [啟用]。

  

Q & A

問：我需要哪些權限才能編輯發行動作？

**答：**使用者必須擁有 [可管理詳細目錄] 權限，才能編輯或加入發行動作。 如果沒有啟用此權限，就不會顯示 [詳細目錄] 頁面。

選取 [沒有工具] 選項時，除非您擁有 [可在動作和元件中使用自訂工具] 權限，否則無法編輯 [命令] 和 [引數] 欄位。 在 [設定應用程式]、[元件] 中，當使用者沒有 [可在動作和元件中使用自訂工具] 權限時，如果選取了 [沒有工具] 選項，就無法編輯 [命令] 和 [引數] 欄位。

發行動作的動作和組態變數

• 管理應用程式集區和網站

• 建立或修改 .ini 檔案

• 管理 SQL Server 資料庫

• 設定您的伺服器

• 管理 Windows 服務

管理應用程式集區和網站

這些動作會使用預先定義的 IIS Deployer 工具來管理應用程式集區、網站、Web 應用程式和虛擬目錄。 IIS 7.0、7.5、8.0 和 8.5 都支援這些動作。 如需這個工具的詳細資訊，請移至 這裡。

動作	使用方式和部署失敗狀況
建立應用程式集區 設定應用程式集區 回收應用程式集區 移除應用程式集區 啟動應用程式集區 停止應用程式集區	建立應用程式集區：這個動作會在 IIS 底下建立新的應用程式集區。 對於 IIS 7.0、7.5、8.0 和 8.5，如果應用程式集區已經存在，它將重新設定為符合已定義的組態變數值 (未定義的組態變數將不會影響應用程式集區的實際組態)。 在 7.0 版以前的 IIS 底下，如果應用程式集區已經存在，部署將會失敗。 設定應用程式集區、回收應用程式集區、啟動應用程式集區或停止應用程式集區：這些動作將會重新設定、回收、啟動或停止應用程式集區。 如果應用程式集區不存在，部署就會失敗。
建立網站 設定網站 移除網站 啟動網站 停止網站	建立網站：在 IIS 底下建立新的網站。 對於 IIS 7.0、7.5、8.0 和 8.5。 如果網站已經存在，它將重新設定為符合已定義的組態變數值 (未定義的組態變數將不會影響網站的實際組態)。 在 7.0 版以前的 IIS 底下，如果應用程式集區已經存在，部署將會失敗。 設定網站、重新啟動網站、啟動網站、停止網站：這些動作將會重新設定、重新啟動、啟動或停止網站。 如果網站不存在，部署就會失敗。
建立 Web 應用程式 設定 Web 應用程式 移除 Web 應用程式	建立 Web 應用程式：在 IIS 底下建立新的 Web 應用程式。 對於 IIS 7.0、7.5、8.0 和 8.5。 如果 Web 應用程式已經存在，它將重新設定為符合已定義的組態變數值 (未定義的組態變數將不會影響 Web 應用程式的實際組態)。 在 7.0 版以前的 IIS 底下，如果應用程式集區已經存在，部署將會失敗。 [設定 Web 應用程式] 將重新設定 Web 應用程式。 如果 Web 應用程式不存在，部署就會失敗。
建立虛擬目錄 設定虛擬目錄 移除虛擬目錄	建立虛擬目錄：在 IIS 底下建立虛擬目錄。 對於 IIS 7.0、7.5、8.0 和 8.5。 如果虛擬目錄已經存在，它將重新設定為符合已定義的組態變數值 (未定義的組態變數將不會影響虛擬目錄的實際組態)。 [設定虛擬目錄] 將重新設定虛擬目錄。 如果虛擬目錄不存在，部署就會失敗。

組態變數

參數	必要項	說明
AppPoolName	是 [應用程式集區動作] 否 [網站動作]	要設定、建立、回收、移除、啟動或停止的應用程式集區名稱。[應用程式集區動作] 要用於新的或修改後網站的應用程式集區名稱。[網站動作]
DotNetVersion	沒有	要用於應用程式集區的 .NET Framework 版本。 此參數僅適用於 IIS 7.5、8.0 和 8.5。 允許的值包括：v1.0、v1.1、v2.0 或 v4.0。
IdentityUserDomain	沒有	要當做應用程式集區之識別使用的使用者網域。 如果未定義此參數而定義 “IdentityUserName”，使用者就會被視為本機使用者 (亦即 .\localuser)。
IdentityUserName	沒有	要當做應用程式集區之識別使用的使用者名稱。 如果未定義此參數，就會忽略 IdentityUserDomain 和 IdentityUserPassword 參數，並且使用 IIS 的預設值 (亦即 ApplicationPoolIdentity)。
IdentityUserPassword	沒有	要當做應用程式集區之識別使用的使用者密碼。
Is32BitsAllowed	沒有	是否允許 32 位元應用程式在應用程式集區中執行的旗標。 允許的值如下： 1 或 True：允許 32 位元應用程式 0 或 False：不允許 32 位元應用程式
IsAutoStart	沒有	指出應用程式集區或網站是否應該在 Windows 啟動時自動啟動的旗標。允許的值如下： 1 或 True：在 Windows 啟動時自動啟動應用程式集區或網站。 0 或 False：不要在 Windows 啟動時自動啟動應用程式集區或網站。
IsPreloadEnabled	沒有	指出網站或 Web 應用程式是否啟用預先載入功能的旗標。 允許的值如下： 1 或 True：啟用預先載入。 0 或 False：停用預先載入。
PhysicalPath	是 [建立動作] 否 [所有其他虛擬目錄、網站和 Web 應用程式動作]	虛擬目錄、網站或 Web 應用程式的完整實體路徑。
PipeLineMode	沒有	要用於應用程式集區的 Managed 管線模式。 允許的值如下： Classic Integrated
PortNumber	是 [僅限建立動作]	要用於新的或修改後網站的通訊埠編號。
ProcessIdleTimeOut	沒有	處理序可以在應用程式集區中閒置的分鐘數。
RecycleAfterMinutes	沒有	回收應用程式集區之前經過的固定分鐘數。
RecycleFixedTime	沒有	回收應用程式集區的固定時間。 必要的格式為 HH:MM，例如 23:58 或 01:23。
RecycleKbMemory	沒有	回收應用程式集區之前要使用的記憶體 KB 數目上限。
SiteName	是 [網站動作] 否 [虛擬目錄動作]	要建立、設定、移除、啟動或停止的網站名稱。[網站動作] 虛擬目錄所在的網站名稱。 如果未定義此參數，就會使用預設網站。[虛擬目錄動作]
StartMode	沒有	要用於應用程式集區的啟動模式。 允許的值如下： OnDemand AlwaysRunning
VirtualDirectoryName	有	要建立、設定或移除的虛擬目錄名稱。
WebApplicationName	沒有	虛擬目錄所在的 Web 應用程式名稱。 如果未定義此參數，就會使用網站的根 Web 應用程式。
WebAppName	有	要設定、建立或移除的 Web 應用程式名稱。
WebSiteName	是 [網站動作] 否 [Web 應用程式動作]	要設定、建立、移除、啟動或停止的網站名稱。[網站動作] Web 應用程式所在的網站名稱。 如果未定義此參數，就會使用預設網站。[Web 應用程式動作]

建立或修改 .ini 檔案

這些 .ini 檔案動作會使用 [INI 檔案管理員] 工具，在檔案中加入、修改或移除區段和機碼。 如需這個工具的詳細資訊，請移至 這裡。

動作	說明
建立機碼	在 .ini 檔案的特定區段中建立包含值的新機碼。 如果指定的檔案不存在，該動作就會建立檔案。 如果指定的區段不存在，該動作就會建立區段。 如果機碼已經存在指定的區段中，該動作就會取代其值。
修改機碼	在 .ini 檔案的特定區段中，使用新的值來修改現有的機碼。 如果指定的檔案不存在，該動作就會建立檔案。 如果指定的區段不存在，該動作就會建立區段。 如果機碼已經存在指定的區段中，該動作就會加入其值。
修改值	在 .ini 檔案的特定區段中修改現有機碼的值。 如果指定的檔案不存在，該動作就會建立檔案。 如果指定的區段不存在，該動作就會建立區段。 如果機碼不存在指定的區段中，該動作就會加入其值。
移除機碼	從 .ini 檔案的特定區段中移除機碼及其值。 如果指定的檔案不存在，該動作就會失敗。 如果指定的區段或機碼不存在，該動作仍然會成功。如果您指定要移除區段中的所有機碼，該動作也會一併移除區段。
修改區段	變更 .ini 檔案中區段的名稱。 如果指定的檔案不存在，該動作就會建立檔案。 如果指定的區段不存在，該動作仍然會成功。
移除區段	移除 .ini 檔案中的區段及其所有機碼和值。 如果指定的檔案不存在，該動作就會失敗。 如果指定的區段不存在，該動作仍然會成功。

組態變數

參數	必要項	說明
INIFile	有	要修改之 .ini 檔案的名稱和路徑 (視需要)。
KeyName	有	要建立、修改或移除的機碼名稱。
KeyValue	沒有	要指派給機碼的新值。 如果未指定此參數，而指定了 NewKeyName，系統將會使用實際值。 如果未指定此參數，而且未指定 NewKeyName，就會清空其值。
NewKeyName	沒有	要指派給機碼的新名稱。 如果未指定，將不會變更機碼名稱。
NewSectionName	沒有	要指派給區段名稱的新名稱。 如果未指定，舊區段的機碼將會放在根區段底下 (在第一個區段前位於檔案開頭的所有機碼會被視為位於根區段)。
SectionName	沒有	[建立或修改機碼動作] 要加入或修改機碼的區段名稱。 如果未指定此參數，該動作就會更新根區段。 注意事項 在第一個區段前位於檔案開頭的所有機碼會被視為位於根區段。 [重新命名動作] 要重新命名的區段名稱。 如果未指定此參數，舊區段的機碼就會放在根區段底下。 [移除動作] 要移除的區段名稱。 如果未指定此參數，就會移除根區段。

管理 SQL Server 資料庫

這些動作會使用 [資料庫部署器 - 執行指令碼] 工具來建立、刪除、備份和還原 SQL Server 資料庫。 如需這個工具的詳細資訊，請移至 這裡。

動作	說明
建立 SQL 資料庫	建立新的資料庫。 如果資料庫已經存在，該動作就會失敗。
卸除 SQL 資料庫	刪除資料庫。 如果資料庫不存在，該動作就會失敗。
備份 SQL 資料庫	將現有的資料庫備份到指定的路徑。
還原 SQL 資料庫	從指定的來源還原資料庫。

組態變數

參數	必要項	說明
DatabaseName	有	要建立、卸除、備份或還原的 SQL Server 資料庫名稱。
Path	有	要用來儲存資料庫備份的路徑和檔案名稱。 例如 \\server\filename.bak。
ServerName	有	要建立、備份、還原或卸除之 SQL 資料庫的伺服器名稱。
Source	有	要用來還原資料庫之資料庫備份的路徑和檔案名稱。

設定您的伺服器

如果您的伺服器電腦執行任何 Windows 作業系統，這些動作就可用來設定伺服器電腦。 您可以執行命令和終止處理序，以及管理檔案、資料夾、環境變數和 Windows 登錄機碼與值。 系統會使用許多預先定義的 Release Management 工具來執行這些動作，包括 [命令列執行器]、[Windows 處理序] 和 [XCOPY 部署器]。 如需這些工具的詳細資訊，請移至 這裡。

動作	注意事項和部署失敗狀況
執行命令列 以使用者身分執行命令列 終止 Windows 處理序	使用 [執行命令列] 可以使用部署代理程式識別來執行命令。 使用 [以使用者身分執行命令列] 可以使用特定使用者認證來執行命令。
複製檔案或資料夾 建立資料夾 刪除檔案或資料夾 移動檔案或資料夾 重新命名檔案或資料夾 修改檔案或資料夾屬性 修改檔案或資料夾擁有者	這些動作支援建立、修改和刪除檔案、資料夾以及選取屬性。 當您建立檔案或資料夾時，如果要建立之資料夾的任何父目錄不存在，將會一併建立這些目錄。
建立環境變數 修改環境變數 刪除環境變數	這些動作支援建立、修改和刪除環境變數。
建立 Windows 登錄機碼 刪除 Windows 登錄機碼 修改 Windows 登錄機碼 建立 Windows 登錄值 刪除 Windows 登錄值 修改 Windows 登錄值	這些動作支援建立、修改和刪除登錄機碼與值。 只有當您嘗試修改不存在的登錄機碼時，部署序列才會失敗。

要執行命令或終止處理序的組態變數

參數	必要項	說明
Arguments	沒有	執行命令列所需的引數。
command	有	固定值 ./WindowsProcess.ps1。
FilePath	沒有	要當做應用程式集區之識別使用的使用者網域。 如果未定義此參數而定義 IdentityUserName，使用者就會被視為本機使用者 (亦即 .\localuser)。
IsKillProcessTree	沒有	指出是否要終止處理序樹狀結構。 允許的值如下： 1：終止處理序樹狀結構。 0 (或空白)：不要終止處理序樹狀結構。
ProcessName	有	要終止的 Windows 處理序名稱。
UserDomain	沒有	要用來執行可執行檔之使用者的網域。 未指定此參數時，就會指派 .\localuser。
UserName	是 [執行命令動作] 否 [終止處理序動作]	要用來執行可執行檔之使用者的名稱。 執行處理序的使用者帳戶。 如果未指定，就會終止所有使用者的處理序。
UserPassword	沒有	要用來執行可執行檔之使用者的密碼。

要管理檔案和資料夾的組態變數

參數	必要項	說明
Archive	沒有	設定或重設檔案或資料夾的封存屬性。 +：設定旗標。 -：重設旗標。 任何其他值：保留目前的旗標值。
DestinationFileFolder		要用於應用程式集區的 .NET Framework 版本。 此參數僅適用於 IIS 7.5、8.0 和 8.5。 允許的值包括：v1.0、v1.1、v2.0 或 v4.0。
DestinationName	有	要複製或移動檔案或資料夾的目的地路徑。 或者，要提供給重新命名之檔案或資料夾的新名稱。
FileFolderName	有	要刪除、修改、移動或重新命名的來源檔案或資料夾。 若為刪除動作，您可以使用萬用字元，例如 c:、temp 或 *.log。
FolderName	有	要建立的資料夾名稱和路徑。
Hidden	沒有	設定或重設檔案或資料夾的隱藏屬性。 +：設定旗標。 -：重設旗標。 任何其他值：保留目前的旗標值。
OwnerDomain	沒有	檔案或資料夾之新擁有者的網域。 未指定此參數時，就會指派 .\localuser。
OwnerDomain	有	檔案或資料夾之新擁有者的名稱。
ReadOnly		設定或重設檔案或資料夾的唯讀屬性。 +：設定旗標。 -：重設旗標。 任何其他值：保留目前的旗標值。
SourceFileFolder	有	要複製的來源檔案或資料夾。 您可以使用萬用字元，例如 c:、temp 或 *.log。
System		設定或重設檔案或資料夾的系統屬性。 +：設定旗標。 -：重設旗標。 任何其他值：保留目前的旗標值。

環境變數動作的組態變數

參數	必要項	說明
VariableName	有	要建立、修改或刪除的變數名稱。
VariableValue	沒有	要提供給加入或修改之變數的值。 如果沒有設定任何值，將會刪除變數。

Windows 登錄動作的組態變數

參數	必要項	說明
NewRegistryKey	有	目的地登錄機碼的完整名稱，例如 HKLM、Software 或 NEWKEY。
OperatingSystemType	沒有	要在其中建立登錄機碼的作業系統類型。 允許的值如下： 32：(預設值) 建立 32 位元登錄機碼。 64：建立 64 位元登錄機碼。
RegistryData	沒有	要影響登錄值的資料。
RegistryKey	有	要建立、修改或刪除之登錄機碼的完整名稱。 例如 HKLM、Software 或 NEWKEY。
RegistryValue	有	要加入或修改之登錄值的名稱。
ValueType	沒有	登錄值的資料類型。 允許的值如下： REG_SZ：(預設值)：字串。 REG_QWORD_LITTLE_ENDIAN：採用位元組由小到大格式的 64 位元數字。 REG_QWORD：64 位元數字。 REG_NONE：沒有值。 REG_MULTI_SZ：多行字串 (以 \0 分隔)。 REG_LINK：符號連結。 REG_EXPAND_SZ：字串，其中包含未展開的環境變數參考。 REG_DWORD_BIG_ENDIAN：採用位元組由小到大格式的 32 位元數字。 REG_DWORD_LITTLE_ENDIAN：採用位元組由大到小格式的 32 位元數字。 REG_DWORD：32 位元數字。 REG_BINARY：任何形式的二進位資料。

管理 Windows 服務

這些動作會使用預先定義的 [Windows 服務管理員] 工具來建立、設定、刪除、重新啟動、啟動和停止 Windows 服務。如需這個工具的詳細資訊，請移至 這裡。

動作	使用方式和部署失敗狀況
設定服務 設定服務認證 建立服務 刪除服務 重新啟動服務 啟動服務 停止服務	使用 [建立服務] 可以建立新的服務。 如果服務已經存在，部署序列將會失敗。 使用 [設定服務] 可以設定現有服務。 如果服務不存在，部署序列將會失敗。 使用 [設定服務認證] 可以使用新的認證來設定現有的服務。 如果服務不存在，部署序列將會失敗。 此外，當您指定要啟動、停止或重新啟動服務時，如果指定的 ServiceName 不存在，部署序列將會失敗。 如果服務已經啟動或停止，則不會失敗。

組態變數

參數	必要項	說明
BinPath	沒有	服務的二進位路徑和名稱。
Description	有	要建立或設定之服務的描述。
DisplayName	沒有	要建立或設定之服務的名稱。
Password	沒有	要啟動服務之指定使用者名稱的密碼。
ServiceName	有	要建立、設定、刪除、回收、啟動或停止的服務名稱。
StartMode	沒有	服務的啟動模式。 允許的值如下： Automatic：(預設值) 在下次電腦重新啟動時自動啟動服務。 Disabled：停用服務。 Manual：僅以手動方式啟動服務。
UserName	有	將用於啟動服務之認證的使用者名稱。 請使用 DOMAIN\USER 格式，例如 NT AUTHORITY\NETWORK SERVICE。 如果您指定了 UserName，就必須一併指定 Password。 若要將認證重設為 LocalSystem，請輸入 LocalSystem 做為使用者名稱並輸入 "" 做為密碼。