Diskraid

Diskraid 是一種命令列工具，可讓您設定和管理獨立 （或廉價） 磁碟 （RAID） 儲存子系統的備援陣列。

RAID 通常用於伺服器，以標準化和分類容錯磁碟系統。 RAID 層級提供各種混合的效能、可靠性和成本。 有些伺服器提供三個RAID層級：層級0（等量）、層級1（鏡像），以及層級5（等位等量）。

硬體RAID子系統會使用邏輯單元號碼 （LUN） 來區分實體可尋址儲存單位與彼此。 LUN 對象必須至少有一個 plex，而且可以有任意數目的額外 plex。 每個 plex 都包含 LUN 物件上的數據複本。 您可以在 LUN 物件中新增和移除 Plexes。

大部分的 Diskraid 命令在特定的主機總線適配卡 （HBA） 埠、啟動器配接器、啟動器入口網站、提供者、子系統、控制器、埠、磁碟驅動器、LUN、目標入口網站、目標或目標入口網站群組上運作。 您可以使用 SELECT 指令來選取物件。 選取的對象據說有焦點。 焦點可簡化一般設定工作，例如在相同的子系統內建立多個 LUN。

Note

Diskraid 命令行工具僅適用於支援虛擬磁碟服務 （VDS） 的記憶體子系統。

Diskraid commands

下列命令可從 Diskraid 工具內取得。

add

將現有的 LUN 新增至目前選取的 LUN，或將 iSCSI 目標入口網站新增至目前選取的 iSCSI 目標入口網站群組。

Syntax

add plex lun=n [noerr]
add tpgroup tportal=n [noerr]

Parameters

Parameter	Description
Plex LUN=<n>	指定要新增為目前選取 LUN 的 plex 的 LUN 編號。 注意：將會刪除要新增為 plex 之 LUN 上的所有數據。
tpgroup tportal=<n>	指定要新增至目前選取之 iSCSI 目標入口網站群組的 iSCSI 目標入口網站號碼。
noerr	僅適用於腳本。 發生錯誤時，Diskraid 會繼續處理命令，就像沒有發生錯誤一樣。

associate

針對目前選取的 LUN，將指定的控制器埠清單設定為作用中（其他控制器埠為非使用中），或將指定的控制器埠新增至目前選取 LUN 的現有使用中控制器埠清單，或將目前選取 LUN 的指定 iSCSI 目標產生關聯。

Syntax

associate controllers [add] <n>[,<n> [,…]]
associate ports [add] <n-m>[,<n-m>[,…]]
associate targets [add] <n>[,<n> [,…]]

Parameters

Parameter	Description
控制器	新增或取代與目前選取之 LUN 相關聯的控制器清單。 僅搭配 VDS 1.0 提供者使用。
ports	新增或取代與目前選取之 LUN 相關聯的控制器埠清單。 僅適用於 VDS 1.1 提供者。
targets	新增或取代與目前選取之 LUN 相關聯的 iSCSI 目標清單。 僅適用於 VDS 1.1 提供者。
add	如果使用 VDS 1.0 提供者： 將指定的控制器新增至與 LUN 相關聯的現有控制器清單。 如果未指定此參數，控制器清單會取代與此 LUN 相關聯的現有控制器清單。 如果使用 VDS 1.1 提供者： 將指定的控制器埠新增至與 LUN 相關聯的現有控制器埠清單。 如果未指定此參數，控制器埠清單會取代與此 LUN 相關聯的現有控制器埠清單。
<n>[,<n> [, ...]]	與 控制器 或 目標 參數搭配使用。 指定要設定為作用中或關聯的控制器或 iSCSI 目標數目。
<n-m>[,<n-m>[,…]]	與 ports 參數搭配使用。 指定要使用控制器號碼（n）和連接埠號碼（m）配對設定作用中的控制器連接埠。

Example

若要將埠關聯並新增至使用 VDS 1.1 提供者的 LUN：

DISKRAID> SEL LUN 5
LUN 5 is now the selected LUN.

DISKRAID> ASSOCIATE PORTS 0-0,0-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1)

DISKRAID> ASSOCIATE PORTS ADD 1-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1, Ctlr 1 Port 1)

automagic

設定或清除旗標，為提供者提供如何設定 LUN 的提示。 使用時沒有參數， 自動魔術 作業會顯示旗標清單。

Syntax

automagic {set | clear | apply} all <flag=value> [<flag=value> [...]]

Parameters

Parameter	Description
set	將指定的旗標設定為指定的值。
清晰	清除指定的旗標。 all 關鍵字會清除所有自動魔法旗標。
套用	將目前的旗標套用至選取的 LUN。
<flag>	旗標是由三個字母縮寫來識別，包括： FCR - 需要快速崩潰恢復 FTL - 容錯 MSR - 主要讀取 MXD - 最大磁碟機數 MXS - 預期大小上限 ORA - 最佳讀取對齊方式 ORS - 最佳讀取大小 OSR - 針對循序讀取進行最佳化 OSW - 針對循序寫入進行最佳化 OWA - 最佳寫入對齊方式 OWS - 最佳寫入大小 RBP - 重建優先順序 RBV — 已啟用回讀驗證 RMP — 已啟用重新對映 STS - 條帶尺寸 WTC - 啟用 Write-Through 緩存 YNK - 可拆卸

中斷

從目前選取的 LUN 移除 plex。 plex 及其所包含的數據不會保留，而且磁碟驅動器範圍可能會回收。

Caution

您必須先選取鏡像 LUN，才能使用此命令。 將會刪除 plex 上的所有資料。 原始 LUN 上所包含的所有資料不保證一致。

Syntax

break plex=<plex_number> [noerr]

Parameters

Parameter	Description
plex	指定要移除的 plex 數目。 plex 及其所包含的數據將不會保留，而且會回收此 plex 所使用的資源。 LUN 中包含的數據不保證一致。 如果您想要保留此 plex，請使用磁碟區陰影複製服務 （VSS）。
noerr	僅適用於腳本。 發生錯誤時，Diskraid 會繼續處理命令，就像沒有發生錯誤一樣。

chap

設定「挑戰交握驗證通訊協定」（CHAP）共用的秘密，讓iSCSI啟動器和iSCSI目標可以彼此通訊。

Syntax

chap initiator set secret=[<secret>] [target=<target>]
chap initiator remember secret=[<secret>] target=<target>
chap target set secret=[<secret>] [initiator=<initiatorname>]
chap target remember secret=[<secret>] initiator=<initiatorname>

Parameters

Parameter	Description
initiator set	設定當啟動器驗證目標時，用於相互 CHAP 驗證的本機 iSCSI 啟動器服務中的共享密碼。
initiator remember	將 iSCSI 目標的 CHAP 秘密傳達給本機 iSCSI 啟動器服務，讓啟動器服務可以使用秘密，以便在 CHAP 驗證期間向目標驗證本身。
target set	設定當目標驗證啟動器時，用於 CHAP 驗證的目前選取 iSCSI 目標中的共享密碼。
target remember	將 iSCSI 啟動器的 CHAP 秘密傳達給目前焦點中的 iSCSI 目標，讓目標可以使用秘密，以便在相互 CHAP 驗證期間向啟動器驗證本身。
密碼	指定要使用的秘密。 如果空白，則會清除秘密。
目標	指定目前選取子系統中要與秘密建立關聯的目標。 在啟動器上設定秘密並將其排除時，這是選擇性的，表示密碼將用於尚未擁有相關聯秘密的所有目標。
initiatorname	指定要與秘密建立關聯的啟動器 iSCSI 名稱。 在目標上設定秘密並離開時，這是選擇性的，表示密碼將用於尚未擁有相關聯秘密的所有啟動器。

建立

在目前選取的子系統上建立新的 LUN 或 iSCSI 目標，或在目前選取的目標上建立目標入口網站群組。 您可以使用 Diskraid list 指令來檢視實際繫結。

Syntax

create lun simple [size=<n>] [drives=<n>] [noerr]
create lun stripe [size=<n>] [drives=<n, n> [,...]]  [stripesize=<n>] [noerr]
create lun raid [size=<n>] [drives=<n, n> [,...]] [stripesize=<n>] [noerr]
create lun mirror [size=<n>] [drives=<n, n> [,...]] [stripesize=<n>] [noerr]
create lun automagic size=<n> [noerr]
create target name=<name> [iscsiname=<iscsiname>] [noerr]
create tpgroup [noerr]

Parameters

Parameter	Description
simple	建立簡單的 LUN。
stripe	建立等量 LUN。
raid	使用同位建立等量 LUN。
mirror	建立鏡像 LUN。
automagic	使用目前有效的 自動魔術 提示來建立 LUN。 如需詳細資訊，請參閱本文中的 automagic 子命令。
size=	指定 MB 的 LUN 大小總計。 必須指定 size= 或 drives= 參數。 它們也可以一起使用。 如果未指定 size= 參數，則建立的 LUN 將是所有指定磁碟機所允許的最大可能大小。 提供者通常會建立至少與要求大小一樣大的 LUN，但在某些情況下，提供者可能必須四捨五入到下一個最大的大小。 例如，如果大小指定為 .99 GB，且提供者只能配置 GB 磁碟範圍，則產生的 LUN 會是 1 GB。 若要使用其他單位指定大小，請在大小之後立即使用下列其中一個辨識的後綴： B - 位元組 KB - 千位元組 MB - 兆位元組 GB - 千兆字節 TB - 太字節 PB - PB。
drives=	指定磁碟機用來建立 LUN 的 drive_number 。 必須指定 size= 或 drives= 參數。 它們也可以一起使用。 如果未指定 size= 參數，則建立的 LUN 是所有指定磁碟機所允許的最大可能大小。 如果指定 size= 參數，提供者會從指定的磁碟機清單中選取磁碟機來建立 LUN。 提供者會盡可能依指定的順序嘗試使用磁碟驅動器。
stripesize=	指定 等量 或 raid LUN 的大小 （以 MB 為單位）。 建立 LUN 之後，就無法變更等量化。 若要使用其他單位指定大小，請在大小之後立即使用下列其中一個辨識的後綴： B - 位元組 KB - 千位元組 MB - 兆位元組 GB - 千兆字節 TB - 太字節 PB - PB。
目標	在目前選取的子系統上建立新的 iSCSI 目標。
name	提供目標的易記名稱。
iscsiname	提供目標的 iSCSI 名稱，而且可以省略，讓提供者產生名稱。
tpgroup	在目前選取的目標上建立新的 iSCSI 目標入口網站群組。
noerr	僅適用於腳本。 發生錯誤時，Diskraid 會繼續處理命令，就像沒有發生錯誤一樣。

刪除

刪除目前選取的 LUN、iSCSI 目標（只要沒有任何與 iSCSI 目標相關聯的 LUN）或 iSCSI 目標入口網站群組。

Syntax

delete lun [uninstall] [noerr]
delete target [noerr]
delete tpgroup [noerr]

Parameters

Parameter	Description
lun	刪除目前選取的 LUN 及其上的所有數據。
解除安裝	指定在刪除 LUN 之前，將會清除與 LUN 相關聯之本機系統上的磁碟。
目標	如果沒有任何 LUN 與目標相關聯，則刪除目前選取的 iSCSI 目標。
tpgroup	刪除目前選取的 iSCSI 目標入口網站群組。
noerr	僅適用於腳本。 發生錯誤時，Diskraid 會繼續處理命令，就像沒有發生錯誤一樣。

detail

顯示指定之類型目前選取之物件的詳細資訊。

Syntax

detail {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup} [verbose]

Parameters

Parameter	Description
hbaport	列出目前選取主機總線適配卡 （HBA） 埠的詳細資訊。
iadapter	列出目前選取之 iSCSI 啟動器配接器的詳細資訊。
iportal	列出目前選取之 iSCSI 啟動器入口網站的詳細資訊。
提供者	列出目前選取之提供者的詳細資訊。
子系統	列出目前選取子系統的詳細資訊。
控制器	列出目前所選控制器的詳細資訊。
傳輸埠	列出目前所選控制器埠的詳細資訊。
drive	列出目前所選磁碟驅動器的詳細資訊，包括佔用 LUN。
lun	列出目前所選 LUN 的詳細資訊，包括參與的磁碟驅動器。 視 LUN 是光纖通道或 iSCSI 子系統的一部分而定，輸出會稍有不同。 如果 [未遮罩主機] 清單只包含星號，這表示 LUN 會解除遮罩到所有主機。
tportal	列出目前選取之 iSCSI 目標入口網站的詳細資訊。
目標	列出目前選取之 iSCSI 目標的詳細資訊。
tpgroup	列出目前選取之 iSCSI 目標入口網站群組的詳細資訊。
詳細資訊	僅適用於 LUN 參數。 列出其他資訊，包括其叢集。

dissociate

針對目前選取的 LUN，將指定的控制器埠清單設定為非使用中狀態（其他控制器埠不會受到影響），或解除目前選取之 LUN 的指定 iSCSI 目標清單。

Syntax

dissociate controllers <n> [,<n> [,...]]
dissociate ports <n-m>[,<n-m>[,…]]
dissociate targets <n> [,<n> [,…]]

Parameter

Parameter	Description
controllers	從與目前選取之 LUN 相關聯的控制器清單中移除控制器。 僅搭配 VDS 1.0 提供者使用。
ports	從與目前選取的 LUN 相關聯的控制器埠清單中移除控制器埠。 僅適用於 VDS 1.1 提供者。
targets	從與目前選取的 LUN 相關聯的 iSCSI 目標清單中移除目標。 僅適用於 VDS 1.1 提供者。
<n> [,<n> [,…]]	與 控制器 或 目標 參數搭配使用。 指定要設定為非使用中或解除關聯的控制器或iSCSI目標數目。
<n-m>[,<n-m>[,…]]	與 ports 參數搭配使用。 使用控制器號碼 （n） 和連接埠號碼 （m） 配對，指定要設定為非作用中的控制器連接埠。

Example

DISKRAID> SEL LUN 5
LUN 5 is now the selected LUN.

DISKRAID> ASSOCIATE PORTS 0-0,0-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1)

DISKRAID> ASSOCIATE PORTS ADD 1-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 0, Ctlr 0 Port 1, Ctlr 1 Port 1)

DISKRAID> DISSOCIATE PORTS 0-0,1-1
Controller port associations changed.
(Controller ports active after this command: Ctlr 0 Port 1)

結束

Exits Diskraid.

Syntax

exit

extend

將扇區新增至 LUN 結尾，以擴充目前選取的 LUN。 並非所有提供者都支援擴充 LUN。 不會擴充 LUN 中包含的任何磁碟區或文件系統。 擴充 LUN 之後，您應該使用 DiskPart extend 命令來擴充相關聯的磁碟上結構。

Syntax

extend lun [size=<LUN_size>] [drives=<drive_number>, [<drive_number>, ...]] [noerr]

Parameters

Parameter	Description
size	指定要擴充 LUN 的大小，以 MB 為單位。 必須指定 大小 或 <drive> 參數。 它們也可以一起使用。 如果未指定 size= 參數，則 LUN 會擴充所有指定磁碟機所允許的最大可能大小。 如果指定 size= 參數，提供者會從 drives= 參數指定的清單中選取磁碟驅動器，以建立 LUN。 若要使用其他單位指定大小，請在大小之後立即使用下列其中一個辨識的後綴： B - 位元組 KB - 千位元組 MB - 兆位元組 GB - 千兆字節 TB - 太字節 PB - PB。
drives=	指定建立 LUN 時要使用的磁碟驅動器 <drive_number>。 必須指定 大小 或 <drive> 參數。 它們也可以一起使用。 如果未指定 size= 參數，則建立的 LUN 是所有指定磁碟機所允許的最大可能大小。 提供者會盡可能依指定的順序使用磁碟驅動器。
noerr	僅適用於腳本。 發生錯誤時，Diskraid 會繼續處理命令，就像沒有發生錯誤一樣。

flushcache

清除目前選取控制器上的快取。

Syntax

flushcache controller

help

顯示所有 Diskraid 命令的清單。

Syntax

help

importtarget

擷取或設定目前所選子系統所設定的目前磁碟區陰影複製服務 （VSS） 匯入目標。

Syntax

importtarget subsystem [set target]

Parameter

Parameter	Description
set target	如果指定，請將目前選取的目標設定為目前選取子系統的 VSS 匯入目標。 如果未指定，命令會擷取針對目前選取的子系統所設定的目前 VSS 匯入目標。

啟動器

擷取本機 iSCSI 啟動器的相關信息。

Syntax

initiator

invalidatecache

使目前選取控制器上的快取失效。

Syntax

invalidatecache controller

lbpolicy

在目前選取的 LUN 上設定負載平衡原則。

Syntax

lbpolicy set lun type=<type> [paths=<path>-{primary | <weight>}[,<path>-{primary | <weight>}[,…]]]
lbpolicy set lun paths=<path>-{primary | <weight>}[,<path>-{primary | <weight>}[,…]]

Parameters

Parameter	Description
型別	指定負載平衡原則。 如果未指定類型，則必須指定 路徑 參數。 Type 可以是下列其中之一： 容錯移轉 — 使用一個主要路徑，其他路徑是備份路徑。 ROUNDROBIN - 以循環配置資源方式使用所有路徑，依序嘗試每個路徑。 SUBSETROUNDROBIN - 以循環配置資源方式使用所有主要路徑;只有在所有主要路徑都失敗時，才會使用備份路徑。 DYNLQD - 使用作用中要求數目最少的路徑。 WEIGHTED - 使用權重最低的路徑 （必須為每條路徑指派權重）。 LEASTBLOCKS - 使用具有最少區塊的路徑。 VENDORSPECIFIC - 使用廠商特定的原則。
路徑	指定路徑是 主要 路徑還是具有特定 <weight>. 未指定的任何路徑都會隱含地設定為備份。 列出的任何路徑都必須是目前選取的 LUN 路徑之一。

list

顯示指定型別的物件清單。

Syntax

list {hbaports | iadapters | iportals | providers | subsystems | controllers | ports | drives | LUNs | tportals | targets | tpgroups}

Parameters

Parameter	Description
hbaports	列出 VDS 已知所有 HBA 埠的摘要資訊。 目前選取的 HBA 埠會以星號 {.
iadapters	列出 VDS 已知所有 iSCSI 啟動器適配卡的摘要資訊。 目前選取的啟動器配接器會以星號 \.
iportals	列出目前所選取啟動器配接器配接器中所有iSCSI 啟動器入口網站的相關摘要資訊。 目前選取的啟動器入口網站會以星號 \.
providers	列出 VDS 已知每個提供者的摘要資訊。 目前選取的提供者會以星號 \.
subsystems	列出系統中每個子系統的摘要資訊。 目前選取的子系統會以星號 {.
controllers	列出目前所選子系統中每個控制器的摘要資訊。 目前選取的控制器會以星號 \.
ports	列出目前所選控制器中每個控制器埠的摘要資訊。 目前選取的埠會以星號 \.
drives	列出目前所選子系統中每個磁碟驅動器的摘要資訊。 目前選取的磁碟驅動器會以星號 \.
luns	列出目前所選子系統中每個 LUN 的摘要資訊。 目前選取的 LUN 會以星號 \.
tportals	列出目前所選子系統中所有 iSCSI 目標入口網站的相關摘要資訊。 目前選取的目標入口網站會以星號 \.
targets	列出目前所選子系統中所有 iSCSI 目標的相關摘要資訊。 目前選取的目標會以星號 \.
tpgroups	列出目前選取目標中所有 iSCSI 目標入口網站群組的摘要資訊。 目前選取的入口網站群組會以星號 \.

login

將指定的 iSCSI 啟動器配接器記錄到目前選取的 iSCSI 目標中。

Syntax

login target iadapter=<iadapter> [type={manual | persistent | boot}] [chap={none | oneway | mutual}] [iportal=<iportal>] [tportal=<tportal>] [<flag> [<flag> […]]]

Parameters

Parameter	Description
型別	指定要執行的登入類型：手動或持續。 如果未指定，將會執行手動登入。
manual	Login manually. 還有一個 啟動 選項，用於未來的開發，目前未使用。
persistent	當電腦重新啟動時，自動使用相同的登入。
chap	指定要使用的 CHAP 驗證型別： 無、 單向 CHAP 或 相互 CHAP;如果未指定，則不會使用任何驗證。
tportal	指定目前選取子系統中要用於登入的選擇性目標入口網站。
iportal	在指定的啟動器配接器配接器中，指定要用於登入的選擇性啟動器入口網站。
<flag>	以三個字母縮略字識別： IPS — 需要IPsec EMP — 啟用多重路徑 EHD - 啟用標頭摘要 EDD — 啟用資料摘要

logout

將指定的 iSCSI 啟動器配接器記錄出目前選取的 iSCSI 目標。

Syntax

logout target iadapter= <iadapter>

Parameters

Parameter	Description
iadapter	指定要註銷之登入工作階段的啟動器配接器。

維修

在目前選取的指定型別物件上執行維護作業。

Syntax

maintenance <object operation> [count=<iteration>]

Parameters

Parameter	Description
<object>	指定要在其中執行作業的物件類型。 物件類型可以是子系統、控制器、連接埠、磁碟機或 LUN。
<operation>	指定要執行的維護作業。 操作類型可以是旋轉、旋轉、閃爍、嗶嗶聲或 ping。 必須指定 作業 。
count=	指定重複 作業的次數。 這通常與 閃爍、 嗶聲或 ping 一起使用。

name

將目前選取的子系統、LUN 或 iSCSI 目標的易記名稱設定為指定的名稱。

Syntax

name {subsystem | lun | target} [<name>]

Parameter

Parameter	Description
<name>	指定子系統、LUN 或目標的名稱。 名稱長度必須小於64個字元。 如果未提供任何名稱，則會刪除現有的名稱。

離線

將指定類型的目前選取物件的狀態設定為 離線。

Syntax

offline <object>

Parameter

Parameter	Description
<object>	指定要執行這項作業的物件類型。 類型可以是： 子系統、 控制器、 磁碟機、 LUN 或 tportal。

連線

將指定類型的所選物件的狀態設定為 線上。 如果物件是 hbaport，則會將目前選取的 HBA 連接埠的路徑狀態變更為 線上。

Syntax

online <object>

Parameter

Parameter	Description
<object>	指定要執行這項作業的物件類型。 類型可以是： hbaport、 子系統、 控制器、 磁碟機、 LUN或 tportal。

recover

執行必要的作業，例如重新同步處理或經常性疏散，以修復目前選取的容錯 LUN。 例如，RECOVER 可能會導致熱備援系結至具有失敗磁碟或其他磁碟範圍重新分配的 RAID 集合。

Syntax

recover <lun>

reenumerate

繼續指定型別的物件。 如果您使用擴充 LUN 命令，您必須使用 refresh 命令來更新磁碟大小，才能使用繼續命令。

Syntax

reenumerate {subsystems | drives}

Parameters

Parameter	Description
subsystems	查詢提供者，以探索在目前選取的提供者中新增的任何新子系統。
drives	查詢內部 I/O 總線，以探索在目前選取的子系統中新增的任何新磁碟驅動器。

重新整理

重新整理目前選取提供者的內部數據。

Syntax

refresh provider

rem

用來批註腳本。

Syntax

Rem <comment>

移除

從目前選取的目標入口網站群組中移除指定的 iSCSI 目標入口網站。

Syntax

remove tpgroup tportal=<tportal> [noerr]

Parameter

Parameter	Description
tpgroup tportal=<tportal>	指定要移除的 iSCSI 目標入口網站。
noerr	僅適用於腳本。 發生錯誤時，Diskraid 會繼續處理命令，就像沒有發生錯誤一樣。

取代

以目前選取的磁碟驅動器取代指定的磁碟驅動器。 指定的磁碟驅動器可能不是目前選取的磁碟驅動器。

Syntax

replace drive=<drive_number>

Parameter

Parameter	Description
drive=	指定要取代之磁碟驅動器的 <drive_number>。

重置

重設目前選取的控制器或埠。

Syntax

reset {controller | port}

Parameters

Parameter	Description
控制器	重設控制器。
傳輸埠	重設埠。

select

顯示或變更目前選取的物件。

Syntax

select {hbaport | iadapter | iportal | provider | subsystem | controller | port | drive | lun | tportal | target | tpgroup } [<n>]

Parameters

Parameter	Description
物件	指定要選取的物件類型，包括： 提供者、 子系統、 控制器、 磁碟驅動器或 LUN。
HBAport [<n>]	將焦點設定為指定的本機 HBA 埠。 如果未指定 HBA 埠，命令會顯示目前選取的 HBA 埠（如果有的話）。 指定無效的 HBA 埠索引會導致沒有焦點 HBA 埠。 選取 HBA 埠會取消選取任何選取的啟動器配接器和啟動器入口網站。
iadapter 適配器 [<n>]	將焦點設定為指定的本機 iSCSI 啟動器配接器。 如果未指定啟動器配接器，命令會顯示目前選取的啟動器配接器配接器（如果有的話）。 指定無效的啟動器配接器索引會導致沒有焦點啟動器配接器。 選取啟動器配接器會取消選取任何選取的 HBA 埠和啟動器入口網站。
iPortal [<n>]	將焦點設定為所選 iSCSI 啟動器配接器配接器內的指定本機 iSCSI 啟動器入口網站。 如果未指定啟動器入口網站，命令會顯示目前選取的啟動器入口網站（如果有的話）。 指定無效的啟動器入口網站索引會導致沒有選取的啟動器入口網站。
供應商 [<n>]	將焦點設定為指定的提供者。 如果未指定任何提供者，命令會顯示目前選取的提供者（如果有的話）。 指定無效的提供者索引會導致沒有焦點提供者。
子系統 [<n>]	將焦點設定為指定的子系統。 如果未指定任何子系統，命令會顯示具有焦點的子系統（如果有的話）。 指定無效的子系統索引會導致沒有焦點子系統。 選取子系統會隱含地選取其相關聯的提供者。
控制器 [<n>]	將焦點設定為目前選取子系統內的指定控制器。 如果未指定任何控制器，命令會顯示目前選取的控制器（如果有的話）。 指定無效的控制器索引會導致沒有焦點控制器。 選取控制器會取消選取任何選取的控制器埠、磁碟驅動器、LUN、目標入口網站、目標和目標入口網站群組。
埠 [<n>]	將焦點設定為目前選取控制器內的指定控制器埠。 如果未指定任何埠，命令會顯示目前選取的埠（如果有的話）。 指定無效的埠索引會導致沒有選取的埠。
磁碟驅動器 [<n>]	在目前選取的子系統內，將焦點設定為指定的磁碟驅動器或實體主軸。 如果未指定磁碟驅動器，命令會顯示目前選取的磁碟驅動器（如果有的話）。 指定無效的磁碟驅動器索引會導致無焦點磁碟驅動器。 選取磁碟驅動器會取消選取任何選取的控制器、控制器埠、LUN、目標入口網站、目標和目標入口網站群組。
倫 [<n>]	將焦點設定為目前選取子系統內的指定 LUN。 如果未指定任何 LUN，命令會顯示目前選取的 LUN（如果有的話）。 指定無效的 LUN 索引會導致未選取的 LUN。 選取 LUN 會取消選取任何選取的控制器、控制器埠、磁碟驅動器、目標入口網站、目標和目標入口網站群組。
門戶網站 [<n>]	將焦點設定為目前選取的子系統內的指定 iSCSI 目標入口網站。 如果未指定任何目標入口網站，命令會顯示目前選取的目標入口網站（如果有的話）。 指定無效的目標入口網站索引會導致未選取的目標入口網站。 選取目標入口網站會取消選取任何控制器、控制器埠、磁碟驅動器、LUN、目標和目標入口網站群組。
目標 [<n>]	將焦點設定為目前選取子系統內的指定 iSCSI 目標。 如果未指定任何目標，命令會顯示目前選取的目標（如果有的話）。 指定無效的目標索引會導致沒有選取的目標。 選取目標會取消選取任何控制器、控制器埠、磁碟驅動器、LUN、目標入口網站和目標入口網站群組。
TPP組 [<n>]	將焦點設定為目前選取之 iSCSI 目標內的指定 iSCSI 目標入口網站群組。 如果未指定目標入口網站群組，命令會顯示目前選取的目標入口網站群組（如果有的話）。 指定無效的目標入口網站群組索引會導致沒有焦點目標入口網站群組。
[<n>]	指定要選取的 <object number>。 如果指定的 <object number> 無效，則會清除指定型別物件的任何現有選取範圍。 如果未指定 <object number>，則會顯示目前的物件。

setflag

將目前選取的磁碟驅動器設定為熱備援。 經常性備援無法用於一般 LUN 系結作業。 它們只保留給錯誤處理。 磁碟驅動器目前不得系結至任何現有的 LUN。

Syntax

setflag drive hotspare={true | false}

Parameters

Parameter	Description
true	選取目前選取的磁碟驅動器作為熱備援。
false	取消選取目前選取的磁碟驅動器作為熱備援。

shrink

減少選取 LUN 的大小。

Syntax

shrink lun size=<n> [noerr]

Parameters

Parameter	Description
size	指定所需的空間量，以 MB 為單位來減少 LUN 的大小。 若要使用其他單位指定大小，請在大小之後立即使用下列其中一個辨識的後綴： B - 位元組 KB - 千位元組 MB - 兆位元組 GB - 千兆字節 TB - 太字節 PB - PB。
noerr	僅適用於腳本。 發生錯誤時，Diskraid 會繼續處理命令，就像沒有發生錯誤一樣。

standby

將目前選取主機總線適配卡 （HBA） 埠的路徑狀態變更為 STANDBY。

Syntax

standby hbaport

Parameters

Parameter	Description
hbaport	將目前選取主機總線適配卡 （HBA） 埠的路徑狀態變更為 STANDBY。

unmask

讓目前選取的 LUN 可從指定的主機存取。

Syntax

unmask lun {all | none | [add] wwn=<hexadecimal_number> [;<hexadecimal_number> [;…]] | [add] initiator=<initiator>[;<initiator>[;…]]} [uninstall]

Parameters

Parameter	Description
all	指定應該從所有主機存取 LUN。 不過，您無法將 LUN 解除遮罩至 iSCSI 子系統中的所有目標。 您必須先註銷目標，才能執行 unmask lun all 命令。
none	指定無法存取任何主機的 LUN。 您必須先註銷目標，才能執行 unmask lun none 命令。
add	指定指定的主機必須新增至可從中存取此 LUN 的現有主機清單。 如果未指定此參數，提供的主機清單會取代可從中存取此 LUN 的現有主機清單。
wwn=	指定十六進位數位的清單，代表應該從中存取 LUN 或主機的世界名稱。 若要遮罩/取消遮罩至光纖通道系統中特定主機集，您可以針對感興趣的主機機器上的埠輸入以分號分隔的WWN 清單。
initiator=	指定目前選取的 LUN 應該可供存取的 iSCSI 啟動器清單。 若要遮罩/取消遮罩至 iSCSI 子系統中的一組特定主機，您可以在感興趣的主計算機上輸入以分號分隔的 iSCSI 啟動器名稱清單。
解除安裝	如果指定，請先卸載與本機系統上 LUN 相關聯的磁碟，再遮罩 LUN。

Scripting Diskraid

Diskraid 可以在任何執行受支援版本的 Windows Server 計算機上，搭配相關聯的 VDS 硬體提供者編寫腳本。 若要叫用 Diskraid 腳稿，請在命令提示字元中輸入：

diskraid /s <script.txt>

根據預設，Diskraid 會停止處理命令，並在腳本發生問題時傳回錯誤碼。 若要繼續執行指令碼並忽略錯誤，請在指令上包含 noerr 參數。 這允許使用單一腳本刪除子系統中所有 LUN 的實用做法，而不論 LUN 總數為何。 並非所有指令都支援 noerr 參數。 無論您是否包含 noerr 參數，一律會在命令語法錯誤上傳回錯誤。

Diskraid 錯誤碼

Error Code	Error Description
0	未發生錯誤。 整個腳本未失敗執行。
1	發生嚴重例外狀況。
2	Diskraid 命令行上指定的自變數不正確。
3	Diskraid 無法開啟指定的腳本或輸出檔案。
4	Diskraid 使用的其中一個服務傳回失敗。
5	發生命令語法錯誤。 腳本失敗，因為物件未正確選取或無效，無法與該命令搭配使用。

Example

若要檢視電腦上的子系統 0 狀態，請輸入：

diskraid

按下 ENTER 並輸出，如下所示：

Microsoft Diskraid version 5.2.xxxx
Copyright (©) 2003 Microsoft Corporation
On computer: COMPUTER_NAME

若要選取子系統 0，請在 Diskraid 提示字元中輸入下列命令：

select subsystem 0

按下 ENTER 並輸出，如下所示：

Subsystem 0 is now the selected subsystem.

DISKRAID> list drives

  Drive ###  Status      Health          Size      Free    Bus  Slot  Flags
  ---------  ----------  ------------  --------  --------  ---  ----  -----
  Drive 0    Online      Healthy         107 GB    107 GB    0     1
  Drive 1    Offline     Healthy          29 GB     29 GB    1     0
  Drive 2    Online      Healthy         107 GB    107 GB    0     2
  Drive 3    Not Ready   Healthy          19 GB     19 GB    1     1

若要結束 Diskraid，請在 Diskraid 提示字元中輸入下列命令：

exit

Related links

• 命令列語法重點