Partager via

Get-AzBatchRemoteDesktopProtocolFile

  • Référence
Module:
Az.Batch

Obtient un fichier RDP à partir d’un nœud de calcul.

Syntaxe

Get-AzBatchRemoteDesktopProtocolFile
   [-PoolId] <String>
   [-ComputeNodeId] <String>
   -DestinationPath <String>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchRemoteDesktopProtocolFile
   [-PoolId] <String>
   [-ComputeNodeId] <String>
   -DestinationStream <Stream>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchRemoteDesktopProtocolFile
   [[-ComputeNode] <PSComputeNode>]
   -DestinationPath <String>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchRemoteDesktopProtocolFile
   [[-ComputeNode] <PSComputeNode>]
   -DestinationStream <Stream>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzBatchRemoteDesktopProtocolFile obtient un fichier RDP (Remote Desktop Protocol) à partir d’un nœud de calcul et l’enregistre en tant que fichier ou dans un flux fourni par l’utilisateur.

Exemples

Exemple 1 : Obtenir un fichier RDP à partir d’un nœud de calcul spécifié et enregistrer le fichier

Get-AzBatchRemoteDesktopProtocolFile -PoolId "Pool06" -ComputeNodeId "ComputeNode01" -DestinationPath "C:\PowerShell\ComputeNode01.rdp" -BatchContext $Context

Cette commande obtient un fichier RDP à partir du nœud de calcul qui a l’ID ComputeNode01 dans le pool qui a le pool d’ID06. La commande enregistre le fichier .rdp en tant que C :\PowerShell\MyComputeNode.rdp. Utilisez l’applet de commande Get-AzBatchAccountKey pour affecter un contexte à la variable $Context.

Exemple 2 : Obtenir un fichier RDP à partir d’un nœud de calcul et enregistrer le fichier à l’aide du pipeline

Get-AzBatchComputeNode -PoolId "Pool06" -Id "ComputeNode02" -BatchContext $Context | Get-AzBatchRemoteDesktopProtocolFile -DestinationPath "C:\PowerShell\MyComputeNode02.rdp" -BatchContext $Context

Cette commande obtient le nœud de calcul qui a l’ID ComputeNode02 dans le pool qui a le pool d’ID06. La commande transmet ce nœud de calcul à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande actuelle obtient un fichier .rpd à partir du nœud de calcul, puis enregistre le contenu sous la forme d’un fichier nommé C :\PowerShell\MyComputeNode02.rdp.

Exemple 3 : Obtenir un fichier RDP à partir d’un nœud de calcul spécifié et le diriger vers un flux

$Stream = New-Object -TypeName "System.IO.MemoryStream"
Get-AzBatchRemoteDesktopProtocolFile "Pool06" -ComputeNodeId "ComputeNode03" -DestinationStream $Stream -BatchContext $Context

La première commande crée un flux à l’aide de l’applet de commande New-Object, puis la stocke dans la variable $Stream. La deuxième commande obtient un fichier .rdp à partir du nœud de calcul qui a l’ID ComputeNode03 dans le pool qui a le pool d’ID 06. La commande dirige le contenu du fichier vers le flux dans $Stream.

Paramètres

-BatchContext

Spécifie l’instance BatchAccountContext utilisée par cette applet de commande pour interagir avec le service Batch. Si vous utilisez l’applet de commande Get-AzBatchAccount pour obtenir votre BatchAccountContext, l’authentification Microsoft Entra sera utilisée lors de l’interaction avec le service Batch. Pour utiliser l’authentification par clé partagée à la place, utilisez l’applet de commande Get-AzBatchAccountKey pour obtenir un objet BatchAccountContext avec ses clés d’accès remplies. Lorsque vous utilisez l’authentification par clé partagée, la clé d’accès primaire est utilisée par défaut. Pour modifier la clé à utiliser, définissez la propriété BatchAccountContext.KeyInUse.

Type:BatchAccountContext
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ComputeNode

Spécifie un nœud de calcul, en tant qu’objet PSComputeNode , auquel pointe le fichier .rdp. Pour obtenir un objet de nœud de calcul, utilisez l’applet de commande Get-AzBatchComputeNode.

Type:PSComputeNode
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ComputeNodeId

Spécifie l’ID du nœud de calcul auquel le fichier .rdp pointe.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationPath

Spécifie le chemin du fichier dans lequel cette applet de commande enregistre le fichier .rdp.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationStream

Spécifie le flux dans lequel cette applet de commande dirige les données RDP. Cette applet de commande ne ferme pas ou ne rembobine pas ce flux.

Type:Stream
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PoolId

Spécifie l’ID du pool qui contient le nœud de calcul à partir duquel cette applet de commande obtient un fichier .rdp.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

String

PSComputeNode

BatchAccountContext

Sorties

Void