VirtualMachineOperationsExtensions.CreateAsync Method (IVirtualMachineOperations, String, String, VirtualMachineCreateParameters)

Asynchronously adds a Virtual Machine to an existing deployment.

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

Syntax

public static Task<OperationStatusResponse> CreateAsync(
    this IVirtualMachineOperations operations,
    string serviceName,
    string deploymentName,
    VirtualMachineCreateParameters parameters
)

public:
[ExtensionAttribute]
static Task<OperationStatusResponse^>^ CreateAsync(
    IVirtualMachineOperations^ operations,
    String^ serviceName,
    String^ deploymentName,
    VirtualMachineCreateParameters^ parameters
)

static member CreateAsync : 
        operations:IVirtualMachineOperations *
        serviceName:string *
        deploymentName:string *
        parameters:VirtualMachineCreateParameters -> Task<OperationStatusResponse>

<ExtensionAttribute>
Public Shared Function CreateAsync (
    operations As IVirtualMachineOperations,
    serviceName As String,
    deploymentName As String,
    parameters As VirtualMachineCreateParameters
) As Task(Of OperationStatusResponse)

Parameters

• operations
  Type: Microsoft.WindowsAzure.Management.Compute.IVirtualMachineOperations

  The IVirtualMachineOperations object that specifies the operations for managing Virtual Machines.

• serviceName
  Type: System.String

  The name of the cloud service to which the Virtual Machine should be added.

• deploymentName
  Type: System.String

  The name of the deployment.

• parameters
  Type: Microsoft.WindowsAzure.Management.Compute.Models.VirtualMachineCreateParameters

  The VirtualMachineCreateParameters object that contains the parameters that are used to add a Virtual Machine to an existing deployment.

Return Value

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

The T:Microsoft.WindowsAzure.Management.Compute.Models.ComputeOperationStatusResponse object that contains the status of the operation.

Remarks

If the asynchronous operation succeeds, the response includes the HTTP status code for the successful request. If the asynchronous operation failed, the response includes the HTTP status code for the failed request, and also includes error information about the failure.

For more information about adding a Virtual Machine to an existing deployment, see the following resources:

• Add Role

• Create or Delete Virtual Machines Using Azure Cmdlets

• How to Connect Virtual Machines in a Cloud Service

See Also

VirtualMachineOperationsExtensions Class
Microsoft.WindowsAzure.Management.Compute Namespace

Return to top