PoolOperations.GetRDPFile Method

Definition

Namespace:

Microsoft.Azure.Batch

Assembly:

Microsoft.Azure.Batch.dll

Package:

Microsoft.Azure.Batch v16.2.0

Overloads

GetRDPFile(String, String, Stream, IEnumerable<BatchClientBehavior>)	Gets a Remote Desktop Protocol (RDP) file for the specified node.
GetRDPFile(String, String, String, IEnumerable<BatchClientBehavior>)	Gets a Remote Desktop Protocol file for the specified node.

GetRDPFile(String, String, Stream, IEnumerable<BatchClientBehavior>)

Source:

PoolOperations.cs

Gets a Remote Desktop Protocol (RDP) file for the specified node.

public void GetRDPFile (string poolId, string computeNodeId, System.IO.Stream rdpStream, System.Collections.Generic.IEnumerable<Microsoft.Azure.Batch.BatchClientBehavior> additionalBehaviors = default);

member this.GetRDPFile : string * string * System.IO.Stream * seq<Microsoft.Azure.Batch.BatchClientBehavior> -> unit

Public Sub GetRDPFile (poolId As String, computeNodeId As String, rdpStream As Stream, Optional additionalBehaviors As IEnumerable(Of BatchClientBehavior) = Nothing)

Parameters

poolId

String

The id of the pool that contains the compute node.

computeNodeId

String

The id of the compute node for which to get a Remote Desktop file.

rdpStream

Stream

The Stream into which the RDP file contents will be written.

additionalBehaviors

IEnumerable<BatchClientBehavior>

A collection of BatchClientBehavior instances that are applied to the Batch service request after the CustomBehaviors.

Remarks

This method does not close the rdpStream stream, and it does not reset the position after writing. It is the caller's responsibility to close the stream, or to reset the position if required.

This is a blocking operation. For a non-blocking equivalent, see GetRDPFileAsync(String, String, Stream, IEnumerable<BatchClientBehavior>, CancellationToken).

This method can be invoked only if the pool is created with a CloudServiceConfiguration property. If this method is invoked on pools created with VirtualMachineConfiguration, then Batch service returns 409 (Conflict). For pools with VirtualMachineConfiguration property, the new method GetRemoteLoginSettings(String, String, IEnumerable<BatchClientBehavior>) must be used.

GetRDPFile(String, String, String, IEnumerable<BatchClientBehavior>)

Source:

PoolOperations.cs

Gets a Remote Desktop Protocol file for the specified node.

public void GetRDPFile (string poolId, string computeNodeId, string rdpFileNameToCreate, System.Collections.Generic.IEnumerable<Microsoft.Azure.Batch.BatchClientBehavior> additionalBehaviors = default);

member this.GetRDPFile : string * string * string * seq<Microsoft.Azure.Batch.BatchClientBehavior> -> unit

Public Sub GetRDPFile (poolId As String, computeNodeId As String, rdpFileNameToCreate As String, Optional additionalBehaviors As IEnumerable(Of BatchClientBehavior) = Nothing)

Parameters

poolId

String

The id of the pool that contains the compute node.

computeNodeId

String

The id of the compute node for which to get a Remote Desktop file.

rdpFileNameToCreate

String

The file path at which to create the RDP file.

additionalBehaviors

IEnumerable<BatchClientBehavior>

A collection of BatchClientBehavior instances that are applied to the Batch service request after the CustomBehaviors.

Remarks

If the file specified by rdpFileNameToCreate already exists, it is overwritten.

This is a blocking operation. For a non-blocking equivalent, see GetRDPFileAsync(String, String, String, IEnumerable<BatchClientBehavior>, CancellationToken).

This method can be invoked only if the pool is created with a CloudServiceConfiguration property. If this method is invoked on pools created with VirtualMachineConfiguration, then Batch service returns 409 (Conflict). For pools with VirtualMachineConfiguration property, the new method GetRemoteLoginSettings(String, String, IEnumerable<BatchClientBehavior>) must be used.