Rsm

Rsm

Gerencia recursos de mídia usando o Armazenamento removível. Com o comando rsm, é possível executar scripts em lotes para aplicativos que não dão suporte no momento à API do Armazenamento Removível.

Para alocar mídias a partir de um pool de mídia

Sintaxe

rsm allocate /m Nome_do_Pool_deMídia /o{errunavail | new | next} [/l{g | f} ID_da_Mídia_Lógica | /p{g | f}ID_da_Partição] [/lnNome_da_Mídia_Lógica] [/ldDescrição_da_Mídia_Lógica] [/pnNome_da_Partição] [/pdDescrição_da_Partição] [/tTempo_Limite] [/b]

Parâmetros

/m Nome_do_Pool_de_Mídia
As mídias são alocadas do pool de mídia especificado. Isso significa que você terá alocado mídias nesse pool.
/o
Permite o uso de um dos parâmetros listados na tabela a seguir.

 

Valor Descrição

errunavail

Impede a submissão de uma solicitação do operador para novas mídias se nenhuma puder ser alocada com as restrições especificadas.

novo

Aloca uma partição que não pode ser compartilhada com outro aplicativo. Pode ser usado para reservar o segundo lado da mídia de dois lados.

next

Aloca o próximo lado da mídia que foi alocado anteriormente com o parâmetro new.

/l{g | f} ID_da_Mídia_Lógica
Especifica a mídia a ser alocada usando a identificação da mídia lógica. É possível usar a GUID (com a opção de linha de comando lg) ou o nome amigável (com a opção de linha de comando lf). ID_da_Mídia_Lógica especifica o próximo lado da mídia de vários lados a ser alocado. Este parâmetro é opcional e precisa ser usado com a opção de linha de comando /o e o parâmetro next. Depois que essa mídia é desalocada, a identificação da mídia lógica se torna inválida.
/p{g | f} ID_da_Partição
Especifica a partição a ser alocada com a identificação da partição. É possível usar a GUID (com a opção de linha de comando pg) ou o nome amigável (com a opção de linha de comando pf). Este parâmetro é opcional e continua persistente até depois que a mídia é desalocada.
/ln Nome_da_Mídia_Lógica
Especifica o nome amigável a ser atribuído ao objeto da mídia lógica da mídia alocada.
/ld Descrição_da_Mídia_Lógica
Especifica a descrição a ser atribuída ao objeto da mídia lógica da mídia alocada.
/pn Nome_da_Partição
Especifica o nome amigável a ser atribuído ao objeto da partição da mídia alocada.
/pd Descrição_da_Partição
Especifica a descrição a ser atribuída ao objeto da partição da mídia alocada.
/t Tempo_Limite
Especifica o tempo limite do comando em milissegundos. O valor padrão do tempo limite é infinito.
/b
Somente a GUID da operação de alocação é exibida. Isso ajuda no script em que você deseja transferir a saída de um comando para o próximo com o mínimo de análise.
/?
Exibe ajuda no prompt de comando.

Comentários

  • Nomes de mídia lógica e nomes de lado podem ser usados em outros comandos para especificar as mídias como o parâmetro para a opção /lf ou /pf, respectivamente. Se não forem usados nomes de mídia lógica (que são nomes amigáveis) com o comando allocate, será possível usar somente GUIDs em comandos subseqüentes para especificar mídias lógicas.

Para criar um pool de mídia

Sintaxe

rsm createpool /m Nome_do_Pool_de_Mídia /a{existing | always | new}[/t{g | f}ID_do_Tipo_de_Pool_de_Mídia][/d][/r]

Parâmetros

/m Nome_do_Pool_de_Mídia
Especifica o nome do pool de mídia a ser criado.
/a
Permite o uso de um dos parâmetros listados na tabela a seguir.

 

Valor Descrição

existing

Abre o pool de mídia existente ou retorna um erro se o pool de mídia especificado não existir.

always

Abre o pool de mídia existente ou cria um novo se o existente não for encontrado.

novo

Cria um novo pool de mídia ou retorna um erro se o pool de mídia especificado já existir.

/tg ID_do_Tipo_de_Pool_de_Mídia
Especifica o tipo de mídia que o pool de mídia conterá usando a GUID. O tipo padrão é um pool de mídia que contém outros pools.
/tf ID_do_Tipo_de_Pool_de_Mídia
Especifica o tipo de mídia que o pool de mídia conterá usando o nome amigável. O tipo padrão é um pool de mídia que contém outros pools.
/d
Permite que o pool de mídia extraia mídias automaticamente do pool de mídia livre. Se a opção /d não for incluída, o pool de mídia não terá permissão para extrair mídias do pool de mídia livre.
/r
Permite que o pool de mídia retorne mídias automaticamente para o pool de mídia livre. Se a opção /r não for incluída, o pool de mídia não terá permissão para retornar mídias para o pool de mídia livre.
/?
Exibe ajuda no prompt de comando.

Para desalocar mídias

Sintaxe

rsm deallocate /l{g | f}Id_da_Mídia_Local| /p{g | f}Id_da_Partição

Parâmetros

/lg Id_da_Mídia_Lógica
Especifica a mídia lógica a ser desalocada usando a GUID.
/lf Id_da_Mídia_Lógica
Especifica a mídia lógica a ser desalocada usando o nome amigável.
/pg Id_da_Partição
Especifica o lado da mídia a ser desalocado usando a GUID.
/pf Id_da_Partição
Especifica o lado da mídia a ser desalocado usando o nome amigável.
/?
Exibe ajuda no prompt de comando.

Comentários

  • Você poderá usar o nome da mídia lógica ou o nome da partição para especificar a mídia lógica a ser desalocada somente se um desses nomes tiver sido especificado com o comando allocate com a opção /ln ou /pn, respectivamente. Caso contrário, você precisará especificar a identificação da mídia lógica (LMID) ou a identificação da partição (PARTID).

Para excluir um pool de mídia

Sintaxe

rsm deletepool /m Nome_do_Pool_de_Mídia

Parâmetros

/m Nome_do_Pool_de_Mídia
Especifica o nome do pool de mídia a ser excluído.
/?
Exibe ajuda no prompt de comando.

Para desmontar mídias de uma unidade

Sintaxe

rsm dismount {/l{g | f}ID_de_Mídia_Lógica| /p{g | f}ID_da_Partição}[/o[deferred]]

Parâmetros

/lg ID_da_Mídia_Lógica
Especifica a mídia lógica a ser desmontada usando a GUID.
/lf ID_da_Mídia_Lógica
Especifica a mídia lógica a ser desmontada usando o nome amigável.
/pg ID_da_Partição
Especifica o lado da mídia a ser desmontado usando a GUID.
/pf ID_da_Partição
Especifica o lado da mídia a ser desmontado usando o nome amigável.
/o
Quando usada com o parâmetro opcional deferred, esta opção marcará a mídia como desmontável, mas ela será mantida na unidade. Os comandos mount subseqüentes poderão ser concluídos normalmente. Se esta opção não for utilizada, a mídia será desmontada de imediato da unidade.
/?
Exibe ajuda no prompt de comando.

Comentários

  • Você poderá usar o nome da mídia lógica ou o nome da partição para especificar a mídia lógica a ser desmontada somente se um desses nomes tiver sido especificado com o comando allocate usando a opção /ln ou /pn, respectivamente. Caso contrário, você precisará especificar a identificação da mídia lógica (LMID) ou a identificação da partição (PARTID).

Para ejetar mídias de uma biblioteca

A mídia a ser ejetada pode ser especificada em uma destas quatro maneiras:

  • Você pode especificar a mídia física a ser ejetada usando a identificação da mídia física (PMID) ou o nome da mídia física.
  • Você pode ejetar a mídia em um slot especificado dentro de uma biblioteca especificada.
  • Você pode ejetar a mídia em uma unidade especificada dentro de uma biblioteca especificada.
  • Você pode ejetar a mídia em uma unidade autônoma especificando o GUID ou nome amigável.

Sintaxe

rsm eject {/p{g | f}ID_da_Mídia_Física| /s{g | f}ID_do_Slot/l{g | f}ID_do_Alterador/ID_da_Biblioteca| /d{g | f}

ID_da_Unidade /l{g | f}ID_da_Biblioteca| /l{g | f}ID_da_Biblioteca_Autônoma}

[/oID_da_Operação_de_Ejeção]

[/a{start | stop | queue}]

[/b]

Parâmetros

Para ejetar mídias de um alterador ATAPI

Sintaxe

rsm ejectatapi /n Número_do_Alterador_Atapi

Parâmetros

/n Número_do_Alterador_Atapi
Especifica o número do alterador. Número_do_Alterador_Atapi é o número encontrado no final da seqüência correspondente ao nome de dispositivo do alterador. Por exemplo, o número do alterador ATAPI de \\.\CdChanger0 é 0.
/?
Exibe ajuda no prompt de comando.

Comentários

  • Antes de executar este comando, interrompa manualmente o serviço ntmssvc.

Para apagar o conteúdo de uma fita

Sintaxe

rsm erase /p{g | f}ID_da_Mídia_Física[/tTimeout]

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

Parâmetros

/pg ID_da_Mídia_Física
Especifica a fita a ser apagada, usando o GUID.
/pf ID_da_Mídia_Física
Especifica a fita a ser apagada, usando o nome amigável.
/t Tempo_Limite
Especifica o tempo limite do comando em milissegundos. O valor padrão do tempo limite é infinito.
/r{normal | high | low | highest | lowest}
Especifica, de forma opcional, a prioridade na qual o RSM deve executar a operação de montangem para apagar a filta; o padrão é normal.
/b
Oculta o texto após ser concluído, para fins de criação de scripts.
/?
Exibe ajuda no prompt de comando.

Para gravar um rótulo de mídia livre em uma mídia e retorná-la ao pool de mídia livre

Sintaxe

rsm freemedia {/p{g | f}ID_da_Mídia_Física| /s{g | f}ID_do_Slot/l{g | f}ID_do_Alterador/Id_da_Biblioteca| /d{g | f}Id_da_Unidade/l{g | f}ID_do_Alterador/Id_da_Biblioteca| /l{g | f}ID_da_Biblioteca_Autônoma[/b]

Parâmetros

/pg ID_da_Mídia_Física
Especifica a mídia física a ser liberada, usando o GUID.
/pf ID_da_Mídia_Física
Especifica a mídia física a ser liberada, usando o nome amigável.
/sg ID_do_Slot
Especifica o slot que contém a mídia a ser liberada, usando o GUID.
/sf ID_do_Slot
Especifica o slot que contém a mídia a ser liberada, usando o nome amigável.
/lg ID_da_Biblioteca
Especifica a biblioteca que contém a mídia a ser liberada (em uma unidade autônoma) ou a biblioteca que contém o slot ou a unidade da qual ejetar a mídia (em uma biblioteca automatizada), usando o GUID. Se estiver especificando uma biblioteca automatizada, esta opção deverá ser usada com a opção /s ou /d.
/lf ID_da_Biblioteca
Especifica a biblioteca que contém a mídia a ser liberada (em uma unidade autônoma) ou a biblioteca que contém o slot ou a unidade da qual ejetar a mídia (em uma biblioteca automatizada), usando o nome amigável. Se estiver especificando uma biblioteca automatizada, esta opção deverá ser usada com a opção /s ou /d.
/dg ID_da_Unidade
Especifica a unidade que contém a mídia a ser liberada, usando o GUID.
/df ID_da_Unidade
Especifica a unidade que contém a mídia a ser liberada, usando o nome amigável.
/b
Exibe somente o GUID da operação de ejeção para fins de script.
/?
Exibe ajuda no prompt de comando.

Comentários

Você pode especificar a mídia a ser ejetada em uma destas quatro maneiras:

  • É possível especificar a mídia física a ser ejetada usando a identificação da mídia física (PMID) ou o seu nome.
  • É possível gravar um rótulo de mídia livre na mídia em um slot especificado dentro de uma biblioteca especificada.
  • É possível gravar um rótulo de mídia livre na mídia em uma unidade especificada dentro de uma biblioteca especificada.
  • É possível liberar a mídia em uma unidade autônoma especificando o GUID da biblioteca ou o nome amigável.

Para inventariar a mídia em uma biblioteca automatizada especificada

Sintaxe

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

Parâmetros

/lf ID_da_Biblioteca
Especifica a biblioteca a ser inventariada usando o nome amigável.
/lg ID_da_Biblioteca
Especifica a biblioteca a ser inventariada usando a GUID.
/a{full | fast | default | none | stop}
Obrigatório. Especifica o tipo de operação de inventário que será realizado. A tabela a seguir lista operações de inventário válidas.

 

Valor Descrição

full

Realiza um inventário em mídia completo da biblioteca. O Armazenamento removível monta cada fita ou disco na biblioteca e lê o identificador na mídia.

fast

Realiza um inventário de código de barras se a biblioteca especificada possui uma leitora de código de barras instalada. Se a biblioteca não tiver uma leitora de código de barras, o Armazenamento removível verificará os slots de armazenamento e lerá o identificador em mídia, em slots que estavam vazios anteriormente.

default

Realiza um inventário usando o método padrão especificado na caixa de diálogo Propriedades da biblioteca.

none

Não realiza nenhum inventário.

stop

Interromperá o inventário atual da biblioteca especificada se um inventário estiver sendo realizado.

/?
Exibe ajuda no prompt de comando.

Para montar mídias na biblioteca designada

É possível especificar a mídia lógica a ser montada usando a identificação de mídia lógica (LMID) ou o nome de mídia lógica.

Sintaxe

rsm mount {/l{g | f}ID_da_Mídia_Lógica| /p{g | f}ID_da_Partição|[/s{g | f}ID_do_Slot/c{g | f}ID_do_Alterador}

[/d{g | f}ID_da_Unidade]/o{errunavail | drive | read | write | offline}

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

Parâmetros

/pf ID_da_Partição
Especifica o lado da mídia a ser montado usando o nome amigável.
/lf ID_da_Mídia_Lógica
Especifica a mídia lógica a ser montada usando o nome amigável.
/pg ID_da_Partição
Especifica o lado da mídia a ser montado usando a GUID.
/lg ID_da_Mídia_Lógica
Especifica a mídia lógica a ser montada usando a GUID.
/cg ID_do_Alterador
Usando a GUID, especifica o alterador que contém a mídia a ser montada. Só pode ser usado em conjunto com a opção /sg e o slot GUID ou com a opção /sf e o nome amigável do slot.
/cf ID_do_Alteador
Usando o nome amigável, especifica o alterador que contém a mídia a ser montada. Só pode ser usado em conjunto com a opção /sg e o slot GUID ou com a opção /sf e o nome amigável do slot.
/sg ID_do_Slot
Usando a GUID, especifica o slot de mídia que contém a mídia a ser montada. Só pode ser usado com a opção /cg e o alterador GUID, ou com a opção /cf e o nome amigável do alterador.
/sf ID_do_Slot
Usando o nome amigável, especifica o slot de mídia que contém a mídia a ser montada. Só pode ser usado com a opção /cg e o alterador GUID, ou com a opção /cf e o nome amigável do alterador.
/dg ID_da_Unidade
Usando a GUID, especifica a unidade determinada em que a mídia em questão será montada. Este parâmetro é opcional e precisa ser usado em conjunto com a opção /o e o parâmetro drive.
/df ID_da_Unidade
Usando o nome amigável, especifica a unidade determinada em que a mídia em questão será montada. Este parâmetro é opcional e precisa ser usado em conjunto com a opção /o e o parâmetro drive.
/o{ errunavail | drive| read | write| offline}
Permite o uso de um dos parâmetros listados na tabela a seguir.

 

Valor Descrição

errunavail

Gera um erro caso a mídia ou a unidade não esteja disponível.

drive

Especifica que uma unidade em particular deve ser montada. Este parâmetro é usado em conjunto com a opção /d.

read

Monta a mídia para acesso de leitura.

write

Monta a mídia para acesso de gravação. Se este parâmetro for utilizado, a mídia concluída não será montada.

offline

Gera um erro caso a mídia esteja off-line.

/r{ normal | high | low | highest | lowest}
Como opção, especifica a ordem de montagem ou a prioridade. Também é possível especificar a prioridade de montagem usando um dos parâmetros listados, normal (o padrão), high, low, highest ou lowest.
/t Tempo_Limite
Especifica, de forma opcional, o tempo limite do comando em milissegundos. O tempo limite padrão é infinito.
/?
Exibe ajuda no prompt de comando.

Comentários

  • Ao utilizar o comando de montagem, você pode especificar a mídia a ser montada usando a opção /l, a opção /p ou uma combinação das opções /s e /c.

Para atualizar uma biblioteca, mídia física ou todos os dispositivos de um determinado tipo de mídia.

Este comando causa uma única chamada seletiva dos dispositivos de destino, de forma que o banco de dados do Armazenamento removível contenha o estado atual do dispositivo. Pode ser útil após as operações de inserção ou ejeção de mídia.

Sintaxe

rsm refresh {/l{g | f}ID_da_Biblioteca| /p{g | f}ID_da_Mídia_Física| /tg_ID_de_Tipo_de_Mídia}

Parâmetros

/lg ID_da_Biblioteca
Especifica a biblioteca a ser atualizada usando a GUID.
/lf ID_da_Biblioteca
Especifica a biblioteca a ser atualizada usando o nome amigável.
/pg ID_da_Mídia_Física
Especifica a mídia física a ser atualizada usando a GUID.
/pf ID_da_Mídia_Física
Especifica a mídia física a ser atualizada usando o nome amigável.
/tg ID_do_Tipo_de_Mídia
Especifica o tipo de mídia a ser atualizado. Somente a GUID pode ser especificada. É possível usar este parâmetro para atualizar todos os dispositivos de mídia removível especificando a GUID da mídia removível. Para determinar essa GUID, use o comando view da seguinte maneira: rsm view /tmedia_type /guiddisplay.
/?
Exibe ajuda no prompt de comando.

Para alterar o nome amigável ou a descrição de um objeto RSM

Sintaxe

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}ID_do_Objeto /nNovo_Nome

[/dNova_Descrição][/b]

Parâmetros

/t{drive | library | changer | storageslot | iedoor | ieport | physical_media | media_pool | partition | logical_media | media_type | drive_type | librequest | oprequest | computer}
Indica o tipo de objeto RSM que você está especificando com o nome amigável ou GUID.
/f: ID_do_Objeto
Especificao objeto a ser renomeado, usando seu nome amigável.
/g ID_do_Objeto
Especificao objeto a ser renomeado, usando seu GUID.
/n Novo_Nome
Especifica o novo nome do objeto RSM.
/d Nova_Descrição
Especifica a nova descrição do objeto RSM.
/b
Oculta o texto após ser concluído, para fins de criação de scripts.
/?
Exibe ajuda no prompt de comando.

Para exibir uma lista de objetos de mídia ou de destinos de UI

Sintaxe

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}

[/cgID_do_Recipiente][/uTipo_de_UI][/guiddisplay][/desc][/b]

Parâmetros

/t {drive | library | changer | storageslot | iedoor | ieport | physical_media | media_pool | partition | logical_media | media_type | drive_type | librequest | oprequest | computer | ui_destination}
Exibe uma lista de objetos de mídia do tipo especificado.
/cg ID_do_Recipiente
Especifica a GUID do recipiente de objeto. O tipo do recipiente depende do tipo de objeto (parâmetro) especificado com a opção /t. Se a identificação do recipiente não for especificada, todas as ocorrências do tipo de objeto em questão serão exibidas.
/u Tipo_de_UI
Quando usado com as opções /tui_destination e /cg, exibe os destinos para os quais as mensagens de UI do tipo especificado são direcionadas. O tipo pode ser um dos três parâmetros:

 

Valor Descrição

info

Mensagens informativas

req

Mensagens cuja natureza é a de "solicitar" dados

err

Mensagens de erro

/guiddisplay
Exibe a GUID e o nome amigável dos objetos.
/desc
Exibe a descrição do objeto.
/b
Exibe somente a GUID do objeto para fins de script.
/?
Exibe ajuda no prompt de comando.

Comentários

  • Se as opções /guiddisplay e /b não forem usadas, somente os nomes amigáveis dos objetos serão exibidos.
  • Você deve usar as opções /cg e /u quando especificar ui_destination como o tipo de objeto para a opção /t. Além disso, o ID_do_Recipiente especificado com a opção /cg deve ser uma biblioteca ou um GUID de computador válido. Se /guiddisplay ou /desc for especificado, elas são ignoradas.

Para definir o destino das mensagens de UI

Sintaxe

rsm ui /o Operação /t Tipo_de_UI /{l | c}{f | g}ID_do_Recipiente

[/dDestino][/b]

Parâmetros

/o Operação
Especifica se deseja adicionar ou remover itens da lista de destinos, usando um dos parâmetros na tabela a seguir.

 

ValorDescrição

add

Adiciona um novo destino (nome de computador) à lista.

delete

Remove um destino existente da lista.

deleteall

Limpa toda a lista de destino. Quando a lista de destino estiver vazia, as mensagens de UI do tipo especificado pela opção /t não serão exibidas em nenhum computador.

/t Tipo_de_UI
Especifica o tipo de mensagem para o qual está configurando o destino, usando um dos parâmetros na tabela a seguir.

 

ValorDescrição

INFO

Mensagens informativas

REQ

Mensagens cuja natureza é a de "solicitar" dados

ERR

Mensagens de erro

/cg ID_do_Recipiente
Especifica o objeto computador para o qual você está redirecionando as mensagens do tipo especificado por /t, usando o GUID do objeto.
/cf ID_do_Recipiente
Especifica o objeto computador para o qual você está redirecionando as mensagens do tipo especificado por /t, usando o nome amigável do objeto.
/lg ID_do_Recipiente
Especifica o objeto biblioteca para o qual você está redirecionando as mensagens do tipo especificado por /t, usando o GUID do objeto.
/lf ID_do_Recipiente
Especifica o objeto biblioteca para o qual você está redirecionando as mensagens do tipo especificado por /t, usando o nome amigável do objeto.
/d Destino
Especifica o computador para o qual está redirecionando as mensagens. Se omitido, o computador local é usado.
/b
Oculta o texto após ser concluído, para fins de criação de scripts.
/?
Exibe ajuda no prompt de comando.

Comentários

  • Se um comando for executado com êxito, será retornado o código ERROR_SUCCESS. Todos os comandos que não obtêm êxito retornam um código de erro, o qual pode ser usado para fins de script. O código de erro pode ser definido pelo sistema ou ser um dos listados na tabela a seguir.

     

    Código de erro Descrição

    536870913

    Argumentos inválidos foram especificados. Geralmente, isso é causado por um espaço após uma opção de argumento, por exemplo, /t 50 em vez de /t50.

    536870914

    Opções de argumento duplicadas foram especificadas. Por exemplo, o comando allocate usado com duas opções /m.

    536870915

    Nenhuma GUID corresponde ao nome amigável que foi especificado. Verifique o uso de letras maiúsculas e minúsculas, pois os nomes amigáveis fazem distinção entre elas.

    536870916

    Um número insuficiente de opções de argumento foi especificado. Verifique se alguma opção necessária está faltando.

    536870917

    Uma GUID inválida foi especificada. Use o comando view para determinar a GUID correta de um objeto.

    536870918

    É retornado somente pelo comando ejectatapi. Verifique se o alterador ATAPI está funcionando corretamente.

    536870919

    Nenhuma correspondência foi encontrada para o objeto da unidade especificada. Use o comando view para determinar o nome amigável ou o GUID correto da unidade.

    536870920

    Nenhuma correspondência foi encontrada para o objeto do slot especificado. Use o comando view para determinar o nome amigável ou o GUID correto do slot.

Legenda da formatação

 

Formato Significado

Itálico

Informações que o usuário deve fornecer

Negrito

Elementos que o usuário deve digitar exatamente como é exibido

Reticências (...)

Parâmetro que pode ser repetido várias vezes em uma linha de comando

Entre colchetes ([])

Itens opcionais

Entre chaves ({}); opções separadas por barra vertical (|). Exemplo: {even|odd}

Conjunto de opções entre as quais o usuário deve escolher apenas uma

Courier font

Saída de código ou de programa

Consulte também

Contribuições da comunidade

Mostrar: