다음을 통해 공유

Add-AzVhd

모듈:
Az.Compute Module

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

구문

DefaultParameterSet (기본값) 

Add-AzVhd
    [-ResourceGroupName] <String>
    [-Destination] <Uri>
    [-LocalFilePath] <FileInfo>
    [[-NumberOfUploaderThreads] <Int32>]
    [[-BaseImageUriToPatch] <Uri>]
    [-OverWrite]
    [-SkipResizing]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

DirectUploadToManagedDiskSet 

Add-AzVhd
    [-ResourceGroupName] <String>
    [-LocalFilePath] <FileInfo>
    [-Location] <String>
    [[-NumberOfUploaderThreads] <Int32>]
    -DiskName <String>
    [-DiskSku <String>]
    [-DiskZone <String[]>]
    [-DiskHyperVGeneration <String>]
    [-DiskOsType <OperatingSystemTypes>]
    [-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&amp;se=2013-01-09T23%3A10%3A49Z&amp;sr=b&amp;sp=w&amp;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
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

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

-BaseImageUriToPatch

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

매개 변수 속성

형식:Uri
Default value:None
와일드카드 지원:False
DontShow:False
별칭:모텔

매개 변수 집합

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

-DataAccessAuthMode

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

매개 변수 속성

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

매개 변수 집합

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

-DefaultProfile

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

매개 변수 속성

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

매개 변수 집합

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

-Destination

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

매개 변수 속성

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

매개 변수 집합

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

-DiskHyperVGeneration

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

매개 변수 속성

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

매개 변수 집합

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

-DiskName

새 관리 디스크의 이름

매개 변수 속성

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

매개 변수 집합

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

-DiskOsType

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

매개 변수 속성

형식:OperatingSystemTypes
Default value:None
허용되는 값:Windows, Linux
와일드카드 지원:False
DontShow:False
별칭:OsType

매개 변수 집합

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

-DiskSku

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

매개 변수 속성

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

매개 변수 집합

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

-DiskZone

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:False
DontShow:False
별칭:영역

매개 변수 집합

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

-LocalFilePath

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

매개 변수 속성

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

매개 변수 집합

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

-Location

새 Managed Disk의 위치

매개 변수 속성

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

매개 변수 집합

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

-NumberOfUploaderThreads

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

매개 변수 속성

형식:

Nullable<T>[Int32]

Default value:None
와일드카드 지원:False
DontShow:False
별칭:일

매개 변수 집합

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

-OverWrite

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

매개 변수 속성

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

매개 변수 집합

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

-ResourceGroupName

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

매개 변수 속성

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

매개 변수 집합

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

-SkipResizing

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

매개 변수 속성

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

매개 변수 집합

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

CommonParameters

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

입력

String

Uri

FileInfo

Nullable<T>

SwitchParameter

출력

VhdUploadContext