Files
ZertoApiWrapper/docs/Get-ZertoProtectedVm.md
T
Wes Carroll 59a0a53812 Help system (#4)
* Establish a help system

* Continue to update Help System

* Update Get-ZertoAlert.md

* Update Get-ZertoDatastore.md

* Add Link to Zerto API for Datastores

* Update Get-ZertoLicense.md

* Update Links to Zerto API documentation

* Update the Readme Information

* Continue to update README

* Update README

* Update README.md

* Update Help Markdown Files

* Correct API URL

* Update ZertoApiWrapper-help.xml

* Update Get-ZertoProtectedVm.md

* Update Help Markdown files

* Update Get-ZertoVpgSetting.md

* Added online url to each help object.

* Update Help Markdown Files

* Update ZertoApiWrapper-help.xml
2019-03-06 20:50:14 -05:00

5.9 KiB

external help file, Module Name, online version, schema
external help file Module Name online version schema
ZertoApiWrapper-help.xml ZertoApiWrapper https://github.com/wcarroll/ZertoApiWrapper/blob/master/docs/Get-ZertoProtectedVm.md 2.0.0

Get-ZertoProtectedVm

SYNOPSIS

Returns information about Virtual Machines protected by Zerto

SYNTAX

main (Default)

Get-ZertoProtectedVm [<CommonParameters>]

vmIdentifier

Get-ZertoProtectedVm -vmIdentifier <String[]> [<CommonParameters>]

filter

Get-ZertoProtectedVm [-vpgName <String>] [-vmName <String>] [-status <String>] [-substatus <String>]
 [-organizationName <String>] [-priority <String>] [-protectedSiteType <String>] [-recoverySiteType <String>]
 [-protectedSiteIdentifier <String>] [-recoverySiteIdentifier <String>] [<CommonParameters>]

DESCRIPTION

Returns information about virtual machines protected by Zerto. When called without parameters, will return all currently protected virtual machines. A single vmIdentifier or an array of vmIdentifiers can be used to only return information about those virtual machines.

If information is wanted for several virtual machines and you need to search for those machines, any of the parameters in the Filter parameter set can be used to find virtual machines that fit all the criteria passed to the function.

EXAMPLES

Example 1

PS C:\> Get-ZertoProtectedVm

Returns all virtual machines that are either protected to or protected from this site by Zerto

Example 1

PS C:\> Get-ZertoProtectedVm -vmIdentifier "MyVmIdentifier"

Returns information about the protected virtual machine with identifier "MyVmIdentifier"

Example 1

PS C:\> Get-ZertoProtectedVm -vmIdentifier "MyVmIdentifier", "MyOtherVmIdentifier"

Returns information about the protected virtual machines with identifiers "MyVmIdentifier" and "MyOtherVmIdentifier"

Example 1

PS C:\> Get-ZertoProtectedVm -vpgName "My Vpg"

Returns all virtual machines that are members of the Virtual Protection Group "My Vpg"

PARAMETERS

-organizationName

The ZORG for this VPG.

Type: String
Parameter Sets: filter
Aliases:

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

-priority

The priority specified for the VPG. Possible values are: '0' or 'Low', '1' or 'Medium', '2' or 'High'

Type: String
Parameter Sets: filter
Aliases:

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

-protectedSiteIdentifier

The identifier of the protected site where the VPG virtual machines are protected.

Type: String
Parameter Sets: filter
Aliases:

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

-protectedSiteType

The protected site type. Please see Zerto API documentation for possible values.

Type: String
Parameter Sets: filter
Aliases:

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

-recoverySiteIdentifier

The identifier of the recovery site where the VPG virtual machines are recovered.

Type: String
Parameter Sets: filter
Aliases:

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

-recoverySiteType

The recovery site type. Please see Zerto API documentation for possible values.

Type: String
Parameter Sets: filter
Aliases:

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

-status

The status of the VPG. Please see Zerto API documentation for possible values.

Type: String
Parameter Sets: filter
Aliases:

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

-substatus

The substatus of the VPG, for example the VPG is in a bitmap sync. For the description of substatuses, refer to the Zerto Virtual Manager Administration Guide. Please see Zerto API documentation for possible values.

Type: String
Parameter Sets: filter
Aliases:

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

-vmIdentifier

vmIdentifier(s) for which to return information

Type: String[]
Parameter Sets: vmIdentifier
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-vmName

The name of the virtual machine.

Type: String
Parameter Sets: filter
Aliases:

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

-vpgName

The name of the VPG which protects the virtual machine.

Type: String
Parameter Sets: filter
Aliases:

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

System.String[]

OUTPUTS

System.Object

NOTES

Zerto REST API Protected VMs End Point Documentation