The Remove-Agent
PowerShell command lets you remove a machine from Rapid Recovery Core protection.
Usage
The usage for the command is as follows:
Remove-Agent -core [host name] -user [login] -password [password] -protectedserver [name | IP address] -deleterecoverypoints -all
Command Options
The following table describes the options available for the Remove-MountAgent
command:
Table 139: Remove-Agent command options
-? |
Display this help message. |
-core |
Optional. Remote Core host machine IP address (with an optional port number). By default the connection is made to the Core installed on the local machine. |
-user |
Optional. User name for the remote Core host machine. If you specify a user name, you also have to provide a password. If none are provided, then the logged-on user's credentials will be used. |
-password |
Optional. Password to the remote Core host machine. If you specify a password, you also have to provide a log on.
If none are provided, then the logged-on user's credentials will be used. |
-protectedserver |
Dismount all mounted recovery points for the current protected machine. |
-deleterecoverypoints |
Optional. Delete all recovery points for this protected machine. |
-all |
Optional. Delete all protected machines from the Core. |
Example:
Dismount all protected machines and their recovery points:
>Remove-Agent -core 10.10.10.10:8006 -user administrator -password 23WE@#$sdd -deleterecoverypoints -all
The Remove-EsxAutoProtectObjects
cmdlet lets you remove specific objects on vCenter or ESXi server from protection by a Core.
Usage
The usage for the command is as follows:
Remove-EsxAutoProtectObjects -core [host name] -user [user name] -password [password] -protectedserver [name | IP address] -autoprotectobjects
Command Options
The following table describes the options available for the Remove-EsxAutoProtectObjects
command:
Table 140: Remove-ESXAutoProtectObjects command options
-? |
Display this help message. |
-core |
Optional. Remote Core host machine IP address (with an optional port number). By default the connection is made to the Core installed on the local machine. |
-user |
Optional. User name for the remote Core host machine. If you specify a user name, you also have to provide a password.
If none are provided, then the logged-on user's credentials will be used. |
-password |
Optional. Password to the remote Core host machine. If you specify a password, you also have to provide a log on.
If none are provided, then the logged-on user's credentials will be used. |
-protectedserver |
Use this option to edit the vCenter or ESXi objects for a specific protected machine. |
-autoprotectobjects |
A list of vCenter or ESXi objects each enclosed in double quotes and separated by a comma. |
Example:
Remove specific vCenter or ESXi objects from protection auto-protection by the Core:
>Remove-EsxAutoProtectObjects -protectedserver 10.10.8.150 -autoprotectobjects "vm1", "vm2"
The Remove-HyperVClusterSharedVirtualDisks
cmdlet lets you remove shared Hyper-V virtual disks from protection of a Core.
Usage
The usage for the command is as follows:
Remove-HyperVClusterSharedVirtualDisks -core [host name] -user [user name] -password [password] -shareddisks [shared virtual disks name or path collection | all]
Command Options
The following table describes the options available for the Remove-HyperVClusterSharedVirtualDisks
command:
Table 141: Remove-HyperVClusterSharedVirtualDisks command options
-? |
Display this help message. |
-core |
Optional. Remote Core host machine IP address (with an optional port number). By default the connection is made to the Core installed on the local machine. |
-user |
Optional. User name for the remote Core host machine. If you specify a user name, you also have to provide a password.
If none are provided, then the logged-on user's credentials will be used. |
-password |
Optional. Password to the remote Core host machine. If you specify a password, you also have to provide a log on.
If none are provided, then the logged-on user's credentials will be used. |
-protectedserver |
Use this option to edit the shared virtual disks for a specific protected machine. |
-shareddisks |
A list of shared disks each separate by a comma. |
Example:
Remove one shared virtual disk from protection:
>Remove-HyprVClusterSharedVirtualDisks -protectedserver "HV-2012R2" -shareddisks "Shared Disk 1"
The Remove-HyperVClusterVirtualMachines
cmdlet lets you remove specific virtual machines (VMs) of a Hyper-V cluster from protection of a Core.
Usage
The usage for the command is as follows:
Remove-HyperVClusterVirtualMachines -core [host name] -user [user name] -password [password] -repository [name] -protectedserver [name | IP address] -virtualmachines [virtual machines collection | all]
Command Options
The following table describes the options available for the Remove-HyperVClusterVirtualMachines
command:
Table 142: Remove-HyperVClusterVirtualMachines command options
-? |
Display this help message. |
-core |
Optional. Remote Core host machine IP address (with an optional port number). By default the connection is made to the Core installed on the local machine. |
-user |
Optional. User name for the remote Core host machine. If you specify a user name, you also have to provide a password.
If none are provided, then the logged-on user's credentials will be used. |
-password |
Optional. Password to the remote Core host machine. If you specify a password, you also have to provide a log on.
If none are provided, then the logged-on user's credentials will be used. |
-protectedserver |
Use this option to protect virtual machines. |
-virtualmachines |
A list of the virtual machines that you want to protect, each separated by a comma. The name of the VM must be enclosed in double quotes. |
-deleterecoverypoints |
Optional. Include this option if you want to delete all of the recovery points for this VM. |
Example:
Remove specific virtual machines of a Hyper-V cluster from protection by the Core and delete its recovery points:
>Remove-HyperVClusterVirtualMachines -protectedserver hvcluster -virtualmachines "Win8x64-gen1", "Win2012x64-gen2" -deleterecoverypoints