Export-AzSshConfig

모듈:

Az.Ssh Module

이 cmdlet은 미리 보기 모듈의 일부입니다. 미리 보기 버전은 프로덕션 환경에서 사용하지 않는 것이 좋습니다. 자세한 내용은 를 참조하세요.

이 cmdlet은 OpenSSH 구성 및 인증서를 지원하는 클라이언트 애플리케이션을 통해 Azure 리소스에 연결하는 데 사용할 수 있는 SSH 구성 파일을 내보냅니다. 발급된 인증서 또는 로컬 사용자 자격 증명을 Microsoft Entra ID 사용하는 SSH 구성 파일을 만들 수 있습니다.

구문

Interactive (기본값)

Export-AzSshConfig
    -ResourceGroupName <String>
    -Name <String>
    -ConfigFilePath <String>
    [-PublicKeyFile <String>]
    [-PrivateKeyFile <String>]
    [-UsePrivateIp]
    [-LocalUser <String>]
    [-Port <String>]
    [-ResourceType <String>]
    [-CertificateFile <String>]
    [-Overwrite]
    [-KeysDestinationFolder <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

IpAddress

Export-AzSshConfig
    -Ip <String>
    -ConfigFilePath <String>
    [-PublicKeyFile <String>]
    [-PrivateKeyFile <String>]
    [-LocalUser <String>]
    [-Port <String>]
    [-CertificateFile <String>]
    [-Overwrite]
    [-KeysDestinationFolder <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ResourceId

Export-AzSshConfig
    -ResourceId <String>
    -ConfigFilePath <String>
    [-PublicKeyFile <String>]
    [-PrivateKeyFile <String>]
    [-UsePrivateIp]
    [-LocalUser <String>]
    [-Port <String>]
    [-CertificateFile <String>]
    [-Overwrite]
    [-KeysDestinationFolder <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

내보낸 SSH 구성 파일을 사용하여 OpenSSH 구성 및 인증서를 지원하는 클라이언트 애플리케이션에서 Azure Resources에 연결할 수 있습니다. git 및 rsync와 같은 애플리케이션은 명령을 'ssh -F /path/to/config'로 설정하여 구성 파일을 사용할 수 있습니다. 예: rsync -e 'ssh -F /path/to/config'. 사용자는 발급된 Microsoft Entra ID 인증서 또는 로컬 사용자 자격 증명을 사용하는 ssh 구성 파일을 만들 수 있습니다. 중요: Azure Arc 리소스에 연결할 때 이 cmdlet을 사용하려면 Az.Ssh.ArcProxy 모듈도 클라이언트 컴퓨터에 설치해야 합니다. cmdlet은 PowerShell Gallery 모듈을 설치하려고 시도하지만 사용자에게는 모듈을 직접 설치하는 옵션도 있습니다. 사용자에게 Az.Ssh.ArcProxy 모듈에서 프록시 파일을 실행할 수 있는 권한도 있어야 합니다. 그렇지 않으면 연결이 실패합니다. Az.Ssh.ArcServer 모듈은 PowerShell Gallery https://aka.ms/PowerShellGallery-Az.Ssh.ArcProxy 찾을 수 있습니다.

예제

예제 1: 인증을 위해 발급된 인증서를 사용하여 리소스에 연결하기 위해 Microsoft Entra ID SSH 구성 파일을 내보냅니다.

Export-AzSshConfig -ResourceGroupName myRg -Name myMachine -ConfigFilePath ./sshconfig.config

-LocalUser 제공되지 않으면 cmdlet은 Microsoft Entra ID 사용하여 로그인할 인증서를 만들려고 시도합니다. 이는 현재 Linux OS를 실행하는 리소스에 대해서만 지원됩니다. Microsoft Entra ID 사용하여 리소스에 로그인하는 경우 구성 항목의 호스트 이름은 Azure VM의 "{리소스 그룹 이름}-{resource name}" 또는 "{ip address}"입니다.

예제 2: 발급된 Microsoft Entra ID 인증서를 사용하여 Azure Virtual Machine의 공용 IP에 연결하기 위한 SSH 구성 파일을 내보냅니다.

Export-AzSshConfig -Ip 1.2.3.4 -ConfigFilePath ./sshconfig.config

예제 3: 인증을 위해 SSH 인증서를 사용하여 Azure 리소스의 로컬 사용자에 연결하기 위한 SSH 구성 파일 내보내기

Export-AzSshConfig -ResourceGroupName myRg -Name myVm -LocalUser azureuser -CertificateFile ./cert -PrivateKeyFile ./id_rsa -ConfigFilePath ./sshconfig.config

로컬 사용자 자격 증명을 사용하여 로그인하는 경우 구성 항목의 호스트 이름은 Azure VM에 대해 "{리소스 그룹 이름}-{resource name}-{username}" 또는 "{ip address}-{username}"입니다.

예제 4: 인증에 SSH 프라이빗 키를 사용하여 Azure 리소스의 로컬 사용자에 연결하기 위한 SSH 구성 파일 내보내기

Export-AzSshConfig -ResourceGroupName myRg -Name myVm -LocalUser azureuser -PrivateKeyFile ./id_rsa -ConfigFilePath ./sshconfig.config

예제 5: 인증을 위해 대화형 사용자 이름 및 암호를 사용하여 Azure Resource에서 로컬 사용자에 연결하기 위한 SSH 구성 파일 내보내기

Export-AzSshConfig -ResourceGroupName myRg -Name myVm -LocalUser azureuser -ConfigFilePath ./sshconfig.config

예제 6: 인증서에 대해 생성된 키와 인증서가 저장되는 위치를 결정합니다.

Export-AzSshConfig -ResourceGroupName myRg -Name myVm -KeysDestinationFolder /home/user/mykeys -ConfigFilePath ./sshconfig.config

생성된 키와 인증서는 기본적으로 구성 파일과 동일한 디렉터리의 "az_ssh_config" 디렉터리에 저장됩니다. -KeysDestinationFolder 매개 변수를 사용하면 키를 저장할 위치를 결정할 수 있습니다.

예제 7: Azure VM에서 사용할 제네릭 구성을 만듭니다.

Export-AzSshConfig -Ip * -ConfigFilePath ./sshconfig.config

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

Export-AzSshConfig -ResourceGroupName myRg -Name myVm -ResourceType Microsoft.Compute/virtualMachines -ConfigFilePath ./sshconfig.config

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

매개 변수

-CertificateFile

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

매개 변수 속성

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

매개 변수 집합

(All)

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

-ConfigFilePath

SSH 구성을 작성할 경로입니다.

매개 변수 속성

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

매개 변수 집합

(All)

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

-DefaultProfile

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

매개 변수 속성

형식:	IAzureContextContainer
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)

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

-Force

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

매개 변수 속성

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

매개 변수 집합

(All)

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

-Ip

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

매개 변수 속성

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

매개 변수 집합

IpAddress

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

-KeysDestinationFolder

생성된 키 및 인증서가 저장되는 디렉터리입니다.

매개 변수 속성

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

매개 변수 집합

(All)

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

-LocalUser

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

매개 변수 속성

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

매개 변수 집합

(All)

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

-Name

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

매개 변수 속성

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

매개 변수 집합

Interactive

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

-Overwrite

파일 끝에 새 항목을 추가하는 대신 구성 파일을 덮어씁니다.

매개 변수 속성

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

매개 변수 집합

(All)

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

-Port

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

매개 변수 속성

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

매개 변수 집합

(All)

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

-PrivateKeyFile

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

매개 변수 속성

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

매개 변수 집합

(All)

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

-PublicKeyFile

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

매개 변수 속성

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

매개 변수 집합

(All)

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

-ResourceGroupName

리소스 그룹 이름

매개 변수 속성

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

매개 변수 집합

Interactive

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

-ResourceId

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

매개 변수 속성

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

매개 변수 집합

ResourceId

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

-ResourceType

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

매개 변수 속성

형식:	String
Default value:	None
허용되는 값:	Microsoft.HybridCompute/machines, Microsoft.Compute/virtualMachines, Microsoft.ConnectedVMwarevSphere/virtualMachines, Microsoft.ScVmm/virtualMachines, Microsoft.AzureStackHCI/virtualMachines
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

Interactive

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

-UsePrivateIp

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

매개 변수 속성

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

매개 변수 집합

Interactive

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

ResourceId

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

CommonParameters

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

입력

String

출력

PSSshConfigEntry

관련 링크

• Azure Arc 사용 가능한 서버에 대한 SSH 액세스
• Azure Arc 사용 서버에 대한 SSH 액세스 문제 해결
• Microsoft Entra ID 사용하여 Linux VM에 로그인
• openSSH for Windows 설치