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

Set-AzVmssStorageProfile

设置 VMSS 的存储配置文件属性。

语法

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-AzVmss存储Profile 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 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DataDisk

指定数据磁盘对象。

Type:VirtualMachineScaleSetDataDisk[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiffDiskPlacement

指定操作系统磁盘的临时磁盘放置。 用户可以在请求中使用此属性来选择用于临时 OS 磁盘预配的位置,即缓存磁盘或资源磁盘空间。 有关临时 OS 磁盘大小要求的详细信息,请参阅 上的 https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Windows VM 和 Linux VM https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements的临时 OS 磁盘大小要求。 仅当参数 DiffDiskSetting 设置为“Local”时,才能使用此参数。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiffDiskSetting

指定操作系统磁盘的不同磁盘设置。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DiskControllerType

指定为 VM 和 VirtualMachineScaleSet 配置的磁盘控制器类型。 只有操作系统磁盘和 VM SKU 支持第 2 代(https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2)的虚拟机才支持此属性,检查作为 VM SKU 功能的一部分返回的 HyperVGenerations 功能,响应该区域的 Microsoft.Compute SKU API 包含 V2(https://learn.microsoft.com/rest/api/compute/resourceskus/list) 。
有关支持的磁盘控制器类型的详细信息,请参阅 https://aka.ms/azure-diskcontrollertypes

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskEncryptionSetId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Image

指定用户映像的 Blob URI。 VMSS 在用户映像的同一容器中创建操作系统磁盘。

Type:String
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageReferenceId

指定图像引用 ID。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageReferenceOffer

指定虚拟机映像(VMImage)产品/服务的类型。 若要获取映像产品/服务,请使用 Get-AzVMImageOffer cmdlet。

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageReferencePublisher

指定 VMImage 的发布者的名称。 若要获取发布者,请使用 Get-AzVMImagePublisher cmdlet。

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageReferenceSku

指定 VMImage SKU。 若要获取 SKU,请使用 Get-AzVMImageSku cmdlet。

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ImageReferenceVersion

指定 VMImage 的版本。 若要使用最新版本,请指定最新版本而不是特定版本的值。

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ManagedDisk

指定托管磁盘。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OsDiskCaching

指定操作系统磁盘的缓存模式。 此参数的可接受值为:

  • ReadOnly
  • ReadWrite 默认值为 ReadWrite。 如果更改缓存值,cmdlet 将重启虚拟机。 此设置会影响磁盘的一致性和性能。
Type:Nullable<T>[CachingTypes]
Accepted values:None, ReadOnly, ReadWrite
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OsDiskCreateOption

指定此 cmdlet 如何创建 VMSS 虚拟机。 此参数的可接受值为:

  • 附加:使用专用磁盘创建 VMSS 虚拟机时,将使用此值。
  • FromImage:使用映像创建 VMSS 虚拟机时,将使用此值。 如果使用平台映像,则还将使用 imageReference 参数。
Type:String
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OsDiskDeleteOption

指定在 VMSS Flex 删除时是否应删除或分离 OS 磁盘(此功能仅适用于具有灵活 OrchestrationMode 的 VMSS)。

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OsDiskName

指定操作系统磁盘的名称。

Type:String
Aliases:Name
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OsDiskOsType

指定磁盘上的操作系统类型。 这仅适用于用户映像方案,而不需要用于平台映像。

Type:Nullable<T>[OperatingSystemTypes]
Accepted values:Windows, Linux
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OSDiskSizeGB

指定空数据磁盘的大小(以 GB 为单位)。 此元素可用于覆盖虚拟机映像中的磁盘大小。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OsDiskWriteAccelerator

指定是否应在 OS 磁盘上启用或禁用 WriteAccelerator。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecureVMDiskEncryptionSet

用于启用静态加密的磁盘加密集的 ResourceId。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SecurityEncryptionType

设置虚拟机规模集的 SecurityEncryptionType。 可能的值包括:DiskWithVMGuestState、VMGuestStateOnly

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SharedGalleryImageId

为 vm 部署指定共享库映像唯一 ID。 这可以从共享库映像 GET 调用中提取。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VhdContainer

指定用于存储 VMSS 操作系统磁盘的容器 URL。

Type:String[]
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VirtualMachineScaleSet

指定 VMSS 对象。 若要获取对象,请使用 New-AzVmssConfig 对象。

Type:PSVirtualMachineScaleSet
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

PSVirtualMachineScaleSet

String

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

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

String[]

VirtualMachineScaleSetDataDisk[]

输出

PSVirtualMachineScaleSet