New-AzureRmVmssConfig
Crea un objeto de configuración de VMSS.
Advertencia
El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.
Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.
Syntax
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
El cmdlet New-AzureRmVmssConfig crea un objeto de conjunto de escalado de Virtual Manager (VMSS) local configurable. Se necesitan otros cmdlets para configurar el objeto VMSS. Estos cmdlets son:
- Set-AzureRmVmssOsProfile
- Set-AzureRmVmssStorageProfile
- Add-AzureRmVmssNetworkInterfaceConfiguration
- Add-AzureRmVmssExtension
Ejemplos
Ejemplo 1: Creación de un objeto de configuración de 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;En este ejemplo se crea un objeto de configuración VMSS. El primer comando usa el cmdlet New-AzureRmVmssConfig para crear un objeto de configuración de VMSS y almacena el resultado en la variable denominada $VMSS. El segundo comando usa el cmdlet New-AzureRmVmss para crear un VMSS que use el objeto de configuración VMSS creado en el primer comando.
Parámetros
-AssignIdentity
Especifique la identidad asignada por el sistema para el conjunto de escalado de máquinas virtuales.
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AutoOSUpgrade
Establece si las actualizaciones del sistema operativo se deben aplicar automáticamente a las instancias del conjunto de escalado de forma gradual cuando esté disponible una versión más reciente de la imagen.
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BootDiagnostic
Especifica el perfil de diagnóstico de arranque del conjunto de escalado de máquinas virtuales.
| Tipo: | BootDiagnostics |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableAutoRollback
Deshabilitar la reversión automática para la directiva de actualización automática del sistema operativo
| Tipo: | Boolean |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableUltraSSD
Permite que una funcionalidad tenga uno o varios discos de datos administrados con UltraSSD_LRS tipo de cuenta de almacenamiento en el conjunto de escalado de máquinas virtuales. Los discos administrados con el tipo de cuenta de almacenamiento UltraSSD_LRS solo se pueden agregar a un VMSS si esta propiedad está habilitada.
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EvictionPolicy
Especifica la directiva de expulsión de las máquinas virtuales del conjunto de escalado.
| Tipo: | String |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Extension
Especifica el objeto de información de extensión para VMSS. Puede usar el cmdlet Add-AzureRmVmssExtension para agregar este objeto.
| Tipo: | VirtualMachineScaleSetExtension[] |
| Position: | 10 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HealthProbeId
Especifica el identificador de un sondeo de equilibrador de carga usado para determinar el estado de una instancia en el conjunto de escalado de máquinas virtuales. HealthProbeId está en forma de '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'.
| Tipo: | String |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IdentityId
Especifica la lista de identidades de usuario asociadas al conjunto de escalado de máquinas virtuales. Las referencias de identidad de usuario serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'
| Tipo: | String[] |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IdentityType
Especifica el tipo de identidad que se usa para el conjunto de escalado de máquinas virtuales. El tipo "SystemAssignedUserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará las identidades del conjunto de escalado de máquinas virtuales. Los valores permitidos para este parámetro son los siguientes:
- Asignada por el sistema
- UserAssigned
- SystemAssignedUserAssigned
- None
| Tipo: | Nullable<T>[ResourceIdentityType] |
| valores aceptados: | SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LicenseType
Especifique el tipo de licencia, que es para traer su propio escenario de licencia.
| Tipo: | String |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Location
Especifica la ubicación de Azure donde se crea el VMSS.
| Tipo: | String |
| Position: | 1 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NetworkInterfaceConfiguration
Especifica el objeto de perfil de red que contiene las propiedades de red para la configuración de VMSS. Puede usar el cmdlet Add-AzureRmVmssNetworkInterfaceConfiguration para agregar este objeto.
| Tipo: | VirtualMachineScaleSetNetworkConfiguration[] |
| Position: | 9 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OsProfile
Especifica el objeto de perfil de sistema operativo que contiene las propiedades del sistema operativo para la configuración de VMSS. Puede usar el cmdlet Set-AzureRmVmssOsProfile para establecer este objeto.
| Tipo: | VirtualMachineScaleSetOSProfile |
| Position: | 7 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Overprovision
Indica si el cmdlet sobreaprovisiona vmSS.
| Tipo: | Nullable<T>[Boolean] |
| Position: | 0 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PlanName
Especifica el nombre del plan.
| Tipo: | String |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PlanProduct
Especifica el producto del plan.
| Tipo: | String |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PlanPromotionCode
Especifica el código de promoción del plan.
| Tipo: | String |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PlanPublisher
Especifica el publicador del plan.
| Tipo: | String |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PlatformFaultDomainCount
Recuento de dominios de error para cada grupo de selección de ubicación.
| Tipo: | Int32 |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Priority
Especifica la prioridad de las máquinas virtuales del conjunto de escalado.
| Tipo: | String |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RollingUpgradePolicy
Especifica la directiva de actualización gradual.
| Tipo: | RollingUpgradePolicy |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SinglePlacementGroup
Especifica el grupo de selección de ubicación único.
| Tipo: | Nullable<T>[Boolean] |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkuCapacity
Especifica el número de instancias de VMSS.
| Tipo: | Int32 |
| Position: | 5 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkuName
Especifica el tamaño de todas las instancias de VMSS.
| Tipo: | String |
| Aliases: | AccountType |
| Position: | 3 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkuTier
Especifica el nivel de VMSS. Los valores permitidos para este parámetro son los siguientes:
- Estándar
- Básica
| Tipo: | String |
| Position: | 4 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageProfile
Especifica el objeto de perfil de almacenamiento que contiene las propiedades de disco para la configuración de VMSS. Puede usar el cmdlet Set-AzureRmVmssStorageProfile para establecer este objeto.
| Tipo: | VirtualMachineScaleSetStorageProfile |
| Position: | 8 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Tag
Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}
| Tipo: | Hashtable |
| Position: | 2 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UpgradePolicyMode
Se especificó el modo de una actualización a las máquinas virtuales del conjunto de escalado. Los valores permitidos para este parámetro son los siguientes:
- Automático
- Manual
| Tipo: | Nullable<T>[UpgradeMode] |
| valores aceptados: | Automatic, Manual, Rolling |
| Position: | 6 |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Zone
Especifica la lista de zonas del conjunto de escalado de máquinas virtuales.
| Tipo: | String[] |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ZoneBalance
Si se fuerza estrictamente incluso la distribución de máquinas virtuales entre zonas x en caso de que se produzca una interrupción de zona.
| Tipo: | SwitchParameter |
| Position: | Named |
| valor predeterminado: | None |
| Requerido: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
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[]
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.ResourceIdentityType, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]