Partager via


Update-AzVmssVM

Met à jour l’état d’une machine virtuelle Vmss.

Syntaxe

DefaultParameter (Par défaut)

Update-AzVmssVM
    [-ResourceGroupName] <String>
    [-VMScaleSetName] <String>
    [-InstanceId] <String>
    [-ProxyAgentKeyIncarnationId <Int32>]
    [-DataDisk <PSVirtualMachineDataDisk[]>]
    [-ProtectFromScaleIn <Boolean>]
    [-ProtectFromScaleSetAction <Boolean>]
    [-AsJob]
    [-UserData <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdParameter

Update-AzVmssVM
    [-ResourceId] <String>
    [-ProxyAgentKeyIncarnationId <Int32>]
    [-DataDisk <PSVirtualMachineDataDisk[]>]
    [-ProtectFromScaleIn <Boolean>]
    [-ProtectFromScaleSetAction <Boolean>]
    [-AsJob]
    [-UserData <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectParameter

Update-AzVmssVM
    [-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
    [-ProxyAgentKeyIncarnationId <Int32>]
    [-DataDisk <PSVirtualMachineDataDisk[]>]
    [-ProtectFromScaleIn <Boolean>]
    [-ProtectFromScaleSetAction <Boolean>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Met à jour l’état d’une machine virtuelle Vmss. Pour l’instant, la seule mise à jour autorisée ajoute un disque de données managé.

Exemples

Exemple 1 : Ajouter un disque de données managé à une machine virtuelle Vmss à l’aide de New-AzVMDataDisk

$disk = Get-AzDisk -ResourceGroupName $rgname -DiskName $diskname0
$datadisk = New-AzVMDataDisk -Caching 'ReadOnly' -Lun 2 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
$VmssVM = Get-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
Update-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0 -DataDisk $datadisk

La première commande obtient un disque managé existant. La commande suivante crée un objet de disque de données avec le disque managé. La commande suivante obtient une machine virtuelle Vmss existante donnée par le nom du groupe de ressources, le nom des machines virtuelles et l’ID d’instance. La commande finale met à jour la machine virtuelle Vmss en ajoutant un nouveau disque de données.

Exemple 2 : Ajouter un disque de données managé à une machine virtuelle Vmss à l’aide de Add-AzVMDataDisk

$disk = Get-AzDisk -ResourceGroupName $rgname -DiskName $diskname0
$VmssVM = Get-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
$VmssVM = Add-AzVMDataDisk -VM $VmssVM -Lun 0 -DiskSizeInGB 10 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
Update-AzVmssVM -VirtualMachineScaleSetVM $VmssVM

La première commande obtient un disque managé existant. La commande suivante obtient une machine virtuelle Vmss existante donnée par le nom du groupe de ressources, le nom des machines virtuelles et l’ID d’instance. La commande suivante ajoute le disque managé à la machine virtuelle Vmss stockée localement dans $VmssVM. La commande finale met à jour la machine virtuelle Vmss avec un disque de données ajouté.

Exemple 3

Met à jour l’état d’une machine virtuelle Vmss. (autogenerated)

Update-AzVmssVM -InstanceId 0 -ProtectFromScaleIn $false -ProtectFromScaleSetAction $false -ResourceGroupName 'myrg' -VMScaleSetName 'myvmss'

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DataDisk

Met à jour l’état d’une machine virtuelle Vmss. Pour l’instant, la seule mise à jour autorisée ajoute un disque de données managé.

Propriétés du paramètre

Type:

PSVirtualMachineDataDisk[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-InstanceId

Spécifie l’ID d’instance d’une machine virtuelle VMSS.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DefaultParameter
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ProtectFromScaleIn

Indique que la machine virtuelle du groupe de machines virtuelles identiques ne doit pas être prise en compte pour la suppression pendant une opération de mise à l’échelle.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ProtectFromScaleSetAction

Indique que les mises à jour ou actions de modèle (y compris la mise à l’échelle) lancées sur vmSS ne doivent pas être appliquées à la machine virtuelle VMSS.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ProxyAgentKeyIncarnationId

Augmenter la valeur de ce paramètre permet aux utilisateurs de réinitialiser la clé utilisée pour sécuriser le canal de communication entre l’invité et l’hôte.

Propriétés du paramètre

Type:

Nullable<T>[Int32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:KeyIncarnationId

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ResourceGroupName

Spécifie le nom du groupe de ressources de VMSS.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DefaultParameter
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ResourceId

ID de ressource de la machine virtuelle de groupe de machines virtuelles identiques

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ResourceIdParameter
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-UserData

UserData pour la machine virtuelle Vmss, qui sera encodée en base 64. Le client ne doit pas transmettre de secrets ici.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DefaultParameter
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ResourceIdParameter
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-VirtualMachineScaleSetVM

Objet de machine virtuelle de groupe de machines virtuelles identiques local

Propriétés du paramètre

Type:PSVirtualMachineScaleSetVM
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ObjectParameter
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VMScaleSetName

Nom du groupe de machines virtuelles identiques

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Nom

Jeux de paramètres

DefaultParameter
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

PSVirtualMachineDataDisk

PSVirtualMachineScaleSetVM

Sorties

PSVirtualMachineScaleSetVM