/// <summary>
/// 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)
/// </summary>
/// <param name='operations'>
/// Reference to the
/// Microsoft.WindowsAzure.Management.Compute.IVirtualMachineOperations.
/// </param>
/// <param name='serviceName'>
/// Required. The name of your service.
/// </param>
/// <param name='deploymentName'>
/// Required. The name of your deployment.
/// </param>
/// <param name='virtualMachineName'>
/// Required. The name of the virtual machine to restart.
/// </param>
/// <param name='parameters'>
/// Required. Parameters supplied to the Begin Capturing Virtual
/// Machine operation.
/// </param>
/// <returns>
/// A standard service response including an HTTP status code and
/// request ID.
/// </returns>
public static OperationResponse BeginCapturingOSImage(this IVirtualMachineOperations operations, string serviceName, string deploymentName, string virtualMachineName, VirtualMachineCaptureOSImageParameters parameters)
{
return Task.Factory.StartNew((object s) =>
{
return ((IVirtualMachineOperations)s).BeginCapturingOSImageAsync(serviceName, deploymentName, virtualMachineName, parameters);
}
, operations, CancellationToken.None, TaskCreationOptions.None, TaskScheduler.Default).Unwrap().GetAwaiter().GetResult();
}
protected PSArgument[] CreateVirtualMachineCaptureOSImageParameters()
{
string serviceName = string.Empty;
string deploymentName = string.Empty;
string virtualMachineName = string.Empty;
VirtualMachineCaptureOSImageParameters parameters = new VirtualMachineCaptureOSImageParameters();
return ConvertFromObjectsToArguments(new string[] { "ServiceName", "DeploymentName", "VirtualMachineName", "Parameters" }, new object[] { serviceName, deploymentName, virtualMachineName, parameters });
}
/// <summary>
/// The Capture 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)
/// </summary>
/// <param name='operations'>
/// Reference to the
/// Microsoft.WindowsAzure.Management.Compute.IVirtualMachineOperations.
/// </param>
/// <param name='serviceName'>
/// Required. The name of your service.
/// </param>
/// <param name='deploymentName'>
/// Required. The name of your deployment.
/// </param>
/// <param name='virtualMachineName'>
/// Required. The name of the virtual machine to restart.
/// </param>
/// <param name='parameters'>
/// Required. Parameters supplied to the Capture Virtual Machine
/// operation.
/// </param>
/// <returns>
/// The response body contains the status of the specified asynchronous
/// operation, indicating whether it has succeeded, is inprogress, or
/// has failed. Note that this status is distinct from the HTTP status
/// code returned for the Get Operation Status operation itself. If
/// the asynchronous operation succeeded, the response body includes
/// the HTTP status code for the successful request. If the
/// asynchronous operation failed, the response body includes the HTTP
/// status code for the failed request and error information regarding
/// the failure.
/// </returns>
public static Task<OperationStatusResponse> CaptureOSImageAsync(this IVirtualMachineOperations operations, string serviceName, string deploymentName, string virtualMachineName, VirtualMachineCaptureOSImageParameters parameters)
{
return operations.CaptureOSImageAsync(serviceName, deploymentName, virtualMachineName, parameters, CancellationToken.None);
}
