你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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>]

说明

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
别名:	cf

参数集

(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 磁盘大小要求的详细信息，请参阅上的 https://free.blessedness.top/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Windows VM 和 Linux VM https://free.blessedness.top/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements的临时 OS 磁盘大小要求。仅当参数 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://free.blessedness.top/en-us/azure/virtual-machines/generation-2）的虚拟机才支持此属性，请在响应区域中的 Microsoft.Compute SKU API 包含 V2 （https://free.blessedness.top/rest/api/compute/resourceskus/list）时检查作为 VM SKU 功能的一部分返回的 HyperVGenerations 功能。
有关支持的磁盘控制器类型的详细信息，请参阅 https://aka.ms/azure-diskcontrollertypes。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DiskEncryptionSetId

指定客户托管磁盘加密集的资源 ID。这只能为托管磁盘指定。

参数属性

类型:	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 的版本。若要使用最新版本，请指定最新版本而不是特定版本的值。

参数属性

类型:	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 删除时是否应删除或分离 OS 磁盘（此功能仅适用于具有灵活 OrchestrationMode 的 VMSS）。

接受的值删除 - 如果使用此值，则删除 VMSS Flex VM 时，将删除 OS 磁盘。分离 - 如果使用此值，则会在删除 VMSS Flex VM 后保留 OS 磁盘。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-OsDiskName

指定作系统磁盘的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	Name

参数集

(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 部署指定共享库映像唯一 ID。这可以从共享库映像 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 （默认值）

说明

示例

示例 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

参数属性

参数集