Partager via


Set-AzVM

Cette applet de commande peut être utilisée pour effectuer les opérations suivantes : réappliquer ou redéployer une machine virtuelle, marquer une machine virtuelle comme généralisée, simuler une éviction sur une machine virtuelle spot.

Syntaxe

GeneralizeResourceGroupNameParameterSetName (Par défaut)

Set-AzVM
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Generalized]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

RedeployResourceGroupNameParameterSetName

Set-AzVM
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Redeploy]
    [-AsJob]
    [-NoWait]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ReapplyResourceGroupNameParameterSetName

Set-AzVM
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Reapply]
    [-AsJob]
    [-NoWait]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SimulateEvictionResourceGroupNameParameterSetName

Set-AzVM
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-SimulateEviction]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GeneralizeIdParameterSetName

Set-AzVM
    [-Id] <String>
    [-Generalized]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

RedeployIdParameterSetName

Set-AzVM
    [-Id] <String>
    [-Redeploy]
    [-AsJob]
    [-NoWait]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ReapplyIdParameterSetName

Set-AzVM
    [-Id] <String>
    [-Reapply]
    [-AsJob]
    [-NoWait]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SimulateEvictionIdParameterSetName

Set-AzVM
    [-Id] <String>
    [-SimulateEviction]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

L’applet de commande Set-AzVM peut être utilisée pour redéployer ou réappliquer une machine virtuelle. Il peut également être utilisé pour marquer une machine virtuelle comme généralisée ou simuler une éviction sur une machine virtuelle spot.
Avant de marquer une machine virtuelle comme généralisée, connectez-vous à la machine virtuelle et utilisez Sysprep pour préparer le disque dur. Pour plus d’informations, consultez ici.

Exemples

Exemple 1 : Marquer une machine virtuelle comme généralisée

Set-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Generalized

Cette commande marque la machine virtuelle nommée « VirtualMachine07 » comme généralisée.

Exemple 2 : Simuler une éviction sur une machine virtuelle spot à l’aide de l’ID de ressource

$vm = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Set-AzVM -Id $vm.id -SimulateEviction

Cette commande simule l’éviction sur la machine virtuelle nommée « VirtualMachine07 » à l’aide de l’ID de ressource.

Exemple 3 : Réappliquer une machine virtuelle

Set-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Reapply

Cette commande réapplique la machine virtuelle nommée « VirtualMachine07 ».

Exemple 4 : Redéployer une machine virtuelle à l’aide de l’ID de ressource

$vm = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Set-AzVM -Id $vm.id -Redeploy

Cette commande déploie la machine virtuelle nommée « VirtualMachine07 » à l’aide de l’ID de ressource.

Paramètres

-AsJob

Exécutez l’applet de commande en arrière-plan et retournez un travail pour suivre la progression.

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

-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

-Generalized

Indique que cette applet de commande marque une machine virtuelle comme généralisée.

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

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

-Id

Spécifie l’ID de ressource de la machine virtuelle.

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

GeneralizeIdParameterSetName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
RedeployIdParameterSetName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ReapplyIdParameterSetName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
SimulateEvictionIdParameterSetName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Name

Spécifie le nom de la machine virtuelle sur laquelle cette applet de commande fonctionne.

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

GeneralizeResourceGroupNameParameterSetName
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
RedeployResourceGroupNameParameterSetName
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ReapplyResourceGroupNameParameterSetName
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
SimulateEvictionResourceGroupNameParameterSetName
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-NoWait

Démarre l’opération et retourne immédiatement, avant la fin de l’opération. Pour déterminer si l’opération a bien été effectuée, utilisez un autre mécanisme.

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

RedeployResourceGroupNameParameterSetName
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
ReapplyResourceGroupNameParameterSetName
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
RedeployIdParameterSetName
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
ReapplyIdParameterSetName
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Reapply

Pour réappliquer la machine virtuelle.

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

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

-Redeploy

Indique que cette applet de commande redéploie manuellement la machine virtuelle sur un autre hôte Azure pour résoudre les problèmes. Si vous redéployez une machine virtuelle, elle redémarre, ce qui entraîne la perte de données de lecteur éphémères.

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

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

-ResourceGroupName

Spécifie le nom du groupe de ressources de la machine virtuelle.

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

GeneralizeResourceGroupNameParameterSetName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
RedeployResourceGroupNameParameterSetName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
ReapplyResourceGroupNameParameterSetName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False
SimulateEvictionResourceGroupNameParameterSetName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-SimulateEviction

Indique que cette applet de commande simule l’éviction de la machine virtuelle spot. L’éviction se produit dans les 30 minutes suivant l’appel de l’API.

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

SimulateEvictionResourceGroupNameParameterSetName
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
SimulateEvictionIdParameterSetName
Position:Named
Obligatoire:True
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

Sorties

PSComputeLongRunningOperation

PSAzureOperationResponse