New-AzureRmVmssConfig

Modulo:

AzureRM.Compute

Crea un oggetto di configurazione VMSS.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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

Descrizione

Il cmdlet New-AzureRmVmssConfig crea un oggetto VMSS (Virtual Manager Scale Set) locale configurabile. Per configurare l'oggetto VMSS sono necessari altri cmdlet. Questi cmdlet sono:

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

Esempio

Esempio 1: Creare un oggetto di configurazione del set di scalabilità di macchine virtuali

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;

In questo esempio viene creato un oggetto di configurazione VMSS. Il primo comando usa il cmdlet New-AzureRmVmssConfig per creare un oggetto di configurazione VMSS e archivia il risultato nella variabile denominata $VMSS. Il secondo comando usa il cmdlet New-AzureRmVmss per creare un set di scalabilità di macchine virtuali che usa l'oggetto di configurazione VMSS creato nel primo comando.

Parametri

-AssignIdentity

Specificare l'identità assegnata dal sistema per il set di scalabilità di macchine virtuali.

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

-AutoOSUpgrade

Imposta se gli aggiornamenti del sistema operativo devono essere applicati automaticamente alle istanze del set di scalabilità in sequenza quando diventa disponibile una versione più recente dell'immagine.

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

-BootDiagnostic

Specifica il profilo di diagnostica di avvio del set di scalabilità di macchine virtuali.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

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

-DisableAutoRollback

Disabilitare il rollback automatico per i criteri di aggiornamento automatico del sistema operativo

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

-EnableUltraSSD

Consente a una funzionalità di avere uno o più dischi dati gestiti con UltraSSD_LRS tipo di account di archiviazione nel set di scalabilità di macchine virtuali. I dischi gestiti con tipo di account di archiviazione UltraSSD_LRS possono essere aggiunti a un set di scalabilità di macchine virtuali solo se questa proprietà è abilitata.

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

-EvictionPolicy

Specifica i criteri di rimozione per le macchine virtuali nel set di scalabilità.

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

-Extension

Specifica l'oggetto informazioni sull'estensione per il set di scalabilità di macchine virtuali. È possibile usare il cmdlet Add-AzureRmVmssExtension per aggiungere questo oggetto.

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

-HealthProbeId

Specifica l'ID di un probe del servizio di bilanciamento del carico usato per determinare l'integrità di un'istanza nel set di scalabilità di macchine virtuali. HealthProbeId è sotto forma di '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'.

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

-IdentityId

Specifica l'elenco delle identità utente associate al set di scalabilità di macchine virtuali. I riferimenti all'identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

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

-IdentityType

Specifica il tipo di identità usato per il set di scalabilità di macchine virtuali. Il tipo 'SystemAssignedUserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo "Nessuno" rimuoverà tutte le identità dal set di scalabilità di macchine virtuali. I valori validi per questo parametro sono:

• SystemAssigned
• UserAssigned
• SystemAssignedUserAssigned
• None

Type:	Nullable<T>[ResourceIdentityType]
Accepted values:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-LicenseType

Specificare il tipo di licenza, che consiste nel portare uno scenario di licenza personalizzato.

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

-Location

Specifica il percorso di Azure in cui viene creato il set di scalabilità di macchine virtuali.

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

-NetworkInterfaceConfiguration

Specifica l'oggetto profilo di rete che contiene le proprietà di rete per la configurazione del set di scalabilità di macchine virtuali. È possibile usare il cmdlet Add-AzureRmVmssNetworkInterfaceConfiguration per aggiungere questo oggetto.

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

-OsProfile

Specifica l'oggetto profilo del sistema operativo che contiene le proprietà del sistema operativo per la configurazione del set di scalabilità di macchine virtuali. Per impostare questo oggetto, è possibile usare il cmdlet Set-AzureRmVmssOsProfile .

Type:	VirtualMachineScaleSetOSProfile
Position:	7
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Overprovision

Indica se il cmdlet esegue il provisioning eccessivo del set di scalabilità di macchine virtuali.

Type:	Nullable<T>[Boolean]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PlanName

Specifica il nome del piano.

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

-PlanProduct

Specifica il prodotto del piano.

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

-PlanPromotionCode

Specifica il codice promozionale del piano.

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

-PlanPublisher

Specifica l'editore del piano.

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

-PlatformFaultDomainCount

Numero di domini di errore per ogni gruppo di posizionamento.

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

-Priority

Specifica la priorità per le macchine virtuali nel set di scalabilità.

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

-RollingUpgradePolicy

Specifica i criteri di aggiornamento in sequenza.

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

-SinglePlacementGroup

Specifica il singolo gruppo di posizionamento.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SkuCapacity

Specifica il numero di istanze nel set di scalabilità di macchine virtuali.

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

-SkuName

Specifica le dimensioni di tutte le istanze del set di scalabilità di macchine virtuali.

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

-SkuTier

Specifica il livello del set di scalabilità di macchine virtuali. I valori validi per questo parametro sono:

• Standard
• Di base

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

-StorageProfile

Specifica l'oggetto profilo di archiviazione che contiene le proprietà del disco per la configurazione del set di scalabilità di macchine virtuali. È possibile usare il cmdlet Set-AzureRmVmss Archiviazione Profile per impostare questo oggetto.

Type:	VirtualMachineScaleSetStorageProfile
Position:	8
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Coppie chiave-valore sotto forma di tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}

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

-UpgradePolicyMode

Specifica la modalità di un aggiornamento alle macchine virtuali nel set di scalabilità. I valori validi per questo parametro sono:

• Automatico
• Manuale

Type:	Nullable<T>[UpgradeMode]
Accepted values:	Automatic, Manual, Rolling
Position:	6
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

-Zone

Specifica l'elenco di zone per il set di scalabilità di macchine virtuali.

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

-ZoneBalance

Se forzare rigorosamente anche la distribuzione di macchine virtuali tra zone x in caso di interruzione della zona.

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

Input

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

Output

PSVirtualMachineScaleSet

Collegamenti correlati

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