다음을 통해 공유


Get-AzureRemoteDesktopFile

Azure 가상 머신에 대한 RDP 파일을 가져옵니다.

참고 항목

이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.

Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.

구문

Download (기본값)

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

Launch

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

Description

Get-AzureRemoteDesktopFile cmdlet은 Azure 가상 머신에 대한 RDP(원격 데스크톱 연결) 파일을 다운로드하고 저장합니다. cmdlet은 지정된 가상 머신에 대한 원격 데스크톱 연결을 시작할 수 있습니다.

예제

예제 1: RDP 파일 가져오기

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

이 명령은 ContosoService라는 서비스에서 실행되는 VirtualMachine07 가상 머신에 대한 RDP 파일을 가져옵니다. 이 명령은 해당 파일을 C:\temp\VirtualMachine07.rdp로 저장합니다.

예제 2: 원격 세션 시작

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

이 명령은 ContosoService라는 서비스에서 실행되는 VirtualMachine07 가상 머신에 대한 RDP 파일을 가져옵니다. 이 명령은 원격 데스크톱 세션을 시작합니다. 이 명령은 연결이 닫혔을 때 RDP 파일을 삭제합니다.

매개 변수

-InformationAction

이 cmdlet이 정보 이벤트에 응답하는 방법을 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 계속
  • 무시
  • 묻다
  • SilentlyContinue
  • 중지
  • 일시 중단됨

매개 변수 속성

형식:ActionPreference
Default value:None
와일드카드 지원:False
DontShow:False
별칭:infa

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InformationVariable

정보 변수를 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:iv

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Launch

이 cmdlet이 가상 머신에 대한 원격 데스크톱 세션을 시작했음을 나타냅니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Launch
Position:3
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-LocalPath

로컬 컴퓨터에서 다운로드한 RDP 파일의 전체 경로를 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Download
Position:2
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Name

이 cmdlet이 RDP 파일을 다운로드하는 가상 머신을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:인스턴스 이름

매개 변수 집합

(All)
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Profile

이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.

매개 변수 속성

형식:AzureSMProfile
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ServiceName

가상 머신이 속한 Azure 서비스의 이름을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.