View a markdown version of this page

Beispiele für Ressourcengruppen, die Tools für V5 verwenden PowerShell - AWS SDK-Codebeispiele
Aktionen

Weitere AWS SDK-Beispiele sind im AWS Doc SDK Examples GitHub Repo verfügbar.

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 Ressourcengruppen, die Tools für V5 verwenden PowerShell

Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit Ressourcengruppen verwenden.

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.

Themen

Aktionen

Das folgende Codebeispiel zeigt die VerwendungAdd-RGResourceTag.

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 in der AWS -Tools für PowerShell -Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die VerwendungFind-RGResource.

Tools für PowerShell V5

Beispiel 1: In diesem Beispiel wird ein ResourceQuery For-Inance-Ressourcentyp mit Tag-Filtern erstellt und Ressourcen gefunden. 

$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

  • API-Details finden Sie SearchResources in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

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

  • API-Details finden Sie GetGroup in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

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

  • API-Details finden Sie ListGroups in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

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

  • API-Details finden Sie GetGroupQuery in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

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

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

  • API-Details finden Sie GetTags in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die Verwendung. New-RGGroup

Tools für PowerShell V5

Beispiel 1: In diesem Beispiel wird eine neue tagbasierte AWS Ressourcengruppe mit dem Namen Resource Groups erstellt. TestPowerShellGroup Die Gruppe umfasst Amazon EC2-Instances in der aktuellen Region, die mit dem Tag-Schlüssel „Name“ und dem Tag-Wert „test2“ versehen 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

  • API-Details finden Sie CreateGroup in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

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

  • API-Details finden Sie DeleteGroup in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

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 in der AWS -Tools für PowerShell -Cmdlet-Referenz (V5).

Das folgende Codebeispiel zeigt die VerwendungUpdate-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

  • API-Details finden Sie UpdateGroup in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).

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

  • API-Details finden Sie UpdateGroupQuery in der AWS -Tools für PowerShell Cmdlet-Referenz (V5).