Set-AzureRmImageOsDisk

參考

模組:: AzureRM.Compute

設定映像物件上的作業系統磁碟屬性。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。如需轉換至 Az 模組的指引，請參閱我們的移轉資源。

語法

Set-AzureRmImageOsDisk
   [-Image] <PSImage>
   [[-OsType] <OperatingSystemTypes>]
   [[-OsState] <OperatingSystemStateTypes>]
   [[-BlobUri] <String>]
   [-Caching <CachingTypes>]
   [-DiskSizeGB <Int32>]
   [-StorageAccountType <String>]
   [-SnapshotId <String>]
   [-ManagedDiskId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzureRmImageOsDisk Cmdlet 會在映射對象上設定操作系統磁碟屬性。

範例

範例 1

PS C:\> $imageConfig = New-AzureRmImageConfig -Location 'West US';
PS C:\> $osDiskVhdUri = "https://contoso.blob.core.windows.net/test/os.vhd"
PS C:\> $dataDiskVhdUri1 = "https://contoso.blob.core.windows.net/test/data1.vhd"
PS C:\> $dataDiskVhdUri2 = "https://contoso.blob.core.windows.net/test/data2.vhd"
PS C:\> Set-AzureRmImageOsDisk -Image $imageConfig -OsType 'Windows' -OsState 'Generalized' -BlobUri $osDiskVhdUri;
PS C:\> Add-AzureRmImageDataDisk -Image $imageConfig -Lun 1 -BlobUri $dataDiskVhdUri1;
PS C:\> Add-AzureRmImageDataDisk -Image $imageConfig -Lun 2 -BlobUri $dataDiskVhdUri2;
PS C:\> New-AzureRmImage -Image $imageConfig -ImageName 'ImageName01' -ResourceGroupName 'ResourceGroup01';

第一個命令會建立映像對象，然後將它儲存在$imageConfig變數中。接下來的三個命令會將os磁碟和兩個數據磁碟的路徑指派給 $osDiskVhdUri、$dataDiskVhdUri 1 和 $dataDiskVhdUri 2 變數。此方法僅適用於下列命令的可讀性。接下來的三個命令會將os磁碟和兩個數據磁碟新增至儲存在 $imageConfig中的映像。每個磁碟的 URI 會儲存在 $osDiskVhdUri、$dataDiskVhdUri 1 和 $dataDiskVhdUri 2 中。最後一個命令會在資源群組『ResourceGroup01』中建立名為『ImageName01』的映像。

參數

-BlobUri

指定 Blob 的 URI。

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

-Caching

指定磁碟的快取模式。

類型:	Nullable<T>[CachingTypes]
接受的值:	None, ReadOnly, ReadWrite
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

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

-DiskSizeGB

指定以 GB 為單位的磁碟大小。

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

-Image

指定本機影像物件。

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

-ManagedDiskId

指定受控磁碟的識別碼。

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

-OsState

指定 OS 狀態。

類型:	Nullable<T>[OperatingSystemStateTypes]
接受的值:	Generalized, Specialized
Position:	2
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-OsType

指定 OS 類型。

類型:	Nullable<T>[OperatingSystemTypes]
接受的值:	Windows, Linux
Position:	1
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-SnapshotId

指定快照集的識別碼。

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

-StorageAccountType

Os 映像磁碟的記憶體帳戶類型

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

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

輸入

PSImage

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.OperatingSystemTypes, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.OperatingSystemStateTypes, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

String

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.CachingTypes, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Int32

輸出