Rsm

语法

rsm allocate /mMediaPoolName /o{errunavail | new | next} [/l{g | f} LogicalMediaID | /p{g | f}PartitionID] [/lnLogicalMediaName] [/ldLogicalMediaDescription] [/pnPartitionName] [/pdPartitionDescription] [/tTimeout] [/b]

参数

 

/mMediaPoolName
 

从指定的媒体池中分配媒体。这意味着将从该池中分配媒体。
 

/o
 

允许使用下表列出的参数之一。
   
     
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
     
   

值	描述
errunavail	如果因指定限制而无法分配媒体时，阻止提交新媒体的操作员请求。
new	分配一个不与其他应用程序共享的分区。该参数可用于保留双面媒体中的第 2 面。
next	分配以前通过 new 参数分配的媒体的下一面。

 

/l{g | f} LogicalMediaID
 

使用逻辑媒体 ID 来指定要分配的媒体。可以使用 GUID（与 lg 命令行选项一起使用）或好记的名称（与 lf 命令行选项一起使用）。LogicalMediaID 指定要分配的多面媒体的下一面。该参数可选，并要同 /o 命令行选项和 next 参数一起使用。当对该媒体解除分配之后，此逻辑媒体 ID 将无效。
 

/p{g | f} PartitionID
 

使用分区 ID 来指定要分配的分区。可以使用 GUID（与 pg 命令行选项一起使用）或好记的名称（与 pf 命令行选项一起使用）。该参数是可选的，即使该媒体解除分配之后仍保持有效。
 

/lnLogicalMediaName
 

指定要指派给已分配媒体的逻辑媒体对象的好记的名称。
 

/ldLogicalMediaDescription
 

指定要指派给已分配媒体的逻辑媒体对象的描述。
 

/pnPartitionName
 

指定要指派给已分配媒体的分区对象的好记的名称。
 

/pdPartitionDescription
 

指定要指派给已分配媒体的分区对象的描述。
 

/tTimeout
 

指定命令的超时值，单位为毫秒。默认的超时值无限制。
 

/b
 

只显示分派操作的 GUID。这有助于在编写脚本时只要通过最少的解析就可以将命令输出传递给下一个命令。
   

 

/?
 

在命令提示符下显示帮助。
   

 

注释

 
• 逻辑媒体名和面名可以在其他命令中使用，以便分别作为 /lf 或 /pf 开关参数来指定媒体。如果逻辑媒体名称（好记的名称）没有与分配命令一起使用，那么只能在后面的命令中使用 GUID 来指定逻辑媒体。

语法

rsm createpool /mMediaPoolName /a{existing | always | new} [/t{g | f} MediaPoolTypeID] [/d] [/r]

参数

 

/mMediaPoolName
 

指定要创建媒体池的名称。
 

/a
 

允许使用下表列出的参数之一。
   
     
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
     
   

值	描述
existing	打开现有媒体池，如果指定的媒体池不存在，则返回一个错误。
always	打开现有媒体池，如果指定的媒体池不存在，则新建一个媒体池。
new	新建一个媒体池，如果指定的媒体池已存在，则返回一个错误。

 

/tgMediaPoolTypeID
 

使用 GUID 指定媒体池中包含的媒体的类型。默认类型是包含其他媒体池的媒体池。
 

/tfMediaPoolTypeID
 

使用好记的名称来指定媒体池中包含的媒体的类型。默认类型是包含其他媒体池的媒体池。
 

/d
 

允许媒体池可以从空闲媒体池中自动抽取媒体。如果不包含 /d 开关，则不允许媒体池从空闲媒体池中抽取媒体。
 

/r
 

允许媒体池将媒体自动返回到空闲媒体池。如果不包含 /r 开关，则不允许媒体池将媒体返回到空闲媒体池。
   

 

/?
 

在命令提示符下显示帮助。
   

 

语法

rsm deallocate /l{g | f}LogicalMediaID | /p{g | f}PartitionID

参数

 

/lgLogicalMediaID
 

使用 GUID 指定要解除分配的逻辑媒体。
 

/lfLogicalMediaID
 

使用好记的名称指定要解除分配的逻辑媒体。
 

/pgPartitionID
 

使用 GUID 指定要解除分配的媒体面。
 

/pfPartitionID
 

使用好记的名称指定要解除分配的媒体面。
   

 

/?
 

在命令提示符下显示帮助。
   

 

注释

 
• 逻辑媒体名或分区名可用来指定要解除分配的逻辑媒体，只要这些名称之一曾在 allocate 命令中用 /ln 或 /pn 开关项分别指定过。否则，就必须指定逻辑媒体 ID (LMID) 或分区 ID (PARTID)。

语法

rsm deletepool /mMediaPoolName

参数

 

/mMediaPoolName
 

指定要删除的媒体池的名称。
   

 

/?
 

在命令提示符下显示帮助。
   

 

语法

rsm dismount {/l{g | f}LogicalMediaID | /p{g | f}PartitionID}

  [/o[deferred]]

参数

 

/lgLogicalMediaID
 

使用 GUID 指定要卸除的逻辑媒体。
 

/lfLogicalMediaID
 

使用好记的名称指定要卸除的逻辑媒体。
 

/pgPartitionID
 

使用 GUID 指定要卸除的媒体面。
 

/pfPartitionID
 

使用好记的名称指定要卸除的媒体面。
 

/o
 

如果这个可选的开关与可选的 deferred 参数一起使用，则将媒体标记为可卸除，但媒体仍保留在驱动器中。以后的 mount 命令将无法正常完成。如果不使用该开关和参数，则媒体马上就会从驱动器中卸除。
 

/?
 

在命令提示符下显示帮助。

注释

 
• 逻辑媒体名或分区名可用来指定要卸除的逻辑媒体，只要这些名称之一曾在 allocate 命令中用 /ln 或 /pn 开关项分别指定过。否则，就必须指定逻辑媒体 ID (LMID) 或分区 ID (PARTID)。

要弹出的媒体可以由下面的四种方式之一来指定：

 
• 可以使用物理 ID (PMID) 或物理媒体名称来指定要弹出的物理媒体名称。
   
• 可以在指定库的指定插槽中弹出媒体。
   
• 可以在指定库的指定驱动器中弹出媒体。
   
• 可以通过指定 GUID 或好记的名称来弹出单独驱动器中的媒体。

语法

rsm eject {/p{g | f}PhysicalMediaID | /s{g | f}SlotID /l{g | f}ChangerID/LibraryID | /d{g | f}DriveID /l{g | f}LibraryID | /l{g | f}StandaloneLibraryID}

  [/oEjectOperationID]

  [/a{start | stop | queue}]

  [/b]

参数

 

/pgPhysicalMediaID
 

使用 GUID 指定要弹出的物理媒体。
 

/pfPhysicalMediaID
 

使用好记的名称指定要弹出的物理媒体。
 

/sgSlotID
 

使用 GUID 指定保存要弹出媒体的插槽。
 

/sfSlotID
 

使用好记的名称指定保存要弹出媒体的插槽。
 

/lgLibraryID
 

使用 GUID 指定包含要弹出的媒体的库（对于单独驱动器），或包含要从中弹出媒体的插槽或驱动器的库（对于自动库）。如果您正在指定一个自动程序库，该开关必须与 /s 或 /d 开关一起使用。
 

/lfLibraryID
 

使用好记的名称指定包含要弹出的媒体的库（对于单独驱动器），或包含要从中弹出媒体的插槽或驱动器的库（对于自动库）。如果您正在指定一个自动程序库，该开关必须与 /s 或 /d 开关一起使用。
 

/dgDriveID
 

使用 GUID 指定保存要弹出媒体的驱动器。
 

/dfDriveID
 

使用好记的名称指定保存要弹出媒体的驱动器。
 

/oEjectOperationID
 

用来为特定弹出操作指定 GUID。可选的 /o 开关可与 /a 开关及 stop 参数结合使用，以终止弹出操作。也可以与 /a 开关和 start 参数结合使用，以显示弹出操作的 GUID。
 

/a
 

允许使用下表列出的参数之一。
   
     
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
     
   

值	描述
Start	默认值是立即开始弹出操作。除非超时或者又发出了另一个 eject 命令，并带有 /a 命令行选项和 stop 参数，否则媒体将被弹出。该 eject 命令还必须用 /o 命令行选项指定弹出操作的 GUID。对于库，Timeout 参数在库对象中指定（对于所有弹出操作）。要设置该 Timeout 参数，必须使用可移动存储 API。该参数也可以与 /o 开关结合使用，以显示特定弹出操作的 GUID。
Stop	在超时之前终止弹出操作。特定弹出操作可以用 GUID 终止。该 GUID 是在使用 start 参数和 /a 开关及 /o 开关时显示的。
Queue	将媒体排队以便稍后弹出。该选项用于带有多个插入/弹出 (IE) 端口的库。

 

/b
 

出于编写脚本的目的，只显示弹出操作 GUID。
   

 

/?
 

在命令提示符下显示帮助。
   

 

语法

rsm ejectatapi /nAtapiChangerNumber

参数

 

/nAtapiChangerNumber
 

指定转换器编号。AtapiChangerNumber 是转换器的设备名称字符串结尾的编号。例如，\\.\CdChanger0 将 0 作为 ATAPI 转换器号。
   

 

/?
 

在命令提示符下显示帮助。
   

 

注释

 
• 在运行这个命令之前，请手动停止 ntmssvc 服务。

语法

rsm erase /p{g | f}PhysicalMediaID

  [/tTimeout]

  [/r{normal | high | low | highest | lowest}]

  [/b]

参数

 

/pgPhysicalMediaID
 

使用 GUID 指定要清除的磁带。
 

/pfPhysicalMediaID
 

使用好记的名称指定要清除的磁带。
 

/tTimeout
 

指定命令的超时值，单位为毫秒。默认的超时值无限制。
 

/r{normal | high | low | highest | lowest}
 

或者，为了清除磁带，指定 RSM 执行安装操作的优先级，通常情况下为默认值。
 

/b
 

为了编写脚本，请在完成时隐藏文本。
 

/?
 

在命令提示符下显示帮助。

语法

rsm freemedia {/p{g | f}PhysicalMediaID | /s{g | f}SlotID /l{g | f}ChangerID/LibraryID | /d{g | f}DriveID /l{g | f}ChangerID/library | /l{g | f}StandaloneLibraryID

  [/b]

参数

 

/pgPhysicalMediaID
 

使用 GUID 指定要清空的物理媒体。
 

/pfPhysicalMediaID
 

使用好记的名称指定要清空的物理媒体。
 

/sgSlotID
 

使用 GUID 指定保存要清空的媒体的插槽。
 

/sfSlotID
 

使用好记的名称指定保存要清空的媒体的插槽。
 

/lgLibraryID
 

使用 GUID 指定包含要清空的媒体的库（对于单独驱动器），或包含要从中弹出的媒体的插槽或驱动器的库（对于自动库）。如果您正在指定一个自动程序库，该开关必须与 /s 或 /d 开关一起使用。
 

/lfLibraryID
 

使用好记的名称指定包含要清空的媒体的库（对于单独驱动器），或包含要从中弹出的媒体的插槽或驱动器的库（对于自动库）。如果您正在指定一个自动程序库，该开关必须与 /s 或 /d 开关一起使用。
 

/dgDriveID
 

使用 GUID 指定保存要清空的媒体的驱动器。
 

/dfDriveID
 

使用好记的名称指定保存要清空的媒体的驱动器。
 

/b
 

出于编写脚本的目的，只显示弹出操作 GUID。
 

/?
 

在命令提示符下显示帮助。

注释

可以以四种方式之一指定要清空的媒体：

 
• 可以使用物理媒体 ID (PMID) 或物理媒体名称来指定物理媒体。
   
• 可以在指定库内的指定插槽中的媒体上写空白媒体标签。
   
• 可以在指定库内的指定驱动器中的媒体上写空白媒体标签。
   
• 可以通过指定库 GUID 或好记的名称来清空单独驱动器中的媒体。

语法

rsm inventory /l{g | f}LibraryID /a{full | fast | default | none | stop}

参数

 

/lfLibraryID
 

使用好记的名称指定要清点的库。
 

/lgLibraryID
 

使用 GUID 指定要清点的库。
 

/a{full | fast | default | none | stop}
 

必需。指定要执行的清点操作类型。下表列出了有效的清点操作。
   
     
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
     
   

值	描述
full	执行库的完整媒体清点。“可移动存储”装入库中的每个磁带和磁盘并读取媒体上的标识符。
fast	如果指定库安装了条形码阅读器，执行条形码清点。如果该库没有条形码阅读器，“可移动存储”检查存储插槽，读取先前为空的插槽中的媒体上的标识符。
default	使用库的“属性”对话框中指定的默认方法执行清点。
none	不执行清点。
stop	停止当前对指定库的清点，如果正在执行的话。

   

 

/?
 

在命令提示符下显示帮助。
   

 

要装入的逻辑媒体可通过逻辑媒体 ID 或逻辑媒体名称指定。

语法

rsm mount {/l{g | f}LogicalMediaID | /p{g | f}PartitionID | [/s{g | f}SlotID /c{g | f}ChangerID}

  [/d{g | f}DriveID]

  /o{errunavail | drive | read | write | offline}

  [/r{normal | high | low | highest | lowest}]

  [/tTimeout]

参数

 

/pfPartitionID
 

使用好记的名称指定要装入的媒体面。
 

/lfLogicalMediaID
 

使用好记的名称指定要装入的逻辑媒体。
 

/pgPartitionID
 

使用 GUID 指定要装入的媒体面。
 

/lgLogicalMediaID
 

使用 GUID 指定要装入的逻辑媒体。
 

/cgChangerID
 

使用 GUID 指定包含要装入媒体的转换器。该参数只能与 /sg 开关和插槽 GUID 一起使用，或者与 /sf 开关及好记的插槽名称一起使用。
 

/cfChangerID
 

使用好记的名称指定包含有要装入媒体的转换器。该参数只能与 /sg 开关和插槽 GUID 一起使用，或者与 /sf 开关及好记的插槽名称一起使用。
 

/sgSlotID
 

使用 GUID 指定包含要装入媒体的媒体槽。该参数只能与 /cg 开关和转换器 GUID 一起使用，或者与 /cf 及好记的转换器名称一起使用。
 

/sfSlotID
 

使用好记的名称指定包含有要装入媒体的媒体槽。该参数只能与 /cg 开关和转换器 GUID 一起使用，或者与 /cf 及好记的转换器名称一起使用。
 

/dgDriveID
 

使用 GUID 指定装入可用媒体的特定驱动器。该参数是可选的，并且必须与 /o 开关和 drive 参数一起使用。
 

/dfDriveID
 

使用好记的名称指定装入可用媒体的特定驱动器。该参数是可选的，并且必须与 /o 开关和 drive 参数一起使用。
 

/o{errunavail | drive | read | write | offline}
 

允许使用下表列出的参数之一。
   
     
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
     
   

值	描述
errunavail	如果媒体或驱动器不可用，该参数将产生一个错误。
drive	指定要装入的特定驱动器。该参数与 /d 开关一起使用。
read	装入媒体用于读取访问。
write	装入媒体用于写入访问。如果使用该参数，将装入完整的媒体。
offline	如果媒体脱机，该参数产生一个错误。

 

/r{normal | high | low | highest | lowest}
 

或者指定装入的顺序或优先权。装入优先权也可以使用下列参数之一来指定：normal（默认值）、high、low、highest 或 lowest。
 

/tTimeout
 

还可以指定命令的超时值，单位为毫秒。默认的超时值无限制。
   

 

/?
 

在命令提示符下显示帮助。
   

 

注释

 
• 在使用 mount 命令时，可以通过 /l 开关、/p 开关或 /s 开关与 /c 开关的组合指定要装入的媒体。

该命令只选出一个目标设备，以确保可移动存储数据库包含当前设备的状态。该命令在媒体插入或弹出操作之后非常有用。

语法

rsm refresh {/l{g | f}LibraryID | /p{g | f}PhysicalMediaID | /tgMediaTypeID}

参数

 

/lgLibraryID
 

使用 GUID 指定要刷新的库。
 

/lfLibraryID
 

使用好记的名称指定要刷新的库。
 

/pgPhysicalMediaID
 

使用 GUID 指定要刷新的物理媒体。
 

/pfPhysicalMediaID
 

使用好记的名称指定要刷新的物理媒体。
 

/tgMediaTypeID
 

指定要刷新的媒体类型。只能指定 GUID。该参数通过指定“可移动媒体”的 GUID，刷新所有可移动媒体设备。该 GUID 可以使用下面的 view 命令来确定：rsm view /tmedia_type /guiddisplay。
 

/?
 

在命令提示符下显示帮助。

语法

rsm rename /t{drive | library | changer | storageslot | iedoor | ieport | physical_media| media_pool | partition | logical_media | media_type | drive_type | librequest | oprequest | computer} {/f | /g}ObjectID /nNewName

  [/dNewDescription]

  [/b]

参数

 

/t{drive | library | changer | storageslot | iedoor | ieport | physical_media| media_pool | partition | logical_media | media_type | drive_type | librequest | oprequest | computer}
 

指出要用好记的名称或 GUID 指定的 RSM 对象的类型。
 

/fObjectID
 

使用好记的名称指定要重命名的对象。
 

/gObjectID
 

使用 GUID 指定要重命名的对象。
 

/nNewName
 

为 RSM 对象指定新的名称。
 

/dNewDescription
 

为 RSM 对象指定新描述。
 

/b
 

为了编写脚本，请在完成时隐藏文本。
 

/?
 

在命令提示符下显示帮助。

语法

rsm view /t{drive | library | changer | storageslot | iedoor | ieport | physical_media| media_pool | partition | logical_media | media_type | drive_type | librequest | oprequest | computer | ui_destination}

  [/cgContainerID][/uUIType]

  [/guiddisplay]

  [/desc]

  [/b]

参数

 

/t {drive | library | changer | storageslot | iedoor | ieport | physical_media| media_pool | partition | logical_media | media_type | drive_type | librequest | oprequest | computer | ui_destination}
 

显示指定类型的媒体对象列表。
 

/cgContainerID
 

指定对象容器的 GUID。容器的类型取决于由 /t 开关指定的对象类型（参数）。如果没有指定容器 ID，将显示适用对象类型的所有实例。
 

/uUIType
 

当与 /tui_destination 和 /cg 开关一起使用时，显示指定类型的 UI 消息被定向到的目标。类型可以是三个参数之一：
   
     
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
     
   

值	描述
info	提示性消息
req	实际正在“请求”的消息
err	错误信息

 

/guiddisplay
 

显式对象的 GUID 和好记的名称。
 

/desc
 

显示对象的描述。
 

/b
 

出于编写脚本的目的，只显示对象的 GUID。
 

/?
 

在命令提示符下显示帮助。

注释

 
• 如果没有使用 /guiddisplay 开关和 /b 开关，则只显示对象的好记的名称。
   
• 在指定 ui_destination 作为 /t 开关的对象类型时，必须使用 /cg 和 /u 开关。此外，以 /cg 开关指定的 ContainerID 必须是有效的库或计算机 GUID。如果指定了 /guiddisplay 或 /desc，它们将被忽略。

语法

rsm ui /oOperation

  /tUIType

  /{l | c}{f | g}ContainerID

  [/dDestination]

  [/b]

参数

 

/oOperation
 

使用下表中的参数之一指定是向目标列表中添加项目还是从中删除项目。
   
     
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
     
   

值	描述
add	向列表中添加新目标（计算机名）。
delete	从列表中删除现有目标。
deleteall	清除整个目标列表。当目标列表被清空时，/t 开关指定的 UI 消息类型将不出现在任何计算机上。

 

/tUIType
 

使用下表中的参数之一指定要为其设置目标的消息类型。
   
     
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
     
   

值	描述
INFO	提示性消息
REQ	实际正在“请求”的消息
ERR	错误信息

 

/cgContainerID
 

使用对象的 GUID 指定要为其重定向 /t 指定类型的消息的计算机对象。
 

/cfContainerID
 

使用对象的好记的名称指定要为其重定向 /t 指定的类型的消息的计算机对象。
 

/lgContainerID
 

使用对象的 GUID 指定要为其重定向 /t 指定的类型的消息的库对象。
 

/lfContainerID
 

使用对象的好记的名称指定要为其重定向 /t 指定的类型的消息的库对象。
 

/dDestination
 

指定要将消息重定向到其中的计算机。如果省略，则使用本地计算机。
 

/b
 

为了编写脚本，请在完成时隐藏文本。
 

/?
 

在命令提示符下显示帮助。