다음을 통해 공유

Enter-AzVM

  • 참조
모듈:
Az.Ssh

Azure 리소스(예: Azure VM 또는 Arc Servers)에 대한 대화형 SSH 세션을 시작합니다. 사용자는 표준 SSH 인증을 통해 Microsoft Entra 계정 또는 로컬 사용자 계정을 사용하여 로그인할 수 있습니다. 최상의 보안 및 편의를 위해 Microsoft Entra 계정 로그인을 사용합니다.

구문

Enter-AzVM
     -ResourceGroupName <String>
     -Name <String>
     [-PublicKeyFile <String>]
     [-PrivateKeyFile <String>]
     [-UsePrivateIp]
     [-LocalUser <String>]
     [-Port <String>]
     [-ResourceType <String>]
     [-CertificateFile <String>]
     [-SshArgument <String[]>]
     [-Rdp]
     [-PassThru]
     [-Force]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]
Enter-AzVM
     -Ip <String>
     [-PublicKeyFile <String>]
     [-PrivateKeyFile <String>]
     [-LocalUser <String>]
     [-Port <String>]
     [-CertificateFile <String>]
     [-SshArgument <String[]>]
     [-Rdp]
     [-PassThru]
     [-Force]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]
Enter-AzVM
     -ResourceId <String>
     [-PublicKeyFile <String>]
     [-PrivateKeyFile <String>]
     [-UsePrivateIp]
     [-LocalUser <String>]
     [-Port <String>]
     [-CertificateFile <String>]
     [-SshArgument <String[]>]
     [-Rdp]
     [-PassThru]
     [-Force]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]

Description

Azure 리소스에 대한 대화형 SSH 세션을 시작합니다(현재 Azure VM 및 Arc Server 지원). 사용자는 Microsoft Entra에서 발급한 인증서를 사용하거나 로컬 사용자 자격 증명을 사용하여 로그인할 수 있습니다. 가능한 경우 Microsoft Entra에서 발급한 인증서를 사용하여 로그인하는 것이 좋습니다. 중요 참고: Azure Arc 리소스에 연결할 때 이 cmdlet을 사용하려면 Az.Ssh.ArcProxy 모듈도 클라이언트 컴퓨터에 설치해야 합니다. cmdlet은 PowerShell 갤러리에서 모듈을 설치하려고 시도하지만 사용자에게는 모듈을 직접 설치하는 옵션도 있습니다. 사용자에게 Az.Ssh.ArcProxy 모듈에서 프록시 파일을 실행할 수 있는 권한도 있어야 합니다. 그렇지 않으면 연결이 실패합니다. PowerShell 갤러리에서 Az.Ssh.ArcServer 모듈을 찾을 수 있습니다. https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy.

예제

예제 1: Microsoft Entra에서 발급한 인증서를 사용하여 Azure 리소스에 연결

Enter-AzVM -ResourceGroupName myRg -Name myMachine

-LocalUser 제공되지 않으면 cmdlet은 Microsoft Entra ID를 사용하여 로그인을 시도합니다. 이는 현재 Linux OS를 실행하는 리소스에 대해서만 지원됩니다.

예제 2: 인증을 위해 SSH 인증서를 사용하여 Azure 리소스의 로컬 사용자에 연결

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser -PrivateKeyFile ./id_rsa -CertificateFile ./cert

예제 3: 인증에 SSH 프라이빗 키를 사용하여 Azure 리소스의 로컬 사용자에 연결

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser -PrivateKeyFile ./id_rsa

예제 4: 대화형 사용자 이름 및 암호 인증을 사용하여 Azure 리소스의 로컬 사용자에 연결

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser azureuser

예제 5: Microsoft Entra에서 발급한 인증서를 사용하여 Azure Virtual Machine의 공용 IP에 연결

Enter-AzVM -Ip 1.2.3.4

예제 6: 대상의 리소스 종류를 제공합니다.

Enter-AzVM -ResourceGroupName myRg -Name myMachine -ResourceType Microsoft.HybridCompute/machines

이 매개 변수는 리소스 그룹에 이름이 같은 지원되는 리소스가 둘 이상 있는 경우에 유용합니다.

예제 7: Microsoft Entra 인증서 발급 인증서 및 사용자 지정 키 파일을 사용하여 Azure 리소스에 연결

Enter-AzVM -ResourceGroupName myRg -Name myMachine -PrivateKeyFile ./id_rsa -PublicKeyFile ./id_rsa.pub

사용자 지정 키 파일이 제공되지 않으면 cmdlet은 키 쌍을 생성합니다.

예제 8: SSH 연결을 통해 RDP 연결을 시작합니다.

Enter-AzVM -ResourceGroupName myRg -Name myMachine -LocalUser username -Rdp

이 매개 변수는 Arc Connectivity Platform을 통해 Arc 리소스에 대한 RDP 세션을 만드는 데 유용합니다.

매개 변수

-CertificateFile

로컬 사용자 계정에 인증하는 데 사용할 SSH 인증서입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

Arc 리소스에 연결할 때 연결 엔드포인트에서 대상 포트와 일치하도록 허용된 SSH 연결 포트를 업데이트하거나 필요한 경우 PowerShell 갤러리에서 Az.Ssh.ArcProxy 모듈을 설치하기 전에 확인을 요청하지 마세요.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Ip

대상 Azure VM의 IP 주소입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-LocalUser

대상 리소스의 로컬 사용자에 대한 사용자 이름입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

대상 Azure 리소스의 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PassThru

연결에 성공하면 true를 반환합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Port

원격 호스트에 연결할 포트입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PrivateKeyFile

프라이빗 키 파일의 경로입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PublicKeyFile

공개 키 파일의 경로입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Rdp

SSH 연결을 통해 RDP 연결을 시작합니다. Windows OS에서만 지원됩니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResourceGroupName

리소스 그룹 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceId

대상 리소스의 리소스 ID입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceType

대상 리소스의 리소스 종류입니다.

형식:String
허용되는 값:Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SshArgument

OpenSSH에 전달된 추가 SSH 인수입니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UsePrivateIp

Azure VM에 연결할 때 이 플래그는 VM의 개인 IP 중 하나에 연결하도록 지정합니다. 개인 IP에 대한 연결이 필요합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

String

String[]

출력

Boolean