Add-AzVhd

  • Odwołanie
Moduł:
Az.Compute

Przekazuje wirtualny dysk twardy z maszyny lokalnej na platformę Azure (dysk zarządzany lub obiekt blob).

Składnia

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>]

Opis

Polecenie cmdlet Add-AzVhd przekazuje lokalny wirtualny dysk twardy na dysk zarządzany lub konto magazynu obiektów blob.

Przekazany wirtualny dysk twardy musi być plikiem vhd o rozmiarze N * Mib + 512 bajtów. Za pomocą funkcji Hyper-V dodatek-AzVhd przekonwertuje dowolny plik vhdx na plik vhd i zmień rozmiar przed przekazaniem. Aby zezwolić na tę funkcję, należy włączyć funkcję Hyper-V. Jeśli używasz maszyny z systemem Linux lub nie chcesz używać tej funkcji, musisz ręcznie zmienić rozmiar pliku VHD. Ponadto polecenie Add-AzVhd konwertuje dynamicznie rozmiar plików VHD na stały rozmiar podczas przekazywania. Użyj polecenia -Verbose , aby postępować zgodnie ze wszystkimi procesami.

W przypadku domyślnego zestawu parametrów (przekazywanie do obiektu blob) obsługiwane jest również przekazywanie poprawkowej wersji lokalnego pliku vhd. Po przekazaniu podstawowego wirtualnego dysku twardego można przekazać dyski różnicowe, które używają obrazu podstawowego jako nadrzędnego. Identyfikator URI sygnatury dostępu współdzielonego (SAS) jest również obsługiwany.

W przypadku zestawu parametrów przekazywania bezpośredniego do dysku zarządzanego parametry: ResourceGroupName, DiskName, Location, DiskSku i Zone zostaną użyte do utworzenia nowego dysku, a następnie wirtualny dysk twardy zostanie przekazany do niego.

Więcej informacji na temat używania polecenia Add-AzVhd do bezpośredniego przekazywania na dysk zarządzany.

W przypadku plików VHD większych niż 50 GB zalecamy użycie narzędzia AzCopy w celu szybszego przekazywania.

Przykłady

Przykład 1. Dodawanie pliku VHD do obiektu blob

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

To polecenie dodaje plik vhd do konta magazynu.

Przykład 2. Dodawanie pliku VHD do obiektu blob i zastępowanie miejsca docelowego

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

To polecenie dodaje plik vhd do konta magazynu. Polecenie zastępuje istniejący plik.

Przykład 3. Dodawanie pliku VHD do obiektu blob z określoną liczbą wątków

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

To polecenie dodaje plik vhd do konta magazynu. Polecenie określa liczbę wątków używanych do przekazania pliku.

Przykład 4. Dodawanie pliku VHD do obiektu blob i określanie identyfikatora URI sygnatury dostępu współdzielonego

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"

To polecenie dodaje plik vhd do konta magazynu i określa identyfikator URI sygnatury dostępu współdzielonego.

Przykład 5. Dodawanie pliku VHD bezpośrednio do dysku zarządzanego.

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

To polecenie tworzy dysk zarządzany z daną wartością ResourceGroupName, Location i DiskName; i przekazuje do niego plik VHD.

Przykład 6. Dodawanie pliku VHD bezpośrednio do bardziej skonfigurowanego dysku.

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

To polecenie będzie próbował przekonwertować plik vhdx na plik vhd najpierw przy użyciu funkcji Hyper-V. Jeśli funkcja Hyper-V nie zostanie znaleziona, zostanie zwrócony błąd z prośbą o użycie pliku VHD. Po pomyślnej konwersji zostanie utworzony dysk zarządzany z podanymi parametrami, a następnie przekaże plik vhd.

Parametry

-AsJob

Uruchom polecenie cmdlet w tle i zwróć zadanie, aby śledzić postęp.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BaseImageUriToPatch

Określa identyfikator URI do podstawowego obiektu blob obrazu w usłudze Azure Blob Storage. Sygnaturę dostępu współdzielonego można określić jako wartość tego parametru.

Type:Uri
Aliases:bs
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DataAccessAuthMode

Dodatkowe wymagania dotyczące uwierzytelniania podczas eksportowania lub przekazywania do dysku lub migawki. Możliwe opcje to: "AzureActiveDirectory" i "None".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Destination

Określa identyfikator URI obiektu blob w usłudze Blob Storage. Parametr obsługuje identyfikator URI sygnatury dostępu współdzielonego, chociaż miejsce docelowe stosowania poprawek nie może być identyfikatorem URI sygnatury dostępu współdzielonego.

Type:Uri
Aliases:dst
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DiskHyperVGeneration

Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego. Wartości posssible to: "V1", "V2".

Type:String
Aliases:HyperVGeneration
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskName

Nazwa nowego dysku zarządzanego

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DiskOsType

Typ systemu operacyjnego dysku zarządzanego. Możliwe wartości to: "Windows", "Linux".

Type:OperatingSystemTypes
Aliases:OsType
Accepted values:Windows, Linux
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskSku

Jednostka SKU dla dysku zarządzanego. Opcje: Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskZone

Lista Strefa logiczna dla dysku.

Type:String[]
Aliases:Zone
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LocalFilePath

Określa ścieżkę lokalnego pliku vhd.

Type:FileInfo
Aliases:lf
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Location

Lokalizacja nowego dysku zarządzanego

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NumberOfUploaderThreads

Określa liczbę wątków przekazywania, które mają być używane podczas przekazywania pliku vhd.

Type:Nullable<T>[Int32]
Aliases:th
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OverWrite

Wskazuje, że to polecenie cmdlet zastępuje istniejący obiekt blob w określonym docelowym identyfikatorze URI, jeśli istnieje.

Type:SwitchParameter
Aliases:o
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Określa nazwę grupy zasobów maszyny wirtualnej.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SkipResizing

Pomija zmianę rozmiaru pliku VHD. Użytkownicy, którzy chcą przekazać pliki VHD o nieprawidłowym rozmiarze (a nie N * Mib + 512 bajtów) do obiektu blob, mogą użyć tego parametru przełącznika.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String

Uri

FileInfo

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

SwitchParameter

Dane wyjściowe

VhdUploadContext