Get-AzureRmAutomationSoftwareUpdateMachineRun
Obtient la liste des exécutions de la machine de configuration des mises à jour logicielles Azure Automation.
Avertissement
Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntaxe
Get-AzureRmAutomationSoftwareUpdateMachineRun
[-Status <SoftwareUpdateMachineRunStatus>]
[-TargetComputer <String>]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzureRmAutomationSoftwareUpdateMachineRun
-Id <Guid>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzureRmAutomationSoftwareUpdateMachineRun
[-SoftwareUpdateRunId <Guid>]
[-Status <SoftwareUpdateMachineRunStatus>]
[-TargetComputer <String>]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzureRmAutomationSoftwareUpdateMachineRun
[-SoftwareUpdateRun <SoftwareUpdateRun>]
[-Status <SoftwareUpdateMachineRunStatus>]
[-TargetComputer <String>]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Cette applet de commande retourne une liste d’exécutions de machine. Chaque exécution de mise à jour logicielle déclenche une exécution de machine pour chaque ordinateur cible de configuration de mise à jour logicielle. Pour obtenir une exécution spécifique d’un ordinateur, passez le paramètre ID. Vous pouvez répertorier toutes les exécutions de l’ordinateur, toutes les exécutions pour un ordinateur spécifique, toutes les exécutions avec un état spécifique en transmettant les paramètres correspondants.
Exemples
Exemple 1
Cet exemple retourne toutes les exécutions de machine ayant échoué pour la machine virtuelle Azure spécifiée.
PS C:\> $targetComputer = "/subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/myvm"
PS C:\> Get-AzureRmAutomationSoftwareUpdateMachineRun -ResourceGroupName "mygroup" `
-AutomationAccountName "myaccount" `
-TargetComputer $targetComputer `
-Status Failed
MachineRunId : 0033d6d6-828d-4712-adab-293cc4fc8809
TargetComputer : /subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/myvm
TargetComputerType : AzureVirtualMachines
SoftwareUpdateRunId : 46568d26-0182-49b2-8bfd-af3455780397
OperatingSystem : Windows
Status : Failed
ResourceGroupName : mygroup
AutomationAccountName : myaccount
Name : 0033d6d6-828d-4712-adab-293cc4fc8809
CreationTime : 5/17/2018 2:06:44 AM +00:00
LastModifiedTime : 5/17/2018 2:08:49 AM +00:00
Paramètres
-AutomationAccountName
Nom du compte Automation.
Type: | String |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
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: | 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 |
-Id
ID de l’ordinateur de mise à jour logicielle exécuté.
Type: | Guid |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ResourceGroupName
Nom du groupe de ressources.
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 |
-SoftwareUpdateRun
Exécution de la mise à jour logicielle.
Type: | SoftwareUpdateRun |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-SoftwareUpdateRunId
ID de l’exécution de la mise à jour logicielle.
Type: | Guid |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Status
État de l’exécution de la machine.
Type: | Nullable<T>[SoftwareUpdateMachineRunStatus] |
Valeurs acceptées: | NotStarted, InProgress, Succeeded, Failed, MaintenanceWindowExceeded, FailedToStart |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-TargetComputer
ordinateur cible pour l’exécution de l’ordinateur. Il peut s’agir d’un nom d’ordinateur non azure ou d’un ID de ressource de machine virtuelle Azure.
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 |
Entrées
Nullable<T>[[Microsoft.Azure.Commands.Automation.Model.UpdateManagement.SoftwareUpdateMachineRunStatus, Microsoft.Azure.Commands.ResourceManager.Automation, Version=5.1.1.0, Culture=neutral, PublicKeyToken=null]]