Version 5 (V5) von AWS -Tools für PowerShell wurde veröffentlicht\$1 Informationen zu wichtigen Änderungen und zur Migration Ihrer Anwendungen finden Sie im [Migrationsthema](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) Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Beispiele für Resource Groups mit Tools für PowerShell V5 Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Resource Groups Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `Add-RGResourceTag` Das folgende Codebeispiel zeigt die Verwendung `Add-RGResourceTag` von. **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel wird der Tag-Schlüssel „Instances“ mit dem Wert „workboxes“ zur angegebenen Ressourcengruppe arn hinzugefügt.** ``` Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes ``` **Ausgabe:** ``` Arn Tags --- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]} ``` + Weitere API-Informationen finden Sie unter [Tag](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*. ### `Find-RGResource` Das folgende Codebeispiel zeigt, wie man es benutzt`Find-RGResource`. **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel wird ein Ressourcentyp ResourceQuery für Instanz mit Tag-Filtern erstellt und Ressourcen gesucht.** ``` $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 ``` **Ausgabe:** ``` ResourceArn ResourceType ----------- ------------ arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance ``` + Einzelheiten zur API finden Sie unter [SearchResources AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*). ### `Get-RGGroup` Das folgende Codebeispiel zeigt die Verwendung. `Get-RGGroup` **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel wird die Ressourcengruppe anhand des Gruppennamens abgerufen.** ``` Get-RGGroup -GroupName auto-no ``` **Ausgabe:** ``` Description GroupArn Name ----------- -------- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no ``` + Einzelheiten zur API finden Sie unter [GetGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5). ### `Get-RGGroupList` Das folgende Codebeispiel zeigt die Verwendung. `Get-RGGroupList` **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel werden bereits erstellte Ressourcengruppen aufgelistet.** ``` Get-RGGroupList ``` **Ausgabe:** ``` 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 ``` + Einzelheiten zur API finden Sie unter [ListGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5). ### `Get-RGGroupQuery` Das folgende Codebeispiel zeigt die Verwendung. `Get-RGGroupQuery` **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel wird die Ressourcenabfrage für die angegebene Ressourcengruppe abgerufen** ``` Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery ``` **Ausgabe:** ``` Query Type ----- ---- {"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0 ``` + Einzelheiten zur API finden Sie unter [GetGroupQuery AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5). ### `Get-RGGroupResourceList` Das folgende Codebeispiel zeigt die Verwendung. `Get-RGGroupResourceList` **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel werden Gruppenressourcen auf der Grundlage einer Filterung nach Ressourcentyp aufgelistet** ``` Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers ``` **Ausgabe:** ``` 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 ``` + Einzelheiten zur API finden Sie unter [ListGroupResources AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5). ### `Get-RGResourceTag` Das folgende Codebeispiel zeigt die Verwendung. `Get-RGResourceTag` **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel werden Tags für die angegebene Ressourcengruppe arn aufgelistet** ``` Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes ``` **Ausgabe:** ``` Key Value --- ----- Instances workboxes ``` + Einzelheiten zur API finden Sie unter [GetTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5). ### `New-RGGroup` Das folgende Codebeispiel zeigt die Verwendung. `New-RGGroup` **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel wird eine neue tagbasierte AWS Ressourcengruppe für Resource Groups mit dem Namen TestPowerShellGroup erstellt. Die Gruppe umfasst EC2 Amazon-Instances in der aktuellen Region, die mit dem Tag-Schlüssel „Name“ und dem Tag-Wert „test2" gekennzeichnet sind. Der Befehl gibt die Abfrage und den Typ der Gruppe sowie die Ergebnisse der Operation zurück.** ``` $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." ``` **Ausgabe:** ``` 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 ``` + Einzelheiten zur API finden Sie unter [CreateGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5). ### `Remove-RGGroup` Das folgende Codebeispiel zeigt die Verwendung. `Remove-RGGroup` **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel wird die benannte Ressourcengruppe entfernt** ``` Remove-RGGroup -GroupName non-tag-cfn-elbv2 ``` **Ausgabe:** ``` 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 ``` + Einzelheiten zur API finden Sie unter [DeleteGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5). ### `Remove-RGResourceTag` Das folgende Codebeispiel zeigt die Verwendung. `Remove-RGResourceTag` **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel wird das erwähnte Tag aus der Ressourcengruppe entfernt** ``` Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances ``` **Ausgabe:** ``` 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} ``` + Weitere API-Informationen finden Sie unter [Untag](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*. ### `Update-RGGroup` Das folgende Codebeispiel zeigt, wie man es benutzt`Update-RGGroup`. **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel wird die Beschreibung der Gruppe aktualisiert** ``` Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove" ``` **Ausgabe:** ``` Description GroupArn Name ----------- -------- ---- Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes ``` + Einzelheiten zur API finden Sie unter [UpdateGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5). ### `Update-RGGroupQuery` Das folgende Codebeispiel zeigt die Verwendung. `Update-RGGroupQuery` **Tools für PowerShell V5** **Beispiel 1: In diesem Beispiel wird ein Abfrageobjekt erstellt und die Abfrage für die Gruppe aktualisiert.** ``` $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 ``` **Ausgabe:** ``` GroupName ResourceQuery --------- ------------- build600 Amazon.ResourceGroups.Model.ResourceQuery ``` + Einzelheiten zur API finden Sie unter [UpdateGroupQuery AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).