Ferramentas de Linha de Comando

Comando Rsm


( Retorna à Lista completa de comandos Shell )

Comando 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 /mnome_do_pool_de_mí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
/mnome_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.
new 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 usando 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 usando 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.
/lnnome_da_mídia_lógica
Especifica a mídia a ser alocada usando o nome da mídia lógica.
/lddescrição_da_mídia_lógica
Especifica a mídia a ser alocada usando a descrição da mídia lógica.
/pnnome_da_partição
Especifica a partição a ser alocada usando o nome da partição.
/pddescrição_da_partição
Especifica a partição de mídia a ser alocada usando a descrição da partição.
/ttempo_limite
Especifica o tempo limite do comando em milissegundos. O valor padrão de 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
É possível usar nomes de mídia lógica e, dessa forma, usar nomes do lado em outros comandos para especificar mídia 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 /mnome_do_pool_de_mídia /a{existing|always|new} [/t{g|f}id_do_tipo_do_pool_de_mídia] [/d] [/r]

Parâmetros
/mnome_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.
new Cria um novo pool de mídia ou retorna um erro se o pool de mídia especificado já existir.

/tgid_do_tipo_do_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.
/tfid_do_tipo_do_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_lógica | /p{g|f}id_da_partição

Parâmetros
/lgid_da_mídia_lógica
Especifica a mídia lógica a ser desalocada usando a GUID.
/lfid_da_mídia_lógica
Especifica a mídia lógica a ser desalocada usando o nome amigável.
/pgid_da_partição
Especifica o lado da mídia a ser desalocado usando a GUID.
/pfid_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 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 excluir um pool de mídia

Sintaxe
rsm deletepool /mnome_do_pool_de_mídia

Parâmetros
/mnome_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_da_mídia_lógica | /p{g|f}id_da_partição
rsm dismount [/o[deferred]]}

Parâmetros
/lgid_da_mídia_lógica
Especifica a mídia lógica a ser desmontada usando a GUID.
/lfid_da_mídia_lógica
Especifica a mídia lógica a ser desmontada usando o nome amigável.
/pgid_da_partição
Especifica o lado da mídia a ser desmontado usando a GUID.
/pfid_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

É possível especificar a mídia a ser ejetada de uma destas três 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.
Sintaxe
rsm eject {/p{g|f}id_da_mídia_física | /s{g|f}id_do_slot /l{g|f}id_da_biblioteca | /d{g|f}id_da_unidade /l{g|f}id_da_biblioteca
rsm eject [/oid_da_operação_de_ejeção]
rsm eject [/a{start|stop|queue}]
rsm eject [/b]

Parâmetros
/pgid_da_mídia_física
Especifica a mídia física a ser ejetada usando a GUID.
/pfid_da_mídia_física
Especifica a mídia física a ser ejetada usando o nome amigável.
/sgid_do_slot
Especifica o slot que contém a mídia a ser ejetada usando a GUID.
/sfid_do_slot
Especifica o slot que contém a mídia a ser ejetada usando o nome amigável.
/lgid_da_biblioteca
Usando a GUID, especifica a biblioteca que contém o slot ou a unidade da qual a mídia será ejetada.
/lfid_da_biblioteca
Usando o nome amigável, especifica a biblioteca que contém o slot ou a unidade da qual a mídia será ejetada.
/dgid_da_unidade
Usando a GUID, especifica a unidade que contém a mídia a ser ejetada.
/dfid_da_unidade
Usando o nome amigável, especifica a unidade que contém a mídia a ser ejetada.
/oid_da_operação_de_ejeção
Usado para especificar a GUID da operação de ejeção em particular. É possível usar a opção /o em conjunto com a opção /a e o parâmetro stop para finalizar uma operação de ejeção em particular. Você também pode usar este parâmetro em conjunto com a opção /a e o parâmetro start para exibir a GUID da operação de ejeção em particular.
/a
Permite o uso de um dos parâmetros listados na tabela a seguir. Valor Descrição
Start O padrão; inicia a operação de ejeção imediatamente. A mídia é ejetada até que um tempo limite seja atingido ou a menos que outro comando de ejeção seja emitido com a opção de linha de comando /a e o parâmetro stop. Tais comandos de ejeção também precisam especificar a GUID da operação de ejeção usando a opção de linha de comando /o. O parâmetro de tempo limite é especificado no objeto de biblioteca (para todas as operações de ejeção) da biblioteca. Para definir esse parâmetro, use a API do Armazenamento removível. Também pode ser usado em conjunto com a opção /o para exibir a GUID de uma operação de ejeção em particular.
Stop Finaliza a operação de ejeção antes de expirar o tempo limite. É possível determinar a operação de ejeção em particular usando a GUID exibida quando o parâmetro start é usado com as opções /a e /o.
Queue Enfileira as mídias para ejeção posterior. Pode ser usado em bibliotecas com portas de inserção/ejeção (IE) de vários slots.

/b
Exibe somente a GUID da operação de ejeção para fins de script.

/?
Exibe ajuda no prompt de comando.

Para ejetar mídias de um alterador ATAPI

Sintaxe
rsm ejectatapi /nnúmero_do_alterador_atapi

Parâmetros
/nnú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 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
/lfid_da_biblioteca
Especifica a biblioteca a ser inventariada usando o nome amigável.
/lgid_da_biblioteca
Especifica a biblioteca a ser inventariada usando a GUID.
/a
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}
rsm mount [/d{g|f}id_da_unidade]
rsm mount /o{errunavail|drive|read|write|offline}
rsm mount [/r{normal|high|low|highest|lowest}]
rsm mount [/ttempo_limite]

Parâmetros
/lfid_da_mídia_lógica
Especifica a mídia lógica a ser montada usando o nome amigável.
/pfid_da_partição
Especifica o lado da mídia a ser montado usando o nome amigável.
/pgid_da_partição
/lgid_da_mídia_lógica
Especifica a mídia lógica a ser montada usando a GUID.
Especifica o lado da mídia a ser montado usando a GUID.
/cgid_do_alterador
Usando a GUID, especifica o alterador que contém a mídia a ser montada. É possível usá-lo somente em conjunto com a opção /sg e a GUID do slot.
/cfid_do_alterador
Usando o nome amigável, especifica o alterador que contém a mídia a ser montada. É possível usá-lo somente em conjunto com a opção /sg e a GUID do slot.
/sgid_do_slot
Usando a GUID, especifica o slot de mídia que contém a mídia a ser montada. É possível usá-lo somente em conjunto com a opção /cg e a GUID do alterador.
/sfid_do_slot
Usando o nome amigável, especifica o slot de mídia que contém a mídia a ser montada. É possível usá-lo somente em conjunto com a opção /cg e a GUID do alterador.
/dgid_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.
/dfid_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
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
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
Como opção, especifica o tempo limite do comando em milissegundos. O tempo limite padrão é 600 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 | /tgid_do_tipo_de_mídia}

Parâmetros
/lgid_da_biblioteca
Especifica a biblioteca a ser atualizada usando a GUID.
/lfid_da_biblioteca
Especifica a biblioteca a ser atualizada usando o nome amigável.
/pgid_da_mídia_física
Especifica a mídia física a ser atualizada usando a GUID.
/pfid_da_mídia_física
Especifica a mídia física a ser atualizada usando o nome amigável.
/tgid_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 exibir uma lista de objetos de mídia

Sintaxe
rsm view /t{drive|library|changer|storageslot|iedoor|ieport|physical_media| media_pool|partition|logical_media|media_type|drive_type|librequest}
rsm view [/cgid_do_recipiente]
rsm view [/guiddisplay]
rsm view [/b]

Parâmetros
/t {drive|library|changer|storageslot|iedoor|ieport|physical_media| media_pool|partition|logical_media|media_type|drive_type|librequest}
Exibe uma lista de objetos de mídia do tipo especificado. Quando usado sem nenhum parâmetro, o comando exibe uma lista de todos os pools de mídia no sistema de Armazenamento removível (conjunto de bibliotecas).
/cgid_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.
/guiddisplay
Exibe a GUID e o nome amigável dos objetos.
/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.
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.

Sistemas Operacionais | Linux Comandos | Linux Shell Script | Atalhos do Office | Literatura e Leitura | Principais Autores | História da Literatura |


Formatando legenda
FormatoSignificado
Itálico Informações que o usuário deve fornecer
Negrito Elementos que o usuário deve digitar exatamente como mostrado
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
Fonte Courier Código ou resultado de um programa


Envie seu comentário:
Nome:

E-mail:

Comentário:


Fonte: •Manual do Windows XP • ( Literatura e Leitura ) • ( Dicas sobre Sistemas Operacionais ) • ( Retorna à Lista completa de comandos Shell ) •