다음을 통해 공유


Save-AzureRmVhd

다운로드한 .vhd 이미지를 로컬로 저장합니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

Save-AzureRmVhd
    [-ResourceGroupName] <String>
    [-SourceUri] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfThreads] <Int32>]
    [-OverWrite]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Save-AzureRmVhd
    [-StorageKey] <String>
    [-SourceUri] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfThreads] <Int32>]
    [-OverWrite]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

Save-AzureRmVhd cmdlet은 .vhd 이미지를 파일에 저장되는 Blob에서 저장합니다. 프로세스에서 사용하는 다운로더 스레드의 수와 이미 존재하는 파일을 바꿀지 여부를 지정할 수 있습니다. 이 cmdlet은 그대로 콘텐츠를 다운로드합니다. VHD(가상 하드 디스크) 형식 변환은 적용되지 않습니다.

예제

예제 1: 이미지 다운로드

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -ResourceGroupName "rgname"

이 명령은 .vhd 파일을 다운로드하고 로컬 경로 C:\vhd\Win7Image.vhd에 저장합니다.

예제 2: 이미지 다운로드 및 로컬 파일 덮어쓰기

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite -ResourceGroupName "rgname"

이 명령은 .vhd 파일을 다운로드하고 로컬 경로에 저장합니다. 명령에는 덮어쓰기 매개 변수가 포함됩니다. 따라서 C:\vhd\Win7Image.vhd가 이미 있는 경우 이 명령이 이를 대체합니다.

예제 3: 지정된 수의 스레드를 사용하여 이미지 다운로드

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfThreads 32 -ResourceGroupName "rgname"

이 명령은 .vhd 파일을 다운로드하고 로컬 경로에 저장합니다. 이 명령은 NumberOfThreads 매개 변수에 대해 32의 값을 지정합니다 . 따라서 cmdlet은 이 작업에 32개의 스레드를 사용합니다.

예제 4: 이미지 다운로드 및 스토리지 키 지정

PS C:\> Save-AzureRmVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -StorageKey "zNvcH0r5vAGmC5AbwEtpcyWCMyBd3eMDbdaa4ua6kwxq6vTZH3Y+sw==" -ResourceGroupName "rgname"

이 명령은 .vhd 파일을 다운로드하고 스토리지 키를 지정합니다.

매개 변수

-AsJob

백그라운드에서 cmdlet을 실행하고 작업을 반환하여 진행률을 추적합니다.

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

-DefaultProfile

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

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

-LocalFilePath

저장된 이미지의 로컬 파일 경로를 지정합니다.

형식:FileInfo
별칭:lf
Position:2
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NumberOfThreads

이 cmdlet이 다운로드하는 동안 사용하는 다운로드 스레드 수를 지정합니다.

형식:Int32
별칭:th
Position:3
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-OverWrite

이 cmdlet이 있는 경우 LocalFilePath 파일로 지정된 파일을 대체한다는 것을 나타냅니다.

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

-ResourceGroupName

스토리지 계정의 리소스 그룹 이름을 지정합니다.

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

-SourceUri

에서 Blob Azure의 URI(Uniform Resource Identifier)를 지정합니다.

형식:Uri
별칭:src, Source
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-StorageKey

Blob Storage 계정의 스토리지 키를 지정합니다. 키를 지정하지 않으면 이 cmdlet은 Azure에서 SourceUri에 있는 계정의 스토리지 키를 확인하려고 시도합니다.

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

입력

String

Uri

출력

VhdDownloadContext