Measure-VMReplication

Module:

Hyper-V

Gets replication statistics and information associated with a virtual machine.

Syntax

PowerShell

Measure-VMReplication
       [[-VMName] <String[]>]
       [-ComputerName <String[]>]
       [-PrimaryServerName <String>]
       [-ReplicaServerName <String>]
       [-ReplicationHealth <VMReplicationHealthState>]
       [-ReplicationMode <VMReplicationMode>]
       [-ReplicationState <VMReplicationState>]
       [-TrustGroup <String>]

PowerShell

Measure-VMReplication
       [-VM] <VirtualMachine[]>

Description

The Measure-VMReplication cmdlet gets replication statistics and information associated with virtual machine. Replication statistics are calculated for a predetermined amount of time based on the monitoring interval specified through the Set-VMReplicationServer cmdlet.

Examples

Example 1

PowerShell

PS C:\>Measure-VMReplication

This example gets the replication monitoring details of all replicating virtual machines on the local host.

Example 2

PowerShell

PS C:\>Measure-VMReplication VM01

This example gets the replication monitoring details of a virtual machine named VM01.

Example 3

PowerShell

PS C:\> Measure-VMReplication -ReplicationHealth Warning

This example gets the replication monitoring details of all virtual machines that have a replication health of "Warning".

Parameters

-ComputerName

Specifies one or more Hyper-V hosts from which to get replication statistics. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer - use "localhost" or a dot (".") to specify the local computer explicitly.

Type:	String[]
Position:	Named
Default value:	.
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrimaryServerName

Specifies the name of a primary server. Replication statistics are retrieved for all virtual machines from the specified primary server.

Type:	String
Aliases:	PrimaryServer
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplicaServerName

Specifies the name of a Replica server of the virtual machines whose replication statistics you want to get.

Type:	String
Aliases:	ReplicaServer
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplicationHealth

Specifies the replication health of the virtual machines whose replication statistics you want to get. Valid values are "Critical", "Warning", "Normal", and "NotApplicable".

Type:	VMReplicationHealthState
Aliases:	Health
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplicationMode

Specifies the replication mode of the virtual machines whose replication statistics you want to get. Valid values are "None", "Primary", "Replica" and "TestReplica".

Type:	VMReplicationMode
Aliases:	Mode
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplicationState

Specifies the replication state of the virtual machines for which you want to get replication statistics. Valid values are:

Error

FailOverWaitingCompletion

FailedOver

NotApplicable

ReadyForInitialReplication

Replicating

Resynchronizing

ResynchronizeSuspended

Suspended

SyncedReplicationComplete

WaitingForInitialReplication

WaitingForStartResynchronize

Type:	VMReplicationState
Aliases:	State
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustGroup

Specifies a trust group associated with the virtual machines whose replication statistics you want to get.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VM

Specifies the virtual machine for which you want to get replication statistics.

Type:	VirtualMachine[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

Specifies the name of the virtual machine for which you want to get virtual machine replication statistics.

Type:	String[]
Aliases:	Name
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Outputs

VMReplicationHealth