Add-AzVhd
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" -OverwriteTo 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 32To 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 newDiskTo 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_LRSTo 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Uri |
| Aliasy: | bs |
| Position: | 4 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DataAccessAuthMode
Dodatkowe wymagania dotyczące uwierzytelniania podczas eksportowania lub przekazywania do dysku lub migawki. Możliwe opcje to: "AzureActiveDirectory" i "None".
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | Uri |
| Aliasy: | dst |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DiskHyperVGeneration
Generacja funkcji hypervisor maszyny wirtualnej. Dotyczy tylko dysków systemu operacyjnego. Wartości posssible to: "V1", "V2".
| Typ: | String |
| Aliasy: | HyperVGeneration |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DiskName
Nazwa nowego dysku zarządzanego
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DiskOsType
Typ systemu operacyjnego dysku zarządzanego. Możliwe wartości to: "Windows", "Linux".
| Typ: | OperatingSystemTypes |
| Aliasy: | OsType |
| Dopuszczalne wartości: | Windows, Linux |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DiskSku
Jednostka SKU dla dysku zarządzanego. Opcje: Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DiskZone
Lista Strefa logiczna dla dysku.
| Typ: | String[] |
| Aliasy: | Zone |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-LocalFilePath
Określa ścieżkę lokalnego pliku vhd.
| Typ: | FileInfo |
| Aliasy: | lf |
| Position: | 2 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Location
Lokalizacja nowego dysku zarządzanego
| Typ: | String |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-NumberOfUploaderThreads
Określa liczbę wątków przekazywania, które mają być używane podczas przekazywania pliku vhd.
| Typ: | Nullable<T>[Int32] |
| Aliasy: | th |
| Position: | 3 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-OverWrite
Wskazuje, że to polecenie cmdlet zastępuje istniejący obiekt blob w określonym docelowym identyfikatorze URI, jeśli istnieje.
| Typ: | SwitchParameter |
| Aliasy: | o |
| Position: | 5 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Określa nazwę grupy zasobów maszyny wirtualnej.
| Typ: | String |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
