D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub . 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 Resource Groups 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 version 5 avec Resource Groups. 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-RGResourceTag` L'exemple de code suivant montre comment utiliser`Add-RGResourceTag`. **Outils pour PowerShell V5** **Exemple 1 : cet exemple ajoute la clé de balise « Instances » avec la valeur « workboxes » à l’ARN du groupe de ressources donné** ``` Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes ``` **Sortie** : ``` Arn Tags --- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]} ``` + Pour plus de détails sur l’API, consultez [Tag](https://docs.aws.amazon.com/powershell/v5/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell  (V5)*. ### `Find-RGResource` L'exemple de code suivant montre comment utiliser`Find-RGResource`. **Outils pour PowerShell V5** **Exemple 1 : Cet exemple crée un type de ressource ResourceQuery for Instance avec des filtres de balises et trouve des ressources.** ``` $query = [Amazon.ResourceGroups.Model.ResourceQuery]::new() $query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0 $query.Query = ConvertTo-Json -Compress -Depth 4 -InputObject @{ ResourceTypeFilters = @('AWS::EC2::Instance') TagFilters = @(@{ Key = 'auto' Values = @('no') }) } Find-RGResource -ResourceQuery $query | Select-Object -ExpandProperty ResourceIdentifiers ``` **Sortie** : ``` ResourceArn ResourceType ----------- ------------ arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance ``` + Pour plus de détails sur l'API, reportez-vous [SearchResources](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Get-RGGroup` L'exemple de code suivant montre comment utiliser`Get-RGGroup`. **Outils pour PowerShell V5** **Exemple 1 : cet exemple extrait le groupe de ressources selon le nom du groupe** ``` Get-RGGroup -GroupName auto-no ``` **Sortie** : ``` Description GroupArn Name ----------- -------- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no ``` + Pour plus de détails sur l'API, reportez-vous [GetGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Get-RGGroupList` L'exemple de code suivant montre comment utiliser`Get-RGGroupList`. **Outils pour PowerShell V5** **Exemple 1 : cet exemple répertorie les groupes de ressources déjà créés.** ``` Get-RGGroupList ``` **Sortie** : ``` GroupArn GroupName -------- --------- arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes arn:aws:resource-groups:eu-west-1:123456789012:group/build600 build600 ``` + Pour plus de détails sur l'API, reportez-vous [ListGroups](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Get-RGGroupQuery` L'exemple de code suivant montre comment utiliser`Get-RGGroupQuery`. **Outils pour PowerShell V5** **Exemple 1 : cet exemple extrait la requête de ressources pour le groupe de ressources donné** ``` Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery ``` **Sortie** : ``` Query Type ----- ---- {"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0 ``` + Pour plus de détails sur l'API, reportez-vous [GetGroupQuery](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Get-RGGroupResourceList` L'exemple de code suivant montre comment utiliser`Get-RGGroupResourceList`. **Outils pour PowerShell V5** **Exemple 1 : cet exemple répertorie les ressources du groupe sur la base du filtrage par type de ressource** ``` Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers ``` **Sortie** : ``` ResourceArn ResourceType ----------- ------------ arn:aws:ec2:eu-west-1:123456789012:instance/i-0123bc45b567890e1 AWS::EC2::Instance arn:aws:ec2:eu-west-1:123456789012:instance/i-0a1caf2345f67d8dc AWS::EC2::Instance arn:aws:ec2:eu-west-1:123456789012:instance/i-012e3cb4df567e8aa AWS::EC2::Instance arn:aws:ec2:eu-west-1:123456789012:instance/i-0fd12dd3456789012 AWS::EC2::Instance ``` + Pour plus de détails sur l'API, reportez-vous [ListGroupResources](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Get-RGResourceTag` L'exemple de code suivant montre comment utiliser`Get-RGResourceTag`. **Outils pour PowerShell V5** **Exemple 1 : cet exemple répertorie les balises pour l’ARN du groupe de ressources donné** ``` Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes ``` **Sortie** : ``` Key Value --- ----- Instances workboxes ``` + Pour plus de détails sur l'API, reportez-vous [GetTags](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `New-RGGroup` L'exemple de code suivant montre comment utiliser`New-RGGroup`. **Outils pour PowerShell V5** **Exemple 1 : Cet exemple crée un nouveau groupe de AWS ressources Resource Groups basé sur des balises nommé TestPowerShellGroup. Le groupe inclut les instances Amazon EC2 de la région actuelle qui sont balisées avec la clé de balise « Name » et la valeur de balise « test2 ». La commande renvoie la requête et le type de groupe, ainsi que les résultats de l’opération.** ``` $ResourceQuery = New-Object -TypeName Amazon.ResourceGroups.Model.ResourceQuery $ResourceQuery.Type = "TAG_FILTERS_1_0" $ResourceQuery.Query = '{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]}' $ResourceQuery New-RGGroup -Name TestPowerShellGroup -ResourceQuery $ResourceQuery -Description "Test resource group." ``` **Sortie** : ``` Query Type ----- ---- {"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]} TAG_FILTERS_1_0 LoggedAt : 11/20/2018 2:40:59 PM Group : Amazon.ResourceGroups.Model.Group ResourceQuery : Amazon.ResourceGroups.Model.ResourceQuery Tags : {} ResponseMetadata : Amazon.Runtime.ResponseMetadata ContentLength : 338 HttpStatusCode : OK ``` + Pour plus de détails sur l'API, reportez-vous [CreateGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Remove-RGGroup` L'exemple de code suivant montre comment utiliser`Remove-RGGroup`. **Outils pour PowerShell V5** **Exemple 1 : cet exemple supprime le groupe de ressources nommé** ``` Remove-RGGroup -GroupName non-tag-cfn-elbv2 ``` **Sortie** : ``` Confirm Are you sure you want to perform this action? Performing the operation "Remove-RGGroup (DeleteGroup)" on target "non-tag-cfn-elbv2". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y Description GroupArn Name ----------- -------- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/non-tag-cfn-elbv2 non-tag-cfn-elbv2 ``` + Pour plus de détails sur l'API, reportez-vous [DeleteGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Remove-RGResourceTag` L'exemple de code suivant montre comment utiliser`Remove-RGResourceTag`. **Outils pour PowerShell V5** **Exemple 1 : cet exemple supprime la balise mentionnée du groupe de ressources** ``` Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances ``` **Sortie** : ``` Confirm Are you sure you want to perform this action? Performing the operation "Remove-RGResourceTag (Untag)" on target "arn:aws:resource-groups:eu-west-1:933303704102:group/workboxes". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y Arn Keys --- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {Instances} ``` + Pour plus de détails sur l’API, consultez [Untag](https://docs.aws.amazon.com/powershell/v5/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell  (V5)*. ### `Update-RGGroup` L'exemple de code suivant montre comment utiliser`Update-RGGroup`. **Outils pour PowerShell V5** **Exemple 1 : cet exemple met à jour la description du groupe** ``` Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove" ``` **Sortie** : ``` Description GroupArn Name ----------- -------- ---- Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes ``` + Pour plus de détails sur l'API, reportez-vous [UpdateGroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Update-RGGroupQuery` L'exemple de code suivant montre comment utiliser`Update-RGGroupQuery`. **Outils pour PowerShell V5** **Exemple 1 : cet exemple crée un objet de requête et met à jour la requête pour le groupe.** ``` $query = [Amazon.ResourceGroups.Model.ResourceQuery]::new() $query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0 $query.Query = @{ ResourceTypeFilters = @('AWS::EC2::Instance') TagFilters = @(@{ Key='Environment' Values='Build600.11' }) } | ConvertTo-Json -Compress -Depth 4 Update-RGGroupQuery -GroupName build600 -ResourceQuery $query ``` **Sortie** : ``` GroupName ResourceQuery --------- ------------- build600 Amazon.ResourceGroups.Model.ResourceQuery ``` + Pour plus de détails sur l'API, reportez-vous [UpdateGroupQuery](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.