VirtualMachineOperationsExtensions.BeginCapturingOSImageAsync Method

Definition

Namespace:

Microsoft.WindowsAzure.Management.Compute

Assembly:

Microsoft.WindowsAzure.Management.Compute.dll

Package:

Microsoft.WindowsAzure.Management.Compute v14.0.0

The Begin Capturing Role operation creates a copy of the operating system virtual hard disk (VHD) that is deployed in the virtual machine, saves the VHD copy in the same storage location as the operating system VHD, and registers the copy as an image in your image gallery. From the captured image, you can create additional customized virtual machines. For more information about images and disks, see Manage Disks and Images at http://msdn.microsoft.com/en-us/library/windowsazure/jj672979.aspx. For more information about capturing images, see How to Capture an Image of a Virtual Machine Running Windows Server 2008 R2 at http://www.windowsazure.com/en-us/documentation/articles/virtual-machines-capture-image-windows-server/ or How to Capture an Image of a Virtual Machine Running Linux at http://www.windowsazure.com/en-us/documentation/articles/virtual-machines-linux-capture-image/. (see http://msdn.microsoft.com/en-us/library/windowsazure/jj157201.aspx for more information)

public static System.Threading.Tasks.Task<Microsoft.Azure.AzureOperationResponse> BeginCapturingOSImageAsync (this Microsoft.WindowsAzure.Management.Compute.IVirtualMachineOperations operations, string serviceName, string deploymentName, string virtualMachineName, Microsoft.WindowsAzure.Management.Compute.Models.VirtualMachineCaptureOSImageParameters parameters);

static member BeginCapturingOSImageAsync : Microsoft.WindowsAzure.Management.Compute.IVirtualMachineOperations * string * string * string * Microsoft.WindowsAzure.Management.Compute.Models.VirtualMachineCaptureOSImageParameters -> System.Threading.Tasks.Task<Microsoft.Azure.AzureOperationResponse>

<Extension()>
Public Function BeginCapturingOSImageAsync (operations As IVirtualMachineOperations, serviceName As String, deploymentName As String, virtualMachineName As String, parameters As VirtualMachineCaptureOSImageParameters) As Task(Of AzureOperationResponse)

Parameters

operations

IVirtualMachineOperations

Reference to the Microsoft.WindowsAzure.Management.Compute.IVirtualMachineOperations.

serviceName

String

Required. The name of your service.

deploymentName

String

Required. The name of your deployment.

virtualMachineName

String

Required. The name of the virtual machine to restart.

parameters

VirtualMachineCaptureOSImageParameters

Required. Parameters supplied to the Begin Capturing Virtual Machine operation.

Returns

Task<Microsoft.Azure.AzureOperationResponse>

A standard service response including an HTTP status code and request ID.