Backup, Rollback, and Query Operations

If you are using a
VmwareDistributedVirtualSwitch
, you can perform backup and rollback operations on the switch and its associated distributed virtual portgroups.
When you reconfigure a VMware distributed virtual switch (
ReconfigureDvs_Task
), the server saves the current switch configuration before applying the configuration updates. The saved switch configuration includes portgroup configuration data. The server uses the saved switch configuration as a checkpoint for rollback operations. You can rollback the switch or portgroup configuration to the saved configuration, or you can rollback to a backup configuration (
EntityBackupConfig
).
  • To backup the switch and portgroup configuration, use the
    DistributedVirtualSwitchManager.DVSManagerExportEntity_Task
    method. The export method produces a
    EntityBackupConfig
    object. The backup configuration contains the switch and/or portgroups specified in the
    SelectionSet
    parameter. To backup the complete configuration you must select the distributed virtual switch and all of its portgroups.
  • To rollback the switch configuration, use the
    DVSRollback_Task
    method to determine if the switch configuration has changed. If it has changed, use the
    ReconfigureDvs_Task
    method to complete the rollback operation.
  • To rollback the portgroup configuration, use the
    DistributedVirtualPortgroup.DVPortgroupRollback_Task
    method to determine if the portgroup configuration has changed. If it has changed, use the
    ReconfigureDVPortgroup_Task
    method to complete the rollback operation.
To perform query operations on a distributed virtual switch, use the
DistributedVirtualSwitchManager
methods.