Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

Measure-VMReplication

Windows Server 2012 R2 and Windows 8.1

Updated: March 3, 2014

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Measure-VMReplication

Gets replication statistics and information associated with a virtual machine.

Syntax

Parameter Set: VMName
Measure-VMReplication [[-VMName] <String[]> ] [-ComputerName <String[]> ] [-PrimaryServerName <String> ] [-ReplicaServerName <String> ] [-ReplicationHealth <VMReplicationHealthState> ] [-ReplicationMode <VMReplicationMode> ] [-ReplicationRelationshipType <VMReplicationRelationshipType> ] [-ReplicationState <VMReplicationState> ] [-TrustGroup <String> ] [ <CommonParameters>]

Parameter Set: VMObject
Measure-VMReplication [-VM] <VirtualMachine[]> [-ReplicationRelationshipType <VMReplicationRelationshipType> ] [ <CommonParameters>]




Detailed 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.

Parameters

-ComputerName<String[]>

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.


Aliases

none

Required?

false

Position?

named

Default Value

.

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PrimaryServerName<String>

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


Aliases

PrimaryServer

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VM<VirtualMachine[]>

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


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMName<String[]>

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


Aliases

Name

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

true

-ReplicaServerName<String>

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


Aliases

ReplicaServer

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ReplicationHealth<VMReplicationHealthState>

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


Aliases

Health

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ReplicationMode<VMReplicationMode>

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


Aliases

Mode

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ReplicationRelationshipType<VMReplicationRelationshipType>

Specifies the replication relationship type of the virtual machine. Specify whether the replication relationship is a simple primary to replica or is an extended replication chain. The cmdlet gets replication statistics and information associated with the virtual machines that have the replication type that you specify.


Aliases

Relationship

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ReplicationState<VMReplicationState>

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


Aliases

State

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TrustGroup<String>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • VMReplicationHealth

Examples

Example 1

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


PS C:\> Measure-VMReplication

Example 2

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


PS C:\> Measure-VMReplication VM01

Example 3

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


PS C:\>  Measure-VMReplication –ReplicationHealth Warning

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.