Set-AzVmssStorageProfile

模組:: Az.Compute Module

設定 VMSS 的儲存設定檔內容。

語法

Default (預設值)

Set-AzVmssStorageProfile
    [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
    [[-ImageReferencePublisher] <String>]
    [[-ImageReferenceOffer] <String>]
    [[-ImageReferenceSku] <String>]
    [[-ImageReferenceVersion] <String>]
    [[-OsDiskName] <String>]
    [[-OsDiskCaching] <CachingTypes>]
    [[-OsDiskCreateOption] <String>]
    [-OsDiskDeleteOption <String>]
    [[-OsDiskOsType] <OperatingSystemTypes>]
    [[-Image] <String>]
    [[-VhdContainer] <String[]>]
    [-ImageReferenceId <String>]
    [-OsDiskWriteAccelerator]
    [-DiffDiskSetting <String>]
    [-DiffDiskPlacement <String>]
    [-ManagedDisk <String>]
    [-DiskEncryptionSetId <String>]
    [-DataDisk <VirtualMachineScaleSetDataDisk[]>]
    [-OSDiskSizeGB <Int32>]
    [-DiskControllerType <String>]
    [-SecurityEncryptionType <String>]
    [-SecureVMDiskEncryptionSet <String>]
    [-SharedGalleryImageId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Set-AzVmssStorageProfile Cmdlet 會設定虛擬機器擴展集（VMSS）的儲存體配置檔屬性。

範例

範例1：設定VMSS的儲存設定檔內容

Set-AzVmssStorageProfile -VirtualMachineScaleSet "ContosoVMSS" -Name "Test" -OsDiskCreateOption "FromImage" -OsDiskCaching "None" `
            -ImageReferenceOffer $ImgRef.Offer -ImageReferenceSku $ImgRef.Skus -ImageReferenceVersion $ImgRef.Version `
            -ImageReferencePublisher $ImgRef.PublisherName -VhdContainer $VhdContainer

此命令會設定名為 ContosoVMSS 之 VMSS 的儲存體配置檔屬性。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DataDisk

指定資料磁碟物件。

參數屬性

類型:	VirtualMachineScaleSetDataDisk[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-DefaultProfile

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

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DiffDiskPlacement

指定作業系統磁碟的暫時磁碟位置。使用者可以在要求中使用此屬性來選擇位置，即暫時性 OS 磁碟佈建的快取磁碟或資源磁碟空間。如需暫時性 OS 磁碟大小需求的詳細資訊，請參閱 Windows VM 的暫時性 OS 磁碟大小需求（和 https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Linux VM）。https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements 只有在參數 DiffDiskSetting 設定為 'Local' 時，才能使用此參數。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-DiffDiskSetting

指定作業系統磁碟的差異磁碟設定。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-DiskControllerType

指定為 VM 和 VirtualMachineScaleSet 設定的磁碟控制器類型。只有作業系統磁碟和 VM SKU 支援第 2 代（https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2）的虛擬機器才支援此屬性，請檢查 Microsoft 回應中傳回的 HyperVGenerations 功能，作為 VM SKU 功能的一部分。區域的計算 SKU API 包含 V2 （https://learn.microsoft.com/rest/api/compute/resourceskus/list）。
如需支援的磁碟控制器類型詳細資訊，請參閱 https://aka.ms/azure-diskcontrollertypes。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DiskEncryptionSetId

指定客戶受控磁碟加密集的資源識別碼。這只能針對受控磁碟指定。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Image

指定使用者映像的 Blob URI。 VMSS 會在使用者映像的相同容器中建立作業系統磁碟。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	9
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ImageReferenceId

指定影像參考 ID。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ImageReferenceOffer

指定虛擬機器映像（VMImage）供應項目的類型。若要取得映像供應專案，請使用 Get-AzVMImageOffer Cmdlet。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	2
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ImageReferencePublisher

指定 VMImage 發行者的名稱。若要取得發行者，請使用 Get-AzVMImagePublisher Cmdlet。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	1
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ImageReferenceSku

指定 VMImage SKU。若要取得 SKU，請使用 Get-AzVMImageSku Cmdlet。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	3
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ImageReferenceVersion

指定 VMImage 的版本。若要使用最新版本，請指定 latest 值，而不是特定版本。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	4
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ManagedDisk

指定受控磁碟。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-OsDiskCaching

指定作業系統磁碟的快取模式。此參數可接受的值為：

ReadOnly
ReadWrite預設值為ReadWrite。如果您變更快取值，Cmdlet 會重新啟動虛擬機器。此設定會影響磁碟的一致性和效能。

參數屬性

類型:	Nullable<T>[CachingTypes]
預設值:	None
接受的值:	None, ReadOnly, ReadWrite
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	6
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-OsDiskCreateOption

指定此 Cmdlet 如何建立 VMSS 虛擬機器。此參數可接受的值為：

連接：當您使用專用磁碟建立 VMSS 虛擬機器時，會使用此值。
FromImage ：當您使用映像建立 VMSS 虛擬機器時，會使用此值。如果您使用平台映像，也會使用 imageReference 參數。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	7
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-OsDiskDeleteOption

指定在刪除 VMSS Flex 時是否應刪除或中斷連結作業系統磁碟（此功能僅適用於具有彈性協調模式的 VMSS）。

Accepted Values Delete — 如果使用此值，則在刪除VMSS Flex VM時刪除作業系統磁碟。分離 - 如果使用此值、則在刪除VMSS Flex VM之後、會保留作業系統磁碟。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-OsDiskName

指定作業系統磁碟的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	名稱

參數集

(All)

Position:	5
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-OsDiskOsType

指定磁碟上的作業系統類型。這僅適用於使用者映像案例，而不需要平台映像。

參數屬性

類型:	Nullable<T>[OperatingSystemTypes]
預設值:	None
接受的值:	Windows, Linux
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	8
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-OSDiskSizeGB

指定以 GB 為單位的空白資料磁碟大小。這個元素可用來覆寫虛擬機映像中的磁碟大小。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-OsDiskWriteAccelerator

指定是否應該在 OS 磁碟上啟用或停用 WriteAccelerator。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SecureVMDiskEncryptionSet

要用於啟用待用加密的磁碟加密集 ResourceId。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-SecurityEncryptionType

設定虛擬機器擴展集的 SecurityEncryptionType。可能的值包括：DiskWithVMGuestState、VMGuestStateOnly

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-SharedGalleryImageId

指定 vm 部署的共享資源庫映像唯一標識碼。這可以從共用資源庫映像 GET 呼叫擷取。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-VhdContainer

指定用來儲存 VMSS 作業系統磁碟的容器 URL。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	10
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-VirtualMachineScaleSet

指定 VMSS 物件。若要取得物件，請使用 New-AzVmssConfig 物件。

參數屬性

類型:	PSVirtualMachineScaleSet
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

共用方式為

Set-AzVmssStorageProfile

語法

Default (預設值)

Description

範例

範例1：設定VMSS的儲存設定檔內容

參數

-Confirm

參數屬性

參數集

-DataDisk

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-DiffDiskPlacement

參數屬性

參數集

-DiffDiskSetting

參數屬性

參數集

-DiskControllerType

參數屬性

參數集

-DiskEncryptionSetId

參數屬性

參數集

-Image

參數屬性

參數集

-ImageReferenceId

參數屬性

參數集

-ImageReferenceOffer

參數屬性

參數集

-ImageReferencePublisher

參數屬性

參數集

-ImageReferenceSku

參數屬性

參數集

-ImageReferenceVersion

參數屬性

參數集

-ManagedDisk

參數屬性

參數集

-OsDiskCaching

參數屬性

參數集

-OsDiskCreateOption

參數屬性

參數集

-OsDiskDeleteOption

參數屬性

參數集

-OsDiskName

參數屬性

參數集

-OsDiskOsType

參數屬性

參數集

-OSDiskSizeGB

參數屬性

參數集

-OsDiskWriteAccelerator

參數屬性

參數集

-SecureVMDiskEncryptionSet

參數屬性

參數集

-SecurityEncryptionType

參數屬性

參數集

-SharedGalleryImageId

參數屬性

參數集