View a markdown version of this page

Contoh Grup Sumber Daya menggunakan Alat untuk PowerShell V5 - Alat AWS untuk PowerShell (versi 5)
Tindakan

Versi 5 (V5) Alat AWS untuk PowerShell telah dirilis!

Untuk informasi tentang mengubah perubahan dan memigrasikan aplikasi Anda, lihat topik https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html migrasi.

Orange button with text "Click here for details".

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh Grup Sumber Daya menggunakan Alat untuk PowerShell V5

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan Alat AWS untuk PowerShell V5 dengan Grup Sumber Daya.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanAdd-RGResourceTag.

Alat untuk PowerShell V5

Contoh 1: Contoh ini menambahkan kunci tag 'Instances' dengan nilai 'kotak kerja' ke grup sumber daya yang diberikan arn 

Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes

Output:

Arn                                                            Tags
---                                                            ----
arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]}

  • Untuk detail API, lihat Tag dalam Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanFind-RGResource.

Alat untuk PowerShell V5

Contoh 1: Contoh ini membuat jenis sumber daya ResourceQuery untuk Instance dengan filter tag dan menemukan sumber daya. 

$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

Output:

ResourceArn                                                     ResourceType
-----------                                                     ------------
arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance

  • Untuk detail API, lihat SearchResources di Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanGet-RGGroup.

Alat untuk PowerShell V5

Contoh 1: Contoh ini mengambil grup sumber daya sesuai nama grup 

Get-RGGroup -GroupName auto-no

Output:

Description GroupArn                                                     Name
----------- --------                                                     ----
            arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no

  • Untuk detail API, lihat GetGroup di Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanGet-RGGroupList.

Alat untuk PowerShell V5

Contoh 1: Contoh ini mencantumkan grup sumber daya yang sudah dibuat. 

Get-RGGroupList

Output:

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

  • Untuk detail API, lihat ListGroups di Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanGet-RGGroupQuery.

Alat untuk PowerShell V5

Contoh 1: Contoh ini mengambil kueri sumber daya untuk grup sumber daya yang diberikan 

Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery

Output:

Query                                                                                        Type
-----                                                                                        ----
{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0

  • Untuk detail API, lihat GetGroupQuery di Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanGet-RGGroupResourceList.

Alat untuk PowerShell V5

Contoh 1: Contoh ini mencantumkan sumber daya grup berdasarkan filter berdasarkan jenis sumber daya 

Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers

Output:

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

Contoh kode berikut menunjukkan cara menggunakanGet-RGResourceTag.

Alat untuk PowerShell V5

Contoh 1: Contoh ini mencantumkan tag untuk grup sumber daya tertentu arn 

Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes

Output:

Key       Value
---       -----
Instances workboxes

  • Untuk detail API, lihat GetTags di Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanNew-RGGroup.

Alat untuk PowerShell V5

Contoh 1: Contoh ini membuat grup sumber daya Grup Sumber AWS Daya berbasis tag baru bernama TestPowerShellGroup. Grup ini menyertakan instans Amazon EC2 di wilayah saat ini yang ditandai dengan kunci tag “Nama”, dan nilai tag “test2". Perintah mengembalikan kueri dan jenis grup, dan hasil operasi. 

$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."

Output:

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

  • Untuk detail API, lihat CreateGroup di Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanRemove-RGGroup.

Alat untuk PowerShell V5

Contoh 1: Contoh ini menghapus grup sumber daya bernama 

Remove-RGGroup -GroupName non-tag-cfn-elbv2

Output:

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

  • Untuk detail API, lihat DeleteGroup di Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanRemove-RGResourceTag.

Alat untuk PowerShell V5

Contoh 1: Contoh ini menghapus tag yang disebutkan dari grup sumber daya 

Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances

Output:

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}

  • Untuk detail API, lihat Untag di Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanUpdate-RGGroup.

Alat untuk PowerShell V5

Contoh 1: Contoh ini memperbarui deskripsi grup 

Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove"

Output:

Description             GroupArn                                                      Name
-----------             --------                                                      ----
Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes

  • Untuk detail API, lihat UpdateGroup di Referensi Alat AWS untuk PowerShell Cmdlet (V5).

Contoh kode berikut menunjukkan cara menggunakanUpdate-RGGroupQuery.

Alat untuk PowerShell V5

Contoh 1: Contoh ini membuat objek query dan memperbarui kueri untuk grup. 

$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

Output:

GroupName ResourceQuery
--------- -------------
build600  Amazon.ResourceGroups.Model.ResourceQuery

  • Untuk detail API, lihat UpdateGroupQuery di Referensi Alat AWS untuk PowerShell Cmdlet (V5).