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

New-AzureRmVMConfig

创建可配置的虚拟机对象。

警告

截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

New-AzureRmVMConfig
   [-VMName] <String>
   [-VMSize] <String>
   [[-AvailabilitySetId] <String>]
   [[-LicenseType] <String>]
   [-Zone <String[]>]
   [-Tags <Hashtable>]
   [-EnableUltraSSD]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmVMConfig
   [-VMName] <String>
   [-VMSize] <String>
   [[-AvailabilitySetId] <String>]
   [[-LicenseType] <String>]
   [-IdentityType] <ResourceIdentityType>
   [-IdentityId <String[]>]
   [-Zone <String[]>]
   [-Tags <Hashtable>]
   [-EnableUltraSSD]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmVMConfig
   [-VMName] <String>
   [-VMSize] <String>
   [[-AvailabilitySetId] <String>]
   [[-LicenseType] <String>]
   [-AssignIdentity]
   [-Zone <String[]>]
   [-Tags <Hashtable>]
   [-EnableUltraSSD]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

New-AzureRmVMConfig cmdlet 为 Azure 创建可配置的本地虚拟机对象。 其他 cmdlet 可用于配置虚拟机对象,例如 Set-AzureRmVMOperatingSystem、Set-AzureRmVMSourceImage、Add-AzureRmVMNetworkInterface 和 Set-AzureRmVMOSDisk。

示例

示例 1:创建虚拟机对象

PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id

第一个命令获取名为 ResourceGroup11 的资源组中名为 AvailablitySet03 的可用性集,然后将该对象存储在$AvailabilitySet变量中。 第二个命令创建虚拟机对象,然后将其存储在$VirtualMachine变量中。 该命令将名称和大小分配给虚拟机。 虚拟机属于存储在$AvailabilitySet的可用性集。

参数

-AssignIdentity

指定虚拟机的系统分配标识。

类型:SwitchParameter
Position:Named
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-AvailabilitySetId

指定可用性集的 ID。 若要获取可用性集对象,请使用 Get-AzureRmAvailabilitySet cmdlet。 可用性集对象包含 ID 属性。

类型:String
Position:2
默认值:None
必需:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

类型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableUltraSSD

允许在 VM 上使用UltraSSD_LRS存储帐户类型的一个或多个托管数据磁盘。 仅当启用此属性时,才能将存储帐户类型UltraSSD_LRS的托管磁盘添加到虚拟机。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
Accept pipeline input:True
Accept wildcard characters:False

-IdentityId

指定与虚拟机规模集关联的用户标识列表。 用户标识引用的格式为 ARM 资源 ID:“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}”

类型:String[]
Position:Named
默认值:None
必需:False
Accept pipeline input:True
Accept wildcard characters:False

-IdentityType

虚拟机的标识(如果已配置)。

类型:Nullable<T>[ResourceIdentityType]
接受的值:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:4
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-LicenseType

用于自带许可证方案的许可证类型。

类型:String
Position:3
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Tags

附加到资源的标记。

类型:Hashtable
Aliases:Tag
Position:Named
默认值:None
必需:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

指定虚拟机的名称。

类型:String
Aliases:ResourceName, Name
Position:0
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-VMSize

指定虚拟机的大小。

类型:String
Position:1
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-Zone

指定虚拟机的区域列表。

类型:String[]
Position:Named
默认值:None
必需:False
Accept pipeline input:True
Accept wildcard characters:False

输入

String

String[]

Hashtable

输出

PSVirtualMachine