Share via

IVirtualMachineOperations.BeginCapturingOSImageAsync Method (String, String, String, VirtualMachineCaptureOSImageParameters, CancellationToken)

  • Article

 

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 https://msdn.microsoft.com/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 https://www.windowsazure.com/documentation/articles/virtual-machines-capture-image-windows-server/ or How to Capture an Image of a Virtual Machine Running Linux at https://www.windowsazure.com/documentation/articles/virtual-machines-linux-capture-image/. (see https://msdn.microsoft.com/library/windowsazure/jj157201.aspx for more information)

Namespace:   Microsoft.WindowsAzure.Management.Compute
Assembly:  Microsoft.WindowsAzure.Management.Compute (in Microsoft.WindowsAzure.Management.Compute.dll)

Syntax

Task<AzureOperationResponse> BeginCapturingOSImageAsync(
    string serviceName,
    string deploymentName,
    string virtualMachineName,
    VirtualMachineCaptureOSImageParameters parameters,
    CancellationToken cancellationToken
)

Task<AzureOperationResponse^>^ BeginCapturingOSImageAsync(
    String^ serviceName,
    String^ deploymentName,
    String^ virtualMachineName,
    VirtualMachineCaptureOSImageParameters^ parameters,
    CancellationToken cancellationToken
)

abstract BeginCapturingOSImageAsync : 
        serviceName:string *
        deploymentName:string *
        virtualMachineName:string *
        parameters:VirtualMachineCaptureOSImageParameters *
        cancellationToken:CancellationToken -> Task<AzureOperationResponse>

Function BeginCapturingOSImageAsync (
    serviceName As String,
    deploymentName As String,
    virtualMachineName As String,
    parameters As VirtualMachineCaptureOSImageParameters,
    cancellationToken As CancellationToken
) As Task(Of AzureOperationResponse)

Parameters

  • deploymentName
    Type: System.String

    The name of your deployment.

  • virtualMachineName
    Type: System.String

    The name of the virtual machine to restart.

Return Value

Type: System.Threading.Tasks.Task<AzureOperationResponse>

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

See Also

IVirtualMachineOperations Interface
Microsoft.WindowsAzure.Management.Compute Namespace

Return to top