Tema anterior: Uso de los comandos de PowerShell de CA ARCserve RHA

Resume-Scenario: cómo reanudar una replicación sobre un réplica suspendido

El comando Resume-Scenario permite reanudar el proceso de replicación en un host de réplica suspendido. Una vez se reanuda la replicación, los cambios acumulados se transfieren y se aplican al réplica sin ninguna necesidad de resincronizar los datos de manera completa.

Sintaxis
Resume-Scenario [-Name] <String> [-Host] <String>
Parámetros
Nombre

El nombre del escenario.

hosts

El nombre del host de réplica suspendido que desea reanudar.

Ejemplo: cómo reanudar el proceso de replicación sobre un réplica suspendido

resume-scenario "File Server 1" 192.168.1.153

Resultado:

Scenario File Server 1 resumed on 192.168.1.153

Run-Scenario: inicio de un escenario

El comando Run-Scenario permite iniciar uno o varios escenarios.

Sintaxis
Run-Scenario [-Name] <String> [-Mode] <String> [-Ignore] <Boolean> 
Parámetros
Nombre

El nombre del escenario. Puede introducir varios nombres de escenario mediante el comando Get-scenario.

Modo

El modo de sincronización. Introduzca uno de los siguientes valores:

B=Binario

F=Archivo

Ignorar

Ignora los archivos con el mismo nombre y tamaño durante la comparación de datos. Introduzca uno de los siguientes valores:

1=Sí

0= No

Notas:

Ejemplo: cómo iniciar un escenario

run-scenario "File Server 1" F 1

Resultado:

Scenario File Server 1 Starting...

Run-Assessment: cómo ejecutar un escenario en el modo de evaluación

El comando Run-Assessment permite valorar el uso de la banda ancha exacto y evaluar de manera comparativa la relación de compresión que se necesita para la replicación, sin reproducir datos. Al ejecutar este comando, no se produce ninguna replicación pero las estadísticas se reúnen. Cuando se detiene el proceso de evaluación, se genera un informe.

Importante: no olvide detener el escenario que se está ejecutando en modo de evaluación una vez haya transcurrido el periodo que deseaba evaluar, mediante el comando Stop-Scenario.

Nota: Para ver el informe de evaluación tras su generación, abra el Centro de informes en la Página de presentación y seleccione el informe requerido.

Sintaxis
Run-Assessment [-Name] <String>
Parámetros
Nombre

El nombre del escenario.

Ejemplo: cómo ejecutar un escenario en el modo de evaluación

run-assessment "File Server 1"

Resultado:

Scenario File Server 1 executed successfully

Set-Bookmark: configuración de un marcador de rebobinado

Un marcador es un punto de control que se establece manualmente para marcar un estado al que puede que desee rebobinar. El comando Set-Bookmark permite establecer un marcador en un escenario determinado. Los marcadores se establecen en tiempo real, no para eventos pasados. Se recomienda establecer un marcador justo antes de cada actividad que pueda hacer que los datos sean inestables.

Notas:

Sintaxis
Set-Bookmark [-Name] <String> [[-Message] <String>]
Parámetros
Nombre

El nombre del escenario.

Mensaje (opcional)

El nombre del marcador. El nombre predeterminado incluye la fecha y el tiempo de la configuración de marcador.

Nota: Recomendamos que proporcione un nombre significativo al marcador, lo que ayudará más tarde a reconocerlo.

Ejemplo: cómo configurar un marcador de rebobinado

set-bookmark "File Server 1" Backup1

Resultado:

Scenario File Server 1: Rewind bookmark set successfully

Stop-Scenario: detención de un escenario

El comando Stop-Scenario permite detener uno o varios escenarios.

Nota: Para verificar que la operación se ha realizado correctamente, utilice los comandos Get-Scenario y Get-Events.

Sintaxis
Stop-Scenario [-Name] <String>  
Parámetros
Nombre

El nombre del escenario que desea detener. Puede introducir varios nombres de escenario mediante el comando Get-scenario.

Ejemplo: cómo detener un escenario

stop-scenario "File Server 1"

Resultado:

Scenario File Server 1 stopped

Suspend-IsAliveCheck: Cómo reanudar Suspend-IsAliveCheck de un escenario en ejecución

El comando Suspend-IsAliveCheck permite detener manualmente la comprobación de monitorización de un escenario de alta disponibilidad proporcionado.

Sintaxis
Suspend-IsAliveCheck [-ScenarioName] <String>  
Parámetros
ScenarioName

El nombre del escenario.

Ejemplo: Suspend IsAlive comprobación del escenario SQL

Suspend-IsAliveCheck escenario SQL

Resultado:

Reanuda la comprobación de monitorización periódica del escenario SQL.

Suspend-Scenario: suspensión de las actualizaciones en un réplica

El comando Suspend-Scenario permite dejar de proporcionar cambios a un réplica suspendido, de manera temporal. Durante la suspensión, los cambios se acumulan en spool hasta que la replicación se reanude para que no sea necesaria la resincronización.

Importante: es imprescindible que durante la suspensión no realice ninguna acción en el réplica que cambie los datos, incluido el inicio de alguna aplicación como, por ejemplo, el servidor Exchange, SQL Server u Oracle. Si es necesario iniciar programas que vayan a cambiar los datos del réplica, puede utilizar la opción de recuperación asegurada.

Notas:

Sintaxis
Suspend-Scenario [-Name] <String> [-Host] <String> 
Parámetros
Nombre

El nombre del escenario.

hosts

El host de réplica que desea suspender.

Ejemplo: suspensión de actualizaciones en un réplica

suspend-scenario "File Server 1" 192.168.1.153

Resultado:

Scenario File Server 1 Suspended on 192.168.1.153

Switchover-Scenario: cómo realizar una conmutación

El comando Switchover-Scenario permite iniciar el proceso de conmutación para un escenario de alta disponibilidad determinado. Para realizar una conmutación regresiva de funciones entre el master y el réplica, vuelva a utilizar el comando Switchover-Scenario.

Sintaxis
Switchover-Scenario [-Name] <String> 
Parámetros
Nombre

El nombre del escenario.

Ejemplo: ejecución de una conmutación

Switchover-Scenario "SQL Server 1"
Resultado
Scenario SQL Server 1 switching over to 192.168.1.153
Done!

Sync-Scenario: inicio de una sincronización

El comando Sync-Scenario permite sincronizar el servidor master y de réplica de un escenario determinado. Dicho proceso se puede activar manualmente en cualquier momento, independientemente de si la replicación está activada o no.

Sintaxis
Sync-Scenario [-Name] <String> [-Mode] <String> [-Ignore] <Boolean> 
Parámetros
Nombre

El nombre del escenario. Puede introducir varios nombres de escenario mediante el comando Get-scenario.

Modo

El modo de sincronización. Introduzca uno de los siguientes valores:

B=Binario

F=Archivo

Ignorar

Ignora los archivos con el mismo nombre y tamaño durante la comparación de datos. Introduzca uno de los siguientes valores:

1=Sí

0= No

Ejemplo: inicio de una sincronización

sync-scenario "File Server 1" F 1

Resultado:

Synchronization is running for scenario FS 1...
Done!

Test-Integrity: cómo realizar una prueba de integridad para la recuperación asegurada

El comando Test-Integrity permite activar la prueba de integridad automática en un host de réplica para la recuperación asegurada.

Notas:

Sintaxis
Test-Integrity [-Name] <String> [-Host] <String>
Parámetros
Nombre

El nombre del escenario.

hosts

La dirección IP o el nombre de host del host de réplica que desea comprobar.

Ejemplo: realización de una prueba de integridad para recuperación asegurada

Test-Integrity "Exchange Server 1" 192.168.1.153
Resultado
Integrity testing for assured recovery started on 192.168.1.153
Done!
Integrity testing for assured recovery completed on 192.168.1.153

Unmount-Snapshot: cómo desmontar una instantánea

El comando Unmount-Snapshot permite liberar una instantánea mostrada sin perder la instantánea en sí. La instantánea sigue mostrándose pero no utiliza ningún punto de montaje.

Sintaxis
Unmount-Snapshot [-Name] <String> [[-Index] [<Int32>]] [[-Port] [<String>]]
Parámetros
Nombre

El nombre del host cuya instantánea desea mostrar.

Índice

El número de índice de la instantánea, de la manera que lo devuelve el comando Get-Snapshot.

Puerto (opcional)

El puerto que se utiliza para conectarse con el host indicado. El puerto predeterminado es 25000.

Ejemplo: desmontaje de una instantánea

Unmount-Snapshot {97127d0b-f1c9-4db5-943d-96c39b712fe6} 1 
Resultado
Snapshot {97127d0b-f1c9-4db5-943d-96c39b712fe6} unmounted










Editar comandos

Esta sección describe los comandos de PowerShell de CA ARCserve RHA que permiten editar escenarios y grupos de escenarios.

Add-Dir: cómo agregar directorios raíz a los host master y de réplica

El comando Add-dir permite agregar directorios raíz a los host master y de réplica. Se puede definir la misma ruta del directorio raíz para el master y el réplica, o se pueden introducir dos rutas diferentes. Si no se introduce una ruta diferente para el réplica, de forma predeterminada será la misma que la ruta del master.

Sintaxis
Add-Dir [-Name] <String> [-MasterPath] <String> [[-ReplicaPath] [<String>]]  
Parámetros
Nombre

El nombre del escenario.

MasterPath

La ruta completa de los directorios raíz del servidor master.

ReplicaPath (Opcional)

La ruta completa de los directorios raíz del réplica. Si no se introduce ningún valor, se utilizará la misma ruta para el master y el réplica.

Ejemplo: cómo agregar el mismo directorio raíz al master y al réplica

add-dir "File Server 1" C:/Tools
Resultado
Root Directory: C:/Tools added successfully

Add-Group: creación de un grupo de escenarios

El comando Add-Group permite crear un nuevo grupo de escenarios.

Nota: Si no se ha definido ningún escenario, los grupos de escenarios vacíos no aparecerán en la Página de presentación.

Sintaxis
Add-Group [-Name] <String> 
Parámetros
Nombre

El nombre del nuevo grupo de escenarios.

Nota: Introduzca un nombre único, dado que no puede utilizar el mismo nombre para más de un grupo de escenarios. Si va a utilizar un nombre existente para el nuevo grupo, el sistema lo cambiará automáticamente.

Ejemplo: creación de un nuevo grupo de escenarios

add-group "File Server Scenarios"
Resultado
Group File Server Scenarios added successfully

Add-Master: cómo agregar un host master a un escenario

El comando Add-Master permite agregar un host master a un escenario facilitado. Al definir un host master, es necesario introducir el nombre de host. También puede introducir la dirección IP del master, pero este parámetro no es obligatorio.

Notas:

Sintaxis
Add-Master [-Name] <String> [-Host] <String> [[-IP] [<String>]] 
Parámetros
Nombre

El nombre del escenario.

hosts

El nombre de host del nuevo servidor master.

IP (opcional)

La dirección IP del nuevo servidor master. Si no hay definida una dirección IP, el sistema la busca de forma predeterminada valiéndose del nombre de host especificado. Utilizará la primera dirección IP que encuentre. Por esta razón, si el host tiene varias direcciones IP es recomendable introducir aquí la dirección IP que se quiere utilizar.

Ejemplo: cómo agregar un host master a un escenario

add-master "File Server 1" 130.119.185.152
Resultado
Master 130.119.185.152 added successfully

Add-Replica: cómo agregar un host de réplica a un escenario

El comando Add-Replica permite agregar un host de réplica a un escenario facilitado. Al definir un host de réplica, es necesario introducir el nombre de host y también, aunque de forma opcional, la dirección IP. A continuación, deberá introducir el host master, que puede ser master u otra réplica.

Nota: Se puede introducir la dirección IP como el nombre de host.

Si se utilizan delegaciones de seguridad ACL, se deben introducir los valores de otros tres parámetros: UserName, Password y DomainName.

Sintaxis
Add-Replica [-Name] <String> [-Host] <String> [[-IP] [<String>]] [-Parent] <String> [[-UserName] <String>] [[-Password] <String>] [[-DomainName] <String>]
Parámetros
Nombre

El nombre del escenario.

hosts

El nombre de host de la nueva réplica.

IP (opcional)

La dirección IP de la nueva réplica. Si no hay definida una dirección IP, el sistema la busca de forma predeterminada valiéndose del nombre de host especificado. Utilizará la primera dirección IP que encuentre. Por esta razón, si el host tiene varias direcciones IP es recomendable introducir aquí la dirección IP que se quiere utilizar.

Principal

El host principal del host de réplica nuevo. El principal puede ser el master o un réplica ascendente, y es posible usar su nombre de host o la dirección IP.

UserName; Password;DomainName (sólo ACL)

El nombre de usuario, la contraseña y el dominio de un usuario que tenga derechos para agregar un nuevo host de réplica.

Ejemplo: cómo agregar un host de réplica a un escenario

add-replica "File Server 1" 130.119.185.153 -parent 130.119.185.152
Resultado
Replica 130.119.185.153 added successfully

Add Replicas: cómo agregar varios host de réplica a un escenario

El comando Add-Replicas permite agregar varios host de réplica a la vez a un escenario determinado. Para agregar varios host de réplica, es necesario crear un archivo de texto que contenga los nombres de host y las direcciones IP de los hosts. Si utiliza este comando, defina en primer lugar el nombre de escenario y el host principal de todos los host de réplica que desee agregar. A continuación, especifique el nombre y la ruta del archivo que contenga la información de los nuevos host.

Sintaxis
Add-Replicas [-ScenarioName] <String> [-ParentHost] <String> [-FileName] <String>
Parámetros
ScenarioName

El nombre del escenario.

ParentHost

El host principal del host de réplica nuevo. El principal puede ser el master o un réplica ascendente, y es posible usar su nombre de host o la dirección IP.

FileName

Un archivo de texto que contiene los nombres de host y sus direcciones IP. El texto debería tener este formato:

#nombre de host Dirección IP

QA95-W2K3-SQL1 *130.119.185.155

QA95-W2K3-EX2 *130.119.185.153

UserName; Password;DomainName (sólo ACL)

El nombre de usuario, la contraseña y el dominio de un usuario que tenga derechos para agregar nuevos host de réplica.

Ejemplo: cómo agregar varios host de réplica a un escenario

add-replicas "Exchange Server" QA95-W2K3-EX1 D:\New_Replica_Hosts.txt
Resultado
130.119.185.151 QA95-W2K3-EX1
130.119.185.152 QA95-W2K3-EX2
Se han agregado 2 réplicas.

Add-Scenario: creación de un nuevo escenario

El comando Add-Scenario permite crear un nuevo escenario. Al crear un nuevo escenario, es necesario definir los siguientes parámetros:

El nuevo escenario se crea sin host ni directorios raíz. Estos parámetros se definen en una fase posterior, mediante los comandos Add-Master, Add-Replica y Add-Dir.

Sintaxis
Add-Scenario [-Name] <String> [[-Group] [<String>]] [[-Application] [<String>]] [[-Type] [<String>]] [[-AR] [<Boolean>] 
Parámetros
Nombre

El nombre del nuevo escenario.

Nota: Introduzca un nombre único, dado que no se puede utilizar el mismo nombre para más de un escenario. Si va a usar un nombre existente para el nuevo escenario, el sistema lo cambiará automáticamente.

Grupo (opcional)

El nombre de grupo de escenarios que contiene el nuevo escenario.

Notas:

  • Si no se introduce un nombre de grupo, el nuevo escenario se asignará al grupo predeterminado Scenarios.
  • Puede crear aquí un nuevo grupo de escenarios, introduciendo un nuevo nombre de grupo. Puede crear también un nuevo grupo de escenarios utilizando el comando Add-Group.
Aplicación

El tipo de servidor cuyos datos se reproducirán:

  • EX: Exchange
  • SQL:SQL Server
  • ORA: Oracle
  • IIS: Servidor de información de Internet
  • FS: Servidor de archivos
Tipo

El tipo de solución:

  • DR: Replicación/Recuperación de desastres
  • HA: Alta disponibilidad
Recuperación asegurada

Especifica la ejecución de una prueba de recuperación asegurada de la capacidad de recuperación de los datos en el servidor réplica:

  • 0 : No
  • 1: Sí

Ejemplo: creación de un nuevo escenario

add-scenario "File Server 1" "File Server Scenarios" FS DR 0
Resultado
Scenario File Server 1 added successfully

Remove-Dir: cómo eliminar directorios raíz del master y del réplica

El comando Remove-Dir permite eliminar directorios raíz de los host master y de réplica.

Nota: No es posible eliminar un directorio raíz desde el réplica sólo a través de este comando. Cuando elimine los directorios raíz del master, también se eliminarán los directorios raíz correspondientes del réplica.

Sintaxis
Remove-Dir [-Name] <String> [-MasterPath] <String> 
Parámetros
Nombre

El nombre del escenario.

MasterPath

La ruta del directorio raíz en el master.

Ejemplo: cómo eliminar un directorio raíz del servidor master y del réplica

remove-dir "File Server 1" C:/Tools

Resultado:

Root Directory: C:/Tools removed

Remove-Group: supresión de un grupo de escenarios

El comando Remove-Group permite eliminar un determinado grupo de escenarios.

Nota: Puede eliminar solamente un grupo de escenarios vacío. Si desea eliminar un grupo que contenga escenarios, antes deberá eliminar los escenarios.

Sintaxis
Remove-Group [-Name] <String> 
Parámetros
Nombre

El nombre del grupo de escenarios que desea suprimir.

Ejemplo: supresión de un grupo de usuarios

remove-group "new group 1"
Resultado
Group new group 1 removed

Remove-Replica: cómo eliminar un host de réplica de un escenario

El comando Remove-Replica permite eliminar un host de réplica de un escenario en particular.

Sintaxis
Remove-Replica [-Name] <String> [-Host] <String> [-Parent] <String>
Parámetros
Nombre

El nombre del escenario.

hosts

El nombre del host de réplica que desea eliminar.

Principal

El principal del host de réplica que desea eliminar en el árbol de replicación. Es posible que sea el master o un réplica ascendente.

Ejemplo: cómo eliminar un host de réplica de un escenario

remove-replica "FS 1" 130.119.185.153 -parent 130.119.185.152
Resultado
Replica 130.119.185.153 removed   

Remove-Scenario: supresión de un escenario

El comando Remove-Scenario permite eliminar un determinado escenario.

Nota: No se puede suprimir un escenario en ejecución.

Sintaxis
Remove-Scenario [-Name] <String> 
Parámetros
Nombre

El nombre del escenario que desea suprimir.

Ejemplo: eliminación de un escenario

remove-scenario "File Server 2"
Resultado
Scenario File Server 2 removed

Rename-Group: cómo renombrar un grupo de escenarios

El comando Rename-Group permite cambiar el nombre de un grupo de escenarios determinado.

Sintaxis
Rename-Group [-Name] <String> [-NewName] <String> 
Parámetros
Nombre

El nombre actual del grupo de escenarios.

NewName

El nombre nuevo del grupo de escenarios.

Nota: Introduzca un nombre único, dado que no puede utilizar el mismo nombre para más de un grupo de escenarios. En el caso de que utilice un nombre que ya existe para el grupo de escenarios, el sistema lo cambiará automáticamente.

Ejemplo: cómo renombrar un grupo de escenarios

rename-group Server "Exchange Server Scenarios"
Resultado
Group Server renamed!

Rename-Scenario: cambio del nombre de escenario

El comando Rename-Scenario permite cambiar el nombre de un escenario determinado.

Nota: No es posible cambiar el nombre de un escenario en ejecución. Para cambiar el nombre, es necesario detenerlo primero.

Sintaxis
Rename-Scenario [-Name] <String> [-NewName] <String> 
Parámetros
Nombre

El nombre actual del escenario.

Nombre nuevo

El nombre nuevo del escenario.

Ejemplo:

rename-scenario "File Server 1" "File Server"
Resultado
Scenario File Server 1 renamed!













Comandos para cambiar escenarios durante la ejecución

Ahora se pueden cambiar ciertas propiedades del escenario durante la ejecución de un escenario. Esta sección enumera la sintaxis y los ejemplos para los comandos que se aplican a la edición de un escenario mientras se ejecuta.

Apply-AllPendingRuntmeChangeableScenarioProperties

El comando Apply-AllPendingRuntimeChangeableScenarioProperties permite aplicar todos los cambios a todos los escenarios modificados en el tiempo de ejecución.

Sintaxis
Apply-AllPendingRuntimeChangeableScenarioProperties
Parámetros

Ninguno

Ejemplo

Imagínese que cambia las propiedades en varios escenarios. Estos cambios todavía están pendientes. Para aplicarlos inmediatamente, utilice este comando.

Apply-PendingRuntimeChangeableScenarioProperties

El comando Apply-PendingRuntimeChangeableScenarioProperties permite aplicar todos los cambios al escenario especificado en ejecución.

Sintaxis
Apply-PendingRuntimeChangeableScenarioProperties [Name]
Parámetros

Nombre: el nombre del escenario en ejecución que desee modificar.

Ejemplo

El comando siguiente aplica cambios al escenario denominado Servidor de archivos:

Apply-PendingRuntimeChangeableScenarioProperties FileServer
Resultado

El resultado es una lista de propiedades y sus valores:

error_source : engine_verification_error

error_level: Error

host_index: 2

root_dir_index: 0

property_xpath: Scenario.ReplicationTree.ReplNode.ReplNode.SpecificReplicaProps. ReplicaScheduledTask.Suspend.SuspendScript.Path


Discard-AllPendingRuntimeChangeableScenarioProperties

El comando Discard-AllPendingRuntimeChangeableScenarioProperties cancela todos los cambios que se han configurado para todos los escenarios.

Sintaxis
Discard-AllPendingRuntimeChangeableScenarioProperties
Parámetros

Ninguno

Discard-RuntimeChangeableScenarioProperties

El comando Discard-RuntimeChangeableScenarioProperties permite cancelar algunos cambios realizados en el escenario en ejecución especificado.

Sintaxis
Discard-RuntimeChangeableScenarioProperties [Name]
Parámetros

Nombre: éste es el nombre del escenario en ejecución para el cual desea descartar los cambios.

Ejemplo

Si se han realizado muchos cambios en un escenario en ejecución denominado Servidor de archivos y se detectan problemas, utilice el comando siguiente para volver a configurar a todos los valores originales:

Discard-RuntimeChangeableScenarioProperties FileServer
Resultado

Todos los cambios realizados en el escenario denominado Servidor de archivos se vuelven a restablecer a los valores originales.

Si desea volver a establecer una propiedad específica a su valor original, utilice el comando Set-RuntimeChangeableScenarioProperties para cambiar solamente la propiedad especificada del escenario en ejecución. Tenga en cuenta que al descartar cambios, se suprimen todos los registros en la lista Get-AllPendingRuntimeChangeableScenarioProperties. La ejecución de Apply-PendingRuntimeChangeableScenarioProperties da lugar a un mensaje de advertencia que indica que el escenario especificado no se ha modificado en el tiempo de ejecución.

Get-AllPendingRuntimeChangeableScenarioProperties

El comando Get-AllPendingRuntimeChangeableScenarioProperties enumera todos los escenarios que se han modificado durante la ejecución.

Sintaxis
Get-AllPendingRuntimeChangeableScenarioProperties
Parámetros

Ninguno

Ejemplo

El comando siguiente enumera todos los escenarios modificados durante la ejecución.

Get-AllPendingRuntimeChangeableScenarioProperties
Resultado

El resultado es una lista de nombres de escenario.

Get-AllRuntimeChangeableScenarioProperties

El comando Get-AllRuntimeChangeableScenarioProperties permite enumerar todas las propiedades que pueden modificarse durante la ejecución de un escenario.

Sintaxis
get-AllRuntimeChangeableScenarioProperties
Parámetros

Ninguno

Ejemplo:

El siguiente código emite el comando a fin de enumerar todas las propiedades editables y volver a dirigir el resultado a un archivo de texto.

Get-AllRuntimeChangeableScenarioProperties > d:\1.txt
Resultado

El resultado es un conjunto de las propiedades editables en el formato Escenario/Master/Réplica/Nombre de propiedad.

Get-RuntimeChangeableScenarioProperties

El comando Get-RuntimeChangeableScenarioProperties permite encontrar todas las propiedades que se pueden editar mientras se ejecuta el escenario especificado. El comando devuelve una lista de las propiedades que se pueden cambiar para el escenario. Combine los comandos de redireccionamiento E/S para dar formato al resultado en un archivo de texto.

Sintaxis
Get-RuntimeChangeableScenarioProperties [Name]
Parámetros

Nombre: el nombre del escenario en ejecución

Ejemplo:

El comando siguiente enumera todas las propiedades editables para el escenario denominado Escenario del Servidor de archivos 1:

Get-RuntimeChangeableScenarioProperties FileServerScenario1
Resultado

Propiedad: Falso

Host: 10.0.0.0

Valor: Falso

Índice: 111

Categoría: Réplica

Name: SpecificReplicaProps.Suspend.SuspendScript

Get-PendingRuntimeChangeableScenarioProperties

El comando Get-PendingRuntimeChangeableScenarioProperties permite enumerar todos los cambios realizados en el escenario en ejecución especificado.

Sintaxis
Get-PendingRuntimeChangeableScenarioProperties [Name]
Parámetros

Nombre: el nombre del escenario en ejecución

Ejemplo:

El ejemplo siguiente muestra la lista de todas las propiedades modificadas para el escenario denominado Servidor de archivos:

Get-PendingRuntimeChangeableScenarioProperties FileServer
Resultado

El resultado es una lista de propiedades, los valores originales y los nuevos valores.

Set-RuntimeChangeableScenarioProperty

El comando Set-RuntimeChangeableScenarioProperty permite actualizar el valor de la propiedad especificada en el escenario denominado mientras está ejecutándose.

Sintaxis
Set-RuntimeChangeableScenarioProperty [Name] [Index] [Value] [Host]
Parámetros

Nombre: el nombre del escenario en ejecución cuyas propiedades desee cambiar.

Índice: el índice o nombre de la propiedad que desee cambiar. Para determinar los nombres correctos, utilice los comandos Get-AllRuntimeChangeableScenarioProperties o Get-RuntimeChangeableScenarioProperties. El valor de índice se genera de manera interna; para dos escenarios incluso del mismo tipo, la misma propiedad puede tener un índice diferente. Asegúrese de que se obtienen los índices o nombres correctos.

Valor: la nueva configuración para la propiedad especificada.

Host: (opcional) Es necesario especificar el host solamente para los cambios de la propiedad del master o del réplica. Para las propiedades genéricas o de HA, este valor es opcional.

Ejemplo:

El comando siguiente actualiza el argumento de la propiedad de script suspendida en función del nombre:

Set-RuntimeChangeableScenarioProperty FileServer SpecificReplicaProps.Suspend.SuspendScript 456 -Host 10.0.0.1
Resultado

El resultado es una tabla que muestra Propiedad, Valor original y Nuevo valor.

Test-RuntimeChangeableScenarioProperty

El comando Test-RuntimeChangeableScenarioProperty permite confirmar si la propiedad especificada todavía puede editarse durante la ejecución del escenario.

Sintaxis
Test-RuntimeChangeableScenarioProperty [Name] [Index] [Host]
Parámetros

Nombre: el nombre del escenario en ejecución

Índice: el índice o nombre de la propiedad que desee probar

Host: opcional

Ejemplo

El comando siguiente prueba la propiedad cuyo índice es 113 para un escenario en ejecución denominado Servidor de archivos.

Test-RuntimeChangeableScenarioProperty FileServer 113 -host 10.0.0.3
Resultado

El resultado es un valor verdadero o falso para el índice o el nombre de propiedad especificado.

Comandos de supervisión

Esta sección describe los comandos de PowerShell de CA ARCserve RHA que permiten controlar los procesos de recuperación de desastres y de alta disponibilidad.

Get-Dirs: enumeración de todos los directorios raíz de un escenario

El comando Get-Dirs permite enumerar todos los directorios raíz de un escenario determinado.

Sintaxis
Get-Dirs [-Name] <String> 
Parámetros
Nombre

El nombre del escenario.

Ejemplo: cómo enumerar los directorios raíz de un escenario en particular

get-dirs "Servidor de archivos 1"
Resultado
ID       : 2721474912
Scenario : File Server 1
Master   : 192.168.1.152
Path     : C:/Tools
DB       : False

Get-Events: enumeración de todos los eventos de un escenario

El comando Get-Events muestra una lista de eventos de replicación de un escenario determinado. La lista de eventos puede incluir eventos de información, de advertencia y de error. La información mostrada está formada por el ID de evento, la fecha y hora del evento, el nombre del escenario, la severidad del evento y el mensaje del evento.

Sintaxis
Get-Events [-Name] <String> 
Parámetros
Nombre

El nombre del escenario cuyos eventos desea ver.

Ejemplo: enumeración de los eventos de un escenario determinado en una tabla de formato de tamaño automático

get-events "File Server 1" | FT -auto
Resultado
ID      Time                  Scenario      Severity    Message
--      ----                  --------      --------    -------
SM00165 10/28/2008 6:02:52 PM File Server 1 Significant Connected to...
SR00014 10/30/2008 7:17:31 PM File Server 1 Significant Starting...
SR00139 10/30/2008 7:17:35 PM File Server 1 Significant Starting File...
IR00119 10/30/2008 7:18:16 PM File Server 1 Info        Root directory...
SR00120 10/30/2008 7:18:16 PM File Server 1 Significant Synchronization..
IM00405 10/30/2008 7:15:06 PM File Server 1 Info        Posting... 
SR00202 10/30/2008 7:18:21 PM File Server 1 Significant All modifications...
SR00096 11/3/2008 6:47:40 PM  File Server 1 Significant Stopping scenario...

Get-Group: enumeración de los grupos que tienen un nombre determinado

El comando Get-Group permite enumerar todos los grupos de escenario que tienen un nombre determinado. Para mostrar esta lista, es necesario introducir el nombre que busca.

Además, el comando permite obtener una lista de todos los grupos de escenario existentes. Para mostrar en una lista todos los grupos de escenarios, basta con introducir el comando sin un nombre de escenario.

Sintaxis
Get-group [[-GroupName] [<String>]]
Parámetros
Nombre

El nombre del grupo de escenarios.

Nota: Es posible usar los caracteres comodín '*" o "?" como parte del nombre del grupo de escenarios.

Ejemplo: enumeración de todos los grupos de escenario que tienen un nombre determinado

get-group *Server*
Resultado
File Server Scenarios 2
File Server Scenarios 1
Exchange Server Scenarios
File Server Scenarios

Get-Hosts: enumeración de todos los hosts de un escenario

El comando Get-Hosts permite enumerar todos los host de un escenario en concreto.

Sintaxis
Get-Hosts [-Name] <String> 
Parámetros
Nombre

El nombre del escenario.

Ejemplo: listado de los host de un escenario determinado en una tabla de formato de tamaño automático

Get-Hosts "File Server 1" |FT -auto
Resultado
Scenario      Name          Role    Parent         State   IP            Port
--------      ----          ----    ------         -----   --            ----
File Server 1 192.168.1.152 Master  --             Running 192.168.1.152 25000
File Server 1 192.168.1.153 Replica 1192.168.1.152 Running 192.168.1.153 25000

Get-Scenario: enumeración de los escenarios que tienen un nombre determinado

El comando Get-Scenario permite enumerar todos los escenarios que tienen un nombre determinado. Para mostrar esta lista, es necesario introducir el nombre que busca.

Además, este comando permite obtener una lista de todos los escenarios existentes. Para enumerar todos los escenarios, simplemente debe introducirse el comando sin un nombre de escenario.

Sintaxis
Get-Scenario [[-Name] [<String>]] 
Parámetros
Nombre

El nombre del escenario.

Nota: Es posible usar los caracteres comodín '*" o "?" como parte del nombre de escenario.

Ejemplo: listado de todos los escenarios que llevan un nombre determinado en una tabla de formato de tamaño automático

get-scenario File* |FT -auto
Resultado
ID         Group     Name          Type       Master         State   Sync AR
--         -----     ----          ----       ------         -----   ---- --
1123633852 Scenarios FileServer    FileServer                Unknown File False
1123633468 Scenarios File Server 1 FileServer 192.168.1.153  Stopped File False

Get-Snapshot: cómo mostrar las instantáneas VSS de un host de réplica

El comando Get-Snapshot permite mostrar todas las instantáneas VSS de un host de réplica determinado.

Sintaxis
Get-Snapshot [-Name] <String> [[-Port] <String>]
Parámetros
Nombre

El nombre del host tal y como aparece en el escenario.

Puerto (opcional)

El puerto de conexión con el host indicado. El número de puerto predeterminado es 25000.

Ejemplo: muestra de todas las instantáneas VSS en un determinado host de réplica en una tabla de formato de tamaño automático

Get-Snapshot 130.119.173.7 |FT -auto
Resultado
Index Snapshot        Created               Exposed Mounted     Drive Scenario
----- --------        -------               ------- -------     ----- --------
0     {4f2bb053-5f2d} 11/18/2008 4:03:09 PM False   Not Mounted C:/   FileServer
1     {bcbdda2b-6165} 11/18/2008 4:06:00 PM False   Not Mounted C:/   FileServer
2     {c1f206be-2ad0} 11/18/2008 4:07:17 PM False   Not Mounted C:/   FileServer

Get-State: enumeración de todos los escenarios definidos para un host determinado

El comando Get-State permite obtener una lista de todos los escenarios que están definidos para un host determinado, junto con sus datos y estados.

Sintaxis
Get-State [-Name] <String> 
Parámetros
Nombre

El nombre del host.

Ejemplo:

get-state 130.119.185.152
Resultado
ID     : 2505374864
Group  : FS Scenarios
Name   : FS 1
Type   : FileServer
Master : 130.119.185.152
State  : Running
Sync   : File
AR     : False

ID     : 2721467841
Group  : File Server Scenarios
Name   : File Server 1
Type   : FileServer
Master : 130.119.185.152
State  : Stopped
Sync   : File
AR     : False

Get-Stats: muestra de las estadísticas de replicación de un escenario

El comando Get-Stats permite mostrar las estadísticas del escenario por host durante una ejecución.

Sintaxis
Get-Stats [-Name] <String> 
Parámetros
Nombre

El nombre del escenario.

Ejemplo: muestra de las estadísticas de replicación de un escenario determinado mientras se ejecuta

get-stats "File Server 1"
Resultado
Scenario    : File Server 1
Nombre        : 192.168.1.152
Role        : Master
Spool_Size  : 0
Sync_Files  : 345
Sync_MBytes : 86
Rep_MBytes  : 0

Scenario    : File Server 1
Nombre        : 192.168.1.153
Role        : Replica
Spool_Size  : 0
Sync_Files  : 345
Sync_MBytes : 86
Rep_MBytes  : 0 

Comandos de gestión de usuarios

En esta sección se describen los comandos de PowerShell de CA ARCserve RHA que permiten controlar y gestionar los grupos de usuarios y los usuarios para el Servicio de control basado en ACL.

Nota: Para utilizar los comandos de ACL se necesita una licencia especial.

Get-SuperUserGroup: muestra del nombre de grupo de superusuarios

El comando Get-SuperUserGroup permite mostrar el nombre del grupo de superusuarios del Servicio de control conectado.

Sintaxis
Get-SuperUserGroup

Nota: Este comando no tiene parámetros.

Ejemplo: cómo mostrar el nombre del grupo de superusuarios

Get-SuperUserGroup
Resultado
E QA95-W2K3-SQL CA XOsoft

Set-SuperUserGroup: cambio del nombre de grupo Superusuarios

El comando Set-SuperUserGroup permite cambiar el grupo de superusuarios.

Sintaxis
Set-SuperUserGroup [-GroupName] <String>
Parámetros
GoupName

El nombre del nuevo grupo de superusuarios.

Ejemplo: cómo cambiar el grupo de superusuarios

Administradores de Set-SuperUserGroup
Resultado
Set super user group successfully

Get-Users: enumeración de todos los usuarios del grupo de superusuarios

El comando Get-Users permite mostrar una lista de todos los usuarios que pertenecen al grupo de superusuarios.

Sintaxis
get-users 

Nota: Este comando no tiene parámetros.

Ejemplo: lista de todos los usuarios que pertenecen al grupo de superusuarios

get-users
Resultado
QA95-W2K3\Administrator
QA95-W2K3-SQL\User2
QA95-W2K3-SQL\User1

Get-ScenarioUsers: muestra una lista de todos los usuarios con derechos en un escenario

El comando Get-ScenarioUsers permite mostrar una lista de todos los usuarios que tienen derechos sobre un escenario determinado.

Sintaxis

get-ScenarioUsers [-ScenarioName] <String>

Parámetros
ScenarioName

El nombre del escenario.

Ejemplo: enumeración de todos los usuarios con derechos sobre un escenario determinado

Get-ScenarioUsers "File Server"
Resultado
name
----
QA95-W2K3-SQL\User2
QA95-W2K3-SQL\User1

Set-ScenarioUser: asignación de derechos de usuario sobre un escenario

El comando Set-ScenarioUser permite asignar a un usuario determinados derechos sobre un escenario concreto.

Sintaxis
Set-ScenarioUser [-Name] <String> [-User] <String> [-Right] <String> 
Parámetros
Nombre

El nombre del escenario.

Usuario

Nombre completo del usuario.

Derecha

El tipo de derechos que tendrá el usuario sobre el escenario. Introduzca uno de los siguientes valores:

A = Administrador

C = Control

V = Sólo ver

Ejemplo: cómo asignar a un usuario derechos de control sobre un escenario determinado

Set-ScenarioUser "File Server" QA95-W2K3-SQL\User2 C
Resultado
Set user right successfully

Remove-ScenarioUser: cómo cancelar los derechos de usuario sobre un escenario

El comando Remove-ScenarioUser permite cancelar los derechos de un usuario sobre un escenario determinado.

Sintaxis
Remove-ScenarioUser [-Name] <String> [-User] <String>
Parámetros
ScenarioName

El nombre del escenario.

nombre de usuario

El nombre del usuario.

Ejemplo: cómo cancelar los derechos de un usuario sobre un escenario determinado

Remove-ScenarioUser "File Server" QA95-W2K3-SQL\User2 C
Resultado
User removed successfully.