Add-AzVhd
온-프레미스 컴퓨터에서 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 |
입력
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]