Get-AzureRmAutomationSoftwareUpdateMachineRun
Azure Automation ソフトウェア更新プログラム構成マシンの実行の一覧を取得します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
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>]
説明
このコマンドレットは、コンピューターの実行の一覧を返します。 ソフトウェア更新プログラムの実行ごとに、ソフトウェア更新構成ターゲット マシンごとにマシンの実行がトリガーされます。 特定のマシンの実行を取得するには、Id パラメーターを渡します。 対応するパラメーターを渡すことで、すべてのマシンの実行、特定のコンピューターのすべての実行、特定の状態の実行をすべて一覧表示できます。
例
例 1
この例では、指定された Azure 仮想マシンに対して失敗したすべてのマシンの実行が返されます。
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
パラメーター
-AutomationAccountName
Automation アカウント名。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
ソフトウェア更新プログラムコンピューターの実行の ID。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
リソース グループ名。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SoftwareUpdateRun
ソフトウェア更新プログラムが実行されます。
型: | SoftwareUpdateRun |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SoftwareUpdateRunId
ソフトウェア更新プログラムの実行の ID。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Status
マシン実行の状態。
型: | Nullable<T>[SoftwareUpdateMachineRunStatus] |
指定可能な値: | NotStarted, InProgress, Succeeded, Failed, MaintenanceWindowExceeded, FailedToStart |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-TargetComputer
マシン実行のターゲット コンピューター。 Azure 以外のコンピューター名または Azure VM リソース ID を指定できます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
Nullable<T>[[Microsoft.Azure.Commands.Automation.Model.UpdateManagement.SoftwareUpdateMachineRunStatus, Microsoft.Azure.Commands.ResourceManager.Automation, Version=5.1.1.0, Culture=neutral, PublicKeyToken=null]]