Measure-VMReplication

Gets replication statistics and information associated with a virtual machine.

Syntax

Measure-VMReplication
       [[-VMName] <String[]>]
       [-ComputerName <String[]>]
       [-PrimaryServerName <String>]
       [-ReplicaServerName <String>]
       [-ReplicationHealth <VMReplicationHealthState>]
       [-ReplicationMode <VMReplicationMode>]
       [-ReplicationState <VMReplicationState>]
       [-TrustGroup <String>]
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

PS C:\>Measure-VMReplication

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

Example 2

PS C:\>Measure-VMReplication VM01

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

Example 3

PS C:\> Measure-VMReplication -ReplicationHealth Warning

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

Required Parameters

-VM

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

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

Optional 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:.
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
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
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
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
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
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
Accept pipeline input:False
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
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Outputs

VMReplicationHealth