Get-AzureRemoteDesktopFile

Obtient un fichier RDP pour une machine virtuelle Azure.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

Get-AzureRemoteDesktopFile
   [-Name] <String>
   [-LocalPath] <String>
   [-ServiceName] <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Get-AzureRemoteDesktopFile
   [-Name] <String>
   [[-LocalPath] <String>]
   [-Launch]
   [-ServiceName] <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzureRemoteDesktopFile télécharge et enregistre un fichier RDP (Remote Desktop Connection) pour une machine virtuelle Azure. L’applet de commande peut lancer une connexion Bureau à distance à la machine virtuelle spécifiée.

Exemples

Exemple 1 : Obtenir un fichier RDP

PS C:\> Get-AzureRemoteDesktopFile -ServiceName "ContosoService" -Name "VirtualMachine07" -LocalPath "C:\temp\VirtualMachine07.rdp"

Cette commande obtient un fichier RDP pour la machine virtuelle VirtualMachine07 nommée VirtualMachine07 qui s’exécute sur le service nommé ContosoService. La commande stocke ce fichier en tant que C:\temp\VirtualMachine07.rdp.

Exemple 2 : Démarrer une session à distance

PS C:\> Get-AzureRemoteDesktopFile -ServiceName "ContosoService" -Name "VirtualMachine07" -Launch

Cette commande obtient un fichier RDP pour la machine virtuelle VirtualMachine07 nommée VirtualMachine07 qui s’exécute sur le service nommé ContosoService. La commande lance une session Bureau à distance. La commande supprime le fichier RDP lorsque la connexion est fermée.

Paramètres

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Renseignez-vous
  • SilentlyContinue
  • Arrêter
  • Suspendre
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Spécifie une variable d’informations.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Launch

Indique que cette applet de commande démarre une session Bureau à distance sur la machine virtuelle.

Type:SwitchParameter
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LocalPath

Spécifie le chemin complet du fichier RDP téléchargé sur l’ordinateur local.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie la machine virtuelle pour laquelle cette applet de commande télécharge un fichier RDP.

Type:String
Aliases:InstanceName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceName

Spécifie le nom du service Azure auquel appartient la machine virtuelle.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False