nscontrol export 命令

發行項
12/15/2008

更新： 2005 年 12 月 5 日

從資料庫中匯出中繼資料來建立一個 XML 執行個體組態檔 (ICF) 以及一或多個 XML 應用程式定義檔案 (ADF) (每個應用程式各一個)。產生的檔案是執行 export 命令時，有效的執行個體和應用程式定義。您可以利用這項資訊來備份您的執行個體和應用程式定義，或產生可用來建立或更新執行個體的檔案。

語法

nscontrol export 
    [-nologo]
    [-help] 
        -name instanceName
    [-server databaseServer]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]
    [-out directory]
    [-force]

引數

-nologo
隱藏執行 nscontrol 命令時所顯示的產品和版本聲明。

-help
顯示命令語法。

-nameinstanceName
這是建立組態檔和應用程式定義檔的來源執行個體名稱。

-serverdatabaseServer
這是主控執行個體和應用程式資料庫的伺服器名稱。請只在本機電腦未登錄這個執行個體時，才提供這個引數。如果已登錄這個執行個體，也提供了 -server 引數，就會忽略執行個體的登錄值。

如果您使用 SQL Server 的具名執行個體來主控執行個體資料庫，請使用 <servername>\<instancename> 格式指定伺服器名稱和執行個體名稱。

-sqlusernamesqlUserName
這是用來連接 SQL Server 的 SQL Server 登入。

重要事項：

Windows 驗證比 SQL Server 驗證更安全。可能的話，請使用 Windows 驗證。

如果您利用 SQL Server 驗證來連接 SQL Server，請利用這個引數來指定登入。另外，也請利用 -sqlpassword 引數來指定密碼。

如果您是使用 Windows 驗證，請勿指定 -sqlusername 和 -sqlpassword 引數。

重要事項：
Windows 驗證比 SQL Server 驗證更安全。可能的話，請使用 Windows 驗證。

-sqlpasswordsqlPassword
這是與 -sqlusername 登入相關聯的密碼。使用 SQL Server 驗證來連接時，您只能使用這個引數。

-outdirectory
這是在其中寫入檔案的目錄。預設目錄是目前的目錄。

-force
指定覆寫輸出目錄中現有的同名檔案。

備註

當執行個體在執行中，您可以使用 nscontrol export 命令。您不需要停用或停止執行個體。

產生的組態檔名稱為 <instance_name>.config.xml。每個產生的 ADF 名稱都是 <instance_name>.<application_name>.adf.xml。

nscontrol export 命令會利用 UTF-8 編碼來寫入檔案。若要利用其他編碼來匯出組態檔和應用程式定義檔，請使用 SQL Server Management Studio 中的 [匯出] 命令。

nscontrol export 命令不會重新建立原始組態檔和應用程式定義檔。它會建立包含目前的執行個體和應用程式設定的檔案，其中包括已利用可取代的參數來提供的值。因此，我們建議您保留原始組態檔和應用程式定義檔，如果您需要判斷目前的執行個體和應用程式設定，請使用 nscontrol export。

nscontrol export 命令會修改組態檔中的 ApplicationDefinitionFilePath 值來指向匯出的 ADF；請修改這個路徑，以便能夠立即使用組態檔。包括 BaseDirectoryPath 在內的所有其他路徑設定都會原封不動，因為它們可能指向執行個體所需要的其他檔案，例如內容格式器檔案。

權限

用來執行 nscontrol export 的帳戶或 -sqlusername 引數所指定的 SQL Server 登入，可以利用個別應用程式和執行個體資料庫中之 NSReader 資料庫角色的成員資格來取得資料庫權限。db_owner 資料庫角色以及系統管理員 (sysadmin) 和資料庫建立者 (dbcreator) 固定伺服器角色的成員，也可以執行 nscontrol export。

此帳戶也必須有權限執行 Notification Services 二進位檔；此權限已授與 Administrators 和 SQLServerNotificationServicesUser Windows 群組的成員。

範例

下列範例說明如何將中繼資料匯出至 XML 檔中。

A. 將檔案匯出至目前的目錄

這個範例會顯示如何匯出 StockInstance 執行個體的執行個體和應用程式資訊。nscontrol 公用程式會利用 Windows 驗證來連接 SQL Server，且會將組態檔和應用程式定義檔寫入目前的目錄中。如果檔案已經存在，nscontrol 會顯示一則錯誤訊息。

nscontrol export -name StockInstance

B. 將檔案匯出至特定目錄，覆寫現有的檔案

這個範例會顯示如何指定所產生之執行個體和應用程式檔案的目錄。另外，它也顯示如何利用 –force 引數來覆寫任何現有的同名檔案。

nscontrol 公用程式利用 Windows 驗證來連接 SQL Server。

nscontrol export -name StockInstance -out "C:\NS\Export" -force

C. 從管理電腦匯出檔案

這個範例會顯示當執行個體尚未登錄在電腦上，如何匯出執行個體和應用程式資訊。您必須利用 –server 引數來指定 SQL Server 執行個體名稱。另外，這個範例也指定了輸出目錄，同時也指定覆寫現有的同名檔案。

nscontrol 公用程式利用 Windows 驗證來連接 SQL Server。

nscontrol export -name StockInstance -server nsuetest 
    -out "C:\NS\Export" -force

D. 利用 SQL Server 驗證來匯出檔案

這個範例會顯示如何利用 SQL Server 驗證來連接 SQL Server，以匯出 StockInstance 執行個體的執行個體資訊。組態檔和應用程式定義檔建立在 C:\NS\Export 目錄中，如果它們已經存在，並不會覆寫它們。

nscontrol export -name StockInstance -out "C:\NS\Export" 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

請參閱

變更歷程記錄

版本	歷程記錄
2005 年 12 月 5 日	新增內容：新增有關 SQLServerNotificationServicesUser Windows 群組的資訊。

共用方式為