共用方式為

New-AzureRmVmssConfig

  • 參考
模組:
AzureRM.Compute

建立 VMSS 組態物件。

警告

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

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

語法

New-AzureRmVmssConfig
   [[-Overprovision] <Boolean>]
   [[-Location] <String>]
   [[-Tag] <Hashtable>]
   [[-SkuName] <String>]
   [[-SkuTier] <String>]
   [[-SkuCapacity] <Int32>]
   [[-UpgradePolicyMode] <UpgradeMode>]
   [[-OsProfile] <VirtualMachineScaleSetOSProfile>]
   [[-StorageProfile] <VirtualMachineScaleSetStorageProfile>]
   [[-NetworkInterfaceConfiguration] <VirtualMachineScaleSetNetworkConfiguration[]>]
   [[-Extension] <VirtualMachineScaleSetExtension[]>]
   [-SinglePlacementGroup <Boolean>]
   [-ZoneBalance]
   [-PlatformFaultDomainCount <Int32>]
   [-Zone <String[]>]
   [-PlanName <String>]
   [-PlanPublisher <String>]
   [-PlanProduct <String>]
   [-PlanPromotionCode <String>]
   [-RollingUpgradePolicy <RollingUpgradePolicy>]
   [-AutoOSUpgrade]
   [-DisableAutoRollback <Boolean>]
   [-EnableUltraSSD]
   [-HealthProbeId <String>]
   [-BootDiagnostic <BootDiagnostics>]
   [-LicenseType <String>]
   [-Priority <String>]
   [-EvictionPolicy <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmVmssConfig
   [[-Overprovision] <Boolean>]
   [[-Location] <String>]
   [[-Tag] <Hashtable>]
   [[-SkuName] <String>]
   [[-SkuTier] <String>]
   [[-SkuCapacity] <Int32>]
   [[-UpgradePolicyMode] <UpgradeMode>]
   [[-OsProfile] <VirtualMachineScaleSetOSProfile>]
   [[-StorageProfile] <VirtualMachineScaleSetStorageProfile>]
   [[-NetworkInterfaceConfiguration] <VirtualMachineScaleSetNetworkConfiguration[]>]
   [[-Extension] <VirtualMachineScaleSetExtension[]>]
   [-SinglePlacementGroup <Boolean>]
   [-ZoneBalance]
   [-PlatformFaultDomainCount <Int32>]
   [-Zone <String[]>]
   [-PlanName <String>]
   [-PlanPublisher <String>]
   [-PlanProduct <String>]
   [-PlanPromotionCode <String>]
   [-RollingUpgradePolicy <RollingUpgradePolicy>]
   [-AutoOSUpgrade]
   [-DisableAutoRollback <Boolean>]
   [-EnableUltraSSD]
   [-HealthProbeId <String>]
   [-BootDiagnostic <BootDiagnostics>]
   [-LicenseType <String>]
   [-Priority <String>]
   [-EvictionPolicy <String>]
   -IdentityType <ResourceIdentityType>
   [-IdentityId <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmVmssConfig
   [[-Overprovision] <Boolean>]
   [[-Location] <String>]
   [[-Tag] <Hashtable>]
   [[-SkuName] <String>]
   [[-SkuTier] <String>]
   [[-SkuCapacity] <Int32>]
   [[-UpgradePolicyMode] <UpgradeMode>]
   [[-OsProfile] <VirtualMachineScaleSetOSProfile>]
   [[-StorageProfile] <VirtualMachineScaleSetStorageProfile>]
   [[-NetworkInterfaceConfiguration] <VirtualMachineScaleSetNetworkConfiguration[]>]
   [[-Extension] <VirtualMachineScaleSetExtension[]>]
   [-SinglePlacementGroup <Boolean>]
   [-ZoneBalance]
   [-PlatformFaultDomainCount <Int32>]
   [-Zone <String[]>]
   [-PlanName <String>]
   [-PlanPublisher <String>]
   [-PlanProduct <String>]
   [-PlanPromotionCode <String>]
   [-RollingUpgradePolicy <RollingUpgradePolicy>]
   [-AutoOSUpgrade]
   [-DisableAutoRollback <Boolean>]
   [-EnableUltraSSD]
   [-HealthProbeId <String>]
   [-BootDiagnostic <BootDiagnostics>]
   [-LicenseType <String>]
   [-Priority <String>]
   [-EvictionPolicy <String>]
   [-AssignIdentity]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzureRmVmssConfig Cmdlet 會建立可設定的本機 Virtual Manager 擴展集 （VMSS） 物件。 需要其他 Cmdlet 才能設定 VMSS 物件。 這些 Cmdlet 包括：

  • Set-AzureRmVmssOsProfile
  • Set-AzureRmVmssStorageProfile
  • Add-AzureRmVmssNetworkInterfaceConfiguration
  • Add-AzureRmVmssExtension

範例

範例 1：建立 VMSS 組態物件

PS C:\> $VMSS = New-AzureRmVmssConfig -Location $Loc -SkuCapacity 2 -SkuName "Standard_A0" -UpgradePolicyMode "Automatic" -NetworkInterfaceConfiguration $NetCfg `
            | Add-AzureRmVmssNetworkInterfaceConfiguration -Name "Test" -Primary $True -IPConfiguration $IPCfg `
            | Set-AzureRmVmssOSProfile -ComputerNamePrefix "Test" -AdminUsername $adminUsername -AdminPassword $AdminPassword `
            | Set-AzureRmVmssStorageProfile -Name "Test" -OsDiskCreateOption "FromImage" -OsDiskCaching "None" `
            -ImageReferenceOffer $ImgRef.Offer -ImageReferenceSku $ImgRef.Skus -ImageReferenceVersion $ImgRef.Version `
            -ImageReferencePublisher $ImgRef.PublisherName -VhdContainer $VHDContainer `
            | Add-AzureRmVmssAdditionalUnattendContent -ComponentName  $AUCComponentName -Content  $AUCContent -PassName  $AUCPassName -SettingName  $AUCSetting `
            | Remove-AzureRmVmssAdditionalUnattendContent -ComponentName  $AUCComponentName;

New-AzureRmVmss -ResourceGroupName $RGName -Name $VMSSName -VirtualMachineScaleSet $VMSS;

此範例會建立 VMSS 組態物件。 第一個命令會使用 New-AzureRmVmssConfig Cmdlet來建立 VMSS 組態物件，並將結果儲存在名為 $VMSS的變數中。 第二個命令會使用 New-AzureRmVmss Cmdlet 來建立 VMSS，該 VMSS 會使用在第一個命令中建立的 VMSS 組態物件。

參數

-AssignIdentity

指定虛擬機擴展集的系統指派身分識別。

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

-AutoOSUpgrade

設定當較新版本的映像可用時，操作系統升級是否應該以滾動方式自動套用至擴展集實例。

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

-BootDiagnostic

指定虛擬機擴展集開機診斷配置檔。

類型:BootDiagnostics
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

-DisableAutoRollback

停用自動OS升級原則的自動回復

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

-EnableUltraSSD

讓能夠在虛擬機擴展集上具有一或多個具有UltraSSD_LRS記憶體帳戶類型的受控數據磁碟。 只有啟用此屬性，才能將具有記憶體帳戶類型的受控磁碟UltraSSD_LRS新增至 VMSS。

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

-EvictionPolicy

指定擴展集中虛擬機的收回原則。

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

-Extension

指定 VMSS 的擴充信息物件。 您可以使用 Add-AzureRmVmssExtension Cmdlet 來新增此物件。

類型:VirtualMachineScaleSetExtension[]
Position:10
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-HealthProbeId

指定用來判斷虛擬機擴展集中實例健全狀況的負載平衡器探查標識碼。 HealthProbeId 的格式為 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'。

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

-IdentityId

指定與虛擬機擴展集相關聯的使用者身分識別清單。 使用者身分識別參考的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

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

-IdentityType

指定用於虛擬機擴展集的身分識別類型。 類型 『SystemAssignedUserAssigned』 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 會從虛擬機擴展集移除任何身分識別。 此參數可接受的值為：

  • SystemAssigned
  • UserAssigned
  • SystemAssignedUserAssigned
  • 無
類型:Nullable<T>[ResourceIdentityType]
接受的值:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-LicenseType

指定授權類型，這是用於攜帶您自己的授權案例。

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

-Location

指定建立 VMSS 的 Azure 位置。

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

-NetworkInterfaceConfiguration

指定包含 VMSS 組態之網路屬性的網路配置檔物件。 您可以使用 Add-AzureRmVmssNetworkInterfaceConfiguration Cmdlet 來新增此物件。

類型:VirtualMachineScaleSetNetworkConfiguration[]
Position:9
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-OsProfile

指定包含 VMSS 組態之作業系統屬性的作業系統設定檔物件。 您可以使用 Set-AzureRmVmssOsProfile Cmdlet 來設定此物件。

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

-Overprovision

指出 Cmdlet 是否過度布建 VMSS。

類型:Nullable<T>[Boolean]
Position:0
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-PlanName

指定計劃名稱。

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

-PlanProduct

指定方案產品。

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

-PlanPromotionCode

指定方案促銷碼。

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

-PlanPublisher

指定方案發行者。

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

-PlatformFaultDomainCount

每個放置群組的容錯網域計數。

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

-Priority

指定擴展集中虛擬機的優先順序。

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

-RollingUpgradePolicy

指定滾動升級原則。

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

-SinglePlacementGroup

指定單一放置群組。

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

-SkuCapacity

指定 VMSS 中的實例數目。

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

-SkuName

指定 VMSS 的所有實體大小。

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

-SkuTier

指定 VMSS 層。 此參數可接受的值為：

  • 標準
  • 基本
類型:String
Position:4
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-StorageProfile

指定記憶體配置檔物件，其中包含 VMSS 組態的磁碟屬性。 您可以使用 Set-AzureRmVmssStorageProfile Cmdlet 來設定此物件。

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

-Tag

哈希表形式的索引鍵/值組。 例如：@{key0=“value0”;key1=$null;key2=“value2”}

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

-UpgradePolicyMode

指定升級至擴展集中虛擬機的模式。 此參數可接受的值為：

  • 自動
  • 手動
類型:Nullable<T>[UpgradeMode]
接受的值:Automatic, Manual, Rolling
Position:6
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-WhatIf

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

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

-Zone

指定虛擬機擴展集的區域清單。

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

-ZoneBalance

如果發生區域中斷，是否要強制甚至虛擬機散發跨 x 區域。

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

輸入

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

String

Hashtable

Int32

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

VirtualMachineScaleSetOSProfile

VirtualMachineScaleSetStorageProfile

VirtualMachineScaleSetNetworkConfiguration[]

VirtualMachineScaleSetExtension[]

String[]

RollingUpgradePolicy

BootDiagnostics

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

輸出

PSVirtualMachineScaleSet