La version 5 (V5) du Outils AWS pour PowerShell est sortie \$1
Pour plus d'informations sur les modifications majeures et la migration de vos applications, consultez la [rubrique relative à la migration](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples de Systems Manager utilisant Tools for PowerShell V5
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la Outils AWS pour PowerShell V5 avec Systems Manager.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `Add-SSMResourceTag`
L'exemple de code suivant montre comment utiliser`Add-SSMResourceTag`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple met à jour une fenêtre de maintenance avec de nouvelles balises. Il n’y a pas de sortie si la commande réussit. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$option1 = @{Key="Stack";Value=@("Production")}
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $option1
```
**Exemple 2 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer chaque balise. Il n’y a pas de sortie si la commande réussit.**
```
$tag1 = New-Object Amazon.SimpleSystemsManagement.Model.Tag
$tag1.Key = "Stack"
$tag1.Value = "Production"
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $tag1
```
+ Pour plus de détails sur l'API, reportez-vous [AddTagsToResource](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Edit-SSMDocumentPermission`
L'exemple de code suivant montre comment utiliser`Edit-SSMDocumentPermission`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple ajoute des autorisations de « partage » à tous les comptes pour un document. Il n’y a pas de sortie si la commande réussit.**
```
Edit-SSMDocumentPermission -Name "RunShellScript" -PermissionType "Share" -AccountIdsToAdd all
```
**Exemple 2 : cet exemple ajoute des autorisations de « partage » à un compte spécifique pour un document. Il n’y a pas de sortie si la commande réussit.**
```
Edit-SSMDocumentPermission -Name "RunShellScriptNew" -PermissionType "Share" -AccountIdsToAdd "123456789012"
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyDocumentPermission](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMActivation`
L'exemple de code suivant montre comment utiliser`Get-SSMActivation`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple fournit des détails sur les activations de votre compte.**
```
Get-SSMActivation
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeActivations](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMAssociation`
L'exemple de code suivant montre comment utiliser`Get-SSMAssociation`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple décrit l’association entre une instance et un document.**
```
Get-SSMAssociation -InstanceId "i-0000293ffd8c57862" -Name "AWS-UpdateSSMAgent"
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAssociation](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMAssociationExecution`
L'exemple de code suivant montre comment utiliser`Get-SSMAssociationExecution`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple renvoie les exécutions pour l’identifiant d’association fourni**
```
Get-SSMAssociationExecution -AssociationId 123a45a0-c678-9012-3456-78901234db5e
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAssociationExecutions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMAssociationExecutionTarget`
L'exemple de code suivant montre comment utiliser`Get-SSMAssociationExecutionTarget`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple affiche l’identifiant de la ressource et son statut d’exécution qui font partie des cibles d’exécution de l’association**
```
Get-SSMAssociationExecutionTarget -AssociationId 123a45a0-c678-9012-3456-78901234db5e -ExecutionId 123a45a0-c678-9012-3456-78901234db5e | Select-Object ResourceId, Status
```
**Sortie** :
```
ResourceId Status
---------- ------
i-0b1b2a3456f7a890b Success
i-01c12a45d6fc7a89f Success
i-0a1caf234f56d7dc8 Success
i-012a3fd45af6dbcfe Failed
i-0ddc1df23c4a5fb67 Success
```
**Exemple 2 : cette commande vérifie l’exécution particulière d’une automatisation particulière depuis hier, où un document de commande est associé. Elle vérifie également si l’exécution de l’association a échoué, et si c’est le cas, elle affiche les détails de l’invocation de la commande pour l’exécution ainsi que l’identifiant de l’instance**
```
$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
}
}
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAssociationExecutionTargets](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMAssociationList`
L'exemple de code suivant montre comment utiliser`Get-SSMAssociationList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie toutes les associations pour une instance. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$filter1 = @{Key="InstanceId";Value=@("i-0000293ffd8c57862")}
Get-SSMAssociationList -AssociationFilterList $filter1
```
**Sortie** :
```
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}
```
**Exemple 2 : cet exemple répertorie toutes les associations pour un document de configuration. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$filter2 = @{Key="Name";Value=@("AWS-UpdateSSMAgent")}
Get-SSMAssociationList -AssociationFilterList $filter2
```
**Sortie** :
```
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}
```
**Exemple 3 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer chaque filtre.**
```
$filter1 = New-Object Amazon.SimpleSystemsManagement.Model.AssociationFilter
$filter1.Key = "InstanceId"
$filter1.Value = "i-0000293ffd8c57862"
Get-SSMAssociationList -AssociationFilterList $filter1
```
**Sortie** :
```
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}
```
+ Pour plus de détails sur l'API, reportez-vous [ListAssociations](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMAssociationVersionList`
L'exemple de code suivant montre comment utiliser`Get-SSMAssociationVersionList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple permet de récupérer toutes les versions de l’association fournie.**
```
Get-SSMAssociationVersionList -AssociationId 123a45a0-c678-9012-3456-78901234db5e
```
**Sortie** :
```
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}
```
+ Pour plus de détails sur l'API, reportez-vous [ListAssociationVersions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMAutomationExecution`
L'exemple de code suivant montre comment utiliser`Get-SSMAutomationExecution`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple affiche les détails d’une exécution d’automatisation.**
```
Get-SSMAutomationExecution -AutomationExecutionId "4105a4fc-f944-11e6-9d32-8fb2db27a909"
```
**Sortie** :
```
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...}
```
**Exemple 2 : cet exemple répertorie les détails des étapes pour l’ID d’exécution d’automatisation donné**
```
Get-SSMAutomationExecution -AutomationExecutionId e1d2bad3-4567-8901-ae23-456c7c8901be | Select-Object -ExpandProperty StepExecutions | Select-Object StepName, Action, StepStatus, ValidNextSteps
```
**Sortie** :
```
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 {}
```
+ Pour plus de détails sur l'API, reportez-vous [GetAutomationExecution](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMAutomationExecutionList`
L'exemple de code suivant montre comment utiliser`Get-SSMAutomationExecutionList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple décrit toutes les exécutions d’automatisation actives et résiliées associées à votre compte.**
```
Get-SSMAutomationExecutionList
```
**Sortie** :
```
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]]}
```
**Exemple 2 : cet exemple affiche l'ExecutionID, le document et l' start/end horodatage d'exécution pour les exécutions dont la valeur n'est pas « AutomationExecutionStatus Success »**
```
Get-SSMAutomationExecutionList | Where-Object AutomationExecutionStatus -ne "Success" | Select-Object AutomationExecutionId, DocumentName, AutomationExecutionStatus, ExecutionStartTime, ExecutionEndTime | Format-Table -AutoSize
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAutomationExecutions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMAutomationStepExecution`
L'exemple de code suivant montre comment utiliser`Get-SSMAutomationStepExecution`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple affiche des informations sur toutes les exécutions d’étapes actives et résiliées d’un flux de travail d’automatisation.**
```
Get-SSMAutomationStepExecution -AutomationExecutionId e1d2bad3-4567-8901-ae23-456c7c8901be | Select-Object StepName, Action, StepStatus
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAutomationStepExecutions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMAvailablePatch`
L'exemple de code suivant montre comment utiliser`Get-SSMAvailablePatch`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple permet d’obtenir tous les correctifs disponibles pour Windows Server 2012 dont la sévérité MSRC est Critique. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$filter1 = @{Key="PRODUCT";Values=@("WindowsServer2012")}
$filter2 = @{Key="MSRC_SEVERITY";Values=@("Critical")}
Get-SSMAvailablePatch -Filter $filter1,$filter2
```
**Sortie** :
```
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
...
```
**Exemple 2 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer chaque filtre.**
```
$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
```
**Exemple 3 : Cet exemple récupère toutes les mises à jour publiées au cours des 20 derniers jours et applicables aux produits correspondant WindowsServer à 2019**
```
Get-SSMAvailablePatch | Where-Object ReleaseDate -ge (Get-Date).AddDays(-20) | Where-Object Product -eq "WindowsServer2019" | Select-Object ReleaseDate, Product, Title
```
**Sortie** :
```
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)
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAvailablePatches](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMCommand`
L'exemple de code suivant montre comment utiliser`Get-SSMCommand`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie toutes les commandes demandées.**
```
Get-SSMCommand
```
**Sortie** :
```
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 : {}
```
**Exemple 2 : cet exemple permet d’obtenir le statut d’une commande spécifique.**
```
Get-SSMCommand -CommandId "4b75a163-d39a-4d97-87c9-98ae52c6be35"
```
**Exemple 3 : cet exemple récupère toutes les commandes SSM invoquées après 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
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [ListCommands](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMCommandInvocation`
L'exemple de code suivant montre comment utiliser`Get-SSMCommandInvocation`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie toutes les invocations d’une commande.**
```
Get-SSMCommandInvocation -CommandId "b8eac879-0541-439d-94ec-47a80d554f44" -Detail $true
```
**Sortie** :
```
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 :
```
**Exemple 2 : Cet exemple répertorie CommandPlugins pour l'invocation de l'identifiant de commande e1eb2e3c-ed4c-5123-45c1-234f5612345f**
```
Get-SSMCommandInvocation -CommandId e1eb2e3c-ed4c-5123-45c1-234f5612345f -Detail:$true | Select-Object -ExpandProperty CommandPlugins
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [ListCommandInvocations](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMCommandInvocationDetail`
L'exemple de code suivant montre comment utiliser`Get-SSMCommandInvocationDetail`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple affiche les détails d’une commande exécutée sur une instance.**
```
Get-SSMCommandInvocationDetail -InstanceId "i-0cb2b964d3e14fd9f" -CommandId "b8eac879-0541-439d-94ec-47a80d554f44"
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [GetCommandInvocation](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMComplianceItemList`
L'exemple de code suivant montre comment utiliser`Get-SSMComplianceItemList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les éléments de conformité pour l’identifiant et le type de ressource donnés, le type de conformité de filtrage étant « Association »**
```
Get-SSMComplianceItemList -ResourceId i-1a2caf345f67d0dc2 -ResourceType ManagedInstance -Filter @{Key="ComplianceType";Values="Association"}
```
**Sortie** :
```
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 :
```
+ Pour plus de détails sur l'API, reportez-vous [ListComplianceItems](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMComplianceSummaryList`
L'exemple de code suivant montre comment utiliser`Get-SSMComplianceSummaryList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple renvoie un récapitulatif des ressources conformes et non conformes pour tous les types de conformité.**
```
Get-SSMComplianceSummaryList
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [ListComplianceSummaries](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMConnectionStatus`
L'exemple de code suivant montre comment utiliser`Get-SSMConnectionStatus`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple récupère le statut de connexion de Session Manager pour une instance afin de déterminer si elle est connectée et prête à recevoir des connexions Session Manager. **
```
Get-SSMConnectionStatus -Target i-0a1caf234f12d3dc4
```
**Sortie** :
```
Status Target
------ ------
Connected i-0a1caf234f12d3dc4
```
+ Pour plus de détails sur l'API, reportez-vous [GetConnectionStatus](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMDefaultPatchBaseline`
L'exemple de code suivant montre comment utiliser`Get-SSMDefaultPatchBaseline`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple affiche le référentiel de correctifs par défaut.**
```
Get-SSMDefaultPatchBaseline
```
**Sortie** :
```
arn:aws:ssm:us-west-2:123456789012:patchbaseline/pb-04fb4ae6142167966
```
+ Pour plus de détails sur l'API, reportez-vous [GetDefaultPatchBaseline](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMDeployablePatchSnapshotForInstance`
L'exemple de code suivant montre comment utiliser`Get-SSMDeployablePatchSnapshotForInstance`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple affiche l’instantané actuel pour le référentiel de correctifs utilisé par une instance. Cette commande doit être exécutée à partir de l’instance en utilisant les informations d’identification de l’instance. Pour s’assurer qu’il utilise les informations d’identification de l’instance, l’exemple passe un objet `Amazon.Runtime.InstanceProfileAWSCredentials` au paramètre Credentials.**
```
$credentials = [Amazon.Runtime.InstanceProfileAWSCredentials]::new()
Get-SSMDeployablePatchSnapshotForInstance -SnapshotId "4681775b-098f-4435-a956-0ef33373ac11" -InstanceId "i-0cb2b964d3e14fd9f" -Credentials $credentials
```
**Sortie** :
```
InstanceId SnapshotDownloadUrl
---------- -------------------
i-0cb2b964d3e14fd9f https://patch-baseline-snapshot-us-west-2.s3-us-west-2.amazonaws.com/853d0d3db0f0cafe...1692/4681775b-098f-4435...
```
**Exemple 2 : Cet exemple montre comment obtenir le résultat complet SnapshotDownloadUrl. Cette commande doit être exécutée à partir de l’instance en utilisant les informations d’identification de l’instance. Pour s'assurer qu'elle utilise les informations d'identification de l'instance, l'exemple configure la PowerShell session pour qu'elle utilise un `Amazon.Runtime.InstanceProfileAWSCredentials` objet.**
```
Set-AWSCredential -Credential ([Amazon.Runtime.InstanceProfileAWSCredentials]::new())
(Get-SSMDeployablePatchSnapshotForInstance -SnapshotId "4681775b-098f-4435-a956-0ef33373ac11" -InstanceId "i-0cb2b964d3e14fd9f").SnapshotDownloadUrl
```
**Sortie** :
```
https://patch-baseline-snapshot-us-west-2.s3-us-west-2.amazonaws.com/853d0d3db0f0cafe...
```
+ Pour plus de détails sur l'API, reportez-vous [GetDeployablePatchSnapshotForInstance](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMDocument`
L'exemple de code suivant montre comment utiliser`Get-SSMDocument`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple renvoie le contenu d’un document.**
```
Get-SSMDocument -Name "RunShellScript"
```
**Sortie** :
```
Content
-------
{...
```
**Exemple 2 : cet exemple affiche le contenu complet d’un document.**
```
(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 }}"
}
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetDocument](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMDocumentDescription`
L'exemple de code suivant montre comment utiliser`Get-SSMDocumentDescription`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple renvoie des informations sur un document.**
```
Get-SSMDocumentDescription -Name "RunShellScript"
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeDocument](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMDocumentList`
L'exemple de code suivant montre comment utiliser`Get-SSMDocumentList`.
**Outils pour PowerShell V5**
**Exemple 1 : répertorie tous les documents de configuration de votre compte.**
```
Get-SSMDocumentList
```
**Sortie** :
```
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
...
```
**Exemple 2 : cet exemple récupère tous les documents d’automatisation dont le nom correspond à ’Plateforme’**
```
Get-SSMDocumentList -DocumentFilterList @{Key="DocumentType";Value="Automation"} | Where-Object Name -Match "Platform"
```
**Sortie** :
```
DocumentFormat : JSON
DocumentType : Automation
DocumentVersion : 7
Name : KT-Get-Platform
Owner : 987654123456
PlatformTypes : {Windows, Linux}
SchemaVersion : 0.3
Tags : {}
TargetType :
VersionName :
```
+ Pour plus de détails sur l'API, reportez-vous [ListDocuments](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMDocumentPermission`
L'exemple de code suivant montre comment utiliser`Get-SSMDocumentPermission`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie toutes les versions pour un document.**
```
Get-SSMDocumentVersionList -Name "RunShellScript"
```
**Sortie** :
```
CreatedDate DocumentVersion IsDefaultVersion Name
----------- --------------- ---------------- ----
2/24/2017 5:25:13 AM 1 True RunShellScript
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeDocumentPermission](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMDocumentVersionList`
L'exemple de code suivant montre comment utiliser`Get-SSMDocumentVersionList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie toutes les versions pour un document.**
```
Get-SSMDocumentVersionList -Name "AWS-UpdateSSMAgent"
```
**Sortie** :
```
CreatedDate : 6/1/2021 5:19:10 PM
DocumentFormat : JSON
DocumentVersion : 1
IsDefaultVersion : True
Name : AWS-UpdateSSMAgent
Status : Active
```
+ Pour plus de détails sur l'API, reportez-vous [ListDocumentVersions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMEffectiveInstanceAssociationList`
L'exemple de code suivant montre comment utiliser`Get-SSMEffectiveInstanceAssociationList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple décrit les associations effectives d’une instance.**
```
Get-SSMEffectiveInstanceAssociationList -InstanceId "i-0000293ffd8c57862" -MaxResult 5
```
**Sortie** :
```
AssociationId Content
------------- -------
d8617c07-2079-4c18-9847-1655fc2698b0 {...
```
**Exemple 2 : cet exemple affiche le contenu des associations effectives d’une instance.**
```
(Get-SSMEffectiveInstanceAssociationList -InstanceId "i-0000293ffd8c57862" -MaxResult 5).Content
```
**Sortie** :
```
{
"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 }}"
}
]
}
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEffectiveInstanceAssociations](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMEffectivePatchesForPatchBaseline`
L'exemple de code suivant montre comment utiliser`Get-SSMEffectivePatchesForPatchBaseline`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie toutes les référentiels de correctifs, avec une liste de résultats maximale de 1.**
```
Get-SSMEffectivePatchesForPatchBaseline -BaselineId "pb-0a2f1059b670ebd31" -MaxResult 1
```
**Sortie** :
```
Patch PatchStatus
----- -----------
Amazon.SimpleSystemsManagement.Model.Patch Amazon.SimpleSystemsManagement.Model.PatchStatus
```
**Exemple 2 : cet exemple affiche le statut des correctifs pour tous les référentiels de correctifs, avec une liste de résultats maximale de 1.**
```
(Get-SSMEffectivePatchesForPatchBaseline -BaselineId "pb-0a2f1059b670ebd31" -MaxResult 1).PatchStatus
```
**Sortie** :
```
ApprovalDate DeploymentStatus
------------ ----------------
12/21/2010 6:00:00 PM APPROVED
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEffectivePatchesForPatchBaseline](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMInstanceAssociationsStatus`
L'exemple de code suivant montre comment utiliser`Get-SSMInstanceAssociationsStatus`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple montre les détails des associations d’une instance.**
```
Get-SSMInstanceAssociationsStatus -InstanceId "i-0000293ffd8c57862"
```
**Sortie** :
```
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
```
**Exemple 2 : cet exemple contrôle le statut des associations de l’instance pour l’ID d’instance donné et affiche ensuite le statut d’exécution de ces associations**
```
Get-SSMInstanceAssociationsStatus -InstanceId i-012e3cb4df567e8aa | ForEach-Object {Get-SSMAssociationExecution -AssociationId .AssociationId}
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstanceAssociationsStatus](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMInstanceInformation`
L'exemple de code suivant montre comment utiliser`Get-SSMInstanceInformation`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple montre les détails de chacune de vos instances.**
```
Get-SSMInstanceInformation
```
**Sortie** :
```
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
```
**Exemple 2 : Cet exemple montre comment utiliser le paramètre -Filter pour filtrer les résultats uniquement en fonction des instances de AWS Systems Manager situées dans une région `us-east-1` avec un `AgentVersion` de`2.2.800.0`. Vous trouverez une liste des valeurs de clé -Filter valides dans la rubrique de référence de l' InstanceInformation API (https://docs.aws.amazon.com/systems-manager/latest/APIReference/API\$1 InstanceInformation .html \$1systemsmanager -Type- -InstanceInformation). ActivationId**
```
$Filters = @{
Key="AgentVersion"
Values="2.2.800.0"
}
Get-SSMInstanceInformation -Region us-east-1 -Filter $Filters
```
**Sortie** :
```
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
```
**Exemple 3 : Cet exemple montre comment utiliser le InstanceInformationFilterList paramètre - pour filtrer les résultats uniquement en fonction des instances `PlatformTypes` de AWS Systems Manager situées dans `us-east-1` une région avec `Windows` ou`Linux`. Vous trouverez une liste des valeurs InstanceInformationFilterList clés valides dans la rubrique de référence de l' InstanceInformationFilter API (https://docs.aws.amazon.com/systems-manager/latest/APIReference/API\$1 InstanceInformationFilter .html).**
```
$Filters = @{
Key="PlatformTypes"
ValueSet=("Windows","Linux")
}
Get-SSMInstanceInformation -Region us-east-1 -InstanceInformationFilterList $Filters
```
**Sortie** :
```
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
```
**Exemple 4 : Cet exemple répertorie les instances gérées par SSM et les exportations InstanceId PingStatus, LastPingDateTime et PlatformName vers un fichier csv.**
```
Get-SSMInstanceInformation | Select-Object InstanceId, PingStatus, LastPingDateTime, PlatformName | Export-Csv Instance-details.csv -NoTypeInformation
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstanceInformation](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMInstancePatch`
L'exemple de code suivant montre comment utiliser`Get-SSMInstancePatch`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple permet d’obtenir les détails de la conformité des correctifs pour une instance.**
```
Get-SSMInstancePatch -InstanceId "i-08ee91c0b17045407"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstancePatches](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMInstancePatchState`
L'exemple de code suivant montre comment utiliser`Get-SSMInstancePatchState`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple permet d’obtenir les états récapitulatifs des correctifs pour une instance.**
```
Get-SSMInstancePatchState -InstanceId "i-08ee91c0b17045407"
```
**Exemple 2 : cet exemple permet d’obtenir les états récapitulatifs des correctifs pour deux instances.**
```
Get-SSMInstancePatchState -InstanceId "i-08ee91c0b17045407","i-09a618aec652973a9"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstancePatchStates](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMInstancePatchStatesForPatchGroup`
L'exemple de code suivant montre comment utiliser`Get-SSMInstancePatchStatesForPatchGroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple permet d’obtenir les états récapitulatifs des correctifs par instance pour un groupe de correctifs.**
```
Get-SSMInstancePatchStatesForPatchGroup -PatchGroup "Production"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstancePatchStatesForPatchGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMInventory`
L'exemple de code suivant montre comment utiliser`Get-SSMInventory`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple permet d’obtenir les métadonnées personnalisées de votre inventaire.**
```
Get-SSMInventory
```
**Sortie** :
```
Data Id
---- --
{[AWS:InstanceInformation, Amazon.SimpleSystemsManagement.Model.InventoryResultItem]} i-0cb2b964d3e14fd9f
```
+ Pour plus de détails sur l'API, reportez-vous [GetInventory](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMInventoryEntriesList`
L'exemple de code suivant montre comment utiliser`Get-SSMInventoryEntriesList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie toutes les entrées d’inventaire personnalisées d’une instance.**
```
Get-SSMInventoryEntriesList -InstanceId "i-0cb2b964d3e14fd9f" -TypeName "Custom:RackInfo"
```
**Sortie** :
```
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
```
**Exemple 2 : cet exemple répertorie les détails.**
```
(Get-SSMInventoryEntriesList -InstanceId "i-0cb2b964d3e14fd9f" -TypeName "Custom:RackInfo").Entries
```
**Sortie** :
```
Key Value
--- -----
RackLocation Bay B/Row C/Rack D/Shelf E
```
+ Pour plus de détails sur l'API, reportez-vous [ListInventoryEntries](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMInventoryEntryList`
L'exemple de code suivant montre comment utiliser`Get-SSMInventoryEntryList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple extrait des entrées d’inventaire de type `AWS:Network` pour l’instance.**
```
Get-SSMInventoryEntryList -InstanceId mi-088dcb0ecea37b076 -TypeName AWS:Network | Select-Object -ExpandProperty Entries
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, consultez la *référence des SSMInventory EntryList Outils AWS pour PowerShell applets de commande [Get-](https://docs.aws.amazon.com/powershell/v5/reference) in (V5)*.
### `Get-SSMInventorySchema`
L'exemple de code suivant montre comment utiliser`Get-SSMInventorySchema`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple renvoie une liste de noms de types d’inventaire pour le compte.**
```
Get-SSMInventorySchema
```
+ Pour plus de détails sur l'API, reportez-vous [GetInventorySchema](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMLatestEC2Image`
L'exemple de code suivant montre comment utiliser`Get-SSMLatestEC2Image`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple répertorie toutes les dernières versions de Windows AMIs.**
```
PS Get-SSMLatestEC2Image -Path ami-windows-latest
```
**Sortie** :
```
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
...
```
**Exemple 2 : cet exemple récupère l’ID AMI d’une image Amazon Linux spécifique pour la région us-west-2.**
```
PS Get-SSMLatestEC2Image -Path ami-amazon-linux-latest -ImageName amzn-ami-hvm-x86_64-ebs -Region us-west-2
```
**Sortie** :
```
ami-09b92cd132204c704
```
**Exemple 3 : Cet exemple répertorie toutes les dernières fenêtres AMIs correspondant à l'expression générique spécifiée.**
```
Get-SSMLatestEC2Image -Path ami-windows-latest -ImageName *Windows*2019*English*
```
**Sortie** :
```
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
...
```
+ Pour plus de détails sur l'API, voir [Get- SSMLatest EC2 Image](https://docs.aws.amazon.com/powershell/v5/reference) in *Outils AWS pour PowerShell Cmdlet Reference (V5)*.
### `Get-SSMMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindow`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple permet d’obtenir des informations sur une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d"
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [GetMaintenanceWindow](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMMaintenanceWindowExecution`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowExecution`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les informations relatives à une tâche exécutée dans le cadre de l’exécution d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowExecution -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [GetMaintenanceWindowExecution](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMMaintenanceWindowExecutionList`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowExecutionList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie toutes les exécutions pour une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d"
```
**Sortie** :
```
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
```
**Exemple 2 : cet exemple répertorie toutes les exécutions pour une fenêtre de maintenance avant une date spécifiée.**
```
$option1 = @{Key="ExecutedBefore";Values=@("2016-11-04T05:00:00Z")}
Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d" -Filter $option1
```
**Exemple 3 : cet exemple répertorie toutes les exécutions d’une fenêtre de maintenance après une date spécifiée.**
```
$option1 = @{Key="ExecutedAfter";Values=@("2016-11-04T05:00:00Z")}
Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d" -Filter $option1
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindowExecutions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMMaintenanceWindowExecutionTask`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowExecutionTask`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les informations relatives à une tâche qui fait partie de l’exécution d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowExecutionTask -TaskId "ac0c6ae1-daa3-4a89-832e-d384503b6586" -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [GetMaintenanceWindowExecutionTask](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMMaintenanceWindowExecutionTaskInvocationList`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowExecutionTaskInvocationList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les invocations d’une tâche exécutée dans le cadre de l’exécution d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowExecutionTaskInvocationList -TaskId "ac0c6ae1-daa3-4a89-832e-d384503b6586" -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Sortie** :
```
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 :
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindowExecutionTaskInvocations](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMMaintenanceWindowExecutionTaskList`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowExecutionTaskList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les tâches associées à l’exécution d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowExecutionTaskList -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindowExecutionTasks](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMMaintenanceWindowList`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie toutes les fenêtres de maintenance de votre compte.**
```
Get-SSMMaintenanceWindowList
```
**Sortie** :
```
Cutoff : 1
Duration : 4
Enabled : True
Name : My-First-Maintenance-Window
WindowId : mw-06d59c1a07c022145
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindows](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMMaintenanceWindowTarget`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowTarget`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie toutes les cibles d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowTarget -WindowId "mw-06cf17cbefcb4bf4f"
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindowTargets](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMMaintenanceWindowTaskList`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowTaskList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie toutes les tâches d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowTaskList -WindowId "mw-06cf17cbefcb4bf4f"
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindowTasks](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMParameterHistory`
L'exemple de code suivant montre comment utiliser`Get-SSMParameterHistory`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie l’historique des valeurs d’un paramètre.**
```
Get-SSMParameterHistory -Name "Welcome"
```
**Sortie** :
```
Description :
KeyId :
LastModifiedDate : 3/3/2017 6:55:25 PM
LastModifiedUser : arn:aws:iam::123456789012:user/admin
Name : Welcome
Type : String
Value : helloWorld
```
+ Pour plus de détails sur l'API, reportez-vous [GetParameterHistory](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMParameterList`
L'exemple de code suivant montre comment utiliser`Get-SSMParameterList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie tous les paramètres.**
```
Get-SSMParameterList
```
**Sortie** :
```
Description :
KeyId :
LastModifiedDate : 3/3/2017 6:58:23 PM
LastModifiedUser : arn:aws:iam::123456789012:user/admin
Name : Welcome
Type : String
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeParameters](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMParameterValue`
L'exemple de code suivant montre comment utiliser`Get-SSMParameterValue`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les valeurs d’un paramètre.**
```
Get-SSMParameterValue -Name "Welcome"
```
**Sortie** :
```
InvalidParameters Parameters
----------------- ----------
{} {Welcome}
```
**Exemple 2 : cet exemple répertorie les détails de la valeur.**
```
(Get-SSMParameterValue -Name "Welcome").Parameters
```
**Sortie** :
```
Name Type Value
---- ---- -----
Welcome String Good day, Sunshine!
```
+ Pour plus de détails sur l'API, reportez-vous [GetParameters](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMPatchBaseline`
L'exemple de code suivant montre comment utiliser`Get-SSMPatchBaseline`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie tous les référentiels de correctifs.**
```
Get-SSMPatchBaseline
```
**Sortie** :
```
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...
```
**Exemple 2 : Cet exemple répertorie toutes les lignes de base de correctifs fournies par AWS. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$filter1 = @{Key="OWNER";Values=@("AWS")}
```
**Sortie** :
```
Get-SSMPatchBaseline -Filter $filter1
```
**Exemple 3 : cet exemple répertorie tous les référentiels de correctifs dont vous êtes le propriétaire. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$filter1 = @{Key="OWNER";Values=@("Self")}
```
**Sortie** :
```
Get-SSMPatchBaseline -Filter $filter1
```
**Exemple 4 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer chaque balise.**
```
$filter1 = New-Object Amazon.SimpleSystemsManagement.Model.PatchOrchestratorFilter
$filter1.Key = "OWNER"
$filter1.Values = "AWS"
Get-SSMPatchBaseline -Filter $filter1
```
**Sortie** :
```
BaselineDescription BaselineId BaselineName DefaultBaselin
e
------------------- ---------- ------------ --------------
Default Patch Baseline Provided by AWS. arn:aws:ssm:us-west-2:123456789012:patchbaseline/pb-04fb4ae6142167966 AWS-DefaultPatchBaseline True
```
+ Pour plus de détails sur l'API, reportez-vous [DescribePatchBaselines](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMPatchBaselineDetail`
L'exemple de code suivant montre comment utiliser`Get-SSMPatchBaselineDetail`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple affiche les détails d’un référentiel de correctifs.**
```
Get-SSMPatchBaselineDetail -BaselineId "pb-03da896ca3b68b639"
```
**Sortie** :
```
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 : {}
```
+ Pour plus de détails sur l'API, reportez-vous [GetPatchBaseline](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMPatchBaselineForPatchGroup`
L'exemple de code suivant montre comment utiliser`Get-SSMPatchBaselineForPatchGroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple affiche le référentiel de correctifs pour un groupe de correctifs.**
```
Get-SSMPatchBaselineForPatchGroup -PatchGroup "Production"
```
**Sortie** :
```
BaselineId PatchGroup
---------- ----------
pb-045f10b4f382baeda Production
```
+ Pour plus de détails sur l'API, reportez-vous [GetPatchBaselineForPatchGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMPatchGroup`
L'exemple de code suivant montre comment utiliser`Get-SSMPatchGroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les enregistrements de groupes de correctifs.**
```
Get-SSMPatchGroup
```
**Sortie** :
```
BaselineIdentity PatchGroup
---------------- ----------
Amazon.SimpleSystemsManagement.Model.PatchBaselineIdentity Production
```
+ Pour plus de détails sur l'API, reportez-vous [DescribePatchGroups](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMPatchGroupState`
L'exemple de code suivant montre comment utiliser`Get-SSMPatchGroupState`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple permet d’obtenir le récapitulatif de haut niveau de la conformité des correctifs pour un groupe de correctifs.**
```
Get-SSMPatchGroupState -PatchGroup "Production"
```
**Sortie** :
```
Instances : 4
InstancesWithFailedPatches : 1
InstancesWithInstalledOtherPatches : 4
InstancesWithInstalledPatches : 3
InstancesWithMissingPatches : 0
InstancesWithNotApplicablePatches : 0
```
+ Pour plus de détails sur l'API, reportez-vous [DescribePatchGroupState](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMResourceComplianceSummaryList`
L'exemple de code suivant montre comment utiliser`Get-SSMResourceComplianceSummaryList`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple permet d’obtenir un récapitulatif du niveau des ressources. Le récapitulatif comprend des informations sur les statuts de conformité et de non-conformité ainsi que des comptes détaillés de la sévérité des éléments de conformité pour les produits qui correspondent à « Windows10 ». Comme la valeur MaxResult par défaut est 100 si le paramètre n'est pas spécifié et que cette valeur n'est pas valide, le MaxResult paramètre est ajouté et la valeur est définie sur 50.**
```
$FilterValues = @{
"Key"="Product"
"Type"="EQUAL"
"Values"="Windows10"
}
Get-SSMResourceComplianceSummaryList -Filter $FilterValues -MaxResult 50
```
+ Pour plus de détails sur l'API, reportez-vous [ListResourceComplianceSummaries](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-SSMResourceTag`
L'exemple de code suivant montre comment utiliser`Get-SSMResourceTag`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple répertorie les balises d’une fenêtre de maintenance.**
```
Get-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow"
```
**Sortie** :
```
Key Value
--- -----
Stack Production
```
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-SSMActivation`
L'exemple de code suivant montre comment utiliser`New-SSMActivation`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée une instance gérée.**
```
New-SSMActivation -DefaultInstanceName "MyWebServers" -IamRole "SSMAutomationRole" -RegistrationLimit 10
```
**Sortie** :
```
ActivationCode ActivationId
-------------- ------------
KWChhOxBTiwDcKE9BlKC 08e51e79-1e36-446c-8e63-9458569c1363
```
+ Pour plus de détails sur l'API, reportez-vous [CreateActivation](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-SSMAssociation`
L'exemple de code suivant montre comment utiliser`New-SSMAssociation`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple associe un document de configuration à une instance, en utilisant l'instance IDs.**
```
New-SSMAssociation -InstanceId "i-0cb2b964d3e14fd9f" -Name "AWS-UpdateSSMAgent"
```
**Sortie** :
```
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 :
```
**Exemple 2 : cet exemple associe un document de configuration à une instance, en utilisant des cibles.**
```
$target = @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")}
New-SSMAssociation -Name "AWS-UpdateSSMAgent" -Target $target
```
**Sortie** :
```
Name : AWS-UpdateSSMAgent
InstanceId :
Date : 3/1/2017 6:22:21 PM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
**Exemple 3 : cet exemple associe un document de configuration à une instance, en utilisant des cibles et des paramètres.**
```
$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
```
**Sortie** :
```
Name : Configure-CloudWatch
InstanceId :
Date : 5/17/2018 3:17:44 PM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
**Exemple 4 : cet exemple crée une association avec toutes les instances de la région, avec `AWS-GatherSoftwareInventory`. Il fournit également des fichiers personnalisés et des emplacements de registre dans les paramètres à collecter**
```
$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)"
```
**Sortie** :
```
Name : AWS-GatherSoftwareInventory
InstanceId :
Date : 6/9/2019 8:57:56 AM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
+ Pour plus de détails sur l'API, reportez-vous [CreateAssociation](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-SSMAssociationFromBatch`
L'exemple de code suivant montre comment utiliser`New-SSMAssociationFromBatch`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple associe un document de configuration à plusieurs instances. La sortie renvoie une liste des opérations réussies et échouées, le cas échéant.**
```
$option1 = @{InstanceId="i-0cb2b964d3e14fd9f";Name=@("AWS-UpdateSSMAgent")}
$option2 = @{InstanceId="i-0000293ffd8c57862";Name=@("AWS-UpdateSSMAgent")}
New-SSMAssociationFromBatch -Entry $option1,$option2
```
**Sortie** :
```
Failed Successful
------ ----------
{} {Amazon.SimpleSystemsManagement.Model.FailedCreateAssociation, Amazon.SimpleSystemsManagement.Model.FailedCreateAsso...
```
**Exemple 2 : cet exemple montre tous les détails d’une opération réussie.**
```
$option1 = @{InstanceId="i-0cb2b964d3e14fd9f";Name=@("AWS-UpdateSSMAgent")}
$option2 = @{InstanceId="i-0000293ffd8c57862";Name=@("AWS-UpdateSSMAgent")}
(New-SSMAssociationFromBatch -Entry $option1,$option2).Successful
```
+ Pour plus de détails sur l'API, reportez-vous [CreateAssociationBatch](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-SSMDocument`
L'exemple de code suivant montre comment utiliser`New-SSMDocument`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée un document dans votre compte. Le document doit être au format JSON. Pour plus d’informations sur la rédaction d’un document de configuration, consultez Document de configuration dans la Référence d’API SSM.**
```
New-SSMDocument -Content (Get-Content -Raw "c:\temp\RunShellScript.json") -Name "RunShellScript" -DocumentType "Command"
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [CreateDocument](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-SSMMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`New-SSMMaintenanceWindow`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée une nouvelle fenêtre de maintenance portant le nom spécifié, qui s’exécute tous les mardis à 16 heures pendant 4 heures, avec une coupure d’une heure, et qui autorise les cibles non associées.**
```
New-SSMMaintenanceWindow -Name "MyMaintenanceWindow" -Duration 4 -Cutoff 1 -AllowUnassociatedTarget $true -Schedule "cron(0 16 ? * TUE *)"
```
**Sortie** :
```
mw-03eb53e1ea7383998
```
+ Pour plus de détails sur l'API, reportez-vous [CreateMaintenanceWindow](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-SSMPatchBaseline`
L'exemple de code suivant montre comment utiliser`New-SSMPatchBaseline`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée un référentiel de correctifs qui approuve les correctifs, sept jours après qu’ils ont été publiés par Microsoft, pour les instances gérées qui exécutent Windows Server 2019 dans un environnement de production.**
```
$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
```
**Sortie** :
```
pb-0z4z6221c4296b23z
```
+ Pour plus de détails sur l'API, reportez-vous [CreatePatchBaseline](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Register-SSMDefaultPatchBaseline`
L'exemple de code suivant montre comment utiliser`Register-SSMDefaultPatchBaseline`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple enregistre un référentiel de correctifs en tant que référence de correctifs par défaut.**
```
Register-SSMDefaultPatchBaseline -BaselineId "pb-03da896ca3b68b639"
```
**Sortie** :
```
pb-03da896ca3b68b639
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterDefaultPatchBaseline](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Register-SSMPatchBaselineForPatchGroup`
L'exemple de code suivant montre comment utiliser`Register-SSMPatchBaselineForPatchGroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple enregistre un référentiel de correctifs pour un groupe de correctifs.**
```
Register-SSMPatchBaselineForPatchGroup -BaselineId "pb-03da896ca3b68b639" -PatchGroup "Production"
```
**Sortie** :
```
BaselineId PatchGroup
---------- ----------
pb-03da896ca3b68b639 Production
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterPatchBaselineForPatchGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Register-SSMTargetWithMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Register-SSMTargetWithMaintenanceWindow`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple enregistre une instance avec une fenêtre de maintenance.**
```
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"
```
**Sortie** :
```
d8e47760-23ed-46a5-9f28-927337725398
```
**Exemple 2 : cet exemple enregistre plusieurs instances avec une fenêtre de maintenance.**
```
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"
```
**Sortie** :
```
6ab5c208-9fc4-4697-84b7-b02a6cc25f7d
```
**Exemple 3 : Cet exemple enregistre une instance avec une fenêtre de maintenance à l'aide de EC2 balises.**
```
$option1 = @{Key="tag:Environment";Values=@("Production")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE"
```
**Sortie** :
```
2994977e-aefb-4a71-beac-df620352f184
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterTargetWithMaintenanceWindow](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Register-SSMTaskWithMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Register-SSMTaskWithMaintenanceWindow`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple enregistre une tâche avec une fenêtre de maintenance à l’aide d’un ID d’instance. Le résultat est l’ID de tâche.**
```
$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
```
**Sortie** :
```
f34a2c47-ddfd-4c85-a88d-72366b69af1b
```
**Exemple 2 : cet exemple enregistre une tâche avec une fenêtre de maintenance à l’aide d’un ID cible. Le résultat est l’ID de tâche.**
```
$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
```
**Sortie** :
```
f34a2c47-ddfd-4c85-a88d-72366b69af1b
```
**Exemple 3 : cet exemple crée un objet paramètre pour le document de commande d’exécution `AWS-RunPowerShellScript` et crée une tâche avec une fenêtre de maintenance donnée à l’aide de l’ID cible. La sortie de retour est l’ID de la tâche.**
```
$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
```
**Sortie** :
```
f1e2ef34-5678-12e3-456a-12334c5c6cbe
```
**Exemple 4 : Cet exemple enregistre une tâche d'automatisation de AWS Systems Manager à l'aide d'un document nommé`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"
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterTaskWithMaintenanceWindow](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-SSMActivation`
L'exemple de code suivant montre comment utiliser`Remove-SSMActivation`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime une activation. Il n’y a pas de sortie si la commande réussit.**
```
Remove-SSMActivation -ActivationId "08e51e79-1e36-446c-8e63-9458569c1363"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteActivation](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-SSMAssociation`
L'exemple de code suivant montre comment utiliser`Remove-SSMAssociation`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime l’association entre une instance et un document. Il n’y a pas de sortie si la commande réussit.**
```
Remove-SSMAssociation -InstanceId "i-0cb2b964d3e14fd9f" -Name "AWS-UpdateSSMAgent"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteAssociation](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-SSMDocument`
L'exemple de code suivant montre comment utiliser`Remove-SSMDocument`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime un document. Il n’y a pas de sortie si la commande réussit.**
```
Remove-SSMDocument -Name "RunShellScript"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteDocument](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-SSMMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Remove-SSMMaintenanceWindow`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime une fenêtre de maintenance.**
```
Remove-SSMMaintenanceWindow -WindowId "mw-06d59c1a07c022145"
```
**Sortie** :
```
mw-06d59c1a07c022145
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteMaintenanceWindow](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-SSMParameter`
L'exemple de code suivant montre comment utiliser`Remove-SSMParameter`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime un paramètre. Il n’y a pas de sortie si la commande réussit.**
```
Remove-SSMParameter -Name "helloWorld"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteParameter](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-SSMPatchBaseline`
L'exemple de code suivant montre comment utiliser`Remove-SSMPatchBaseline`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime un référentiel de correctifs.**
```
Remove-SSMPatchBaseline -BaselineId "pb-045f10b4f382baeda"
```
**Sortie** :
```
pb-045f10b4f382baeda
```
+ Pour plus de détails sur l'API, reportez-vous [DeletePatchBaseline](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-SSMResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-SSMResourceTag`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime une balise d’une fenêtre de maintenance. Il n’y a pas de sortie si la commande réussit.**
```
Remove-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -TagKey "Production"
```
+ Pour plus de détails sur l'API, reportez-vous [RemoveTagsFromResource](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Send-SSMCommand`
L'exemple de code suivant montre comment utiliser`Send-SSMCommand`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple exécute une commande echo sur une instance cible.**
```
Send-SSMCommand -DocumentName "AWS-RunPowerShellScript" -Parameter @{commands = "echo helloWorld"} -Target @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")}
```
**Sortie** :
```
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}
```
**Exemple 2 : cet exemple montre comment exécuter une commande qui accepte des paramètres imbriqués.**
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [SendCommand](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Start-SSMAutomationExecution`
L'exemple de code suivant montre comment utiliser`Start-SSMAutomationExecution`.
**Outils pour PowerShell V5**
**Exemple 1 : Cet exemple exécute un document spécifiant un rôle d'automatisation, un ID source d'AMI et un rôle d' EC2 instance Amazon.**
```
Start-SSMAutomationExecution -DocumentName AWS-UpdateLinuxAmi -Parameter @{'AutomationAssumeRole'='arn:aws:iam::123456789012:role/SSMAutomationRole';'SourceAmiId'='ami-f173cc91';'InstanceIamRole'='EC2InstanceRole'}
```
**Sortie** :
```
3a532a4f-0382-11e7-9df7-6f11185f6dd1
```
+ Pour plus de détails sur l'API, reportez-vous [StartAutomationExecution](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Start-SSMSession`
L'exemple de code suivant montre comment utiliser`Start-SSMSession`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple initie une connexion à une cible pour une session Session Manager, en activant la redirection de port. Remarque : vous devez ajouter le paramètre Region s'il n'est pas déjà défini à l'aide de AWSCredentials.**
```
Start-SSMSession -Target 'i-064578e5e7454488f' -DocumentName 'AWS-StartPortForwardingSession' -Parameter @{ localPortNumber = '8080'; portNumber = '80' } -Region 'us-west-1'
```
**Sortie** :
```
Starting session with SessionId: testUser-xi4glew849asyeryde34u4dfsdfy
Port 8080 opened for sessionId testUser-xi4glew849asyeryde34u4dfsdfy.
Waiting for connections...
```
**Exemple 2 : cet exemple crée une session interactive avec une instance spécifiée pour une session Session Manager.**
```
Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1'
```
**Sortie** :
```
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>
```
**Exemple 3 : Cet exemple crée une session sans s'y connecter et renvoie les TokenValue propriétés SessionId StreamUrl, et requises pour se connecter à la session.**
```
Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1' -DisablePluginInvocation
```
**Sortie** :
```
SessionId : testUser-xi4glew849asyeryde34u4dfsdfy
StreamUrl : {StreamUrl value redacted}
TokenValue : {Token value redacted}
ContentLength : 1207
HttpStatusCode : OK
```
+ Pour plus de détails sur l'API, reportez-vous [StartSession](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Stop-SSMAutomationExecution`
L'exemple de code suivant montre comment utiliser`Stop-SSMAutomationExecution`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple arrête l’exécution d’une automatisation. Il n’y a pas de sortie si la commande réussit.**
```
Stop-SSMAutomationExecution -AutomationExecutionId "4105a4fc-f944-11e6-9d32-8fb2db27a909"
```
+ Pour plus de détails sur l'API, reportez-vous [StopAutomationExecution](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Stop-SSMCommand`
L'exemple de code suivant montre comment utiliser`Stop-SSMCommand`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple tente d’annuler une commande. Il n’y a pas de sortie si l’opération réussit.**
```
Stop-SSMCommand -CommandId "9ded293e-e792-4440-8e3e-7b8ec5feaa38"
```
+ Pour plus de détails sur l'API, reportez-vous [CancelCommand](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Unregister-SSMManagedInstance`
L'exemple de code suivant montre comment utiliser`Unregister-SSMManagedInstance`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple désenregistre une instance gérée. Il n’y a pas de sortie si la commande réussit.**
```
Unregister-SSMManagedInstance -InstanceId "mi-08ab247cdf1046573"
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterManagedInstance](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Unregister-SSMPatchBaselineForPatchGroup`
L'exemple de code suivant montre comment utiliser`Unregister-SSMPatchBaselineForPatchGroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple désenregistre un groupe de correctifs d’un référentiel de correctifs.**
```
Unregister-SSMPatchBaselineForPatchGroup -BaselineId "pb-045f10b4f382baeda" -PatchGroup "Production"
```
**Sortie** :
```
BaselineId PatchGroup
---------- ----------
pb-045f10b4f382baeda Production
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterPatchBaselineForPatchGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Unregister-SSMTargetFromMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Unregister-SSMTargetFromMaintenanceWindow`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime une cible d’une fenêtre de maintenance.**
```
Unregister-SSMTargetFromMaintenanceWindow -WindowTargetId "6ab5c208-9fc4-4697-84b7-b02a6cc25f7d" -WindowId "mw-06cf17cbefcb4bf4f"
```
**Sortie** :
```
WindowId WindowTargetId
-------- --------------
mw-06cf17cbefcb4bf4f 6ab5c208-9fc4-4697-84b7-b02a6cc25f7d
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterTargetFromMaintenanceWindow](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Unregister-SSMTaskFromMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Unregister-SSMTaskFromMaintenanceWindow`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple supprime une tâche d’une fenêtre de maintenance.**
```
Unregister-SSMTaskFromMaintenanceWindow -WindowTaskId "f34a2c47-ddfd-4c85-a88d-72366b69af1b" -WindowId "mw-03a342e62c96d31b0"
```
**Sortie** :
```
WindowId WindowTaskId
-------- ------------
mw-03a342e62c96d31b0 f34a2c47-ddfd-4c85-a88d-72366b69af1b
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterTaskFromMaintenanceWindow](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-SSMAssociation`
L'exemple de code suivant montre comment utiliser`Update-SSMAssociation`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple met à jour une association avec une nouvelle version de document.**
```
Update-SSMAssociation -AssociationId "93285663-92df-44cb-9f26-2292d4ecc439" -DocumentVersion "1"
```
**Sortie** :
```
Name : AWS-UpdateSSMAgent
InstanceId :
Date : 3/1/2017 6:22:21 PM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateAssociation](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-SSMAssociationStatus`
L'exemple de code suivant montre comment utiliser`Update-SSMAssociationStatus`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple met à jour le statut de l’association entre une instance et un document de configuration.**
```
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"
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateAssociationStatus](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-SSMDocument`
L'exemple de code suivant montre comment utiliser`Update-SSMDocument`.
**Outils pour PowerShell V5**
**Exemple 1 : ceci crée une nouvelle version d’un document avec le contenu mis à jour du fichier json que vous spécifiez. Le document doit être au format JSON. Vous pouvez obtenir la version du document à l'aide de l'applet de commande « Get- SSMDocument VersionList ».**
```
Update-SSMDocument -Name RunShellScript -DocumentVersion "1" -Content (Get-Content -Raw "c:\temp\RunShellScript.json")
```
**Sortie** :
```
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
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateDocument](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-SSMDocumentDefaultVersion`
L'exemple de code suivant montre comment utiliser`Update-SSMDocumentDefaultVersion`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple met à jour la version par défaut d’un document. Vous pouvez obtenir les versions de document disponibles à l'aide de l'applet de commande « Get- SSMDocument VersionList ».**
```
Update-SSMDocumentDefaultVersion -Name "RunShellScript" -DocumentVersion "2"
```
**Sortie** :
```
DefaultVersion Name
-------------- ----
2 RunShellScript
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateDocumentDefaultVersion](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-SSMMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Update-SSMMaintenanceWindow`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple met à jour le nom d’une fenêtre de maintenance.**
```
Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Name "My-Renamed-MW"
```
**Sortie** :
```
AllowUnassociatedTargets : False
Cutoff : 1
Duration : 2
Enabled : True
Name : My-Renamed-MW
Schedule : cron(0 */30 * * * ? *)
WindowId : mw-03eb9db42890fb82d
```
**Exemple 2 : cet exemple active une fenêtre de maintenance.**
```
Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Enabled $true
```
**Sortie** :
```
AllowUnassociatedTargets : False
Cutoff : 1
Duration : 2
Enabled : True
Name : My-Renamed-MW
Schedule : cron(0 */30 * * * ? *)
WindowId : mw-03eb9db42890fb82d
```
**Exemple 3 : cet exemple désactive une fenêtre de maintenance.**
```
Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Enabled $false
```
**Sortie** :
```
AllowUnassociatedTargets : False
Cutoff : 1
Duration : 2
Enabled : False
Name : My-Renamed-MW
Schedule : cron(0 */30 * * * ? *)
WindowId : mw-03eb9db42890fb82d
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateMaintenanceWindow](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-SSMManagedInstanceRole`
L'exemple de code suivant montre comment utiliser`Update-SSMManagedInstanceRole`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple met à jour le rôle d’une instance gérée. Il n’y a pas de sortie si la commande réussit.**
```
Update-SSMManagedInstanceRole -InstanceId "mi-08ab247cdf1046573" -IamRole "AutomationRole"
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateManagedInstanceRole](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-SSMPatchBaseline`
L'exemple de code suivant montre comment utiliser`Update-SSMPatchBaseline`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple ajoute deux correctifs comme étant rejetés et un correctif comme étant approuvé à un référentiel de correctifs existant.**
```
Update-SSMPatchBaseline -BaselineId "pb-03da896ca3b68b639" -RejectedPatch "KB2032276","MS10-048" -ApprovedPatch "KB2124261"
```
**Sortie** :
```
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}
```
+ Pour plus de détails sur l'API, reportez-vous [UpdatePatchBaseline](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-SSMComplianceItem`
L'exemple de code suivant montre comment utiliser`Write-SSMComplianceItem`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple écrit un élément de conformité personnalisé pour l’instance gérée donnée**
```
$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"
```
+ Pour plus de détails sur l'API, reportez-vous [PutComplianceItems](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-SSMInventory`
L'exemple de code suivant montre comment utiliser`Write-SSMInventory`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple attribue des informations sur l’emplacement du rack à une instance. Il n’y a pas de sortie si la commande réussit.**
```
$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
```
+ Pour plus de détails sur l'API, reportez-vous [PutInventory](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Write-SSMParameter`
L'exemple de code suivant montre comment utiliser`Write-SSMParameter`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée un paramètre. Il n’y a pas de sortie si la commande réussit.**
```
Write-SSMParameter -Name "Welcome" -Type "String" -Value "helloWorld"
```
**Exemple 2 : cet exemple modifie un paramètre. Il n’y a pas de sortie si la commande réussit.**
```
Write-SSMParameter -Name "Welcome" -Type "String" -Value "Good day, Sunshine!" -Overwrite $true
```
+ Pour plus de détails sur l'API, reportez-vous [PutParameter](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.