AWS systems-manager documentation change
Summary
Added PowerShell examples for monitoring automation execution statuses
Security assessment
The examples demonstrate monitoring automation workflows but don't address security controls or vulnerabilities. They focus on operational visibility rather than security features.
Diff
diff --git a/systems-manager/latest/userguide/example_ssm_DescribeAutomationExecutions_section.md b/systems-manager/latest/userguide/example_ssm_DescribeAutomationExecutions_section.md index 55cb47281..2f1ab7eaa 100644 --- a//systems-manager/latest/userguide/example_ssm_DescribeAutomationExecutions_section.md +++ b//systems-manager/latest/userguide/example_ssm_DescribeAutomationExecutions_section.md @@ -101,0 +102,42 @@ PowerShell +**Tools for PowerShell V5** + + +**Example 1: This example describes all active and terminated Automation Executions associated with your account.** + + + Get-SSMAutomationExecutionList + + +**Output:** + + + AutomationExecutionId : 4105a4fc-f944-11e6-9d32-8fb2db27a909 + AutomationExecutionStatus : Failed + DocumentName : AWS-UpdateLinuxAmi + DocumentVersion : 1 + ExecutedBy : admin + ExecutionEndTime : 2/22/2017 9:17:08 PM + ExecutionStartTime : 2/22/2017 9:17:02 PM + LogFile : + Outputs : {[createImage.ImageId, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]} + +**Example 2: This example displays ExecutionID, document, execution start/end timestamp for executions with AutomationExecutionStatus other than 'Success'** + + + Get-SSMAutomationExecutionList | Where-Object AutomationExecutionStatus -ne "Success" | Select-Object AutomationExecutionId, DocumentName, AutomationExecutionStatus, ExecutionStartTime, ExecutionEndTime | Format-Table -AutoSize + + +**Output:** + + + AutomationExecutionId DocumentName AutomationExecutionStatus ExecutionStartTime ExecutionEndTime + --------------------- ------------ ------------------------- ------------------ ---------------- + e1d2bad3-4567-8901-ae23-456c7c8901be AWS-UpdateWindowsAmi Cancelled 4/16/2019 5:37:04 AM 4/16/2019 5:47:29 AM + 61234567-a7f8-90e1-2b34-567b8bf9012c Fixed-UpdateAmi Cancelled 4/16/2019 5:33:04 AM 4/16/2019 5:40:15 AM + 91234d56-7e89-0ac1-2aee-34ea5d6a7c89 AWS-UpdateWindowsAmi Failed 4/16/2019 5:22:46 AM 4/16/2019 5:27:29 AM + + * For API details, see [DescribeAutomationExecutions](https://docs.aws.amazon.com/powershell/v5/reference) in _AWS Tools for PowerShell Cmdlet Reference (V5)_. + + + +