QUERY FILESPACE（查詢一或多個檔案空間）

請使用這個指令來顯示屬於用戶端節點的檔案空間的相關資訊。這個指令中的輸出包括前次增量備份或抄寫的結果。

提示：如果一個節點有多個檔案空間，您可以針對這些檔案空間之一，發出 DELETE FILESPACE 指令。不過，如果您在刪除過程中，針對節點發出 QUERY FILESPACE 指令，輸出不會顯示檔案空間。如果要取得關於其餘檔案空間的精確資訊，請在刪除程序處理結束之後，發出 QUERY FILESPACE 指令。

專用權類別

任何管理者均可以發出此指令。

語法


                    .-*--*---------------------------.   
>>-Query FIlespace--+--------------------------------+---------->
                    |            .-*---------------. |   
                    '-node_name--+-----------------+-'   
                                 '-file_space_name-'     

   .-Format--=--Standard-----.  .-NAMEType--=--SERVER------.   
>--+-------------------------+--+--------------------------+---->
   '-Format--=--+-Standard-+-'  '-NAMEType--=--+-SERVER--+-'   
                '-Detailed-'                   +-UNIcode-+     
                                               '-FSID----'     

   .-CODEType--=--BOTH-----------.   
>--+-----------------------------+-----------------------------><
   '-CODEType--=--+-UNIcode----+-'   
                  +-NONUNIcode-+     
                  '-BOTH-------'

參數

node_name

指定檔案空間所屬的用戶端節點。您可以使用萬用字元來指定此名稱。此為選用參數。預設值為所有的用戶端節點名稱。

若您指定檔名，就必須為這個參數指定一個值。

file_space_name

指定要查詢的檔案空間名稱。您可以使用萬用字元來指定此名稱。此為選用參數。若沒有指定任何值，則查詢所有的檔案空間。

如果伺服器包括的用戶端使用已啟用 Unicode 的檔案空間，則伺服器可能需要轉換您輸入的名稱。舉例來說，伺服器可能需要將您輸入的檔案空間名稱從伺服器字碼頁轉換為 Unicode。如需相關資訊，請參閱 NAMETYPE 參數。如果沒有指定檔案空間名稱，或只指定了單一萬用字元來代表名稱，您可以利用 CODETYPE 參數，將作業限制於 Unicode 檔案空間或非 Unicode 檔案空間。

檔案空間名稱有區分大小寫。您可以使用 QUERY FILESPACE 指令來判斷要查詢的檔案空間的正確大小寫。

格式

指定資訊的顯示方式。此為選用參數。預設值為 STANDARD。您可以指定下列其中一個值：

標準: 指定顯示所指定之檔案空間的部份資訊。
詳細: 指定顯示指定檔案空間的完整資訊。

NAMEType

指定您要伺服器解譯您輸入之檔案空間的方式。這個參數在其用戶端支援的伺服器非常有用。這個參數適用於已啟用 Unicode 且使用 Windows、Macintosh OS X 及 NetWare 作業系統的 IBM Spectrum Protect™ 用戶端。

請僅在您輸入部分或完整的檔案空間名稱時才使用此參數。預設值為 SERVER。您可以指定下列其中一個值：

SERVER: 伺服器利用伺服器字碼頁來解譯檔案空間名稱。
UNIcode: 伺服器會將輸入的檔案空間名稱從伺服器字碼頁轉換成 UTF-8 字碼頁。轉換是否成功，取決於名稱中的實際字元以及伺服器字碼頁。如果字串含有伺服器字碼頁不支援的字元，或伺服器存取系統轉換常式時發生問題，轉換就可能失敗。
FSID: 伺服器會將檔案空間名稱解譯為它們的檔案空間 ID (FSID)。

CODEType

指定將檔案空間包括到作業中的方式。預設值為 BOTH，表示將包括檔案空間並與字碼頁無關。請在您對檔案空間名稱指定單一的萬用字元時才使用這個參數。您可以指定下列其中一個值：

UNIcode: 只包括 Unicode 格式的檔案空間。
NONUNIcode: 只包括不是 Unicode 格式的檔案空間。
BOTH: 包括檔案空間而且和字碼頁無關。

範例：列出所有檔案空間

查詢與全部用戶端節點有關的所有檔案空間。

query filespace

Node   Filespace   FSID  Platform  Filespace     Is     Capacity Pct
Name   Name                        Type      Filespace          Util
                                             Unicode?               
------ ----------- ----  -------   --------  --------  -------- ----
JOE       \\joe\c$      1  WinNT    NTFS        Yes     2,502.3  75.2
JOE       \\joe\d$      2  WinNT    NTFS        Yes     6,173.4  59.6

如需欄位說明，請參閱欄位說明。

範例：顯示虛擬檔案空間的詳細檔案空間資訊

顯示檔案空間 /HomeDir 的詳細資訊，這個檔案空間是一個虛擬檔案空間對映，並且隸屬於 NAS 節點 NAS1。

query filespace nas1 /HomeDir

Node   Filespace   FSID  Platform  Filespace     Is     Capacity Pct 
Name   Name                        Type      Filespace           Util
                                              Unicode?               
----   ----------- ----  -------   --------  ---------  -------- ----
NAS1   /HomeDir     1    NetApp   WAFL (VFS)     No     2,502.3  75.2

如需欄位說明，請參閱欄位說明。

重要：在要求詳細格式之後，您可能不會看到預期的結果，因為 API 應用程式必須完成若干欄位。這些欄位包括：

File space type
平台
容量
Pct Util
Last backup start Date/Time
Last backup completion Date/Time

如需 API 所更新之特定欄位的相關資訊，請參閱 IBM Spectrum Protect: Using the Application Programming Interface。

範例：顯示特定檔案空間和節點的詳細檔案空間資訊

顯示屬於用戶端節點 JOE 之 \\joe\c$ 檔案空間的詳細資訊。

query filespace joe \\joe\c$ nametype=unicode format=detailed

                                      Node Name: JOE
                                 Filespace Name: \\joe\c$
                     Hexadecimal Filespace Name: 5c5c6a6f655c6324
                                           FSID: 1
                         Collocation Group Name: FSGRP1
                                       平台：WinNT
                                 Filespace Type: NTFS
                          Is Filespace Unicode?: Yes
                                       Capacity: 2,502.3
                                       Pct Util: 75.2
                    Last Backup Start Date/Time:
                 Days Since Last Backup Started:
               Last Backup Completion Date/Time:
               Days Since Last Backup Completed:
               Last Replication Start Date/Time: 12/02/2012, 12:42:00
       Days Since Last Node Replication Started: 30
          Last Replication Completion Date/Time: 12/02/2012, 12:42:00
          Days Since Last Replication Completed: 30
        Last Backup Date/Time From Client (UTC): 06/02/2013, 09:10:00
       Last Archive Date/Time From Client (UTC): 06/02/2013, 09:10:00
                   備份抄寫規則名稱：ACTIVE_DATA
                  備份抄寫規則狀態：ENABLED
                  保存抄寫規則名稱：DEFAULT
                 保存抄寫規則狀態：ENABLED
         空間管理抄寫規則名稱：無
        空間管理抄寫規則狀態：DISABLED
                                   處於風險類型：自訂間隔
                               處於風險間隔：2,222
                                 已解除任務：否
                            解除任務日期： 
                                    MAC Address:

如需欄位說明，請參閱欄位說明。

欄位說明

重要：在要求詳細格式之後，您可能不會看到預期的結果，因為 API 應用程式必須完成若干欄位。這些欄位包括：

Filespace Type
平台
容量
Pct Util
Last Backup Start Date/Time
Last Backup Completion Date/Time

如需 API 所更新之特定欄位的相關資訊，請參閱 IBM Spectrum Protect: Using the Application Programming Interface。

節點名稱

指出用戶端節點名稱。

檔案空間名稱

屬於節點的檔案空間名稱。

檔案空間名稱可以採用不同於伺服器的字碼頁或語言環境。若是如此，Operations Center 和管理指令介面中的名稱，可能不會正確顯示。資料仍會進行備份，並可正常還原，但是可能會以混雜的無效字元或空格，顯示檔案空間名稱或檔名。

若檔案空間名稱已啟用 Unicode，則該名稱會轉換成伺服器的字碼頁來顯示。轉換是否成功，取決於作業系統、名稱中的字元，以及伺服器字碼頁。如果字串包含伺服器字碼頁沒有提供的字元，或伺服器無法存取系統轉換常式，轉換可能會不完整。如果轉換不完整，名稱中可能會有問號、空格、不可列印的字元或省略符號 (...).

Hexadecimal Filespace Name

指定用戶端節點的檔案空間的十六進位名稱。

FSID

指定檔案空間的檔案空間 ID。

Collocation Group Name

檔案空間所屬並置群組（如果有的話）的名稱。

Platform

指出用戶端節點平台。

Filespace Type

指出檔案空間的類型。

檔案空間類型若有附加 "(VFS)"，表示該檔案空間名稱是位在 NAS 裝置上的目錄路徑之虛擬檔案空間對映。

Is Filespace Unicode?

指定檔案空間是否為 Unicode。

容量

以 MB 為單位，指定在用戶端節點上，指定給這個檔案空間的空間數量。

如果檔案空間是目錄路徑的虛擬檔案空間對映，這個欄位就代表目錄路徑所在檔案空間的容量。

Pct Util

指出佔用的檔案空間所佔的百分比。

若檔案空間是目錄路徑的虛擬檔案空間對映，則使用率百分比是指在前次完整備份時，目錄在檔案空間中所佔的容量百分比。

Last Backup Start Date/Time

指出檔案空間最近一次增量備份的起始日期和時間。

Days Since Last Backup Started

指出自從檔案空間最近一次增量備份之後所經過的天數。

Last Backup Completion Date/Time

指出檔案空間最近一次增量備份的完成日期和時間。

Days Since Last Backup Completed

指出自從檔案空間最近一次增量備份完成後所經過的天數。

Last Replication Start Date/Time

指定前次抄寫檔案空間資料的開始日期和時間。

Days Since Last Replication Started

指定前次開始抄寫檔案空間資料之後的天數。

前次抄寫完成的日期/時間

指定前次抄寫檔案空間資料的結束日期和時間。

自前次抄寫完成後的天數

指定前次抄寫檔案空間資料結束之後的天數

Last Backup Date/Time From Client (UTC)

此檔案空間前次備份作業的日期和時間（世界標準時間 (UTC)）。

Last Archive Date/Time From Client (UTC)

此檔案空間前次保存作業的日期和時間（世界標準時間 (UTC)）。

備份抄寫規則名稱

指定適用於檔案空間中之備份資料的抄寫規則。可能的值如下：

ALL_DATA

抄寫作用中和非作用中的備份資料。資料以正常優先順序抄寫。

ACTIVE_DATA

只抄寫作用中的備份資料。資料以正常優先順序抄寫。

小心：如果您指定 ACTIVE_DATA，且下列一個以上狀況為 true，則刪除目標抄寫伺服器上的非作用中備份資料，且不抄寫來源抄寫伺服器上的非作用中備份資料。

在來源或目標抄寫伺服器上安裝早於 7.1.1 版的伺服器版本時。
當您搭配使用 REPLICATE NODE 指令與 FORCERECONCILE=YES 參數時。
當您在配置抄寫、還原資料庫或從早於 7.1.1 版的伺服器版本升級來源與目標抄寫伺服器之後，執行檔案空間的起始抄寫時。

如果未滿足先前的狀況，則抄寫自前次抄寫之後所有新的與已變更的檔案，其中包括非作用中檔案，且在檔案過期時刪除檔案。

ALL_DATA_HIGH_PRIORITY

抄寫作用中和非作用中的備份資料。資料以高優先順序抄寫。

ACTIVE_DATA_HIGH_PRIORITY

除了使用高優先順序抄寫資料之外，此規則與 ACTIVE_DATA 抄寫規則相同。

DEFAULT

根據備份資料的用戶端節點規則來抄寫備份資料。如果備份資料的用戶端節點規則是 DEFAULT，就根據備份資料的伺服器規則來抄寫備份資料。

NONE

不抄寫檔案空間中的備份資料。

備份抄寫規則狀態

指定啟用或停用檔案空間中之備份資料的抄寫。如果狀態是 ENABLED，備份檔就適合進行抄寫。如果狀態是 DISABLED，備份檔就不適合進行抄寫。

保存抄寫規則名稱

指定適用於檔案空間中之保存資料的抄寫規則。可能的值如下：

ALL_DATA: 抄寫保存資料。資料以正常優先順序抄寫。
ALL_DATA_HIGH_PRIORITY: 抄寫保存資料。資料以高優先順序抄寫。
DEFAULT: 根據保存資料的用戶端規則來抄寫保存資料。如果保存資料的用戶端規則是 DEFAULT，就根據保存資料的伺服器規則來抄寫保存資料。
NONE: 不抄寫檔案空間中的保存資料。

保存抄寫規則狀態

指定啟用或停用檔案空間中之保存資料的抄寫。如果狀態是 ENABLED，保存檔就適合進行抄寫。如果狀態是 DISABLED，保存檔就不適合進行抄寫。

空間管理抄寫規則名稱

指定適用於檔案空間中之空間管理資料的抄寫規則。可能的值如下：

ALL_DATA: 抄寫空間管理資料。資料以正常優先順序抄寫。
ALL_DATA_HIGH_PRIORITY: 抄寫空間管理資料。資料以高優先順序抄寫。
DEFAULT: 根據空間管理資料的用戶端規則來抄寫空間管理資料。如果空間管理資料的用戶端規則是 DEFAULT，就根據空間管理資料的伺服器規則來抄寫空間管理資料。
NONE: 不抄寫檔案空間中的空間管理資料。

空間管理抄寫規則狀態

指定啟用或停用檔案空間中之空間管理資料的抄寫。如果狀態是 ENABLED，空間管理檔就適合進行抄寫。如果狀態是 DISABLED，空間管理檔就不適合進行抄寫。

At-risk type

指定風險評估類型。值可以是 Default、Bypassed 或 Custom。 Default 表示使用由 SET STATUSATRISKINTERVAL 指令指定給節點分類的相同間隔，來評估節點。 Bypassed 表示狀態監視器沒有針對風險狀態評估節點。 Custom 表示使用 SET VMATRISKINTERVAL 指令指定的間隔，而非由 SET STATUSATRISKINTERVAL 指令指定的間隔來評估節點。

At-risk interval

指定狀態監視器認定用戶端有風險之前，用戶端備份活動之間的時間量（小時）。此欄位僅在風險類型為 Custom 時才適用。

已解除任務

指定檔案空間所代表的虛擬機器是否已解除任務。

解除任務的日期

指定檔案空間所代表的虛擬機器解除任務的日期。

MAC 位址

指定針對 VMWare 虛擬機器備份之檔案空間的媒體存取控制 (MAC) 位址。如果虛擬機器具有多個 MAC 位址，則這是最低值位址。

指令	說明
DEFINE VIRTUALFSMAPPING	定義虛擬檔案空間對映。
DELETE FILESPACE	刪除與用戶端檔案空間相關聯的資料。如果某個檔案空間是並置群組的一部分，且您從節點中移除檔案空間，則該檔案空間也會從並置群組中移除。
REGISTER NODE	定義用戶端節點到伺服器並為該使用者設定選項。
REMOVE NODE	自特定原則網域的登錄節點清單中移除某個用戶端。
RENAME FILESPACE	重新命名伺服器上的用戶端檔案空間。
UPDATE FILESPACE	變更檔案空間節點的抄寫規則。
UPDATE NODE	變更與用戶端節點相關聯的屬性。

QUERY FILESPACE（查詢一或多個檔案空間）

專用權類別

語法

參數

範例：列出所有檔案空間

範例：顯示虛擬檔案空間的詳細檔案空間資訊

範例：顯示特定檔案空間和節點的詳細檔案空間資訊

欄位說明

相關指令