nscontrol export 命令
更新: 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 引數。
- -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
請參閱
參考
其他資源
如何:檢視 Notification Services 版本資訊
說明及資訊
變更歷程記錄
版本 | 歷程記錄 |
---|---|
2005 年 12 月 5 日 |
|