New-AzVmss
Crée un groupe de machines virtuelles identiques.
Syntaxe
New-AzVmss
[-ResourceGroupName] <String>
[-VMScaleSetName] <String>
[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
[-AsJob]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-EdgeZone <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzVmss
[[-ResourceGroupName] <String>]
[-VMScaleSetName] <String>
[-AsJob]
[-UserData <String>]
[-EnableAutomaticOSUpgrade]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-ImageName <String>]
-Credential <PSCredential>
[-InstanceCount <Int32>]
[-VirtualNetworkName <String>]
[-SubnetName <String>]
[-PublicIpAddressName <String>]
[-DomainNameLabel <String>]
[-SecurityGroupName <String>]
[-LoadBalancerName <String>]
[-BackendPort <Int32[]>]
[-Location <String>]
[-EdgeZone <String>]
[-VmSize <String>]
[-UpgradePolicyMode <UpgradeMode>]
[-AllocationMethod <String>]
[-VnetAddressPrefix <String>]
[-SubnetAddressPrefix <String>]
[-FrontendPoolName <String>]
[-BackendPoolName <String>]
[-SystemAssignedIdentity]
[-UserAssignedIdentity <String>]
[-EnableUltraSSD]
[-Zone <System.Collections.Generic.List`1[System.String]>]
[-NatBackendPort <Int32[]>]
[-DataDiskSizeInGb <Int32[]>]
[-ProximityPlacementGroupId <String>]
[-HostGroupId <String>]
[-Priority <String>]
[-EvictionPolicy <String>]
[-MaxPrice <Double>]
[-ScaleInPolicy <String[]>]
[-SkipExtensionsOnOverprovisionedVMs]
[-EncryptionAtHost]
[-PlatformFaultDomainCount <Int32>]
[-OrchestrationMode <String>]
[-CapacityReservationGroupId <String>]
[-ImageReferenceId <String>]
[-DiskControllerType <String>]
[-SharedGalleryImageId <String>]
[-SecurityType <String>]
[-EnableVtpm <Boolean>]
[-EnableSecureBoot <Boolean>]
[-SkuProfileVmSize <String[]>]
[-SkuProfileAllocationStrategy <String>]
[-DefaultProfile <IAzureContextContainer>]
[-SinglePlacementGroup]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande New-AzVmss crée un groupe de machines virtuelles identiques (VMSS) dans Azure.
Utilisez l’ensemble de paramètres simple (SimpleParameterSet
) pour créer rapidement un vmSS et des ressources associées.
Utilisez l’ensemble de paramètres par défaut (DefaultParameter
) pour des scénarios plus avancés lorsque vous devez configurer précisément chaque composant de VMSS et chaque ressource associée avant la création.
Pour le jeu de paramètres par défaut, utilisez d’abord l’applet de commande New-AzVmssConfig pour créer un objet de groupe de machines virtuelles identiques.
Utilisez ensuite les applets de commande suivantes pour définir différentes propriétés de l’objet groupe de machines virtuelles identiques :
- Add-AzVmssNetworkInterfaceConfiguration pour définir le profil réseau.
- Set-AzVmssOsProfile pour définir le profil du système d’exploitation.
- Set-AzVmssStorageProfile pour définir le profil de stockage.
- Get-AzComputeResourceSku peut également être utilisé pour déterminer les tailles de machine virtuelle disponibles pour votre abonnement et votre région.
Consultez les autres applets de commande pour le groupe de machines virtuelles identiques ici.
La création de VMSS est par défaut orchestrationMode :Flexible. Le jeu de paramètres par défaut définit les propriétés dans VirtualMachineScaleSetVMProfile par défaut. Pour créer un VMSS avec une propriété VirtualMachineScaleSetVMProfile vide, utilisez un jeu de paramètres simple en créant d’abord un objet VirtualMachineScaleSet avec une propriété VirtualMachineScaleSetVMProfile vide à l’aide de New-AzVmssConfig.
Consultez [Démarrage rapide : Créer un groupe de machines virtuelles identiques avec Azure PowerShell](https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/quick-create-powershell) pour obtenir un didacticiel.
Exemples
Exemple 1 : Créer un vmSS à l’aide de SimpleParameterSet
$vmssName = 'VMSSNAME'
# Create credentials, I am using one way to create credentials, there are others as well.
# Pick one that makes the most sense according to your use case.
$vmPassword = ConvertTo-SecureString -String "****" -AsPlainText -Force
$vmCred = New-Object System.Management.Automation.PSCredential('USERNAME', $vmPassword)
$securityTypeStnd = "Standard"
#Create a VMSS using the default settings
New-AzVmss -Credential $vmCred -VMScaleSetName $vmssName -SecurityType $securityTypeStnd
La commande ci-dessus crée ce qui suit avec le nom $vmssName
:
- Un groupe de ressources
- Un réseau virtuel
- Un équilibrage de charge
- Une adresse IP publique
- VMSS avec 2 instances
L’image par défaut choisie pour les machines virtuelles dans vmSS est 2016-Datacenter Windows Server
et la référence SKU est Standard_DS1_v2
Exemple 2 : Créer un vmSS à l’aide de DefaultParameterSet
# Common
$LOC = "WestUs";
$RGName = "rgkyvms";
New-AzResourceGroup -Name $RGName -Location $LOC -Force;
# SRP
$STOName = "sto" + $RGName;
$STOType = "Standard_GRS";
New-AzStorageAccount -ResourceGroupName $RGName -Name $STOName -Location $LOC -Type $STOType;
$STOAccount = Get-AzStorageAccount -ResourceGroupName $RGName -Name $STOName;
# NRP
$SubNet = New-AzVirtualNetworkSubnetConfig -Name ("subnet" + $RGName) -AddressPrefix "10.0.0.0/24";
$VNet = New-AzVirtualNetwork -Force -Name ("vnet" + $RGName) -ResourceGroupName $RGName -Location $LOC -AddressPrefix "10.0.0.0/16" -DnsServer "10.1.1.1" -Subnet $SubNet;
$VNet = Get-AzVirtualNetwork -Name ('vnet' + $RGName) -ResourceGroupName $RGName;
$SubNetId = $VNet.Subnets[0].Id;
$PubIP = New-AzPublicIpAddress -Force -Name ("pubip" + $RGName) -ResourceGroupName $RGName -Location $LOC -AllocationMethod Dynamic -DomainNameLabel ("pubip" + $RGName);
$PubIP = Get-AzPublicIpAddress -Name ("pubip" + $RGName) -ResourceGroupName $RGName;
# Create LoadBalancer
$FrontendName = "fe" + $RGName
$BackendAddressPoolName = "bepool" + $RGName
$ProbeName = "vmssprobe" + $RGName
$InboundNatPoolName = "innatpool" + $RGName
$LBRuleName = "lbrule" + $RGName
$LBName = "vmsslb" + $RGName
$Frontend = New-AzLoadBalancerFrontendIpConfig -Name $FrontendName -PublicIpAddress $PubIP
$BackendAddressPool = New-AzLoadBalancerBackendAddressPoolConfig -Name $BackendAddressPoolName
$Probe = New-AzLoadBalancerProbeConfig -Name $ProbeName -RequestPath healthcheck.aspx -Protocol http -Port 80 -IntervalInSeconds 15 -ProbeCount 2
$InboundNatPool = New-AzLoadBalancerInboundNatPoolConfig -Name $InboundNatPoolName -FrontendIPConfigurationId `
$Frontend.Id -Protocol Tcp -FrontendPortRangeStart 3360 -FrontendPortRangeEnd 3367 -BackendPort 3370;
$LBRule = New-AzLoadBalancerRuleConfig -Name $LBRuleName `
-FrontendIPConfiguration $Frontend -BackendAddressPool $BackendAddressPool `
-Probe $Probe -Protocol Tcp -FrontendPort 80 -BackendPort 80 `
-IdleTimeoutInMinutes 15 -EnableFloatingIP -LoadDistribution SourceIP;
$ActualLb = New-AzLoadBalancer -Name $LBName -ResourceGroupName $RGName -Location $LOC `
-FrontendIpConfiguration $Frontend -BackendAddressPool $BackendAddressPool `
-Probe $Probe -LoadBalancingRule $LBRule -InboundNatPool $InboundNatPool;
$ExpectedLb = Get-AzLoadBalancer -Name $LBName -ResourceGroupName $RGName
# New VMSS Parameters
$VMSSName = "vmss" + $RGName;
$AdminUsername = "Admin01";
$AdminPassword = "p4ssw0rd@123" + $RGName;
$PublisherName = "MicrosoftWindowsServer"
$Offer = "WindowsServer"
$Sku = "2012-R2-Datacenter"
$Version = "latest"
$VHDContainer = "https://" + $STOName + ".blob.core.windows.net/" + $VMSSName;
$ExtName = "CSETest";
$Publisher = "Microsoft.Compute";
$ExtType = "BGInfo";
$ExtVer = "2.1";
#IP Config for the NIC
$IPCfg = New-AzVmssIpConfig -Name "Test" `
-LoadBalancerInboundNatPoolsId $ExpectedLb.InboundNatPools[0].Id `
-LoadBalancerBackendAddressPoolsId $ExpectedLb.BackendAddressPools[0].Id `
-SubnetId $SubNetId;
#VMSS Config
$securityTypeStnd = "Standard";
$VMSS = New-AzVmssConfig -Location $LOC -SkuCapacity 2 -SkuName "Standard_E4-2ds_v4" -UpgradePolicyMode "Automatic" -SecurityType $securityTypeStnd `
| Add-AzVmssNetworkInterfaceConfiguration -Name "Test" -Primary $True -IPConfiguration $IPCfg `
| Add-AzVmssNetworkInterfaceConfiguration -Name "Test2" -IPConfiguration $IPCfg `
| Set-AzVmssOsProfile -ComputerNamePrefix "Test" -AdminUsername $AdminUsername -AdminPassword $AdminPassword `
| Set-AzVmssStorageProfile -Name "Test" -OsDiskCreateOption 'FromImage' -OsDiskCaching "None" `
-ImageReferenceOffer $Offer -ImageReferenceSku $Sku -ImageReferenceVersion $Version `
-ImageReferencePublisher $PublisherName -VhdContainer $VHDContainer `
| Add-AzVmssExtension -Name $ExtName -Publisher $Publisher -Type $ExtType -TypeHandlerVersion $ExtVer -AutoUpgradeMinorVersion $True
#Create the VMSS
New-AzVmss -ResourceGroupName $RGName -Name $VMSSName -VirtualMachineScaleSet $VMSS;
L’exemple complexe ci-dessus crée un VMSS, voici une explication de ce qui se passe :
- La première commande crée un groupe de ressources avec le nom et l’emplacement spécifiés.
- La deuxième commande utilise l’applet de commande New-AzStorageAccount pour créer un compte de stockage.
- La troisième commande utilise ensuite l’applet de commande Get-AzStorageAccount pour obtenir le compte de stockage créé dans la deuxième commande et stocke le résultat dans la variable $STOAccount.
- La cinquième commande utilise l’applet de commande New-AzVirtualNetworkSubnetConfig pour créer un sous-réseau et stocke le résultat dans la variable nommée $SubNet.
- La sixième commande utilise l’applet de commande New-AzVirtualNetwork pour créer un réseau virtuel et stocke le résultat dans la variable nommée $VNet.
- La septième commande utilise Get-AzVirtualNetwork pour obtenir des informations sur le réseau virtuel créé dans la sixième commande et stocke les informations dans la variable nommée $VNet.
- La huitième et neuvième commande utilise New-AzPublicIpAddress et Get- AzureRmPublicIpAddress pour créer et obtenir des informations à partir de cette adresse IP publique.
- Les commandes stockent les informations dans la variable nommée $PubIP.
- La dixième commande utilise l’applet de commande New-AzureRmLoadBalancerFrontendIpConfig pour créer un équilibreur de charge front-end et stocke le résultat dans la variable nommée $Frontend.
- La onzee commande utilise new-AzLoadBalancerBackendAddressPoolConfig pour créer une configuration de pool d’adresses back-end et stocke le résultat dans la variable nommée $BackendAddressPool.
- La douzième commande utilise new-AzLoadBalancerProbeConfig pour créer une sonde et stocker les informations de sonde dans la variable nommée $Probe.
- La treizeème commande utilise l’applet de commande New-AzLoadBalancerInboundNatPoolConfig pour créer une configuration de pool d’adresses réseau entrantes de l’équilibreur de charge.
- La quatorzee commande utilise New-AzLoadBalancerRuleConfig pour créer une configuration de règle d’équilibreur de charge et stocke le résultat dans la variable nommée $LBRule.
- La quinzeième commande utilise l’applet de commande New-AzLoadBalancer pour créer un équilibreur de charge et stocke le résultat dans la variable nommée $ActualLb.
- La sixième commande utilise Get-AzLoadBalancer pour obtenir des informations sur l’équilibreur de charge créé dans la quinzeième commande et stocke les informations dans la variable nommée $ExpectedLb.
- La dix-septième commande utilise l’applet de commande New-AzVmssIpConfig pour créer une configuration IP VMSS et stocke les informations dans la variable nommée $IPCfg.
- La dix-huitième commande utilise l’applet de commande New-AzVmssConfig pour créer un objet de configuration VMSS et stocke le résultat dans la variable nommée $VMSS.
- La dix-neuvième commande utilise l’applet de commande New-AzVmss pour créer le service VMSS.
Exemple 3 : Créer un vmSS avec une valeur UserData
$ResourceGroupName = 'RESOURCE GROUP NAME';
$vmssName = 'VMSSNAME';
$domainNameLabel = "dnl" + $ResourceGroupName;
# Create credentials, I am using one way to create credentials, there are others as well.
# Pick one that makes the most sense according to your use case.
$vmPassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$vmCred = New-Object System.Management.Automation.PSCredential('USERNAME', $vmPassword);
$text = "UserData value to encode";
$bytes = [System.Text.Encoding]::Unicode.GetBytes($text);
$userData = [Convert]::ToBase64String($bytes);
$securityTypeStnd = "Standard";
#Create a VMSS
New-AzVmss -ResourceGroupName $ResourceGroupName -Name $vmssName -Credential $vmCred -DomainNameLabel $domainNameLabel -Userdata $userData -SecurityType $securityTypeStnd;
$vmss = Get-AzVmss -ResourceGroupName $ResourceGroupName -VMScaleSetName $vmssName -InstanceView:$false -Userdata;
Créer un VMSS avec une valeur UserData
Exemple 4 : Créer une machine virtuelle avec le type de sécurité TrustedLaunch
$rgname = "rgname";
$loc = "eastus";
# VMSS Profile & Hardware requirements for the TrustedLaunch default behavior.
$vmssSize = 'Standard_D4s_v3';
$vmssName1 = 'vmss1' + $rgname;
$imageName = "Win2022AzureEdition";
$adminUsername = "<Username>";
$adminPassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$vmCred = New-Object System.Management.Automation.PSCredential ($adminUsername, $adminPassword);
# VMSS Creation
$result = New-AzVmss -Credential $vmCred -VMScaleSetName $vmssName1 -ImageName $imageName -SecurityType "TrustedLaunch";
# Validate that for -SecurityType "TrustedLaunch", "-Vtpm" and -"SecureBoot" are "Enabled/true"
# $result.VirtualMachineProfile.SecurityProfile.UefiSettings.VTpmEnabled;
# $result.VirtualMachineProfile.SecurityProfile.UefiSettings.SecureBootEnabled;
Cet exemple crée une machine virtuelle VMSS avec le nouveau type de sécurité « TrustedLaunch » et les valeurs UEFISettings nécessaires, VTpmEnabled et SecureBootEnalbed sont vraies. Pour plus d’informations, consultez la page de fonctionnalité Lancement approuvé.
Exemple 5 : Créer une machine virtuelle en mode orchestration : flexible par défaut
# Create configration object
$vmssConfig = New-AzVmssConfig -Location EastUs2 -UpgradePolicyMode Manual -SinglePlacementGroup $true
# VMSS Creation
New-AzVmss -ResourceGroupName TestRg -VMScaleSetName myVMSS -VirtualMachineScaleSet $vmssConfig
Cet exemple montre comment créer une machine virtuelle VMSS et la valeur par défaut est OrchestrationMode Flexible.
Exemple 6 : Créez une machine virtuelle VMSS avec TrustedLaunch activée par défaut.
$rgname = "<Resource Group>";
$loc = "<Azure Region>";
New-AzResourceGroup -Name $rgname -Location $loc -Force;
$vmssName = 'vmss' + $rgname;
$vmssSize = 'Standard_D4s_v3';
$imageName = "Win2022AzureEdition";
$publisherName = "MicrosoftWindowsServer";
$offer = "WindowsServer";
$sku = "2022-Datacenter-Azure-Edition";
$adminUsername = "<Username>";
$password = "<Password>";
# NRP
$vnetworkName = 'vnet' + $rgname;
$subnetName = 'subnet' + $rgname;
$subnet = New-AzVirtualNetworkSubnetConfig -Name $subnetName -AddressPrefix "10.0.0.0/24";
$vnet = New-AzVirtualNetwork -Name $vnetworkName -ResourceGroupName $rgname -Location $loc -AddressPrefix "10.0.0.0/16" -Subnet $subnet;
$vnet = Get-AzVirtualNetwork -Name $vnetworkName -ResourceGroupName $rgname;
$subnetId = $vnet.Subnets[0].Id;
$ipCfg = New-AzVmssIpConfig -Name 'test' -SubnetId $subnetId;
$vmss = New-AzVmssConfig -Location $loc -SkuCapacity 2 -SkuName $vmssSize -UpgradePolicyMode 'Manual' `
| Add-AzVmssNetworkInterfaceConfiguration -Name 'test' -Primary $true -IPConfiguration $ipCfg `
| Set-AzVmssOsProfile -ComputerNamePrefix 'test' -AdminUsername $adminUsername -AdminPassword $password;
# Create TL Vmss
$result = New-AzVmss -ResourceGroupName $rgname -VMScaleSetName $vmssName -VirtualMachineScaleSet $vmss;
$vmssGet = Get-AzVmss -ResourceGroupName $rgname -VMScaleSetName $vmssName;
# Verify $vmssGet.VirtualMachineProfile.SecurityProfile.SecurityType is TrustedLaunch.
# Verify $vmssGet.VirtualMachineProfile.SecurityProfile.UefiSettings.VTpmEnabled is True.
# Verify $vmssGet.VirtualMachineProfile.SecurityProfile.UefiSettings.SecureBootEnabled is True.
# Verify $vmssGet.VirtualMachineProfile.StorageProfile.ImageReference.Sku is 2022-Datacenter-Azure-Edition.
Le groupe de machines virtuelles identiques ci-dessus a activé le lancement approuvé par défaut. Pour plus d’informations, consultez la page de fonctionnalité Lancement approuvé.
Paramètres
-AllocationMethod
Méthode d’allocation pour l’adresse IP publique du groupe identique (statique ou dynamique). Si aucune valeur n’est fournie, l’allocation est statique.
Type: | String |
Valeurs acceptées: | Static, Dynamic |
Position: | Named |
Valeur par défaut: | Static |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-AsJob
Exécutez l’applet de commande en arrière-plan et retournez un travail pour suivre la progression.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-BackendPoolName
Nom du pool d’adresses back-end à utiliser dans l’équilibreur de charge pour ce groupe identique. Si aucune valeur n’est fournie, un nouveau pool principal est créé, avec le même nom que le groupe identique.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-BackendPort
Numéros de port principaux utilisés par l’équilibreur de charge du groupe identique pour communiquer avec les machines virtuelles dans le groupe identique. Si aucune valeur n’est spécifiée, les ports 3389 et 5985 sont utilisés pour les machines virtuelles Windows, et le port 22 est utilisé pour les machines virtuelles Linux.
Type: | Int32[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CapacityReservationGroupId
ID du groupe de réservations de capacité utilisé pour allouer.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Alias: | cf |
Position: | Named |
Valeur par défaut: | False |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Credential
Informations d’identification de l’administrateur (nom d’utilisateur et mot de passe) pour les machines virtuelles de ce groupe identique.
Nom d’utilisateur
Restriction:
Windows : Impossible de contenir des caractères spéciaux /"[] :|<>+= ;, ?*@> ou se terminez par « ».
Linux : le nom d’utilisateur ne doit contenir que des lettres, des chiffres, des traits d’union et des traits de soulignement et ne peut pas commencer par un trait d’union ou un nombre.
Valeurs non autorisées : « administrateur », « admin », « user », « user1 », « test », « user2 », « test1 », « test1 », « user3 », « admin1 », « 1 », « 123 », « a », « actuser », « adm », « admin2 », « aspnet », « backup », « console », « david », « guest », « john », « owner », « root », « server », « sql », « support », « support_388945a0 », « sys », « test2 », « test3 », « user4 », « user5 ».
Longueur minimale : 1 caractère
Longueur maximale : 20 caractères pour Windows, 64 caractères pour Linux
Mot de passe
Doit avoir 3 des éléments suivants : 1 caractère minuscule, 1 caractère majuscule, 1 nombre et 1 caractère spécial.
La valeur doit être comprise entre 12 et 123 caractères.
Type: | PSCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DataDiskSizeInGb
Spécifie les tailles des disques de données en Go.
Type: | Int32[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DiskControllerType
Spécifie le type de contrôleur de disque configuré pour la machine virtuelle et VirtualMachineScaleSet. Cette propriété est uniquement prise en charge pour les machines virtuelles dont le disque du système d’exploitation et la référence SKU de machine virtuelle prennent en charge la génération 2 (https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2), vérifiez la fonctionnalité HyperVGenerations retournée dans le cadre des fonctionnalités de référence SKU de machine virtuelle dans la réponse de l’API SKU Microsoft.Compute pour la région contient V2 (https://learn.microsoft.com/rest/api/compute/resourceskus/list).
Pour plus d’informations sur les types de contrôleurs de disque pris en charge, consultez https://aka.ms/azure-diskcontrollertypes.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DomainNameLabel
Étiquette de nom de domaine pour le nom de domaine complet public (FQDN) pour ce groupe identique. Il s’agit du premier composant du nom de domaine qui est automatiquement affecté au groupe identique. Les noms de domaine attribués automatiquement utilisent le formulaire (<DomainNameLabel>.<Location>.cloudapp.azure.com
). Si aucune valeur n’est fournie, l’étiquette de nom de domaine par défaut est la concaténation et <ScaleSetName>
<ResourceGroupName>
.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-EdgeZone
Définit le nom de la zone de périphérie. Si elle est définie, la requête est routée vers la zone de périphérie spécifiée au lieu de la région principale.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-EnableAutomaticOSUpgrade
Indique si les mises à niveau du système d’exploitation doivent être appliquées automatiquement aux instances de groupe identique de manière propagée lorsqu’une version plus récente de l’image devient disponible.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-EnableSecureBoot
Spécifie si le démarrage sécurisé doit être activé sur la machine virtuelle.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-EnableUltraSSD
Utilisez des disques UltraSSD pour les machines virtuelles du groupe identique.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-EnableVtpm
Spécifie si vTPM doit être activé sur la machine virtuelle.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-EncryptionAtHost
Ce paramètre active le chiffrement de tous les disques, y compris le disque Resource/Temp sur l’hôte lui-même. Valeur par défaut : le chiffrement sur l’hôte est désactivé, sauf si cette propriété a la valeur true pour la ressource.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-EvictionPolicy
Stratégie d’éviction pour le groupe de machines virtuelles identiques de faible priorité. Seules les valeurs prises en charge sont « Libérer » et « Supprimer ».
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-FrontendPoolName
Nom du pool d’adresses front-end à utiliser dans l’équilibreur de charge du groupe identique. Si aucune valeur n’est fournie, un nouveau pool d’adresses front-end est créé, avec le même nom que le groupe identique.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-HostGroupId
Spécifie le groupe hôte dédié dans lequel réside le groupe de machines virtuelles identiques.
Type: | String |
Alias: | HostGroup |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-IfMatch
permet d’effectuer une demande conditionnelle pour les méthodes PUT et autres méthodes non sécurisées. Le serveur retourne uniquement les ressources demandées si la ressource correspond à l’une des valeurs ETag répertoriées. Omettez cette valeur pour toujours remplacer la ressource actuelle. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-IfNoneMatch
Utilisé pour effectuer une requête conditionnelle pour les méthodes GET et HEAD. Le serveur retourne uniquement les ressources demandées si aucune des valeurs ETag répertoriées ne correspond à l’entité actuelle. Utilisé pour effectuer une requête conditionnelle pour les méthodes GET et HEAD. Le serveur retourne uniquement les ressources demandées si aucune des valeurs ETag répertoriées ne correspond à l’entité actuelle. Définissez la valeur « * » pour autoriser la création d’un nouveau jeu d’enregistrements, mais pour empêcher la mise à jour d’un jeu d’enregistrements existant. D’autres valeurs entraînent une erreur du serveur, car elles ne sont pas prises en charge.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ImageName
Alias de l’image pour les machines virtuelles de ce groupe identique. Si aucune valeur n’est fournie, l’image « Windows Server 2016 DataCenter » est utilisée. Les alias disponibles sont : Win2022AzureEdition, Win2022AzureEditionCore, Win2019Datacenter, Win2016Datacenter, Win2012R2Datacenter, Win2012Datacenter, UbuntuLTS, Ubuntu2204, CentOS85Gen2, Debian11, OpenSuseLeap154Gen2, RHELRaw8LVMGen2, SuseSles15SP3, FlatcarLinuxFreeGen2.
Type: | String |
Alias: | Image |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ImageReferenceId
Spécifie l’ID unique de l’image de galerie partagée pour le déploiement de machines virtuelles. Cette opération peut être extraite de l’appel GET de l’image de galerie partagée.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-InstanceCount
Nombre d’images de machine virtuelle dans le groupe identique. Si aucune valeur n’est fournie, 2 instances sont créées.
Type: | Int32 |
Position: | Named |
Valeur par défaut: | 2 |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-LoadBalancerName
Nom de l’équilibreur de charge à utiliser avec ce groupe identique. Un nouvel équilibreur de charge portant le même nom que le groupe identique est créé si aucune valeur n’est spécifiée.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Location
Emplacement Azure où ce groupe identique sera créé. Si aucune valeur n’est spécifiée, l’emplacement est déduit à partir de l’emplacement d’autres ressources référencées dans les paramètres.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-MaxPrice
Prix maximal de la facturation d’un groupe de machines virtuelles identiques de faible priorité.
Type: | Double |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-NatBackendPort
Port principal pour la traduction d’adresses réseau entrantes.
Type: | Int32[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-OrchestrationMode
Spécifie le mode d’orchestration du groupe de machines virtuelles identiques. Valeurs possibles : Uniform, Flexible
La création d’un VMSS dans OrchestrationMode :Flexible à l’aide du jeu de paramètres par défaut entraîne la remplissage par défaut de VirtualMachineScaleSetVMProfile. Si vous souhaitez créer un VMSS avec un virtualMachineScaleSetVMProfile vide, commencez par créer un objet VirtualMachineScaleSet avec une propriété VMProfile vide à l’aide de New-AzVmssConfig, puis créez vmSS à l’aide d’un jeu de paramètres simple.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-PlatformFaultDomainCount
Nombre de domaines d’erreur pour chaque groupe de placement.
Type: | Int32 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Priority
Priorité de la machine virtuelle dans le groupe identique. Seules les valeurs prises en charge sont « Regular », « Spot » et « Low ». « Normal » est destiné à une machine virtuelle normale. « Spot » est destiné à une machine virtuelle spot. 'Low' est également destiné à la machine virtuelle spot, mais est remplacé par 'Spot'. Utilisez « Spot » au lieu de « Low ».
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ProximityPlacementGroupId
ID de ressource du groupe de placement de proximité à utiliser avec ce groupe identique.
Type: | String |
Alias: | ProximityPlacementGroup |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-PublicIpAddressName
Nom de l’adresse IP publique à utiliser avec ce groupe identique. Une nouvelle adresse IP publique portant le même nom que le groupe identique est créée si aucune valeur n’est fournie.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ResourceGroupName
Spécifie le nom du groupe de ressources de VMSS. Si aucune valeur n’est spécifiée, un nouveau Groupe de ressources est créé à l’aide du même nom que le groupe identique.
Type: | String |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ScaleInPolicy
Règles à suivre lors de la mise à l’échelle d’un groupe de machines virtuelles identiques. Les valeurs possibles sont : « Default », « OldestVM » et « NewestVM ». « Par défaut » lorsqu’un groupe de machines virtuelles identiques est mis à l’échelle, le groupe identique est d’abord équilibré entre les zones s’il s’agit d’un groupe identique zonal. Ensuite, il sera équilibré entre les domaines d’erreur autant que possible. Dans chaque domaine d’erreur, les machines virtuelles choisies pour la suppression seront les plus récentes qui ne sont pas protégées contre le scale-in. « OldestVM » lorsqu’un groupe de machines virtuelles identiques est mis à l’échelle, les machines virtuelles les plus anciennes qui ne sont pas protégées contre la mise à l’échelle seront choisies pour suppression. Pour les groupes de machines virtuelles identiques zonaux, le groupe identique est d’abord équilibré entre les zones. Dans chaque zone, les machines virtuelles les plus anciennes qui ne sont pas protégées seront choisies pour suppression. « NewestVM » lorsqu’un groupe de machines virtuelles identiques est mis à l’échelle, les machines virtuelles les plus récentes qui ne sont pas protégées contre la mise à l’échelle seront choisies pour suppression. Pour les groupes de machines virtuelles identiques zonaux, le groupe identique est d’abord équilibré entre les zones. Dans chaque zone, les machines virtuelles les plus récentes qui ne sont pas protégées seront choisies pour suppression.
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-SecurityGroupName
Nom du groupe de sécurité réseau à appliquer à ce groupe identique. Si aucune valeur n’est fournie, un groupe de sécurité réseau par défaut portant le même nom que le groupe identique est créé et appliqué au groupe identique.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-SecurityType
Spécifie le SecurityType de la machine virtuelle. Il doit être défini sur n’importe quelle valeur spécifiée pour activer UefiSettings. UefiSettings ne sera pas activé, sauf si cette propriété est définie.
Type: | String |
Valeurs acceptées: | TrustedLaunch, ConfidentialVM, Standard |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-SharedGalleryImageId
Spécifie l’ID unique de l’image de galerie partagée pour le déploiement de machines virtuelles. Cette opération peut être extraite de l’appel GET de l’image de galerie partagée.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-SinglePlacementGroup
Utilisez cette option pour créer le groupe identique dans un groupe de placement unique, la valeur par défaut est de plusieurs groupes.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-SkipExtensionsOnOverprovisionedVMs
Spécifie que les extensions ne s’exécutent pas sur les machines virtuelles surprovisionnés supplémentaires.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-SkuProfileAllocationStrategy
Stratégie d’allocation pour le profil de référence SKU.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-SkuProfileVmSize
Tableau de tailles de machine virtuelle pour le groupe identique.
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-SubnetAddressPrefix
Préfixe d’adresse du sous-réseau que ce ScaleSet utilisera. Les paramètres de sous-réseau par défaut (192.168.1.0/24) sont appliqués si aucune valeur n’est fournie.
Type: | String |
Position: | Named |
Valeur par défaut: | 192.168.1.0/24 |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-SubnetName
Nom du sous-réseau à utiliser avec ce groupe identique. Un nouveau sous-réseau est créé avec le même nom que le groupe identique si aucune valeur n’est fournie.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-SystemAssignedIdentity
Si le paramètre est présent, la ou les machines virtuelles du groupe identique sont affectées à une identité système managée générée automatiquement.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-UpgradePolicyMode
Mode de stratégie de mise à niveau pour les instances de machine virtuelle dans ce groupe identique. La stratégie de mise à niveau peut spécifier des mises à niveau automatiques, manuelles ou propagées.
Type: | UpgradeMode |
Valeurs acceptées: | Automatic, Manual, Rolling |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-UserAssignedIdentity
Nom d’une identité de service managée qui doit être affectée aux machines virtuelles dans le groupe identique.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-UserData
UserData pour les machines virtuelles, qui seront encodées en base 64. Le client ne doit pas transmettre de secrets ici.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-VirtualMachineScaleSet
Spécifie l’objet VirtualMachineScaleSet qui contient les propriétés de VMSS que cette applet de commande crée.
Type: | PSVirtualMachineScaleSet |
Position: | 2 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-VirtualNetworkName
Nom du Réseau virtuel à utiliser avec ce groupe identique. Si aucune valeur n’est fournie, un nouveau réseau virtuel portant le même nom que le groupe identique est créé.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-VMScaleSetName
Spécifie le nom du service VMSS créé par cette applet de commande.
Type: | String |
Alias: | Name |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-VmSize
Taille des instances de machine virtuelle dans ce groupe identique. Get-AzComputeResourceSku peut être utilisé pour connaître les tailles disponibles pour votre abonnement et votre région. Une taille par défaut (Standard_DS1_v2) est utilisée si aucune taille n’est spécifiée.
Type: | String |
Position: | Named |
Valeur par défaut: | Standard_DS1_v2 |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-VnetAddressPrefix
Préfixe d’adresse du réseau virtuel utilisé avec ce groupe identique. Les paramètres de préfixe d’adresse de réseau virtuel par défaut (192.168.0.0/16) sont utilisés si aucune valeur n’est fournie.
Type: | String |
Position: | Named |
Valeur par défaut: | 192.168.0.0/16 |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Alias: | wi |
Position: | Named |
Valeur par défaut: | False |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Zone
Liste des zones de disponibilité indiquant l’adresse IP allouée pour la ressource doit provenir.
Type: | List<T>[String] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
Entrées
List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]