Delen via

New-AzVmssConfig

  • Referentie
Module:
Az.Compute

Hiermee maakt u een VMSS-configuratieobject.

Syntax

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

Description

Met de cmdlet New-AzVmssConfig maakt u een configureerbaar lokaal VMSS-object (Virtual Manager Scale Set). Er zijn andere cmdlets nodig om het VMSS-object te configureren. Deze cmdlets zijn:

  • Set-AzVmssOsProfile
  • Set-AzVmssStorageProfile
  • Add-AzVmssNetworkInterfaceConfiguration
  • Add-AzVmssExtension

Voorbeelden

Voorbeeld 1: Een VMSS-configuratieobject maken

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

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

In dit voorbeeld wordt een VMSS-configuratieobject gemaakt. De eerste opdracht maakt gebruik van de cmdlet New-AzVmssConfig om een VMSS-configuratieobject te maken en slaat het resultaat op in de variabele met de naam $VMSS. De tweede opdracht maakt gebruik van de cmdlet New-AzVmss om een VMSS te maken die gebruikmaakt van het VMSS-configuratieobject dat in de eerste opdracht is gemaakt.

Parameters

-AssignIdentity

Geef de door het systeem toegewezen identiteit op voor de virtuele-machineschaalset.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-AutoOSUpgrade

Hiermee stelt u in of besturingssysteemupgrades automatisch op schaalsetexemplaren moeten worden toegepast wanneer een nieuwere versie van de installatiekopie beschikbaar wordt.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-BootDiagnostic

Hiermee geeft u het diagnostische profiel voor de virtuele-machineschaalset op.

Type:BootDiagnostics
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Extension

Hiermee geeft u het extensie-informatieobject voor de VMSS. U kunt de cmdlet Add-AzVmssExtension gebruiken om dit object toe te voegen.

Type:VirtualMachineScaleSetExtension[]
Position:10
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-HealthProbeId

Hiermee geeft u de id op van een load balancer-test die wordt gebruikt om de status van een exemplaar in de virtuele-machineschaalset te bepalen. HealthProbeId heeft de vorm '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-IdentityId

Hiermee geeft u de lijst met gebruikersidentiteiten die zijn gekoppeld aan de virtuele-machineschaalset. De verwijzingen naar gebruikersidentiteiten zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Type:String[]
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-IdentityType

Hiermee geeft u het type identiteit dat wordt gebruikt voor de virtuele-machineschaalset. Het type SystemAssignedUserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type None worden alle identiteiten uit de virtuele-machineschaalset verwijderd. De acceptabele waarden voor deze parameter zijn:

  • SystemAssigned
  • UserAssigned
  • SystemAssignedUserAssigned
  • None
Type:ResourceIdentityType
geaccepteerde waarden:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-LicenseType

Geef het licentietype op. Dit is bedoeld voor het meenemen van uw eigen licentiescenario.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Hiermee geeft u de Azure-locatie op waar de VMSS wordt gemaakt.

Type:String
Position:1
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-NetworkInterfaceConfiguration

Hiermee geeft u het netwerkprofielobject dat de netwerkeigenschappen voor de VMSS-configuratie bevat. U kunt de cmdlet Add-AzVmssNetworkInterfaceConfiguration gebruiken om dit object toe te voegen.

Type:VirtualMachineScaleSetNetworkConfiguration[]
Position:9
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-OsProfile

Hiermee geeft u het profielobject van het besturingssysteem dat de eigenschappen van het besturingssysteem voor de VMSS-configuratie bevat. U kunt de cmdlet Set-AzVmssOsProfile gebruiken om dit object in te stellen.

Type:VirtualMachineScaleSetOSProfile
Position:7
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Overprovision

Geeft aan of de cmdlet de VMSS overprovisiont.

Type:Boolean
Position:0
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-PlanName

Hiermee geeft u de naam van het plan.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-PlanProduct

Hiermee geeft u het planproduct op.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-PlanPromotionCode

Hiermee geeft u de promotiecode van het plan.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-PlanPublisher

Hiermee geeft u de uitgever van het plan op.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Priority

Hiermee geeft u de prioriteit voor de virtuele machines in de schaalset.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-RollingUpgradePolicy

Hiermee geeft u het beleid voor rolling upgrades op.

Type:RollingUpgradePolicy
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-SinglePlacementGroup

Hiermee geeft u de individuele plaatsingsgroep.

Type:Boolean
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-SkuCapacity

Hiermee geeft u het aantal exemplaren in de VMSS.

Type:Int32
Position:5
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-SkuName

Hiermee geeft u de grootte van alle exemplaren van VMSS.

Type:String
Aliases:AccountType
Position:3
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-SkuTier

Hiermee geeft u de laag van VMSS. De acceptabele waarden voor deze parameter zijn:

  • Standard
  • Basis
Type:String
Position:4
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageProfile

Hiermee geeft u het opslagprofielobject op dat de schijfeigenschappen voor de VMSS-configuratie bevat. U kunt de cmdlet Set-AzVmssStorageProfile gebruiken om dit object in te stellen.

Type:VirtualMachineScaleSetStorageProfile
Position:8
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Voorbeeld:

@{key0="value0";key1=$null;key2="value2"}

Type:Hashtable
Position:2
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-UpgradePolicyMode

De modus van een upgrade naar virtuele machines in de schaalset opgegeven.

De acceptabele waarden voor deze parameter zijn:

  • Automatisch
  • Manual
Type:UpgradeMode
geaccepteerde waarden:Automatic, Manual, Rolling
Position:6
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Hiermee geeft u de zonelijst voor de virtuele-machineschaalset.

Type:String[]
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

None

Deze cmdlet accepteert geen invoer.

Uitvoerwaarden

PSVirtualMachineScaleSet