Save-AzVhd
語法
ResourceGroupParameterSetName
Save-AzVhd
[-ResourceGroupName] <String>
[-SourceUri] <Uri>
[-LocalFilePath] <FileInfo>
[[-NumberOfThreads] <Int32>]
[-OverWrite]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
StorageKeyParameterSetName
Save-AzVhd
[-StorageKey] <String>
[-SourceUri] <Uri>
[-LocalFilePath] <FileInfo>
[[-NumberOfThreads] <Int32>]
[-OverWrite]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Save-AzVhd Cmdlet 會將 .vhd 映像從儲存至 Blob 儲存至檔案。
您可以指定處理程序使用的下載器執行緒數目,以及是否要取代已存在的檔案。
此 Cmdlet 會依原樣下載內容。
它不會套用任何虛擬硬碟 (VHD) 格式轉換。
範例
範例 1:下載影像
Save-AzVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -ResourceGroupName "rgname"
此命令會下載 .vhd 檔案,並將它儲存在本機路徑 C:\vhd\Win7Image.vhd 中。
範例 2:下載映像並覆寫本機檔案
Save-AzVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -Overwrite -ResourceGroupName "rgname"
此命令會下載 .vhd 檔案,並將它儲存在本機路徑中。
此命令包含 Overwrite 參數。
因此,如果 C:\vhd\Win7Image.vhd 已存在,則此命令會取代它。
範例 3:使用指定數目的執行緒下載映像檔
Save-AzVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -NumberOfThreads 32 -ResourceGroupName "rgname"
此命令會下載 .vhd 檔案,並將它儲存在本機路徑中。
此命令會指定 NumberOfThreads 參數的值 32。
因此,Cmdlet 會針對此動作使用 32 個執行緒。
範例 4:下載映像並指定儲存金鑰
Save-AzVhd -SourceUri "http://contosoaccount.blob.core.windows.net/vhdstore/win7baseimage.vhd" -LocalFilePath "C:\vhd\Win7Image.vhd" -StorageKey "zNvcH0r5vAGmC5AbwEtpcyWCMyBd3eMDbdaa4ua6kwxq6vTZH3Y+sw=="
此命令會下載 .vhd 檔案並指定儲存金鑰。
參數
-AsJob
在背景中執行 Cmdlet,並傳回作業以追蹤進度。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LocalFilePath
指定已儲存影像的本端檔案路徑。
參數屬性
| 類型: | FileInfo
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | lf |
參數集
(All)
| Position: | 2 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NumberOfThreads
指定此 Cmdlet 在下載期間使用的下載執行緒數目。
參數屬性
| 類型: | Int32
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | th |
參數集
(All)
| Position: | 3 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OverWrite
表示此 Cmdlet 會取代 LocalFilePath 檔案所指定的檔案 (如果存在的話)。
參數屬性
參數集
(All)
| Position: | 4 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResourceGroupName
指定儲存體帳戶的資源群組名稱。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ResourceGroupParameterSetName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-SourceUri
指定 中 Blob Azure的統一資源識別碼 (URI) 。
參數屬性
| 類型: | Uri
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | src, 來源 |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-StorageKey
指定 Blob 儲存體帳戶的儲存體金鑰。
如果您未指定金鑰,此 Cmdlet 會嘗試從 Azure 判斷 SourceUri 中帳戶的儲存體金鑰。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | sk |
參數集
StorageKeyParameterSetName
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸出