共用方式為

Add-AzureDataDisk

  • 參考
模組:
Azure

將資料磁碟新增至虛擬機器。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。

語法

Add-AzureDataDisk
   [-CreateNew]
   [-DiskSizeInGB] <Int32>
   [-DiskLabel] <String>
   [-LUN] <Int32>
   [-MediaLocation <String>]
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-Import]
   [-DiskName] <String>
   [-LUN] <Int32>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureDataDisk
   [-ImportFrom]
   [-DiskLabel] <String>
   [-LUN] <Int32>
   -MediaLocation <String>
   [-HostCaching <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Add-AzureDataDisk Cmdlet 會將新的或現有的數據磁碟新增至 Azure 虛擬機物件。 使用 CreateNew 參數來建立具有指定大小和標籤的新數據磁碟。 使用 Import 參數從映像存放庫連結現有的磁碟。 使用 ImportFrom 參數，從記憶體帳戶中的 Blob 連結現有的磁碟。 您可以指定連結資料磁碟的主機快取模式。

範例

範例 1：從存放庫匯入數據磁碟

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine07" | Add-AzureDataDisk -Import -DiskName "Disk68" -LUN 0 | Update-AzureVM

此命令會使用 Get-AzureVM Cmdlet，取得 ContosoService 雲端服務中名為 VirtualMachine07 的虛擬機虛擬機物件。 命令會使用管線運算符將它傳遞給目前的 Cmdlet。 該命令會將現有的數據磁碟從存放庫連結至虛擬機。 數據磁碟的 LUN 為 0。 命令會更新虛擬機，以使用 Update-AzureVM Cmdlet來反映您的變更。

範例 2：新增數據磁碟

PS C:\> Get-AzureVM "ContosoService" -Name "VirtualMachine08" | Add-AzureDataDisk -CreateNew -DiskSizeInGB 128 -DiskLabel "main" -LUN 0 | Update-AzureVM

此命令會取得名為 VirtualMachine08 之虛擬機的虛擬機物件。 命令會將它傳遞給目前的 Cmdlet。 此命令會連結名為 MyNewDisk.vhd 的新數據磁碟。 Cmdlet 會在目前訂用帳戶的預設記憶體帳戶中，於 vhds 容器中建立磁碟。 命令會更新虛擬機，以反映您的變更。

範例 3：從指定位置新增數據磁碟

PS C:\> Get-AzureVM "ContosoService" -Name "Database" | Add-AzureDataDisk -ImportFrom -MediaLocation "https://contosostorage.blob.core.windows.net/container07/Disk14.vhd" -DiskLabel "main" -LUN 0 | Update-AzureVM

此命令會取得名為 Database 之虛擬機的虛擬機物件。 命令會將它傳遞給目前的 Cmdlet。 該命令會從指定的位置連結名為 Disk14.vhd 的現有數據磁碟。 命令會更新虛擬機，以反映您的變更。

參數

-CreateNew

表示此 Cmdlet 會建立數據磁碟。

類型:SwitchParameter
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DiskLabel

指定新數據磁碟的磁碟標籤。

類型:String
Position:2
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DiskName

指定磁碟存放庫中數據磁碟的名稱。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-DiskSizeInGB

指定新數據磁碟的邏輯磁碟大小，以 GB 為單位。

類型:Int32
Position:1
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-HostCaching

指定磁碟的主機層級快取設定。 有效值為：

  • 無
  • ReadOnly
  • 讀寫
類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Import

指出此 Cmdlet 會從映像存放庫匯入現有的數據磁碟。

類型:SwitchParameter
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ImportFrom

指出此 Cmdlet 會從記憶體帳戶中的 Blob 匯入現有的數據磁碟。

類型:SwitchParameter
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-InformationAction

指定此 Cmdlet 如何回應資訊事件。

此參數可接受的值為：

  • 繼續
  • 忽略
  • 詢問
  • SilentlyContinue
  • 停止
  • 暫止
類型:ActionPreference
別名:infa
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InformationVariable

指定資訊變數。

類型:String
別名:iv
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LUN

指定虛擬機中數據磁碟驅動器的邏輯單元編號（LUN）。 有效值為：0 到 15。 每個數據磁碟都必須有唯一的 LUN。

類型:Int32
Position:3
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-MediaLocation

指定此 Cmdlet 儲存數據磁碟的 Azure 記憶體帳戶中 Blob 的位置。 如果您未指定位置，Cmdlet 會將數據磁碟儲存在目前訂用帳戶的預設記憶體帳戶的 vhds 容器中。 如果 vhds 容器不存在，Cmdlet 會建立 vhds 容器。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。

類型:AzureSMProfile
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VM

指定這個 Cmdlet 連接資料磁碟的虛擬機物件。 若要取得虛擬機物件，請使用 Get-AzureVM Cmdlet。

類型:IPersistentVM
別名:InputObject
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False