다음을 통해 공유

Add-AzVhd

  • 참조
모듈:
Az.Compute

온-프레미스 컴퓨터에서 Azure(관리 디스크 또는 Blob)로 가상 하드 디스크를 업로드합니다.

구문

Add-AzVhd
   [-ResourceGroupName] <String>
   [-Destination] <Uri>
   [-LocalFilePath] <FileInfo>
   [[-NumberOfUploaderThreads] <Int32>]
   [[-BaseImageUriToPatch] <Uri>]
   [-OverWrite]
   [-SkipResizing]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVhd
   [-ResourceGroupName] <String>
   [-LocalFilePath] <FileInfo>
   -DiskName <String>
   [-Location] <String>
   [-DiskSku <String>]
   [-DiskZone <String[]>]
   [-DiskHyperVGeneration <String>]
   [-DiskOsType <OperatingSystemTypes>]
   [[-NumberOfUploaderThreads] <Int32>]
   [-DataAccessAuthMode <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Add-AzVhd cmdlet은 온-프레미스 가상 하드 디스크를 관리 디스크 또는 Blob Storage 계정에 업로드합니다.

업로드되는 가상 하드 디스크는 .vhd 파일이어야 하며 크기는 N * Mib + 512바이트여야 합니다. Hyper-V 기능을 사용하여 Add-AzVhd는 모든 .vhdx 파일을 .vhd 파일로 변환하고 업로드하기 전에 크기를 조정합니다. 이 기능을 허용하려면 Hyper-V를 사용하도록 설정해야 합니다. Linux 컴퓨터를 사용하거나 이 기능을 사용하지 않도록 선택하는 경우 VHD 파일의 크기를 수동으로 조정해야 합니다. 또한 Add-AzVhd는 업로드 중에 동적으로 크기가 지정된 VHD 파일을 고정 크기로 변환합니다. 모든 프로세스를 따르는 데 사용합니다 -Verbose .

기본 매개 변수 집합(Blob에 업로드)의 경우 패치된 버전의 온-프레미스 .vhd 파일을 업로드하는 기능도 지원됩니다. 기본 가상 하드 디스크가 이미 업로드된 경우 기본 이미지를 부모로 사용하는 차이점 보관용 디스크를 업로드할 수 있습니다. SAS(공유 액세스 서명) URI도 지원됩니다.

Managed Disk 매개 변수 집합에 직접 업로드의 경우 매개 변수: ResourceGroupName, DiskName, Location, DiskSku 및 Zone을 사용하여 새 디스크를 만든 다음 가상 하드 디스크가 업로드됩니다.

Add-AzVhd를 사용하여 관리 디스크에 직접 업로드하는 방법에 대한 자세한 정보입니다.

50GB보다 큰 VHD 파일의 경우 더 빠른 업로드를 위해 AzCopy를 사용하는 것이 좋습니다.

예제

예제 1: Blob에 VHD 파일 추가

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd"

이 명령은 스토리지 계정에 .vhd 파일을 추가합니다.

예제 2: Blob에 VHD 파일 추가 및 대상 덮어쓰기

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite

이 명령은 스토리지 계정에 .vhd 파일을 추가합니다. 이 명령은 기존 파일을 덮어씁니다.

예제 3: 지정된 스레드 수가 있는 Blob에 VHD 파일 추가

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfUploaderThreads 32

이 명령은 스토리지 계정에 .vhd 파일을 추가합니다. 이 명령은 파일을 업로드하는 데 사용할 스레드 수를 지정합니다.

예제 4: Blob에 VHD 파일 추가 및 SAS URI 지정

Add-AzVhd -Destination "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd?st=2013-01 -09T22%3A15%3A49Z&se=2013-01-09T23%3A10%3A49Z&sr=b&sp=w&sig=13T9Ow%2FRJAMmhfO%2FaP3HhKKJ6AY093SmveO SIV4%2FR7w%3D" -LocalFilePath "C:\vhd\win7baseimage.vhd"

이 명령은 스토리지 계정에 .vhd 파일을 추가하고 SAS URI를 지정합니다.

예제 5: 관리 디스크에 직접 VHD 파일을 추가합니다.

Add-AzVhd -LocalFilePath C:\data.vhd -ResourceGroupName rgname -Location eastus -DiskName newDisk

이 명령은 지정된 ResourceGroupName, Location 및 DiskName을 사용하여 관리 디스크를 만듭니다. VHD 파일을 업로드합니다.

예제 6: VHD 파일을 더 구성된 디스크에 직접 추가합니다.

Add-AzVhd -LocalFilePath C:\Data.vhdx -ResourceGroupName rgname -Location eastus -DiskName newDisk -Zone 1 -DiskSku Premium_LRS

이 명령은 Hyper-V를 사용하여 먼저 vhdx 파일을 vhd 파일로 변환하려고 시도합니다. Hyper-V를 찾을 수 없는 경우 vhd 파일을 사용하도록 요청하는 오류가 반환됩니다. 변환에 성공하면 제공된 매개 변수를 사용하여 관리 디스크를 만든 다음 vhd 파일을 업로드합니다.

매개 변수

-AsJob

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

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

-BaseImageUriToPatch

Azure Blob Storage의 기본 이미지 Blob에 대한 URI를 지정합니다. SAS를 이 매개 변수의 값으로 지정할 수 있습니다.

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

-DataAccessAuthMode

디스크 또는 스냅샷을 내보내거나 업로드할 때 추가 인증 요구 사항입니다. 가능한 옵션은 "AzureActiveDirectory" 및 "None"입니다.

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

-DefaultProfile

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

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

-Destination

Blob Storage에서 Blob의 URI를 지정합니다. 매개 변수는 SAS URI를 지원하지만 패치 시나리오 대상은 SAS URI일 수 없습니다.

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

-DiskHyperVGeneration

Virtual Machine의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다. 포지시블 값은 'V1', 'V2'입니다.

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

-DiskName

새 관리 디스크의 이름

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

-DiskOsType

관리 디스크의 운영 체제 유형입니다. 가능한 값은 'Windows', 'Linux'입니다.

형식:OperatingSystemTypes
별칭:OsType
허용되는 값:Windows, Linux
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DiskSku

관리 디스크에 대한 SKU입니다. 옵션: Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS

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

-DiskZone

디스크의 논리 영역 목록입니다.

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

-LocalFilePath

로컬 .vhd 파일의 경로를 지정합니다.

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

-Location

새 Managed Disk의 위치

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

-NumberOfUploaderThreads

.vhd 파일을 업로드할 때 사용할 업로더 스레드 수를 지정합니다.

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

-OverWrite

이 cmdlet이 지정된 대상 URI의 기존 Blob(있는 경우)을 덮어쓰고 있음을 나타냅니다.

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

-ResourceGroupName

가상 머신의 리소스 그룹의 이름을 지정합니다.

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

-SkipResizing

VHD 파일의 크기 조정을 건너뜁니다. 크기가 잘못 정렬된 VHD 파일(N * Mib + 512바이트 아님)을 Blob에 업로드하려는 사용자는 이 스위치 매개 변수를 사용할 수 있습니다.

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

입력

String

Uri

FileInfo

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

SwitchParameter

출력

VhdUploadContext