Esempi per Systems Manager con Strumenti per PowerShell V5

Gli esempi di codice seguenti mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Strumenti per PowerShell V5 con Systems Manager.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Azioni

Add-SSMResourceTag

L’esempio di codice seguente mostra come utilizzare Add-SSMResourceTag.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiorna una finestra di manutenzione con nuovi tag. Se il comando va a buon fine, non viene generato output. La sintassi utilizzata da questo esempio richiede PowerShell versione 3 o successiva.

$option1 = @{Key="Stack";Value=@("Production")}
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $option1

Esempio 2: con PowerShell versione 2, è necessario utilizzare New-Object per creare ogni tag. Se il comando va a buon fine, non viene generato output.

$tag1 = New-Object Amazon.SimpleSystemsManagement.Model.Tag
$tag1.Key = "Stack"
$tag1.Value = "Production"
		
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $tag1

• Per informazioni dettagliate sull’API, consulta AddTagsToResource nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Edit-SSMDocumentPermission

L’esempio di codice seguente mostra come utilizzare Edit-SSMDocumentPermission.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiunge le autorizzazioni di “condivisione” a tutti gli account di un documento. Se il comando va a buon fine, non viene generato output.

Edit-SSMDocumentPermission -Name "RunShellScript" -PermissionType "Share" -AccountIdsToAdd all

Esempio 2: questo esempio aggiunge le autorizzazioni di “condivisione” a un account specifico per un documento. Se il comando va a buon fine, non viene generato output.

Edit-SSMDocumentPermission -Name "RunShellScriptNew" -PermissionType "Share" -AccountIdsToAdd "123456789012"

• Per informazioni dettagliate sull’API, consulta ModifyDocumentPermission nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMActivation

L’esempio di codice seguente mostra come utilizzare Get-SSMActivation.

Strumenti per PowerShell V5

Esempio 1: questo esempio fornisce dettagli sulle attivazioni sull’account.

Get-SSMActivation

Output:

ActivationId        : 08e51e79-1e36-446c-8e63-9458569c1363
CreatedDate         : 3/1/2017 12:01:51 AM
DefaultInstanceName : MyWebServers
Description         :
ExpirationDate      : 3/2/2017 12:01:51 AM
Expired             : False
IamRole             : AutomationRole
RegistrationLimit   : 10
RegistrationsCount  : 0

• Per informazioni dettagliate sull’API, consulta DescribeActivations nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMAssociation

L’esempio di codice seguente mostra come utilizzare Get-SSMAssociation.

Strumenti per PowerShell V5

Esempio 1: questo esempio descrive l’associazione tra un’istanza e un documento.

Get-SSMAssociation -InstanceId "i-0000293ffd8c57862" -Name "AWS-UpdateSSMAgent"

Output:

Name                  : AWS-UpdateSSMAgent
InstanceId            : i-0000293ffd8c57862
Date                  : 2/23/2017 6:55:22 PM
Status.Name           : Pending
Status.Date           : 2/20/2015 8:31:11 AM
Status.Message        : temp_status_change
Status.AdditionalInfo : Additional-Config-Needed

• Per informazioni dettagliate sull’API, consulta DescribeAssociation nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMAssociationExecution

L’esempio di codice seguente mostra come utilizzare Get-SSMAssociationExecution.

Strumenti per PowerShell V5

Esempio 1: questo esempio restituisce le esecuzioni per l’ID di associazione fornito

Get-SSMAssociationExecution -AssociationId 123a45a0-c678-9012-3456-78901234db5e

Output:

AssociationId         : 123a45a0-c678-9012-3456-78901234db5e
AssociationVersion    : 2
CreatedTime           : 3/2/2019 8:53:29 AM
DetailedStatus        :
ExecutionId           : 123a45a0-c678-9012-3456-78901234db5e
LastExecutionDate     : 1/1/0001 12:00:00 AM
ResourceCountByStatus : {Success=4}
Status                : Success

• Per informazioni dettagliate sull’API, consulta DescribeAssociationExecutions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMAssociationExecutionTarget

L’esempio di codice seguente mostra come utilizzare Get-SSMAssociationExecutionTarget.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza l’ID della risorsa e il relativo stato di esecuzione che fanno parte degli obiettivi di esecuzione dell’associazione

Get-SSMAssociationExecutionTarget -AssociationId 123a45a0-c678-9012-3456-78901234db5e -ExecutionId 123a45a0-c678-9012-3456-78901234db5e | Select-Object ResourceId, Status

Output:

ResourceId           Status
----------           ------
i-0b1b2a3456f7a890b  Success
i-01c12a45d6fc7a89f  Success
i-0a1caf234f56d7dc8  Success
i-012a3fd45af6dbcfe  Failed
i-0ddc1df23c4a5fb67  Success

Esempio 2: questo comando controlla la particolare esecuzione di una particolare automazione a partire da ieri, alla quale è associato un documento di comando. Controlla ulteriormente se l’esecuzione dell’associazione è fallita e, in tal caso, mostrerà i dettagli dell’invocazione del comando per l’esecuzione insieme all’ID dell’istanza

$AssociationExecution= Get-SSMAssociationExecutionTarget -AssociationId 1c234567-890f-1aca-a234-5a678d901cb0 -ExecutionId 12345ca12-3456-2345-2b45-23456789012 | 
    Where-Object {$_.LastExecutionDate -gt (Get-Date -Hour 00 -Minute 00).AddDays(-1)} 

foreach ($execution in $AssociationExecution) {
    if($execution.Status -ne 'Success'){
        Write-Output "There was an issue executing the association $($execution.AssociationId) on $($execution.ResourceId)"
        Get-SSMCommandInvocation -CommandId $execution.OutputSource.OutputSourceId -Detail:$true | Select-Object -ExpandProperty CommandPlugins
    }
}

Output:

There was an issue executing the association 1c234567-890f-1aca-a234-5a678d901cb0 on i-0a1caf234f56d7dc8


Name                   : aws:runPowerShellScript
Output                 : 
                         ----------ERROR-------
                         failed to run commands: exit status 1
OutputS3BucketName     : 
OutputS3KeyPrefix      : 
OutputS3Region         : eu-west-1
ResponseCode           : 1
ResponseFinishDateTime : 5/29/2019 11:04:49 AM
ResponseStartDateTime  : 5/29/2019 11:04:49 AM
StandardErrorUrl       : 
StandardOutputUrl      : 
Status                 : Failed
StatusDetails          : Failed

• Per informazioni dettagliate sull’API, consulta DescribeAssociationExecutionTargets nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMAssociationList

L’esempio di codice seguente mostra come utilizzare Get-SSMAssociationList.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutte le associazioni per un’istanza. La sintassi utilizzata da questo esempio richiede PowerShell versione 3 o successiva.

$filter1 = @{Key="InstanceId";Value=@("i-0000293ffd8c57862")}
Get-SSMAssociationList -AssociationFilterList $filter1

Output:

AssociationId      : d8617c07-2079-4c18-9847-1655fc2698b0
DocumentVersion    :
InstanceId         : i-0000293ffd8c57862
LastExecutionDate  : 2/20/2015 8:31:11 AM
Name               : AWS-UpdateSSMAgent
Overview           : Amazon.SimpleSystemsManagement.Model.AssociationOverview
ScheduleExpression :
Targets            : {InstanceIds}

Esempio 2: questo esempio elenca tutte le associazioni per un documento di configurazione. La sintassi utilizzata da questo esempio richiede PowerShell versione 3 o successiva.

$filter2 = @{Key="Name";Value=@("AWS-UpdateSSMAgent")}
Get-SSMAssociationList -AssociationFilterList $filter2

Output:

AssociationId      : d8617c07-2079-4c18-9847-1655fc2698b0
DocumentVersion    :
InstanceId         : i-0000293ffd8c57862
LastExecutionDate  : 2/20/2015 8:31:11 AM
Name               : AWS-UpdateSSMAgent
Overview           : Amazon.SimpleSystemsManagement.Model.AssociationOverview
ScheduleExpression :
Targets            : {InstanceIds}

Esempio 3: con PowerShell versione 2, è necessario utilizzare New-Object per creare ogni filtro.

$filter1 = New-Object Amazon.SimpleSystemsManagement.Model.AssociationFilter
$filter1.Key = "InstanceId"
$filter1.Value = "i-0000293ffd8c57862"

Get-SSMAssociationList -AssociationFilterList $filter1

Output:

AssociationId      : d8617c07-2079-4c18-9847-1655fc2698b0
DocumentVersion    :
InstanceId         : i-0000293ffd8c57862
LastExecutionDate  : 2/20/2015 8:31:11 AM
Name               : AWS-UpdateSSMAgent
Overview           : Amazon.SimpleSystemsManagement.Model.AssociationOverview
ScheduleExpression :
Targets            : {InstanceIds}

• Per informazioni dettagliate sull’API, consulta ListAssociations nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMAssociationVersionList

L’esempio di codice seguente mostra come utilizzare Get-SSMAssociationVersionList.

Strumenti per PowerShell V5

Esempio 1: questo esempio recupera tutte le versioni dell’associazione fornita.

Get-SSMAssociationVersionList -AssociationId 123a45a0-c678-9012-3456-78901234db5e

Output:

AssociationId      : 123a45a0-c678-9012-3456-78901234db5e
AssociationName    :
AssociationVersion : 2
ComplianceSeverity :
CreatedDate        : 3/12/2019 9:21:01 AM
DocumentVersion    :
MaxConcurrency     :
MaxErrors          :
Name               : AWS-GatherSoftwareInventory
OutputLocation     :
Parameters         : {}
ScheduleExpression :
Targets            : {InstanceIds}

AssociationId      : 123a45a0-c678-9012-3456-78901234db5e
AssociationName    : test-case-1234567890
AssociationVersion : 1
ComplianceSeverity :
CreatedDate        : 3/2/2019 8:53:29 AM
DocumentVersion    :
MaxConcurrency     :
MaxErrors          :
Name               : AWS-GatherSoftwareInventory
OutputLocation     :
Parameters         : {}
ScheduleExpression : rate(30minutes)
Targets            : {InstanceIds}

• Per informazioni dettagliate sull’API, consulta ListAssociationVersions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMAutomationExecution

L’esempio di codice seguente mostra come utilizzare Get-SSMAutomationExecution.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza i dettagli di un’esecuzione di automazione.

Get-SSMAutomationExecution -AutomationExecutionId "4105a4fc-f944-11e6-9d32-8fb2db27a909"

Output:

AutomationExecutionId     : 4105a4fc-f944-11e6-9d32-8fb2db27a909
AutomationExecutionStatus : Failed
DocumentName              : AWS-UpdateLinuxAmi
DocumentVersion           : 1
ExecutionEndTime          : 2/22/2017 9:17:08 PM
ExecutionStartTime        : 2/22/2017 9:17:02 PM
FailureMessage            : Step launchInstance failed maximum allowed times. You are not authorized to perform this operation. Encoded
                            authorization failure message: B_V2QyyN7NhSZQYpmVzpEc4oSnj2GLTNYnXUHsTbqJkNMoDgubmbtthLmZyaiUYekORIrA42-fv1x-04q5Fjff6glh
                            Yb6TI5b0GQeeNrpwNvpDzmO-PSR1swlAbg9fdM9BcNjyrznspUkWpuKu9EC1Ou6v3OXU1KC9nZ7mPlWMFZNkSioQqpwWEvMw-GZktsQzm67qOhUhBNOLWYhbS
                            pkfiqzY-5nw3S0obx30fhd3EJa5O_-GjV_a0nFXQJa70ik40bFOrEh3MtCSbrQT6--DvFy_FQ8TKvkIXadyVskeJI84XOF5WmA60f1pi5GI08i-nRfZS6oDeU
                            gELBjjoFKD8s3L2aI0B6umWVxnQOjqhQRxwJ53b54sZJ2PW3v_mtg9-q0CK0ezS3xfh_y0ilaUGOAZG-xjQFuvU_JZedWpla3xi-MZsmblAifBI
                            (Service: AmazonEC2; Status Code: 403; Error Code: UnauthorizedOperation; Request ID:
                            6a002f94-ba37-43fd-99e6-39517715fce5)
Outputs                   : {[createImage.ImageId, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]}
Parameters                : {[AutomationAssumeRole, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]], [InstanceIamRole,
                            Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]], [SourceAmiId,
                            Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]}
StepExecutions            : {launchInstance, updateOSSoftware, stopInstance, createImage...}

Esempio 2: questo esempio elenca i dettagli della fase per l’ID di esecuzione dell’automazione specificato

Get-SSMAutomationExecution -AutomationExecutionId e1d2bad3-4567-8901-ae23-456c7c8901be | Select-Object -ExpandProperty StepExecutions | Select-Object StepName, Action, StepStatus, ValidNextSteps

Output:

StepName                  Action                  StepStatus ValidNextSteps
--------                  ------                  ---------- --------------
LaunchInstance            aws:runInstances        Success    {OSCompatibilityCheck}
OSCompatibilityCheck      aws:runCommand          Success    {RunPreUpdateScript}
RunPreUpdateScript        aws:runCommand          Success    {UpdateEC2Config}
UpdateEC2Config           aws:runCommand          Cancelled  {}
UpdateSSMAgent            aws:runCommand          Pending    {}
UpdateAWSPVDriver         aws:runCommand          Pending    {}
UpdateAWSEnaNetworkDriver aws:runCommand          Pending    {}
UpdateAWSNVMe             aws:runCommand          Pending    {}
InstallWindowsUpdates     aws:runCommand          Pending    {}
RunPostUpdateScript       aws:runCommand          Pending    {}
RunSysprepGeneralize      aws:runCommand          Pending    {}
StopInstance              aws:changeInstanceState Pending    {}
CreateImage               aws:createImage         Pending    {}
TerminateInstance         aws:changeInstanceState Pending    {}

• Per informazioni dettagliate sull’API, consulta GetAutomationExecution nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMAutomationExecutionList

L’esempio di codice seguente mostra come utilizzare Get-SSMAutomationExecutionList.

Strumenti per PowerShell V5

Esempio 1: questo esempio descrive tutte le esecuzioni di automazione attive e terminate associate all’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]]}

Esempio 2: questo esempio visualizza ExecutionID, documenti, timestamp di inizio/fine dell’esecuzione per le esecuzioni con AutomationExecutionStatus diverse da “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

• Per informazioni dettagliate sull’API, consulta DescribeAutomationExecutions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMAutomationStepExecution

L’esempio di codice seguente mostra come utilizzare Get-SSMAutomationStepExecution.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza le informazioni relative a tutte le esecuzioni della fase attive e terminate in un flusso di lavoro di automazione.

Get-SSMAutomationStepExecution -AutomationExecutionId e1d2bad3-4567-8901-ae23-456c7c8901be | Select-Object StepName, Action, StepStatus

Output:

StepName                  Action                  StepStatus
--------                  ------                  ----------
LaunchInstance            aws:runInstances        Success
OSCompatibilityCheck      aws:runCommand          Success
RunPreUpdateScript        aws:runCommand          Success
UpdateEC2Config           aws:runCommand          Cancelled
UpdateSSMAgent            aws:runCommand          Pending
UpdateAWSPVDriver         aws:runCommand          Pending
UpdateAWSEnaNetworkDriver aws:runCommand          Pending
UpdateAWSNVMe             aws:runCommand          Pending
InstallWindowsUpdates     aws:runCommand          Pending
RunPostUpdateScript       aws:runCommand          Pending
RunSysprepGeneralize      aws:runCommand          Pending
StopInstance              aws:changeInstanceState Pending
CreateImage               aws:createImage         Pending
TerminateInstance         aws:changeInstanceState Pending

• Per informazioni dettagliate sull’API, consulta DescribeAutomationStepExecutions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMAvailablePatch

L’esempio di codice seguente mostra come utilizzare Get-SSMAvailablePatch.

Strumenti per PowerShell V5

Esempio 1: questo esempio fa ottenere tutte le patch per Windows Server 2012 che presentano una gravità MSRC pari a Critica. La sintassi utilizzata da questo esempio richiede PowerShell versione 3 o successiva.

$filter1 = @{Key="PRODUCT";Values=@("WindowsServer2012")}
$filter2 = @{Key="MSRC_SEVERITY";Values=@("Critical")}

Get-SSMAvailablePatch -Filter $filter1,$filter2

Output:

Classification : SecurityUpdates
ContentUrl     : https://support.microsoft.com/en-us/kb/2727528
Description    : A security issue has been identified that could allow an unauthenticated remote attacker to compromise your system and gain control
                 over it. You can help protect your system by installing this update from Microsoft. After you install this update, you may have to
                 restart your system.
Id             : 1eb507be-2040-4eeb-803d-abc55700b715
KbNumber       : KB2727528
Language       : All
MsrcNumber     : MS12-072
MsrcSeverity   : Critical
Product        : WindowsServer2012
ProductFamily  : Windows
ReleaseDate    : 11/13/2012 6:00:00 PM
Title          : Security Update for Windows Server 2012 (KB2727528)
Vendor         : Microsoft
...

Esempio 2: con PowerShell versione 2, è necessario utilizzare New-Object per creare ogni filtro.

$filter1 = New-Object Amazon.SimpleSystemsManagement.Model.PatchOrchestratorFilter
$filter1.Key = "PRODUCT"
$filter1.Values = "WindowsServer2012"
$filter2 = New-Object Amazon.SimpleSystemsManagement.Model.PatchOrchestratorFilter
$filter2.Key = "MSRC_SEVERITY"
$filter2.Values = "Critical"

Get-SSMAvailablePatch -Filter $filter1,$filter2

Esempio 3: questo esempio recupera tutti gli aggiornamenti rilasciati negli ultimi 20 giorni e applicabili ai prodotti corrispondenti a WindowsServer2019

Get-SSMAvailablePatch | Where-Object ReleaseDate -ge (Get-Date).AddDays(-20) | Where-Object Product -eq "WindowsServer2019" | Select-Object ReleaseDate, Product, Title

Output:

ReleaseDate         Product           Title
-----------         -------           -----
4/9/2019 5:00:12 PM WindowsServer2019 2019-04 Security Update for Adobe Flash Player for Windows Server 2019 for x64-based Systems (KB4493478)
4/9/2019 5:00:06 PM WindowsServer2019 2019-04 Cumulative Update for Windows Server 2019 for x64-based Systems (KB4493509)
4/2/2019 5:00:06 PM WindowsServer2019 2019-03 Servicing Stack Update for Windows Server 2019 for x64-based Systems (KB4493510)

• Per informazioni dettagliate sull’API, consulta DescribeAvailablePatches nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMCommand

L’esempio di codice seguente mostra come utilizzare Get-SSMCommand.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutti i comandi richiesti.

Get-SSMCommand

Output:

CommandId          : 4b75a163-d39a-4d97-87c9-98ae52c6be35
Comment            : Apply association with id at update time: 4cc73e42-d5ae-4879-84f8-57e09c0efcd0
CompletedCount     : 1
DocumentName       : AWS-RefreshAssociation
ErrorCount         : 0
ExpiresAfter       : 2/24/2017 3:19:08 AM
InstanceIds        : {i-0cb2b964d3e14fd9f}
MaxConcurrency     : 50
MaxErrors          : 0
NotificationConfig : Amazon.SimpleSystemsManagement.Model.NotificationConfig
OutputS3BucketName :
OutputS3KeyPrefix  :
OutputS3Region     :
Parameters         : {[associationIds, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]}
RequestedDateTime  : 2/24/2017 3:18:08 AM
ServiceRole        :
Status             : Success
StatusDetails      : Success
TargetCount        : 1
Targets            : {}

Esempio 2: questo esempio ottiene lo stato di un comando specifico.

Get-SSMCommand -CommandId "4b75a163-d39a-4d97-87c9-98ae52c6be35"

Esempio 3: questo esempio recupera tutti i comandi SSM invocati dopo il 2019-04-01T00:00:00Z

Get-SSMCommand -Filter @{Key="InvokedAfter";Value="2019-04-01T00:00:00Z"} | Select-Object CommandId, DocumentName, Status, RequestedDateTime | Sort-Object -Property RequestedDateTime -Descending

Output:

CommandId                            DocumentName               Status    RequestedDateTime
---------                            ------------               ------    -----------------
edb1b23e-456a-7adb-aef8-90e-012ac34f AWS-RunPowerShellScript    Cancelled 4/16/2019 5:45:23 AM
1a2dc3fb-4567-890d-a1ad-234b5d6bc7d9 AWS-ConfigureAWSPackage    Success   4/6/2019 9:19:42 AM
12c3456c-7e90-4f12-1232-1234f5b67893 KT-Retrieve-Cloud-Type-Win Failed    4/2/2019 4:13:07 AM
fe123b45-240c-4123-a2b3-234bdd567ecf AWS-RunInspecChecks        Failed    4/1/2019 2:27:31 PM
1eb23aa4-567d-4123-12a3-4c1c2ab34561 AWS-RunPowerShellScript    Success   4/1/2019 1:05:55 PM
1c2f3bb4-ee12-4bc1-1a23-12345eea123e AWS-RunInspecChecks        Failed    4/1/2019 11:13:09 AM

• Per informazioni dettagliate sull’API, consulta ListCommands nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMCommandInvocation

L’esempio di codice seguente mostra come utilizzare Get-SSMCommandInvocation.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutte le invocazioni di un comando.

Get-SSMCommandInvocation -CommandId "b8eac879-0541-439d-94ec-47a80d554f44" -Detail $true

Output:

CommandId          : b8eac879-0541-439d-94ec-47a80d554f44
CommandPlugins     : {aws:runShellScript}
Comment            : IP config
DocumentName       : AWS-RunShellScript
InstanceId         : i-0cb2b964d3e14fd9f
InstanceName       :
NotificationConfig : Amazon.SimpleSystemsManagement.Model.NotificationConfig
RequestedDateTime  : 2/22/2017 8:13:16 PM
ServiceRole        :
StandardErrorUrl   :
StandardOutputUrl  :
Status             : Success
StatusDetails      : Success
TraceOutput        :

Esempio 2: Questo esempio elenca CommandPlugins per l’invocazione dell’ID di comando e1eb2e3c-ed4c-5123-45c1-234f5612345f

Get-SSMCommandInvocation -CommandId e1eb2e3c-ed4c-5123-45c1-234f5612345f -Detail:$true | Select-Object -ExpandProperty CommandPlugins

Output:

Name                   : aws:runPowerShellScript
Output                 : Completed 17.7 KiB/17.7 KiB (40.1 KiB/s) with 1 file(s) remainingdownload: s3://dd-aess-r-ctmer/KUMO.png to ..\..\programdata\KUMO.png
                         kumo available

OutputS3BucketName     :
OutputS3KeyPrefix      :
OutputS3Region         : eu-west-1
ResponseCode           : 0
ResponseFinishDateTime : 4/3/2019 11:53:23 AM
ResponseStartDateTime  : 4/3/2019 11:53:21 AM
StandardErrorUrl       :
StandardOutputUrl      :
Status                 : Success
StatusDetails          : Success

• Per informazioni dettagliate sull’API, consulta ListCommandInvocations nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMCommandInvocationDetail

L’esempio di codice seguente mostra come utilizzare Get-SSMCommandInvocationDetail.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza i dettagli di un comando eseguito su un’istanza.

Get-SSMCommandInvocationDetail -InstanceId "i-0cb2b964d3e14fd9f" -CommandId "b8eac879-0541-439d-94ec-47a80d554f44"

Output:

CommandId              : b8eac879-0541-439d-94ec-47a80d554f44
Comment                : IP config
DocumentName           : AWS-RunShellScript
ExecutionElapsedTime   : PT0.004S
ExecutionEndDateTime   : 2017-02-22T20:13:16.651Z
ExecutionStartDateTime : 2017-02-22T20:13:16.651Z
InstanceId             : i-0cb2b964d3e14fd9f
PluginName             : aws:runShellScript
ResponseCode           : 0
StandardErrorContent   :
StandardErrorUrl       :
StandardOutputContent  :
StandardOutputUrl      :
Status                 : Success
StatusDetails          : Success

• Per informazioni dettagliate sull’API, consulta GetCommandInvocation nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMComplianceItemList

L’esempio di codice seguente mostra come utilizzare Get-SSMComplianceItemList.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca l’elenco degli elementi di conformità per l’ID e il tipo di risorsa specificati, filtrando il tipo di conformità utilizzando “Associazione”

Get-SSMComplianceItemList -ResourceId i-1a2caf345f67d0dc2 -ResourceType ManagedInstance -Filter @{Key="ComplianceType";Values="Association"}

Output:

ComplianceType   : Association
Details          : {[DocumentName, AWS-GatherSoftwareInventory], [DocumentVersion, 1]}
ExecutionSummary : Amazon.SimpleSystemsManagement.Model.ComplianceExecutionSummary
Id               : 123a45a1-c234-1234-1245-67891236db4e
ResourceId       : i-1a2caf345f67d0dc2
ResourceType     : ManagedInstance
Severity         : UNSPECIFIED
Status           : COMPLIANT
Title            :

• Per informazioni dettagliate sull’API, consulta ListComplianceItems nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMComplianceSummaryList

L’esempio di codice seguente mostra come utilizzare Get-SSMComplianceSummaryList.

Strumenti per PowerShell V5

Esempio 1: questo esempio restituisce un conteggio riepilogativo delle risorse conformi e non conformi per tutti i tipi di conformità.

Get-SSMComplianceSummaryList

Output:

ComplianceType CompliantSummary                                      NonCompliantSummary
-------------- ----------------                                      -------------------
FleetTotal     Amazon.SimpleSystemsManagement.Model.CompliantSummary Amazon.SimpleSystemsManagement.Model.NonCompliantSummary
Association    Amazon.SimpleSystemsManagement.Model.CompliantSummary Amazon.SimpleSystemsManagement.Model.NonCompliantSummary
Custom:InSpec  Amazon.SimpleSystemsManagement.Model.CompliantSummary Amazon.SimpleSystemsManagement.Model.NonCompliantSummary
Patch          Amazon.SimpleSystemsManagement.Model.CompliantSummary Amazon.SimpleSystemsManagement.Model.NonCompliantSummary

• Per informazioni dettagliate sull’API, consulta ListComplianceSummaries nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMConnectionStatus

L’esempio di codice seguente mostra come utilizzare Get-SSMConnectionStatus.

Strumenti per PowerShell V5

Esempio 1: questo esempio recupera lo stato della connessione di Session Manager per un’istanza per determinare se è connessa e pronta a ricevere connessioni a Session Manager.

Get-SSMConnectionStatus -Target i-0a1caf234f12d3dc4

Output:

Status    Target
------    ------
Connected i-0a1caf234f12d3dc4

• Per informazioni dettagliate sull’API, consulta GetConnectionStatus nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMDefaultPatchBaseline

L’esempio di codice seguente mostra come utilizzare Get-SSMDefaultPatchBaseline.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza la baseline delle patch predefinita.

Get-SSMDefaultPatchBaseline

Output:

arn:aws:ssm:us-west-2:123456789012:patchbaseline/pb-04fb4ae6142167966

• Per informazioni dettagliate sull’API, consulta GetDefaultPatchBaseline nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMDeployablePatchSnapshotForInstance

L’esempio di codice seguente mostra come utilizzare Get-SSMDeployablePatchSnapshotForInstance.

Strumenti per PowerShell V5

Esempio 1: questo esempio visualizza l’istantanea corrente per la baseline delle patch utilizzata da un’istanza. Questo comando deve essere eseguito dall’istanza utilizzando le credenziali dell’istanza. Per garantire che utilizzi le credenziali dell’istanza, l’esempio passa un oggetto Amazon.Runtime.InstanceProfileAWSCredentials al parametro Credentials.

$credentials = [Amazon.Runtime.InstanceProfileAWSCredentials]::new()
Get-SSMDeployablePatchSnapshotForInstance -SnapshotId "4681775b-098f-4435-a956-0ef33373ac11" -InstanceId "i-0cb2b964d3e14fd9f" -Credentials $credentials

Output:

InstanceId          SnapshotDownloadUrl
----------          -------------------
i-0cb2b964d3e14fd9f https://patch-baseline-snapshot-us-west-2.s3-us-west-2.amazonaws.com/853d0d3db0f0cafe...1692/4681775b-098f-4435...

Esempio 2: questo esempio mostra come ottenere lo SnapshotDownloadURL completo. Questo comando deve essere eseguito dall’istanza utilizzando le credenziali dell’istanza. Per garantire che utilizzi le credenziali dell’istanza, l’esempio configura la sessione PowerShell per l’utilizzo di un oggetto Amazon.Runtime.InstanceProfileAWSCredentials.

Set-AWSCredential -Credential ([Amazon.Runtime.InstanceProfileAWSCredentials]::new())
(Get-SSMDeployablePatchSnapshotForInstance -SnapshotId "4681775b-098f-4435-a956-0ef33373ac11" -InstanceId "i-0cb2b964d3e14fd9f").SnapshotDownloadUrl

Output:

https://patch-baseline-snapshot-us-west-2.s3-us-west-2.amazonaws.com/853d0d3db0f0cafe...

• Per informazioni dettagliate sull’API, consulta GetDeployablePatchSnapshotForInstance nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMDocument

L’esempio di codice seguente mostra come utilizzare Get-SSMDocument.

Strumenti per PowerShell V5

Esempio 1: questo esempio restituisce il contenuto di un documento.

Get-SSMDocument -Name "RunShellScript"

Output:

Content
-------
{...

Esempio 2: questo esempio visualizza il contenuto completo di un documento.

(Get-SSMDocument -Name "RunShellScript").Content
{
   "schemaVersion":"2.0",
   "description":"Run an updated script",
   "parameters":{
      "commands":{
         "type":"StringList",
         "description":"(Required) Specify a shell script or a command to run.",
         "minItems":1,
         "displayType":"textarea"
      }
   },
   "mainSteps":[
      {
         "action":"aws:runShellScript",
         "name":"runShellScript",
         "inputs":{
            "commands":"{{ commands }}"
         }
      },
      {
         "action":"aws:runPowerShellScript",
         "name":"runPowerShellScript",
         "inputs":{
            "commands":"{{ commands }}"
         }
      }
   ]
}

• Per informazioni dettagliate sull’API, consulta GetDocument nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMDocumentDescription

L’esempio di codice seguente mostra come utilizzare Get-SSMDocumentDescription.

Strumenti per PowerShell V5

Esempio 1: questo esempio restituisce informazioni su un documento.

Get-SSMDocumentDescription -Name "RunShellScript"

Output:

CreatedDate     : 2/24/2017 5:25:13 AM
DefaultVersion  : 1
Description     : Run an updated script
DocumentType    : Command
DocumentVersion : 1
Hash            : f775e5df4904c6fa46686c4722fae9de1950dace25cd9608ff8d622046b68d9b
HashType        : Sha256
LatestVersion   : 1
Name            : RunShellScript
Owner           : 123456789012
Parameters      : {commands}
PlatformTypes   : {Linux}
SchemaVersion   : 2.0
Sha1            :
Status          : Active

• Per informazioni dettagliate sull’API, consulta DescribeDocument nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMDocumentList

L’esempio di codice seguente mostra come utilizzare Get-SSMDocumentList.

Strumenti per PowerShell V5

Esempio 1: elenca tutti i documenti di configurazione dell’account.

Get-SSMDocumentList

Output:

DocumentType    : Command
DocumentVersion : 1
Name            : AWS-ApplyPatchBaseline
Owner           : Amazon
PlatformTypes   : {Windows}
SchemaVersion   : 1.2

DocumentType    : Command
DocumentVersion : 1
Name            : AWS-ConfigureAWSPackage
Owner           : Amazon
PlatformTypes   : {Windows, Linux}
SchemaVersion   : 2.0

DocumentType    : Command
DocumentVersion : 1
Name            : AWS-ConfigureCloudWatch
Owner           : Amazon
PlatformTypes   : {Windows}
SchemaVersion   : 1.2
...

Esempio 2: questo esempio recupera tutti i documenti di automazione il cui nome corrisponde a “Piattaforma”

Get-SSMDocumentList -DocumentFilterList @{Key="DocumentType";Value="Automation"} | Where-Object Name -Match "Platform"

Output:

DocumentFormat  : JSON
DocumentType    : Automation
DocumentVersion : 7
Name            : KT-Get-Platform
Owner           : 987654123456
PlatformTypes   : {Windows, Linux}
SchemaVersion   : 0.3
Tags            : {}
TargetType      :
VersionName     :

• Per informazioni dettagliate sull’API, consulta ListDocuments nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMDocumentPermission

L’esempio di codice seguente mostra come utilizzare Get-SSMDocumentPermission.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutte le versioni di un documento.

Get-SSMDocumentVersionList -Name "RunShellScript"

Output:

CreatedDate          DocumentVersion IsDefaultVersion Name
-----------          --------------- ---------------- ----
2/24/2017 5:25:13 AM 1               True             RunShellScript

• Per informazioni dettagliate sull’API, consulta DescribeDocumentPermission nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMDocumentVersionList

L’esempio di codice seguente mostra come utilizzare Get-SSMDocumentVersionList.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutte le versioni di un documento.

Get-SSMDocumentVersionList -Name "AWS-UpdateSSMAgent"

Output:

CreatedDate       : 6/1/2021 5:19:10 PM
DocumentFormat    : JSON
DocumentVersion   : 1
IsDefaultVersion  : True
Name              : AWS-UpdateSSMAgent
Status            : Active

• Per informazioni dettagliate sull’API, consulta ListDocumentVersions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMEffectiveInstanceAssociationList

L’esempio di codice seguente mostra come utilizzare Get-SSMEffectiveInstanceAssociationList.

Strumenti per PowerShell V5

Esempio 1: questo esempio descrive le associazioni efficaci per un’istanza.

Get-SSMEffectiveInstanceAssociationList -InstanceId "i-0000293ffd8c57862" -MaxResult 5

Output:

AssociationId                        Content
-------------                        -------
d8617c07-2079-4c18-9847-1655fc2698b0 {...

Esempio 2: questo esempio visualizza il contenuto delle associazioni efficaci per un’istanza.

(Get-SSMEffectiveInstanceAssociationList -InstanceId "i-0000293ffd8c57862" -MaxResult 5).Content

Output:

{
    "schemaVersion": "1.2",
    "description": "Update the Amazon SSM Agent to the latest version or specified version.",
    "parameters": {
        "version": {
            "default": "",
            "description": "(Optional) A specific version of the Amazon SSM Agent to install. If not specified, the agen
t will be updated to the latest version.",
            "type": "String"
        },
        "allowDowngrade": {
            "default": "false",
            "description": "(Optional) Allow the Amazon SSM Agent service to be downgraded to an earlier version. If set
 to false, the service can be upgraded to newer versions only (default). If set to true, specify the earlier version.",
            "type": "String",
            "allowedValues": [
                "true",
                "false"
            ]
        }
    },
    "runtimeConfig": {
        "aws:updateSsmAgent": {
            "properties": [
                {
                "agentName": "amazon-ssm-agent",
                "source": "https://s3.{Region}.amazonaws.com/amazon-ssm-{Region}/ssm-agent-manifest.json",
                "allowDowngrade": "{{ allowDowngrade }}",
                "targetVersion": "{{ version }}"
                }
            ]
        }
    }
}

• Per informazioni dettagliate sull’API, consulta DescribeEffectiveInstanceAssociations nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMEffectivePatchesForPatchBaseline

L’esempio di codice seguente mostra come utilizzare Get-SSMEffectivePatchesForPatchBaseline.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutte le baseline delle patch, con un elenco di risultati massimo di 1.

Get-SSMEffectivePatchesForPatchBaseline -BaselineId "pb-0a2f1059b670ebd31" -MaxResult 1

Output:

Patch                                      PatchStatus
-----                                      -----------
Amazon.SimpleSystemsManagement.Model.Patch Amazon.SimpleSystemsManagement.Model.PatchStatus

Esempio 2: questo esempio visualizza lo stato delle patch per tutte baseline delle patch, con un elenco di risultati massimo di 1.

(Get-SSMEffectivePatchesForPatchBaseline -BaselineId "pb-0a2f1059b670ebd31" -MaxResult 1).PatchStatus

Output:

ApprovalDate          DeploymentStatus
------------          ----------------
12/21/2010 6:00:00 PM APPROVED

• Per informazioni dettagliate sull’API, consulta DescribeEffectivePatchesForPatchBaseline nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMInstanceAssociationsStatus

L’esempio di codice seguente mostra come utilizzare Get-SSMInstanceAssociationsStatus.

Strumenti per PowerShell V5

Esempio 1: questo esempio mostra i dettagli delle associazioni per un’istanza.

Get-SSMInstanceAssociationsStatus -InstanceId "i-0000293ffd8c57862"

Output:

AssociationId    : d8617c07-2079-4c18-9847-1655fc2698b0
DetailedStatus   : Pending
DocumentVersion  : 1
ErrorCode        :
ExecutionDate    : 2/20/2015 8:31:11 AM
ExecutionSummary : temp_status_change
InstanceId       : i-0000293ffd8c57862
Name             : AWS-UpdateSSMAgent
OutputUrl        :
Status           : Pending

Esempio 2: questo esempio controlla lo stato di associazione delle istanze per l’ID di istanza specificato e inoltre visualizza lo stato di esecuzione di tali associazioni

Get-SSMInstanceAssociationsStatus -InstanceId i-012e3cb4df567e8aa | ForEach-Object {Get-SSMAssociationExecution -AssociationId .AssociationId}

Output:

AssociationId         : 512a34a5-c678-1234-1234-12345678db9e
AssociationVersion    : 2
CreatedTime           : 3/2/2019 8:53:29 AM
DetailedStatus        :
ExecutionId           : 512a34a5-c678-1234-1234-12345678db9e
LastExecutionDate     : 1/1/0001 12:00:00 AM
ResourceCountByStatus : {Success=9}
Status                : Success

• Per informazioni dettagliate sull’API, consulta DescribeInstanceAssociationsStatus nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMInstanceInformation

L’esempio di codice seguente mostra come utilizzare Get-SSMInstanceInformation.

Strumenti per PowerShell V5

Esempio 1: questo esempio mostra i dettagli di ciascuna istanza.

Get-SSMInstanceInformation

Output:

ActivationId                           :
AgentVersion                           : 2.0.672.0
AssociationOverview                    : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview
AssociationStatus                      : Success
ComputerName                           : ip-172-31-44-222.us-west-2.compute.internal
IamRole                                :
InstanceId                             : i-0cb2b964d3e14fd9f
IPAddress                              : 172.31.44.222
IsLatestVersion                        : True
LastAssociationExecutionDate           : 2/24/2017 3:18:09 AM
LastPingDateTime                       : 2/24/2017 3:35:03 AM
LastSuccessfulAssociationExecutionDate : 2/24/2017 3:18:09 AM
Name                                   :
PingStatus                             : ConnectionLost
PlatformName                           : Amazon Linux AMI
PlatformType                           : Linux
PlatformVersion                        : 2016.09
RegistrationDate                       : 1/1/0001 12:00:00 AM
ResourceType                           : EC2Instance

Esempio 2: questo esempio mostra come utilizzare il parametro -Filter per filtrare i risultati solo per le istanze di AWS Systems Manager nella Regione us-east-1 con un AgentVersion di 2.2.800.0. È possibile trovare un elenco di valori chiave -Filter validi nell’argomento di riferimento dell’API InstanceInformation (https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_InstanceInformation.html#systemsmanager-Type-InstanceInformation-ActivationId).

$Filters = @{
    Key="AgentVersion"
    Values="2.2.800.0"
}
Get-SSMInstanceInformation -Region us-east-1 -Filter $Filters

Output:

ActivationId                           : 
AgentVersion                           : 2.2.800.0
AssociationOverview                    : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview
AssociationStatus                      : Success
ComputerName                           : EXAMPLE-EXAMPLE.WORKGROUP
IamRole                                : 
InstanceId                             : i-EXAMPLEb0792d98ce
IPAddress                              : 10.0.0.01
IsLatestVersion                        : False
LastAssociationExecutionDate           : 8/16/2018 12:02:50 AM
LastPingDateTime                       : 8/16/2018 7:40:27 PM
LastSuccessfulAssociationExecutionDate : 8/16/2018 12:02:50 AM
Name                                   : 
PingStatus                             : Online
PlatformName                           : Microsoft Windows Server 2016 Datacenter
PlatformType                           : Windows
PlatformVersion                        : 10.0.14393
RegistrationDate                       : 1/1/0001 12:00:00 AM
ResourceType                           : EC2Instance

ActivationId                           : 
AgentVersion                           : 2.2.800.0
AssociationOverview                    : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview
AssociationStatus                      : Success
ComputerName                           : EXAMPLE-EXAMPLE.WORKGROUP
IamRole                                : 
InstanceId                             : i-EXAMPLEac7501d023
IPAddress                              : 10.0.0.02
IsLatestVersion                        : False
LastAssociationExecutionDate           : 8/16/2018 12:00:20 AM
LastPingDateTime                       : 8/16/2018 7:40:35 PM
LastSuccessfulAssociationExecutionDate : 8/16/2018 12:00:20 AM
Name                                   : 
PingStatus                             : Online
PlatformName                           : Microsoft Windows Server 2016 Datacenter
PlatformType                           : Windows
PlatformVersion                        : 10.0.14393
RegistrationDate                       : 1/1/0001 12:00:00 AM
ResourceType                           : EC2Instance

Esempio 3: questo esempio mostra come utilizzare il parametro -InstanceInformationFilterList per filtrare i risultati solo in base alle istanze di AWS Systems Manager nella Regione us-east-1 con PlatformTypes di Windows o Linux. È possibile trovare un elenco di valori chiave -InstanceInformationFilterList validi nell’argomento di riferimento dell’API InstanceInformationFilter (https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_InstanceInformationFilter.html).

$Filters = @{
   Key="PlatformTypes"
   ValueSet=("Windows","Linux")
}
Get-SSMInstanceInformation -Region us-east-1 -InstanceInformationFilterList $Filters

Output:

ActivationId                           : 
AgentVersion                           : 2.2.800.0
AssociationOverview                    : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview
AssociationStatus                      : Success
ComputerName                           : EXAMPLE-EXAMPLE.WORKGROUP
IamRole                                : 
InstanceId                             : i-EXAMPLEb0792d98ce
IPAddress                              : 10.0.0.27
IsLatestVersion                        : False
LastAssociationExecutionDate           : 8/16/2018 12:02:50 AM
LastPingDateTime                       : 8/16/2018 7:40:27 PM
LastSuccessfulAssociationExecutionDate : 8/16/2018 12:02:50 AM
Name                                   : 
PingStatus                             : Online
PlatformName                           : Ubuntu Server 18.04 LTS
PlatformType                           : Linux
PlatformVersion                        : 18.04
RegistrationDate                       : 1/1/0001 12:00:00 AM
ResourceType                           : EC2Instance

ActivationId                           : 
AgentVersion                           : 2.2.800.0
AssociationOverview                    : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview
AssociationStatus                      : Success
ComputerName                           : EXAMPLE-EXAMPLE.WORKGROUP
IamRole                                : 
InstanceId                             : i-EXAMPLEac7501d023
IPAddress                              : 10.0.0.100
IsLatestVersion                        : False
LastAssociationExecutionDate           : 8/16/2018 12:00:20 AM
LastPingDateTime                       : 8/16/2018 7:40:35 PM
LastSuccessfulAssociationExecutionDate : 8/16/2018 12:00:20 AM
Name                                   : 
PingStatus                             : Online
PlatformName                           : Microsoft Windows Server 2016 Datacenter
PlatformType                           : Windows
PlatformVersion                        : 10.0.14393
RegistrationDate                       : 1/1/0001 12:00:00 AM
ResourceType                           : EC2Instance

Esempio 4: questo esempio elenca le istanze gestite da ssm ed esporta InstanceId, PingStatus, LastPingDateTime e PlatformName in un file csv.

Get-SSMInstanceInformation | Select-Object InstanceId, PingStatus, LastPingDateTime, PlatformName | Export-Csv Instance-details.csv -NoTypeInformation

• Per informazioni dettagliate sull’API, consulta DescribeInstanceInformation nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMInstancePatch

L’esempio di codice seguente mostra come utilizzare Get-SSMInstancePatch.

Strumenti per PowerShell V5

Esempio 1: questo esempio ottiene i dettagli sulla conformità delle patch per un’istanza.

Get-SSMInstancePatch -InstanceId "i-08ee91c0b17045407"

• Per informazioni dettagliate sull’API, consulta DescribeInstancePatches nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMInstancePatchState

L’esempio di codice seguente mostra come utilizzare Get-SSMInstancePatchState.

Strumenti per PowerShell V5

Esempio 1: questo esempio ottiene gli stati di riepilogo delle patch per un’istanza.

Get-SSMInstancePatchState -InstanceId "i-08ee91c0b17045407"

Esempio 2: questo esempio ottiene gli stati di riepilogo delle patch per due istanze.

Get-SSMInstancePatchState -InstanceId "i-08ee91c0b17045407","i-09a618aec652973a9"

• Per informazioni dettagliate sull’API, consulta DescribeInstancePatchStates nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMInstancePatchStatesForPatchGroup

L’esempio di codice seguente mostra come utilizzare Get-SSMInstancePatchStatesForPatchGroup.

Strumenti per PowerShell V5

Esempio 1: Questo esempio ottiene gli stati del riepilogo delle patch per istanza per un gruppo di patch.

Get-SSMInstancePatchStatesForPatchGroup -PatchGroup "Production"

• Per informazioni dettagliate sull’API, consulta DescribeInstancePatchStatesForPatchGroup nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMInventory

L’esempio di codice seguente mostra come utilizzare Get-SSMInventory.

Strumenti per PowerShell V5

Esempio 1: questo esempio ottiene i metadati personalizzati per l’inventario.

Get-SSMInventory

Output:

Data                                                                                  Id
----                                                                                  --
{[AWS:InstanceInformation, Amazon.SimpleSystemsManagement.Model.InventoryResultItem]} i-0cb2b964d3e14fd9f

• Per informazioni dettagliate sull’API, consulta GetInventory nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMInventoryEntriesList

L’esempio di codice seguente mostra come utilizzare Get-SSMInventoryEntriesList.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutte le voci di inventario personalizzate per un’istanza.

Get-SSMInventoryEntriesList -InstanceId "i-0cb2b964d3e14fd9f" -TypeName "Custom:RackInfo"

Output:

CaptureTime   : 2016-08-22T10:01:01Z
Entries       : {Amazon.Runtime.Internal.Util.AlwaysSendDictionary`2[System.String,System.String]}
InstanceId    : i-0cb2b964d3e14fd9f
NextToken     :
SchemaVersion : 1.0
TypeName      : Custom:RackInfo

Esempio 2: questo esempio elenca i dettagli.

(Get-SSMInventoryEntriesList -InstanceId "i-0cb2b964d3e14fd9f" -TypeName "Custom:RackInfo").Entries

Output:

Key          Value
---          -----
RackLocation Bay B/Row C/Rack D/Shelf E

• Per informazioni dettagliate sull’API, consulta ListInventoryEntries nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMInventoryEntryList

L’esempio di codice seguente mostra come utilizzare Get-SSMInventoryEntryList.

Strumenti per PowerShell V5

Esempio 1: questo esempio recupera le voci di inventario di tipo AWS:Network per l’istanza.

Get-SSMInventoryEntryList -InstanceId mi-088dcb0ecea37b076 -TypeName AWS:Network | Select-Object -ExpandProperty Entries

Output:

Key        Value
---        -----
DHCPServer 172.31.11.2
DNSServer  172.31.0.1
Gateway    172.31.11.2
IPV4       172.31.11.222
IPV6       fe12::3456:7da8:901a:12a3
MacAddress 1A:23:4E:5B:FB:67
Name       Amazon Elastic Network Adapter
SubnetMask 255.255.240.0

• Per informazioni dettagliate sull’API, consulta Get-SSMInventoryEntryList nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMInventorySchema

L’esempio di codice seguente mostra come utilizzare Get-SSMInventorySchema.

Strumenti per PowerShell V5

Esempio 1: questo esempio restituisce un elenco di nomi dei tipi di inventario per l’account.

Get-SSMInventorySchema

• Per informazioni dettagliate sull’API, consulta GetInventorySchema nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMLatestEC2Image

L’esempio di codice seguente mostra come utilizzare Get-SSMLatestEC2Image.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutte le AMI Windows più recenti.

PS Get-SSMLatestEC2Image -Path ami-windows-latest

Output:

Name                                                                    Value
----                                                                    -----
Windows_Server-2008-R2_SP1-English-64Bit-SQL_2012_SP4_Express           ami-0e5ddd288daff4fab
Windows_Server-2012-R2_RTM-Chinese_Simplified-64Bit-Base                ami-0c5ea64e6bec1cb50
Windows_Server-2012-R2_RTM-Chinese_Traditional-64Bit-Base               ami-09775eff0bf8c113d
Windows_Server-2012-R2_RTM-Dutch-64Bit-Base                             ami-025064b67e28cf5df
...

Esempio 2: questo esempio recupera l’ID AMI di un’immagine Amazon Linux specifica per la Regione us-west-2.

PS Get-SSMLatestEC2Image -Path ami-amazon-linux-latest -ImageName amzn-ami-hvm-x86_64-ebs -Region us-west-2

Output:

ami-09b92cd132204c704

Esempio 3: questo esempio elenca tutte le AMI Windows più recenti corrispondenti all’espressione con caratteri jolly specificata.

Get-SSMLatestEC2Image -Path ami-windows-latest -ImageName *Windows*2019*English*

Output:

Name                                                     Value
----                                                     -----
Windows_Server-2019-English-Full-SQL_2017_Web            ami-085e9d27da5b73a42
Windows_Server-2019-English-STIG-Core                    ami-0bfd85c29148c7f80
Windows_Server-2019-English-Full-SQL_2019_Web            ami-02099560d7fb11f20
Windows_Server-2019-English-Full-SQL_2016_SP2_Standard   ami-0d7ae2d81c07bd598
...

• Per informazioni dettagliate sull’API, consulta Get-SSMLatestEC2Image nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMMaintenanceWindow

L’esempio di codice seguente mostra come utilizzare Get-SSMMaintenanceWindow.

Strumenti per PowerShell V5

Esempio 1: questo esempio ottiene dettagli su una finestra di manutenzione.

Get-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d"

Output:

AllowUnassociatedTargets : False
CreatedDate              : 2/20/2017 6:14:05 PM
Cutoff                   : 1
Duration                 : 2
Enabled                  : True
ModifiedDate             : 2/20/2017 6:14:05 PM
Name                     : TestMaintWin
Schedule                 : cron(0 */30 * * * ? *)
WindowId                 : mw-03eb9db42890fb82d

• Per informazioni dettagliate sull’API, consulta GetMaintenanceWindow nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMMaintenanceWindowExecution

L’esempio di codice seguente mostra come utilizzare Get-SSMMaintenanceWindowExecution.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca le informazioni su un’attività eseguita nell’ambito di un’esecuzione di una finestra di manutenzione.

Get-SSMMaintenanceWindowExecution -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"

Output:

EndTime           : 2/21/2017 4:00:35 PM
StartTime         : 2/21/2017 4:00:34 PM
Status            : FAILED
StatusDetails     : One or more tasks in the orchestration failed.
TaskIds           : {ac0c6ae1-daa3-4a89-832e-d384503b6586}
WindowExecutionId : 518d5565-5969-4cca-8f0e-da3b2a638355

• Per informazioni dettagliate sull’API, consulta GetMaintenanceWindowExecution nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMMaintenanceWindowExecutionList

L’esempio di codice seguente mostra come utilizzare Get-SSMMaintenanceWindowExecutionList.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutte le esecuzioni per una finestra di manutenzione.

Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d"

Output:

EndTime           : 2/20/2017 6:30:17 PM
StartTime         : 2/20/2017 6:30:16 PM
Status            : FAILED
StatusDetails     : One or more tasks in the orchestration failed.
WindowExecutionId : 6f3215cf-4101-4fa0-9b7b-9523269599c7
WindowId          : mw-03eb9db42890fb82d

Esempio 2: questo esempio elenca tutte le esecuzioni per una finestra di manutenzione prima di una data specificata.

$option1 = @{Key="ExecutedBefore";Values=@("2016-11-04T05:00:00Z")}
Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d" -Filter $option1

Esempio 3: questo esempio elenca tutte le esecuzioni per una finestra di manutenzione dopo una data specificata.

$option1 = @{Key="ExecutedAfter";Values=@("2016-11-04T05:00:00Z")}
Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d" -Filter $option1

• Per informazioni dettagliate sull’API, consulta DescribeMaintenanceWindowExecutions nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMMaintenanceWindowExecutionTask

L’esempio di codice seguente mostra come utilizzare Get-SSMMaintenanceWindowExecutionTask.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca le informazioni su un’attività che faceva parte dell’esecuzione di una finestra di manutenzione.

Get-SSMMaintenanceWindowExecutionTask -TaskId "ac0c6ae1-daa3-4a89-832e-d384503b6586" -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"

Output:

EndTime           : 2/21/2017 4:00:35 PM
MaxConcurrency    : 1
MaxErrors         : 1
Priority          : 10
ServiceRole       : arn:aws:iam::123456789012:role/MaintenanceWindowsRole
StartTime         : 2/21/2017 4:00:34 PM
Status            : FAILED
StatusDetails     : The maximum error count was exceeded.
TaskArn           : AWS-RunShellScript
TaskExecutionId   : ac0c6ae1-daa3-4a89-832e-d384503b6586
TaskParameters    : {Amazon.Runtime.Internal.Util.AlwaysSendDictionary`2[System.String,Amazon.SimpleSystemsManagement.Model.MaintenanceWindowTaskPara
                    meterValueExpression]}
Type              : RUN_COMMAND
WindowExecutionId : 518d5565-5969-4cca-8f0e-da3b2a638355

• Per informazioni dettagliate sull’API, consulta GetMaintenanceWindowExecutionTask nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMMaintenanceWindowExecutionTaskInvocationList

L’esempio di codice seguente mostra come utilizzare Get-SSMMaintenanceWindowExecutionTaskInvocationList.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca le invocazioni per un’attività eseguita nell’ambito di un’esecuzione di una finestra di manutenzione.

Get-SSMMaintenanceWindowExecutionTaskInvocationList -TaskId "ac0c6ae1-daa3-4a89-832e-d384503b6586" -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"

Output:

EndTime           : 2/21/2017 4:00:34 PM
ExecutionId       :
InvocationId      : e274b6e1-fe56-4e32-bd2a-8073c6381d8b
OwnerInformation  :
Parameters        : {"documentName":"AWS-RunShellScript","instanceIds":["i-0000293ffd8c57862"],"parameters":{"commands":["df"]},"maxConcurrency":"1",
                    "maxErrors":"1"}
StartTime         : 2/21/2017 4:00:34 PM
Status            : FAILED
StatusDetails     : The instance IDs list contains an invalid entry.
TaskExecutionId   : ac0c6ae1-daa3-4a89-832e-d384503b6586
WindowExecutionId : 518d5565-5969-4cca-8f0e-da3b2a638355
WindowTargetId    :

• Per informazioni dettagliate sull’API, consulta DescribeMaintenanceWindowExecutionTaskInvocations nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMMaintenanceWindowExecutionTaskList

L’esempio di codice seguente mostra come utilizzare Get-SSMMaintenanceWindowExecutionTaskList.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca le attività associate all’esecuzione di una finestra di manutenzione.

Get-SSMMaintenanceWindowExecutionTaskList -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"

Output:

EndTime           : 2/21/2017 4:00:35 PM
StartTime         : 2/21/2017 4:00:34 PM
Status            : SUCCESS
TaskArn           : AWS-RunShellScript
TaskExecutionId   : ac0c6ae1-daa3-4a89-832e-d384503b6586
TaskType          : RUN_COMMAND
WindowExecutionId : 518d5565-5969-4cca-8f0e-da3b2a638355

• Per informazioni dettagliate sull’API, consulta DescribeMaintenanceWindowExecutionTasks nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMMaintenanceWindowList

L’esempio di codice seguente mostra come utilizzare Get-SSMMaintenanceWindowList.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutte le finestre di manutenzione dell’account.

Get-SSMMaintenanceWindowList

Output:

Cutoff   : 1
Duration : 4
Enabled  : True
Name     : My-First-Maintenance-Window
WindowId : mw-06d59c1a07c022145

• Per informazioni dettagliate sull’API, consulta DescribeMaintenanceWindows nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMMaintenanceWindowTarget

L’esempio di codice seguente mostra come utilizzare Get-SSMMaintenanceWindowTarget.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutti gli obiettivi per una finestra di manutenzione.

Get-SSMMaintenanceWindowTarget -WindowId "mw-06cf17cbefcb4bf4f"

Output:

OwnerInformation : Single instance
ResourceType     : INSTANCE
Targets          : {InstanceIds}
WindowId         : mw-06cf17cbefcb4bf4f
WindowTargetId   : 350d44e6-28cc-44e2-951f-4b2c985838f6

OwnerInformation : Two instances in a list
ResourceType     : INSTANCE
Targets          : {InstanceIds}
WindowId         : mw-06cf17cbefcb4bf4f
WindowTargetId   : e078a987-2866-47be-bedd-d9cf49177d3a

• Per informazioni dettagliate sull’API, consulta DescribeMaintenanceWindowTargets nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMMaintenanceWindowTaskList

L’esempio di codice seguente mostra come utilizzare Get-SSMMaintenanceWindowTaskList.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutte le attività per una finestra di manutenzione.

Get-SSMMaintenanceWindowTaskList -WindowId "mw-06cf17cbefcb4bf4f"

Output:

LoggingInfo    :
MaxConcurrency : 1
MaxErrors      : 1
Priority       : 10
ServiceRoleArn : arn:aws:iam::123456789012:role/MaintenanceWindowsRole
Targets        : {InstanceIds}
TaskArn        : AWS-RunShellScript
TaskParameters : {[commands, Amazon.SimpleSystemsManagement.Model.MaintenanceWindowTaskParameterValueExpression]}
Type           : RUN_COMMAND
WindowId       : mw-06cf17cbefcb4bf4f
WindowTaskId   : a23e338d-ff30-4398-8aa3-09cd052ebf17

• Per informazioni dettagliate sull’API, consulta DescribeMaintenanceWindowTasks nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMParameterHistory

L’esempio di codice seguente mostra come utilizzare Get-SSMParameterHistory.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca la cronologia dei valori di un parametro.

Get-SSMParameterHistory -Name "Welcome"

Output:

Description      :
KeyId            :
LastModifiedDate : 3/3/2017 6:55:25 PM
LastModifiedUser : arn:aws:iam::123456789012:user/admin
Name             : Welcome
Type             : String
Value            : helloWorld

• Per informazioni dettagliate sull’API, consulta GetParameterHistory nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMParameterList

L’esempio di codice seguente mostra come utilizzare Get-SSMParameterList.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutti i parametri.

Get-SSMParameterList

Output:

Description      :
KeyId            :
LastModifiedDate : 3/3/2017 6:58:23 PM
LastModifiedUser : arn:aws:iam::123456789012:user/admin
Name             : Welcome
Type             : String

• Per informazioni dettagliate sull’API, consulta DescribeParameters nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMParameterValue

L’esempio di codice seguente mostra come utilizzare Get-SSMParameterValue.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca i valori di un parametro.

Get-SSMParameterValue -Name "Welcome"

Output:

InvalidParameters Parameters
----------------- ----------
{}                {Welcome}

Esempio 2: questo esempio elenca i dettagli del valore.

(Get-SSMParameterValue -Name "Welcome").Parameters

Output:

Name    Type   Value
----    ----   -----
Welcome String Good day, Sunshine!

• Per informazioni dettagliate sull’API, consulta GetParameters nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMPatchBaseline

L’esempio di codice seguente mostra come utilizzare Get-SSMPatchBaseline.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca tutte le baseline delle patch.

Get-SSMPatchBaseline

Output:

BaselineDescription                                             BaselineId                                                            BaselineName
-------------------                                             ----------                                                            ------------
Default Patch Baseline Provided by AWS.                         arn:aws:ssm:us-west-2:123456789012:patchbaseline/pb-04fb4ae6142167966 AWS-DefaultP...
Baseline containing all updates approved for production systems pb-045f10b4f382baeda                                                  Production-B...
Baseline containing all updates approved for production systems pb-0a2f1059b670ebd31                                                  Production-B...

Esempio 2: questo esempio elenca tutte le baseline delle patch fornite da AWS. La sintassi utilizzata da questo esempio richiede PowerShell versione 3 o successiva.

$filter1 = @{Key="OWNER";Values=@("AWS")}

Output:

Get-SSMPatchBaseline -Filter $filter1

Esempio 3: questo esempio elenca tutte le baseline delle patch con l’utente come proprietario. La sintassi utilizzata da questo esempio richiede PowerShell versione 3 o successiva.

$filter1 = @{Key="OWNER";Values=@("Self")}

Output:

Get-SSMPatchBaseline -Filter $filter1

Esempio 4: con PowerShell versione 2, è necessario utilizzare New-Object per creare ogni tag.

$filter1 = New-Object Amazon.SimpleSystemsManagement.Model.PatchOrchestratorFilter
$filter1.Key = "OWNER"
$filter1.Values = "AWS"

Get-SSMPatchBaseline -Filter $filter1

Output:

BaselineDescription                     BaselineId                                                            BaselineName             DefaultBaselin
                                                                                                                                       e
-------------------                     ----------                                                            ------------             --------------
Default Patch Baseline Provided by AWS. arn:aws:ssm:us-west-2:123456789012:patchbaseline/pb-04fb4ae6142167966 AWS-DefaultPatchBaseline True

• Per informazioni dettagliate sull’API, consulta DescribePatchBaselines nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMPatchBaselineDetail

L’esempio di codice seguente mostra come utilizzare Get-SSMPatchBaselineDetail.

Strumenti per PowerShell V5

Esempio 1: questo esempio mostra i dettagli di una baseline delle patch.

Get-SSMPatchBaselineDetail -BaselineId "pb-03da896ca3b68b639"

Output:

ApprovalRules   : Amazon.SimpleSystemsManagement.Model.PatchRuleGroup
ApprovedPatches : {}
BaselineId      : pb-03da896ca3b68b639
CreatedDate     : 3/3/2017 5:02:19 PM
Description     : Baseline containing all updates approved for production systems
GlobalFilters   : Amazon.SimpleSystemsManagement.Model.PatchFilterGroup
ModifiedDate    : 3/3/2017 5:02:19 PM
Name            : Production-Baseline
PatchGroups     : {}
RejectedPatches : {}

• Per informazioni dettagliate sull’API, consulta GetPatchBaseline nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMPatchBaselineForPatchGroup

L’esempio di codice seguente mostra come utilizzare Get-SSMPatchBaselineForPatchGroup.

Strumenti per PowerShell V5

Esempio 1: questo esempio mostra la baseline delle patch per un gruppo di patch.

Get-SSMPatchBaselineForPatchGroup -PatchGroup "Production"

Output:

BaselineId           PatchGroup
----------           ----------
pb-045f10b4f382baeda Production

• Per informazioni dettagliate sull’API, consulta GetPatchBaselineForPatchGroup nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMPatchGroup

L’esempio di codice seguente mostra come utilizzare Get-SSMPatchGroup.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca le registrazioni dei gruppi di patch.

Get-SSMPatchGroup

Output:

BaselineIdentity                                           PatchGroup
----------------                                           ----------
Amazon.SimpleSystemsManagement.Model.PatchBaselineIdentity Production

• Per informazioni dettagliate sull’API, consulta DescribePatchGroups nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMPatchGroupState

L’esempio di codice seguente mostra come utilizzare Get-SSMPatchGroupState.

Strumenti per PowerShell V5

Esempio 1: questo esempio ottiene il riepilogo di alto livello sulla conformità delle patch per un gruppo di patch.

Get-SSMPatchGroupState -PatchGroup "Production"

Output:

Instances                          : 4
InstancesWithFailedPatches         : 1
InstancesWithInstalledOtherPatches : 4
InstancesWithInstalledPatches      : 3
InstancesWithMissingPatches        : 0
InstancesWithNotApplicablePatches  : 0

• Per informazioni dettagliate sull’API, consulta DescribePatchGroupState nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMResourceComplianceSummaryList

L’esempio di codice seguente mostra come utilizzare Get-SSMResourceComplianceSummaryList.

Strumenti per PowerShell V5

Esempio 1: questo esempio ottiene un conteggio riepilogativo a livello di risorsa. Il riepilogo include informazioni sullo stato conforme e non conforme e sui conteggi dettagliati di gravità degli elementi di conformità per i prodotti che corrispondono a “Windows10”. Poiché l’impostazione predefinita di MaxResult è 100 se il parametro non è specificato e questo valore non è valido, viene aggiunto il parametro MaxResult e il valore è impostato su 50.

$FilterValues = @{
		"Key"="Product"
        "Type"="EQUAL"
        "Values"="Windows10"
}
        Get-SSMResourceComplianceSummaryList -Filter $FilterValues -MaxResult 50

• Per informazioni dettagliate sull’API, consulta ListResourceComplianceSummaries nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Get-SSMResourceTag

L’esempio di codice seguente mostra come utilizzare Get-SSMResourceTag.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca i tag per una finestra di manutenzione.

Get-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow"

Output:

Key   Value
---   -----
Stack Production

• Per informazioni dettagliate sull’API, consulta ListTagsForResource nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-SSMActivation

L’esempio di codice seguente mostra come utilizzare New-SSMActivation.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un’istanza gestita.

New-SSMActivation -DefaultInstanceName "MyWebServers" -IamRole "SSMAutomationRole" -RegistrationLimit 10

Output:

ActivationCode       ActivationId
--------------       ------------
KWChhOxBTiwDcKE9BlKC 08e51e79-1e36-446c-8e63-9458569c1363

• Per informazioni dettagliate sull’API, consulta CreateActivation nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-SSMAssociation

L’esempio di codice seguente mostra come utilizzare New-SSMAssociation.

Strumenti per PowerShell V5

Esempio 1: questo esempio associa un documento di configurazione a un’istanza, utilizzando gli ID delle istanze.

New-SSMAssociation -InstanceId "i-0cb2b964d3e14fd9f" -Name "AWS-UpdateSSMAgent"

Output:

Name                  : AWS-UpdateSSMAgent
InstanceId            : i-0000293ffd8c57862
Date                  : 2/23/2017 6:55:22 PM
Status.Name           : Associated
Status.Date           : 2/20/2015 8:31:11 AM
Status.Message        : Associated with AWS-UpdateSSMAgent
Status.AdditionalInfo :

Esempio 2: questo esempio associa un documento di configurazione a un’istanza, utilizzando destinazioni.

$target = @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")}
New-SSMAssociation -Name "AWS-UpdateSSMAgent" -Target $target

Output:

Name                  : AWS-UpdateSSMAgent
InstanceId            :
Date                  : 3/1/2017 6:22:21 PM
Status.Name           :
Status.Date           :
Status.Message        :
Status.AdditionalInfo :

Esempio 3: questo esempio associa un documento di configurazione a un’istanza, utilizzando destinazioni e parametri.

$target = @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")}
$params = @{
  "action"="configure"
  "mode"="ec2"
  "optionalConfigurationSource"="ssm"
  "optionalConfigurationLocation"=""
  "optionalRestart"="yes"
}
New-SSMAssociation -Name "Configure-CloudWatch" -AssociationName "CWConfiguration" -Target $target -Parameter $params

Output:

Name                  : Configure-CloudWatch
InstanceId            :
Date                  : 5/17/2018 3:17:44 PM
Status.Name           :
Status.Date           :
Status.Message        :
Status.AdditionalInfo :

Esempio 4: questo esempio crea un’associazione con tutte le istanze della regione, con AWS-GatherSoftwareInventory. Fornisce inoltre file personalizzati e posizioni di registro nei parametri da raccogliere

$params = [Collections.Generic.Dictionary[String,Collections.Generic.List[String]]]::new()
$params["windowsRegistry"] ='[{"Path":"HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\MachineImage","Recursive":false,"ValueNames":["AMIName"]}]'
$params["files"] = '[{"Path":"C:\Program Files","Pattern":["*.exe"],"Recursive":true}, {"Path":"C:\ProgramData","Pattern":["*.log"],"Recursive":true}]' 
New-SSMAssociation -AssociationName new-in-mum -Name AWS-GatherSoftwareInventory -Target @{Key="instanceids";Values="*"} -Parameter $params -region ap-south-1 -ScheduleExpression "rate(720 minutes)"

Output:

Name                  : AWS-GatherSoftwareInventory
InstanceId            :
Date                  : 6/9/2019 8:57:56 AM
Status.Name           :
Status.Date           :
Status.Message        :
Status.AdditionalInfo :

• Per informazioni dettagliate sull’API, consulta CreateAssociation nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-SSMAssociationFromBatch

L’esempio di codice seguente mostra come utilizzare New-SSMAssociationFromBatch.

Strumenti per PowerShell V5

Esempio 1: questo esempio associa un documento di configurazione a più istanze. L’output restituisce un elenco di operazioni riuscite e non riuscite, se applicabile.

$option1 = @{InstanceId="i-0cb2b964d3e14fd9f";Name=@("AWS-UpdateSSMAgent")}
$option2 = @{InstanceId="i-0000293ffd8c57862";Name=@("AWS-UpdateSSMAgent")}
New-SSMAssociationFromBatch -Entry $option1,$option2

Output:

Failed  Successful
------  ----------
{}      {Amazon.SimpleSystemsManagement.Model.FailedCreateAssociation, Amazon.SimpleSystemsManagement.Model.FailedCreateAsso...

Esempio 2: questo esempio mostrerà tutti i dettagli di un’operazione riuscita.

$option1 = @{InstanceId="i-0cb2b964d3e14fd9f";Name=@("AWS-UpdateSSMAgent")}
$option2 = @{InstanceId="i-0000293ffd8c57862";Name=@("AWS-UpdateSSMAgent")}
(New-SSMAssociationFromBatch -Entry $option1,$option2).Successful

• Per informazioni dettagliate sull’API, consulta CreateAssociationBatch nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-SSMDocument

L’esempio di codice seguente mostra come utilizzare New-SSMDocument.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un documento nell’account. Il documento deve essere in formato JSON. Per ulteriori informazioni sulla scrittura di un documento di configurazione, consulta il Documento di configurazione nella Documentazione di riferimento API SSM.

New-SSMDocument -Content (Get-Content -Raw "c:\temp\RunShellScript.json") -Name "RunShellScript" -DocumentType "Command"

Output:

CreatedDate     : 3/1/2017 1:21:33 AM
DefaultVersion  : 1
Description     : Run an updated script
DocumentType    : Command
DocumentVersion : 1
Hash            : 1d5ce820e999ff051eb4841ed887593daf77120fd76cae0d18a53cc42e4e22c1
HashType        : Sha256
LatestVersion   : 1
Name            : RunShellScript
Owner           : 809632081692
Parameters      : {commands}
PlatformTypes   : {Linux}
SchemaVersion   : 2.0
Sha1            :
Status          : Creating

• Per informazioni dettagliate sull’API, consulta CreateDocument nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-SSMMaintenanceWindow

L’esempio di codice seguente mostra come utilizzare New-SSMMaintenanceWindow.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea una nuova finestra di manutenzione con il nome specificato che viene eseguita alle 16:00 di ogni martedì per 4 ore, con un limite di 1 ora e che consente obiettivi non associati.

New-SSMMaintenanceWindow -Name "MyMaintenanceWindow" -Duration 4 -Cutoff 1 -AllowUnassociatedTarget $true -Schedule "cron(0 16 ? * TUE *)"

Output:

mw-03eb53e1ea7383998

• Per informazioni dettagliate sull’API, consulta CreateMaintenanceWindow nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

New-SSMPatchBaseline

L’esempio di codice seguente mostra come utilizzare New-SSMPatchBaseline.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea una baseline delle patch che approva le patch, sette giorni dopo che sono state rilasciate da Microsoft, per istanze gestite che eseguono Windows Server 2019 in un ambiente di produzione.

$rule = New-Object Amazon.SimpleSystemsManagement.Model.PatchRule
$rule.ApproveAfterDays = 7

$ruleFilters = New-Object Amazon.SimpleSystemsManagement.Model.PatchFilterGroup

$patchFilter = New-Object Amazon.SimpleSystemsManagement.Model.PatchFilter
$patchFilter.Key="PRODUCT"
$patchFilter.Values="WindowsServer2019"

$severityFilter = New-Object Amazon.SimpleSystemsManagement.Model.PatchFilter
$severityFilter.Key="MSRC_SEVERITY"
$severityFilter.Values.Add("Critical")
$severityFilter.Values.Add("Important")
$severityFilter.Values.Add("Moderate")

$classificationFilter = New-Object Amazon.SimpleSystemsManagement.Model.PatchFilter
$classificationFilter.Key = "CLASSIFICATION"
$classificationFilter.Values.Add( "SecurityUpdates" )
$classificationFilter.Values.Add( "Updates" )
$classificationFilter.Values.Add( "UpdateRollups" )
$classificationFilter.Values.Add( "CriticalUpdates" )

$ruleFilters.PatchFilters.Add($severityFilter)
$ruleFilters.PatchFilters.Add($classificationFilter)
$ruleFilters.PatchFilters.Add($patchFilter)
$rule.PatchFilterGroup = $ruleFilters

New-SSMPatchBaseline -Name "Production-Baseline-Windows2019" -Description "Baseline containing all updates approved for production systems" -ApprovalRules_PatchRule $rule

Output:

pb-0z4z6221c4296b23z

• Per informazioni dettagliate sull’API, consulta CreatePatchBaseline nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Register-SSMDefaultPatchBaseline

L’esempio di codice seguente mostra come utilizzare Register-SSMDefaultPatchBaseline.

Strumenti per PowerShell V5

Esempio 1: questo esempio registra una baseline delle patch come baseline delle patch predefinita.

Register-SSMDefaultPatchBaseline -BaselineId "pb-03da896ca3b68b639"

Output:

pb-03da896ca3b68b639

• Per informazioni dettagliate sull’API, consulta RegisterDefaultPatchBaseline nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Register-SSMPatchBaselineForPatchGroup

L’esempio di codice seguente mostra come utilizzare Register-SSMPatchBaselineForPatchGroup.

Strumenti per PowerShell V5

Esempio 1: questo esempio registra una baseline delle patch per un gruppo di patch.

Register-SSMPatchBaselineForPatchGroup -BaselineId "pb-03da896ca3b68b639" -PatchGroup "Production"

Output:

BaselineId           PatchGroup
----------           ----------
pb-03da896ca3b68b639 Production

• Per informazioni dettagliate sull’API, consulta RegisterPatchBaselineForPatchGroup nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Register-SSMTargetWithMaintenanceWindow

L’esempio di codice seguente mostra come utilizzare Register-SSMTargetWithMaintenanceWindow.

Strumenti per PowerShell V5

Esempio 1: questo esempio registra un’istanza con una finestra di manutenzione.

$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"

Output:

d8e47760-23ed-46a5-9f28-927337725398

Esempio 2: questo esempio registra più istanze con una finestra di manutenzione.

$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"

Output:

6ab5c208-9fc4-4697-84b7-b02a6cc25f7d

Esempio 3: questo esempio registra un’istanza con una finestra di manutenzione utilizzando i tag EC2.

$option1 = @{Key="tag:Environment";Values=@("Production")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE"

Output:

2994977e-aefb-4a71-beac-df620352f184

• Per informazioni dettagliate sull’API, consulta RegisterTargetWithMaintenanceWindow nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Register-SSMTaskWithMaintenanceWindow

L’esempio di codice seguente mostra come utilizzare Register-SSMTaskWithMaintenanceWindow.

Strumenti per PowerShell V5

Esempio 1: questo esempio registra un’attività con una finestra di manutenzione utilizzando un ID di istanza. L’output è l’ID dell’attività.

$parameters = @{}
$parameterValues = New-Object Amazon.SimpleSystemsManagement.Model.MaintenanceWindowTaskParameterValueExpression
$parameterValues.Values = @("Install")
$parameters.Add("Operation", $parameterValues)

Register-SSMTaskWithMaintenanceWindow -WindowId "mw-03a342e62c96d31b0" -ServiceRoleArn "arn:aws:iam::123456789012:role/MaintenanceWindowsRole" -MaxConcurrency 1 -MaxError 1 -TaskArn "AWS-RunShellScript" -Target @{ Key="InstanceIds";Values="i-0000293ffd8c57862" } -TaskType "RUN_COMMAND" -Priority 10 -TaskParameter $parameters

Output:

f34a2c47-ddfd-4c85-a88d-72366b69af1b

Esempio 2: questo esempio registra un’attività con una finestra di manutenzione utilizzando un ID di destinazione. L’output è l’ID dell’attività.

$parameters = @{}
$parameterValues = New-Object Amazon.SimpleSystemsManagement.Model.MaintenanceWindowTaskParameterValueExpression
$parameterValues.Values = @("Install")
$parameters.Add("Operation", $parameterValues)

register-ssmtaskwithmaintenancewindow -WindowId "mw-03a342e62c96d31b0" -ServiceRoleArn "arn:aws:iam::123456789012:role/MaintenanceWindowsRole" -MaxConcurrency 1 -MaxError 1 -TaskArn "AWS-RunShellScript" -Target @{ Key="WindowTargetIds";Values="350d44e6-28cc-44e2-951f-4b2c985838f6" } -TaskType "RUN_COMMAND" -Priority 10 -TaskParameter $parameters

Output:

f34a2c47-ddfd-4c85-a88d-72366b69af1b

Esempio 3: questo esempio crea un oggetto parametro per il documento di comando run AWS-RunPowerShellScript e crea un’attività con una determinata finestra di manutenzione utilizzando l’ID di destinazione. L’output restituito è l’ID dell’attività.

$parameters = [Collections.Generic.Dictionary[String,Collections.Generic.List[String]]]::new()
$parameters.Add("commands",@("ipconfig","dir env:\computername"))
$parameters.Add("executionTimeout",@(3600))

$props = @{
    WindowId = "mw-0123e4cce56ff78ae"
    ServiceRoleArn = "arn:aws:iam::123456789012:role/MaintenanceWindowsRole"
    MaxConcurrency = 1
    MaxError = 1
    TaskType = "RUN_COMMAND"
    TaskArn = "AWS-RunPowerShellScript"
    Target = @{Key="WindowTargetIds";Values="fe1234ea-56d7-890b-12f3-456b789bee0f"}
    Priority = 1
    RunCommand_Parameter = $parameters
    Name = "set-via-cmdlet"
}

Register-SSMTaskWithMaintenanceWindow @props

Output:

f1e2ef34-5678-12e3-456a-12334c5c6cbe

Esempio 4: Questo esempio registra un’attività di AWS Systems Manager Automation utilizzando un documento denominato Create-Snapshots.

$automationParameters = @{}
$automationParameters.Add( "instanceId", @("{{ TARGET_ID }}") )
$automationParameters.Add( "AutomationAssumeRole", @("{arn:aws:iam::111111111111:role/AutomationRole}") )
$automationParameters.Add( "SnapshotTimeout", @("PT20M") )
Register-SSMTaskWithMaintenanceWindow -WindowId mw-123EXAMPLE456`
    -ServiceRoleArn "arn:aws:iam::123456789012:role/MW-Role"`
    -MaxConcurrency 1 -MaxError 1 -TaskArn "CreateVolumeSnapshots"`
    -Target @{ Key="WindowTargetIds";Values="4b5acdf4-946c-4355-bd68-4329a43a5fd1" }`
    -TaskType "AUTOMATION"`
    -Priority 4`
    -Automation_DocumentVersion '$DEFAULT' -Automation_Parameter $automationParameters -Name "Create-Snapshots"

• Per informazioni dettagliate sull’API, consulta RegisterTaskWithMaintenanceWindow nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-SSMActivation

L’esempio di codice seguente mostra come utilizzare Remove-SSMActivation.

Strumenti per PowerShell V5

Esempio 1: questo esempio elimina un’attivazione. Se il comando va a buon fine, non viene generato output.

Remove-SSMActivation -ActivationId "08e51e79-1e36-446c-8e63-9458569c1363"

• Per informazioni dettagliate sull’API, consulta DeleteActivation nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-SSMAssociation

L’esempio di codice seguente mostra come utilizzare Remove-SSMAssociation.

Strumenti per PowerShell V5

Esempio 1: questo esempio elimina l’associazione tra un’istanza e un documento. Se il comando va a buon fine, non viene generato output.

Remove-SSMAssociation -InstanceId "i-0cb2b964d3e14fd9f" -Name "AWS-UpdateSSMAgent"

• Per informazioni dettagliate sull’API, consulta DeleteAssociation nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-SSMDocument

L’esempio di codice seguente mostra come utilizzare Remove-SSMDocument.

Strumenti per PowerShell V5

Esempio 1: questo esempio elimina un documento. Se il comando va a buon fine, non viene generato output.

Remove-SSMDocument -Name "RunShellScript"

• Per informazioni dettagliate sull’API, consulta DeleteDocument nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-SSMMaintenanceWindow

L’esempio di codice seguente mostra come utilizzare Remove-SSMMaintenanceWindow.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove una finestra di manutenzione.

Remove-SSMMaintenanceWindow -WindowId "mw-06d59c1a07c022145"

Output:

mw-06d59c1a07c022145

• Per informazioni dettagliate sull’API, consulta DeleteMaintenanceWindow nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-SSMParameter

L’esempio di codice seguente mostra come utilizzare Remove-SSMParameter.

Strumenti per PowerShell V5

Esempio 1: questo esempio elimina un parametro. Se il comando va a buon fine, non viene generato output.

Remove-SSMParameter -Name "helloWorld"

• Per informazioni dettagliate sull’API, consulta DeleteParameter nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-SSMPatchBaseline

L’esempio di codice seguente mostra come utilizzare Remove-SSMPatchBaseline.

Strumenti per PowerShell V5

Esempio 1: questo esempio elimina una baseline delle patch.

Remove-SSMPatchBaseline -BaselineId "pb-045f10b4f382baeda"

Output:

pb-045f10b4f382baeda

• Per informazioni dettagliate sull’API, consulta DeletePatchBaseline nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Remove-SSMResourceTag

L’esempio di codice seguente mostra come utilizzare Remove-SSMResourceTag.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove un tag da una finestra di manutenzione. Se il comando va a buon fine, non viene generato output.

Remove-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -TagKey "Production"

• Per informazioni dettagliate sull’API, consulta RemoveTagsFromResource nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Send-SSMCommand

L’esempio di codice seguente mostra come utilizzare Send-SSMCommand.

Strumenti per PowerShell V5

Esempio 1: questo esempio esegue un comando echo su un’istanza di destinazione.

Send-SSMCommand -DocumentName "AWS-RunPowerShellScript" -Parameter @{commands = "echo helloWorld"} -Target @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")}

Output:

CommandId          : d8d190fc-32c1-4d65-a0df-ff5ff3965524
Comment            : 
CompletedCount     : 0
DocumentName       : AWS-RunPowerShellScript
ErrorCount         : 0
ExpiresAfter       : 3/7/2017 10:48:37 PM
InstanceIds        : {}
MaxConcurrency     : 50
MaxErrors          : 0
NotificationConfig : Amazon.SimpleSystemsManagement.Model.NotificationConfig
OutputS3BucketName : 
OutputS3KeyPrefix  : 
OutputS3Region     : 
Parameters         : {[commands, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]}
RequestedDateTime  : 3/7/2017 9:48:37 PM
ServiceRole        : 
Status             : Pending
StatusDetails      : Pending
TargetCount        : 0
Targets            : {instanceids}

Esempio 2: questo esempio mostra come eseguire un comando che accetta parametri annidati.

Send-SSMCommand -DocumentName "AWS-RunRemoteScript" -Parameter @{ sourceType="GitHub";sourceInfo='{"owner": "me","repository": "amazon-ssm","path": "Examples/Install-Win32OpenSSH"}'; "commandLine"=".\Install-Win32OpenSSH.ps1"} -InstanceId i-0cb2b964d3e14fd9f

• Per informazioni dettagliate sull’API, consulta SendCommand nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Start-SSMAutomationExecution

L’esempio di codice seguente mostra come utilizzare Start-SSMAutomationExecution.

Strumenti per PowerShell V5

Esempio 1: questo esempio esegue un documento che specifica un ruolo di automazione, un ID di origine AMI e un ruolo di istanza Amazon EC2.

Start-SSMAutomationExecution -DocumentName AWS-UpdateLinuxAmi -Parameter @{'AutomationAssumeRole'='arn:aws:iam::123456789012:role/SSMAutomationRole';'SourceAmiId'='ami-f173cc91';'InstanceIamRole'='EC2InstanceRole'}

Output:

3a532a4f-0382-11e7-9df7-6f11185f6dd1

• Per informazioni dettagliate sull’API, consulta StartAutomationExecution nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Start-SSMSession

L’esempio di codice seguente mostra come utilizzare Start-SSMSession.

Strumenti per PowerShell V5

Esempio 1: questo esempio avvia una connessione a una destinazione per una sessione di Session Manager, abilitando il port forwarding. Nota: è necessario aggiungere il parametro Region se non è già stato impostato mediante AWSCredentials.

Start-SSMSession -Target 'i-064578e5e7454488f' -DocumentName 'AWS-StartPortForwardingSession' -Parameter @{ localPortNumber = '8080'; portNumber = '80' } -Region 'us-west-1'

Output:

Starting session with SessionId: testUser-xi4glew849asyeryde34u4dfsdfy
Port 8080 opened for sessionId testUser-xi4glew849asyeryde34u4dfsdfy.
Waiting for connections...

Esempio 2: questo esempio crea una sessione interattiva con un’istanza specificata per una sessione di Session Manager.

Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1'

Output:

Starting session with SessionId : testUser-xi4glew849asyeryde34u4dfsdfy
Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.
                                                                                                                                                                                                
Install the latest PowerShell for new features and improvements!
                                                                                                                                                      
PS C:\Windows\system32> whoami
ec2amaz-fnsdrwv\ec2-test-user
PS C:\Windows\system32>

Esempio 3: questo esempio crea una sessione senza connessione e restituisce le proprietà SessionId, StreamUrl e TokenValue necessarie per connettersi alla sessione.

Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1' -DisablePluginInvocation

Output:

SessionId        : testUser-xi4glew849asyeryde34u4dfsdfy
StreamUrl        : {StreamUrl value redacted}
TokenValue       : {Token value redacted}
ContentLength    : 1207
HttpStatusCode   : OK

• Per informazioni dettagliate sull’API, consulta StartSession nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Stop-SSMAutomationExecution

L’esempio di codice seguente mostra come utilizzare Stop-SSMAutomationExecution.

Strumenti per PowerShell V5

Esempio 1: questo esempio interrompe un’esecuzione di automazione. Se il comando va a buon fine, non viene generato output.

Stop-SSMAutomationExecution -AutomationExecutionId "4105a4fc-f944-11e6-9d32-8fb2db27a909"

• Per informazioni dettagliate sull’API, consulta StopAutomationExecution nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Stop-SSMCommand

L’esempio di codice seguente mostra come utilizzare Stop-SSMCommand.

Strumenti per PowerShell V5

Esempio 1: questo esempio tenta di annullare un comando. Se l’operazione va a buon fine, non viene generato output.

Stop-SSMCommand -CommandId "9ded293e-e792-4440-8e3e-7b8ec5feaa38"

• Per informazioni dettagliate sull’API, consulta CancelCommand nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Unregister-SSMManagedInstance

L’esempio di codice seguente mostra come utilizzare Unregister-SSMManagedInstance.

Strumenti per PowerShell V5

Esempio 1: questo esempio annulla la registrazione di un’istanza gestita. Se il comando va a buon fine, non viene generato output.

Unregister-SSMManagedInstance -InstanceId "mi-08ab247cdf1046573"

• Per informazioni dettagliate sull’API, consulta DeregisterManagedInstance nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Unregister-SSMPatchBaselineForPatchGroup

L’esempio di codice seguente mostra come utilizzare Unregister-SSMPatchBaselineForPatchGroup.

Strumenti per PowerShell V5

Esempio 1: questo esempio annulla la registrazione di un gruppo di patch da una baseline delle patch.

Unregister-SSMPatchBaselineForPatchGroup -BaselineId "pb-045f10b4f382baeda" -PatchGroup "Production"

Output:

BaselineId           PatchGroup
----------           ----------
pb-045f10b4f382baeda Production

• Per informazioni dettagliate sull’API, consulta DeregisterPatchBaselineForPatchGroup nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Unregister-SSMTargetFromMaintenanceWindow

L’esempio di codice seguente mostra come utilizzare Unregister-SSMTargetFromMaintenanceWindow.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove una destinazione da una finestra di manutenzione.

Unregister-SSMTargetFromMaintenanceWindow -WindowTargetId "6ab5c208-9fc4-4697-84b7-b02a6cc25f7d" -WindowId "mw-06cf17cbefcb4bf4f"

Output:

WindowId             WindowTargetId
--------             --------------
mw-06cf17cbefcb4bf4f 6ab5c208-9fc4-4697-84b7-b02a6cc25f7d

• Per informazioni dettagliate sull’API, consulta DeregisterTargetFromMaintenanceWindow nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Unregister-SSMTaskFromMaintenanceWindow

L’esempio di codice seguente mostra come utilizzare Unregister-SSMTaskFromMaintenanceWindow.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove un’attività da una finestra di manutenzione.

Unregister-SSMTaskFromMaintenanceWindow -WindowTaskId "f34a2c47-ddfd-4c85-a88d-72366b69af1b" -WindowId "mw-03a342e62c96d31b0"

Output:

WindowId             WindowTaskId
--------             ------------
mw-03a342e62c96d31b0 f34a2c47-ddfd-4c85-a88d-72366b69af1b

• Per informazioni dettagliate sull’API, consulta DeregisterTaskFromMaintenanceWindow nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Update-SSMAssociation

L’esempio di codice seguente mostra come utilizzare Update-SSMAssociation.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiorna un’associazione con una nuova versione del documento.

Update-SSMAssociation -AssociationId "93285663-92df-44cb-9f26-2292d4ecc439" -DocumentVersion "1"

Output:

Name                  : AWS-UpdateSSMAgent
InstanceId            :
Date                  : 3/1/2017 6:22:21 PM
Status.Name           :
Status.Date           :
Status.Message        :
Status.AdditionalInfo :

• Per informazioni dettagliate sull’API, consulta UpdateAssociation nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Update-SSMAssociationStatus

L’esempio di codice seguente mostra come utilizzare Update-SSMAssociationStatus.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiorna lo stato dell’associazione tra un’istanza e un documento di configurazione.

Update-SSMAssociationStatus -Name "AWS-UpdateSSMAgent" -InstanceId "i-0000293ffd8c57862" -AssociationStatus_Date "2015-02-20T08:31:11Z" -AssociationStatus_Name "Pending" -AssociationStatus_Message "temporary_status_change" -AssociationStatus_AdditionalInfo "Additional-Config-Needed"

Output:

Name                  : AWS-UpdateSSMAgent
InstanceId            : i-0000293ffd8c57862
Date                  : 2/23/2017 6:55:22 PM
Status.Name           : Pending
Status.Date           : 2/20/2015 8:31:11 AM
Status.Message        : temporary_status_change
Status.AdditionalInfo : Additional-Config-Needed

• Per informazioni dettagliate sull’API, consulta UpdateAssociationStatus nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Update-SSMDocument

L’esempio di codice seguente mostra come utilizzare Update-SSMDocument.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea una nuova versione di un documento con il contenuto aggiornato del file json specificato. Il documento deve essere in formato JSON. È possibile ottenere la versione del documento con il cmdlet “Get-SSMDocumentVersionList”.

Update-SSMDocument -Name RunShellScript -DocumentVersion "1" -Content (Get-Content -Raw "c:\temp\RunShellScript.json")

Output:

CreatedDate     : 3/1/2017 2:59:17 AM
DefaultVersion  : 1
Description     : Run an updated script
DocumentType    : Command
DocumentVersion : 2
Hash            : 1d5ce820e999ff051eb4841ed887593daf77120fd76cae0d18a53cc42e4e22c1
HashType        : Sha256
LatestVersion   : 2
Name            : RunShellScript
Owner           : 809632081692
Parameters      : {commands}
PlatformTypes   : {Linux}
SchemaVersion   : 2.0
Sha1            :
Status          : Updating

• Per informazioni dettagliate sull’API, consulta UpdateDocument nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Update-SSMDocumentDefaultVersion

L’esempio di codice seguente mostra come utilizzare Update-SSMDocumentDefaultVersion.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiorna la versione predefinita di un documento. È possibile ottenere le versioni dei documenti disponibili con il cmdlet “Get-SSMDocumentVersionList”.

Update-SSMDocumentDefaultVersion -Name "RunShellScript" -DocumentVersion "2"

Output:

DefaultVersion Name
-------------- ----
2              RunShellScript

• Per informazioni dettagliate sull’API, consulta UpdateDocumentDefaultVersion nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Update-SSMMaintenanceWindow

L’esempio di codice seguente mostra come utilizzare Update-SSMMaintenanceWindow.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiorna il nome di una finestra di manutenzione.

Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Name "My-Renamed-MW"

Output:

AllowUnassociatedTargets : False
Cutoff                   : 1
Duration                 : 2
Enabled                  : True
Name                     : My-Renamed-MW
Schedule                 : cron(0 */30 * * * ? *)
WindowId                 : mw-03eb9db42890fb82d

Esempio 2: questo esempio abilita una finestra di manutenzione.

Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Enabled $true

Output:

AllowUnassociatedTargets : False
Cutoff                   : 1
Duration                 : 2
Enabled                  : True
Name                     : My-Renamed-MW
Schedule                 : cron(0 */30 * * * ? *)
WindowId                 : mw-03eb9db42890fb82d

Esempio 3: questo esempio disabilita una finestra di manutenzione.

Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Enabled $false

Output:

AllowUnassociatedTargets : False
Cutoff                   : 1
Duration                 : 2
Enabled                  : False
Name                     : My-Renamed-MW
Schedule                 : cron(0 */30 * * * ? *)
WindowId                 : mw-03eb9db42890fb82d

• Per informazioni dettagliate sull’API, consulta UpdateMaintenanceWindow nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Update-SSMManagedInstanceRole

L’esempio di codice seguente mostra come utilizzare Update-SSMManagedInstanceRole.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiorna il ruolo di un’istanza gestita. Se il comando va a buon fine, non viene generato output.

Update-SSMManagedInstanceRole -InstanceId "mi-08ab247cdf1046573" -IamRole "AutomationRole"

• Per informazioni dettagliate sull’API, consulta UpdateManagedInstanceRole nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Update-SSMPatchBaseline

L’esempio di codice seguente mostra come utilizzare Update-SSMPatchBaseline.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiunge due patch come rifiutate e una patch approvata a una baseline delle patch esistente.

Update-SSMPatchBaseline -BaselineId "pb-03da896ca3b68b639" -RejectedPatch "KB2032276","MS10-048" -ApprovedPatch "KB2124261"

Output:

ApprovalRules   : Amazon.SimpleSystemsManagement.Model.PatchRuleGroup
ApprovedPatches : {KB2124261}
BaselineId      : pb-03da896ca3b68b639
CreatedDate     : 3/3/2017 5:02:19 PM
Description     : Baseline containing all updates approved for production systems
GlobalFilters   : Amazon.SimpleSystemsManagement.Model.PatchFilterGroup
ModifiedDate    : 3/3/2017 5:22:10 PM
Name            : Production-Baseline
RejectedPatches : {KB2032276, MS10-048}

• Per informazioni dettagliate sull’API, consulta UpdatePatchBaseline nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Write-SSMComplianceItem

L’esempio di codice seguente mostra come utilizzare Write-SSMComplianceItem.

Strumenti per PowerShell V5

Esempio 1: questo esempio scrive un elemento di conformità personalizzato per l’istanza gestita specificata

$item = [Amazon.SimpleSystemsManagement.Model.ComplianceItemEntry]::new()
$item.Id = "07Jun2019-3"
$item.Severity="LOW"
$item.Status="COMPLIANT"
$item.Title="Fin-test-1 - custom"
Write-SSMComplianceItem -ResourceId mi-012dcb3ecea45b678 -ComplianceType Custom:VSSCompliant2 -ResourceType ManagedInstance -Item $item -ExecutionSummary_ExecutionTime "07-Jun-2019"

• Per informazioni dettagliate sull’API, consulta PutComplianceItems nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Write-SSMInventory

L’esempio di codice seguente mostra come utilizzare Write-SSMInventory.

Strumenti per PowerShell V5

Esempio 1: questo esempio assegna le informazioni sulla posizione del rack a un’istanza. Se il comando va a buon fine, non viene generato output.

$data = New-Object "System.Collections.Generic.Dictionary[System.String,System.String]"
$data.Add("RackLocation", "Bay B/Row C/Rack D/Shelf F")

$items = New-Object "System.Collections.Generic.List[System.Collections.Generic.Dictionary[System.String, System.String]]"
$items.Add($data)

$customInventoryItem = New-Object Amazon.SimpleSystemsManagement.Model.InventoryItem
$customInventoryItem.CaptureTime = "2016-08-22T10:01:01Z"
$customInventoryItem.Content = $items
$customInventoryItem.TypeName = "Custom:TestRackInfo2"
$customInventoryItem.SchemaVersion = "1.0"

$inventoryItems = @($customInventoryItem)

Write-SSMInventory -InstanceId "i-0cb2b964d3e14fd9f" -Item $inventoryItems

• Per informazioni dettagliate sull’API, consulta PutInventory nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Write-SSMParameter

L’esempio di codice seguente mostra come utilizzare Write-SSMParameter.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un parametro. Se il comando va a buon fine, non viene generato output.

Write-SSMParameter -Name "Welcome" -Type "String" -Value "helloWorld"

Esempio 2: questo esempio modifica un parametro. Se il comando va a buon fine, non viene generato output.

Write-SSMParameter -Name "Welcome" -Type "String" -Value "Good day, Sunshine!" -Overwrite $true

• Per informazioni dettagliate sull’API, consulta PutParameter nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).