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.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Contoh Amazon S3 menggunakan Alat untuk PowerShell V5
Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan Alat AWS untuk PowerShell V5 dengan Amazon S3.
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.
Topik
Tindakan
Contoh kode berikut menunjukkan cara menggunakanCopy-S3Object.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini menyalin objek "sample.txt" dari bucket “test-files” ke bucket yang sama tetapi dengan kunci baru "sample-copy.txt”.
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -DestinationKey sample-copy.txtContoh 2: Perintah ini menyalin objek "sample.txt" dari bucket “test-files” ke bucket “backup-files” dengan kunci "sample-copy.txt”.
Copy-S3Object -BucketName amzn-s3-demo-source-bucket -Key sample.txt -DestinationKey sample-copy.txt -DestinationBucket amzn-s3-demo-destination-bucketContoh 3: Perintah ini mengunduh objek "sample.txt" dari bucket “test-files” ke file lokal dengan nama "local-sample.txt”.
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -LocalFile local-sample.txtContoh 4: Mengunduh objek tunggal ke file yang ditentukan. File yang diunduh akan ditemukan di c:\downloads\data\archive.zip
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key data/archive.zip -LocalFolder c:\downloadsContoh 5: Mengunduh semua objek yang cocok dengan awalan kunci yang ditentukan ke folder lokal. Hirarki kunci relatif akan dipertahankan sebagai subfolder di lokasi unduhan keseluruhan.
Copy-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data -LocalFolder c:\downloadsContoh 6: Mengunduh satu objek ke file lokal menggunakan unduhan paralel multibagian untuk meningkatkan kinerja pada file besar.
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -LocalFile local-sample.txt -UseMultipartDownloadContoh 7: Mengunduh objek besar menggunakan mode RANGE dengan ukuran bagian 64MB khusus. Mode RANGE menggunakan permintaan rentang byte HTTP dan berfungsi untuk semua objek terlepas dari bagaimana mereka diunggah.
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key large-file.zip -LocalFile local-large-file.zip -UseMultipartDownload -MultipartDownloadType RANGE -PartSize 64MBContoh 8: Mengunduh semua objek yang cocok dengan awalan kunci ke folder lokal menggunakan unduhan multibagian dengan unduhan file bersamaan.
Copy-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data/ -LocalFolder C:\local-data -UseMultipartDownload -DownloadFilesConcurrentlyContoh 9: Mengunduh satu objek menggunakan unduhan multibagian dengan 20 koneksi bersamaan untuk throughput maksimum pada jaringan bandwidth tinggi.
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key large-file.zip -LocalFile local-large-file.zip -UseMultipartDownload -ConcurrentServiceRequest 20Contoh 10: Mengunduh semua objek yang cocok dengan awalan kunci ke folder lokal menggunakan unduhan multibagian, melanjutkan kegagalan file individual sebelumnya alih-alih membatalkan.
Copy-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data/ -LocalFolder C:\local-data -UseMultipartDownload -FailurePolicy ContinueOnFailure-
Untuk detail API, lihat CopyObject di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanDismount-S3PSDrive.
- Alat untuk PowerShell V5
-
Contoh 1: Mengubah lokasi di luar drive S3, lalu menghapus drive.
Set-Location $HOME Dismount-S3PSDrive -Name S3-
Untuk detail API, lihat Dismount-S3PSDrive di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3Bucket.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan semua bucket S3.
Get-S3BucketContoh 2: Perintah ini mengembalikan bucket bernama “test-files”
Get-S3Bucket -BucketName amzn-s3-demo-bucket-
Untuk detail API, lihat ListBuckets di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketACL.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah mendapatkan detail pemilik objek dari objek S3.
(Get-S3BucketACL -BucketName 'amzn-s3-demo-bucket' -Select *).OwnerOutput:
DisplayName Id ----------- -- testusername 9988776a6554433d22f1100112e334acb45566778899009e9887bd7f66c5f544-
Untuk detail API, lihat GetBucketAcl di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketAccelerateConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan nilai Diaktifkan, jika pengaturan akselerasi transfer diaktifkan untuk bucket yang ditentukan.
Get-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket'Output:
Value ----- Enabled-
Untuk detail API, lihat GetBucketAccelerateConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketAnalyticsConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan detail filter analitik dengan nama 'testfilter' di bucket S3 yang diberikan.
Get-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'-
Untuk detail API, lihat GetBucketAnalyticsConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketAnalyticsConfigurationList.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan 100 konfigurasi analitik pertama dari bucket S3 yang diberikan.
Get-S3BucketAnalyticsConfigurationList -BucketName 'amzn-s3-demo-bucket'-
Untuk detail API, lihat ListBucketAnalyticsConfigurations di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketEncryption.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan semua aturan enkripsi sisi server yang terkait dengan bucket yang diberikan.
Get-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'-
Untuk detail API, lihat GetBucketEncryption di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketInventoryConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan detail inventaris bernama 'testinventaris' untuk bucket S3 yang diberikan.
Get-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testinventory'-
Untuk detail API, lihat GetBucketInventoryConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketInventoryConfigurationList.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan 100 konfigurasi inventaris pertama dari bucket S3 yang diberikan.
Get-S3BucketInventoryConfigurationList -BucketName 'amzn-s3-demo-bucket'-
Untuk detail API, lihat ListBucketInventoryConfigurations di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketLocation.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan batasan lokasi untuk bucket 'amzn-s3-demo-bucket', jika ada batasan.
Get-S3BucketLocation -BucketName 'amzn-s3-demo-bucket'Output:
Value ----- ap-south-1-
Untuk detail API, lihat GetBucketLocation di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketLogging.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan status logging untuk bucket yang ditentukan.
Get-S3BucketLogging -BucketName 'amzn-s3-demo-bucket'Output:
TargetBucketName Grants TargetPrefix ---------------- ------ ------------ testbucket1 {} testprefix-
Untuk detail API, lihat GetBucketLogging di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketMetricsConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan detail tentang filter metrik bernama 'testfilter' untuk bucket S3 yang diberikan.
Get-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testfilter'-
Untuk detail API, lihat GetBucketMetricsConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketNotification.
- Alat untuk PowerShell V5
-
Contoh 1: Contoh ini mengambil konfigurasi notifikasi dari bucket yang diberikan
Get-S3BucketNotification -BucketName amzn-s3-demo-bucket | select -ExpandProperty TopicConfigurationsOutput:
Id Topic -- ----- mimo arn:aws:sns:eu-west-1:123456789012:topic-1-
Untuk detail API, lihat GetBucketNotification di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketPolicy.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini menampilkan kebijakan bucket yang terkait dengan bucket S3 yang diberikan.
Get-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'-
Untuk detail API, lihat GetBucketPolicy di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketPolicyStatus.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan status kebijakan untuk bucket S3 yang diberikan, menunjukkan apakah bucket bersifat publik.
Get-S3BucketPolicyStatus -BucketName 'amzn-s3-demo-bucket'-
Untuk detail API, lihat GetBucketPolicyStatus di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketReplication.
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikan informasi konfigurasi replikasi yang ditetapkan pada bucket bernama 'amzn-s3-demo-bucket'.
Get-S3BucketReplication -BucketName amzn-s3-demo-bucket-
Untuk detail API, lihat GetBucketReplication di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketRequestPayment.
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikan konfigurasi permintaan pembayaran untuk bucket bernama 'amzn-s3-demo-bucket'. Secara default, pemilik bucket membayar unduhan dari bucket.
Get-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket-
Untuk detail API, lihat GetBucketRequestPayment di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketTagging.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan semua tag yang terkait dengan bucket yang diberikan.
Get-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'-
Untuk detail API, lihat GetBucketTagging di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketVersioning.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan status pembuatan versi sehubungan dengan bucket yang diberikan.
Get-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket'-
Untuk detail API, lihat GetBucketVersioning di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3BucketWebsite.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan detail konfigurasi situs web statis dari bucket S3 yang diberikan.
Get-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'-
Untuk detail API, lihat GetBucketWebsite di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3CORSConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan objek yang berisi semua aturan konfigurasi CORS yang sesuai dengan Bucket S3 yang diberikan.
Get-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket' -Select Configuration.RulesOutput:
AllowedMethods : {PUT, POST, DELETE} AllowedOrigins : {http://www.example1.com} Id : ExposeHeaders : {} MaxAgeSeconds : 0 AllowedHeaders : {*} AllowedMethods : {PUT, POST, DELETE} AllowedOrigins : {http://www.example2.com} Id : ExposeHeaders : {} MaxAgeSeconds : 0 AllowedHeaders : {*} AllowedMethods : {GET} AllowedOrigins : {*} Id : ExposeHeaders : {} MaxAgeSeconds : 0 AllowedHeaders : {}-
Untuk detail API, lihat GetCorsConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3HeadBucket.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan output dengan kode status HTTP 200 OK untuk bucket yang ada ketika pengguna memiliki izin untuk mengaksesnya. BucketArn parameter hanya didukung untuk bucket direktori S3.
Get-S3HeadBucket -BucketName amzn-s3-demo-bucketOutput:
AccessPointAlias : False BucketArn : BucketLocationName : BucketLocationType : BucketRegion : us-east-2 ResponseMetadata : Amazon.Runtime.ResponseMetadata ContentLength : 0 HttpStatusCode : OKContoh 2: Perintah ini menimbulkan kesalahan dengan kode status HTTP NotFound untuk bucket yang tidak ada.
Get-S3HeadBucket -BucketName amzn-s3-non-existing-bucketOutput:
Get-S3HeadBucket: Error making request with Error Code NotFound and Http Status Code NotFound. No further error information was returned by the service.Contoh 3: Perintah ini menimbulkan kesalahan dengan kode status HTTP Dilarang untuk bucket yang ada di mana pengguna tidak memiliki izin untuk mengaksesnya.
Get-S3HeadBucket -BucketName amzn-s3-no-access-bucketOutput:
Get-S3HeadBucket: Error making request with Error Code Forbidden and Http Status Code Forbidden. No further error information was returned by the service.-
Untuk detail API, lihat HeadBucket di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3LifecycleConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Contoh ini mengambil konfigurasi siklus hidup untuk bucket.
Get-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucketOutput:
Rules ----- {Remove-in-150-days, Archive-to-Glacier-in-30-days}-
Untuk detail API, lihat GetLifecycleConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3Object.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengambil informasi tentang semua item dalam bucket “test-files”.
Get-S3Object -BucketName amzn-s3-demo-bucketContoh 2: Perintah ini mengambil informasi tentang item "sample.txt" dari bucket “test-files”.
Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txtContoh 3: Perintah ini mengambil informasi tentang semua item dengan awalan “sampel” dari bucket “test-files”.
Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample-
Untuk detail API, lihat ListObjects di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3ObjectACL.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah mendapatkan detail pemilik objek dari objek S3.
(Get-S3ObjectACL -BucketName 'amzn-s3-demo-bucket' -key 'initialize.ps1' -Select *).OwnerOutput:
DisplayName Id ----------- -- testusername 9988776a6554433d22f1100112e334acb45566778899009e9887bd7f66c5f544-
Untuk detail API, lihat GetObjectAcl di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3ObjectLockConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan nilai 'Diaktifkan' jika konfigurasi kunci objek diaktifkan untuk bucket S3 yang diberikan.
Get-S3ObjectLockConfiguration -BucketName 'amzn-s3-demo-bucket' -Select ObjectLockConfiguration.ObjectLockEnabledOutput:
Value ----- Enabled-
Untuk detail API, lihat GetObjectLockConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3ObjectMetadata.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan metadata objek dengan kunci 'ListTrusts.txt' di bucket S3 yang diberikan.
Get-S3ObjectMetadata -BucketName 'amzn-s3-demo-bucket' -Key 'ListTrusts.txt'Output:
Headers : Amazon.S3.Model.HeadersCollection Metadata : Amazon.S3.Model.MetadataCollection DeleteMarker : AcceptRanges : bytes ContentRange : Expiration : RestoreExpiration : RestoreInProgress : False LastModified : 01/01/2020 08:02:05 ETag : "d000011112a222e333e3bb4ee5d43d21" MissingMeta : 0 VersionId : null Expires : 01/01/0001 00:00:00 WebsiteRedirectLocation : ServerSideEncryptionMethod : AES256 ServerSideEncryptionCustomerMethod : ServerSideEncryptionKeyManagementServiceKeyId : ReplicationStatus : PartsCount : ObjectLockLegalHoldStatus : ObjectLockMode : ObjectLockRetainUntilDate : 01/01/0001 00:00:00 StorageClass : RequestCharged :-
Untuk detail API, lihat GetObjectMetadata di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3ObjectRetention.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah mengembalikan mode dan tanggal sampai objek akan dipertahankan.
Get-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt'-
Untuk detail API, lihat GetObjectRetention di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3ObjectTagSet.
- Alat untuk PowerShell V5
-
Contoh 1: Sampel mengembalikan tag yang terkait dengan objek yang ada pada bucket S3 yang diberikan.
Get-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket'Output:
Key Value --- ----- test value-
Untuk detail API, lihat GetObjectTagging di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3PreSignedURL.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah mengembalikan URL yang telah ditandatangani sebelumnya untuk kunci tertentu dan tanggal kedaluwarsa.
Get-S3PreSignedURL -BucketName 'amzn-s3-demo-bucket' -Key 'testkey' -Expires '2023-11-16'Contoh 2: Perintah mengembalikan URL yang telah ditandatangani sebelumnya untuk Bucket Direktori dengan kunci yang ditentukan dan tanggal kedaluwarsa.
[Amazon.AWSConfigsS3]::UseSignatureVersion4 = $true Get-S3PreSignedURL -BucketName amzn-s3-demo-bucket--usw2-az1--x-s3 -Key 'testkey' -Expire '2023-11-17'-
Untuk detail API, lihat GetPreSignedURL di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3PublicAccessBlock.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah mengembalikan konfigurasi blok akses publik dari bucket S3 yang diberikan.
Get-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket'-
Untuk detail API, lihat GetPublicAccessBlock di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-S3Version.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan metadata tentang semua versi objek dalam bucket S3 yang diberikan.
Get-S3Version -BucketName 'amzn-s3-demo-bucket'Output:
IsTruncated : False KeyMarker : VersionIdMarker : NextKeyMarker : NextVersionIdMarker : Versions : {EC2.txt, EC2MicrosoftWindowsGuide.txt, ListDirectories.json, ListTrusts.json} Name : amzn-s3-demo-bucket Prefix : MaxKeys : 1000 CommonPrefixes : {} Delimiter :-
Untuk detail API, lihat ListVersions di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanMount-S3PSDrive.
- Alat untuk PowerShell V5
-
Contoh 1: Memasang drive S3 root akun bernama S3 menggunakan kredensi default dan resolusi Wilayah. Cmdlet tidak mengubah lokasi saat ini. Get-PSDrive menunjukkan drive yang dipasang, dan mencant Get-ChildItem umkan bucket yang tersedia untuk kredenSIAL yang diselesaikan.
Mount-S3PSDrive -Name S3 Get-PSDrive -Name S3 Get-ChildItem -Path S3:\Contoh 2: Memasang drive yang dicakup ke awalan bucket dan menetapkan Region yang digunakan oleh drive. Set-Location memasuki drive secara eksplisit karena pemasangan tidak mengubah lokasi saat ini.
Mount-S3PSDrive -Name ProjectData -Root 'amzn-s3-demo-bucket/projects/2026' -Region us-west-2 Set-Location ProjectData:\Contoh 3: Memasang drive root akun menggunakan kredenSIAL dari profil bernama.
Mount-S3PSDrive -Name Archive -ProfileName my-profile -Region us-east-1-
Untuk detail API, lihat Mount-S3PSDrive di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanNew-S3Bucket.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini membuat bucket pribadi baru bernama “sample-bucket”.
New-S3Bucket -BucketName amzn-s3-demo-bucketContoh 2: Perintah ini membuat bucket baru bernama “sample-bucket” dengan izin baca-tulis.
New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadWriteContoh 3: Perintah ini membuat bucket baru bernama “sample-bucket” dengan izin read-only.
New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadOnlyContoh 4: Perintah ini membuat bucket Direktori baru bernama “amzn-s3-demo-bucket--use1-az5--x-s3" dengan. PutBucketConfiguration
$bucketConfiguration = @{ BucketInfo = @{ DataRedundancy = 'SingleAvailabilityZone' Type = 'Directory' } Location = @{ Name = 'usw2-az1' Type = 'AvailabilityZone' } } New-S3Bucket -BucketName amzn-s3-demo-bucket--usw2-az1--x-s3 -BucketConfiguration $bucketConfiguration -Region us-west-2-
Untuk detail API, lihat PutBucket di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRead-S3Object.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengambil item "sample.txt" dari bucket “amzn-s3-demo-bucket” dan menyimpannya ke file bernama "local-sample.txt" di lokasi saat ini. File "local-sample.txt" tidak harus ada sebelum perintah ini dipanggil.
Read-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -File local-sample.txtContoh 2: Perintah ini mengambil direktori virtual “DIR” dari bucket “amzn-s3-demo-bucket” dan menyimpannya ke folder bernama "" di lokasi saat ini. Local-DIR Folder "Local-DIR" tidak harus ada sebelum perintah ini dipanggil.
Read-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix DIR -Folder Local-DIRContoh 3: Mengunduh semua objek dengan kunci yang diakhiri dengan '.json' dari bucket dengan 'config' di nama bucket ke file di folder yang ditentukan. Tombol objek digunakan untuk mengatur nama file.
Get-S3Bucket | ? { $_.BucketName -like '*config*' } | Get-S3Object | ? { $_.Key -like '*.json' } | Read-S3Object -Folder C:\ConfigObjectsContoh 4: Mengunduh satu objek menggunakan unduhan paralel multibagian untuk meningkatkan kinerja pada file besar.
Read-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -File local-sample.txt -UseMultipartDownloadContoh 5: Mengunduh objek besar menggunakan mode RANGE dengan ukuran bagian 64MB khusus. Mode RANGE menggunakan permintaan rentang byte HTTP dan berfungsi untuk semua objek terlepas dari bagaimana mereka diunggah.
Read-S3Object -BucketName amzn-s3-demo-bucket -Key large-file.zip -File local-large-file.zip -UseMultipartDownload -MultipartDownloadType RANGE -PartSize 64MBContoh 6: Mengunduh semua objek dengan awalan kunci “data/” ke folder lokal menggunakan unduhan multibagian dengan unduhan file bersamaan.
Read-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data/ -Folder C:\local-data -UseMultipartDownload -DownloadFilesConcurrentlyContoh 7: Mengunduh satu objek menggunakan unduhan multibagian dengan 20 koneksi bersamaan untuk throughput maksimum pada jaringan bandwidth tinggi.
Read-S3Object -BucketName amzn-s3-demo-bucket -Key large-file.zip -File local-large-file.zip -UseMultipartDownload -ConcurrentServiceRequest 20Contoh 8: Mengunduh semua objek dengan awalan kunci “data/” ke folder lokal menggunakan unduhan multibagian, melanjutkan kegagalan file individual sebelumnya alih-alih membatalkan.
Read-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data/ -Folder C:\local-data -UseMultipartDownload -FailurePolicy ContinueOnFailure-
Untuk detail API, lihat GetObject di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3Bucket.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini menghapus semua objek dan versi objek dari bucket 'test-files' dan kemudian menghapus bucket. Perintah akan meminta konfirmasi sebelum melanjutkan. Tambahkan sakelar -Force untuk menekan konfirmasi. Perhatikan bahwa bucket yang tidak kosong tidak dapat dihapus.
Remove-S3Bucket -BucketName amzn-s3-demo-bucket -DeleteBucketContent-
Untuk detail API, lihat DeleteBucket di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3BucketAnalyticsConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah menghapus filter analitik dengan nama 'testfilter' di bucket S3 yang diberikan.
Remove-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'-
Untuk detail API, lihat DeleteBucketAnalyticsConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3BucketEncryption.
- Alat untuk PowerShell V5
-
Contoh 1: Ini menonaktifkan enkripsi yang diaktifkan untuk bucket S3 yang disediakan.
Remove-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'Output:
Confirm Are you sure you want to perform this action? Performing the operation "Remove-S3BucketEncryption (DeleteBucketEncryption)" on target "s3casetestbucket". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y-
Untuk detail API, lihat DeleteBucketEncryption di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3BucketInventoryConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini menghapus invventory bernama InventoryName 'test' yang sesuai dengan bucket S3 yang diberikan.
Remove-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testInventoryName'Output:
Confirm Are you sure you want to perform this action? Performing the operation "Remove-S3BucketInventoryConfiguration (DeleteBucketInventoryConfiguration)" on target "amzn-s3-demo-bucket". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y-
Untuk detail API, lihat DeleteBucketInventoryConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3BucketMetricsConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah menghapus filter metrik dengan nama 'testmetrics' di bucket S3 yang diberikan.
Remove-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testmetrics'-
Untuk detail API, lihat DeleteBucketMetricsConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3BucketPolicy.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah menghapus kebijakan bucket yang terkait dengan bucket S3 yang diberikan.
Remove-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'-
Untuk detail API, lihat DeleteBucketPolicy di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3BucketReplication.
- Alat untuk PowerShell V5
-
Contoh 1: Menghapus konfigurasi replikasi yang terkait dengan bucket bernama 'amzn-s3-demo-bucket'. Perhatikan bahwa operasi ini memerlukan izin untuk DeleteReplicationConfiguration tindakan s3:. Anda akan diminta untuk konfirmasi sebelum operasi berlangsung - untuk menekan konfirmasi, gunakan sakelar -Force.
Remove-S3BucketReplication -BucketName amzn-s3-demo-bucket-
Untuk detail API, lihat DeleteBucketReplication di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3BucketTagging.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini menghapus semua tag yang terkait dengan bucket S3 yang diberikan.
Remove-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'Output:
Confirm Are you sure you want to perform this action? Performing the operation "Remove-S3BucketTagging (DeleteBucketTagging)" on target "amzn-s3-demo-bucket". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y-
Untuk detail API, lihat DeleteBucketTagging di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3BucketWebsite.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini menonaktifkan properti hosting situs web statis dari bucket S3 yang diberikan.
Remove-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'Output:
Confirm Are you sure you want to perform this action? Performing the operation "Remove-S3BucketWebsite (DeleteBucketWebsite)" on target "amzn-s3-demo-bucket". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y-
Untuk detail API, lihat DeleteBucketWebsite di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3CORSConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini menghapus konfigurasi CORS untuk bucket S3 yang diberikan.
Remove-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket'Output:
Confirm Are you sure you want to perform this action? Performing the operation "Remove-S3CORSConfiguration (DeleteCORSConfiguration)" on target "amzn-s3-demo-bucket". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y-
Untuk detail API, lihat DeleteCorsConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3LifecycleConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah menghapus semua aturan siklus hidup untuk bucket S3 yang diberikan.
Remove-S3LifecycleConfiguration -BucketName 'amzn-s3-demo-bucket'-
Untuk detail API, lihat DeleteLifecycleConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3MultipartUpload.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini membatalkan upload multipart yang dibuat lebih awal dari 5 hari yang lalu.
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -DaysBefore 5Contoh 2: Perintah ini membatalkan upload multipart yang dibuat sebelum 2 Januari 2014.
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "Thursday, January 02, 2014"Contoh 3: Perintah ini membatalkan upload multipart yang dibuat lebih awal dari 2 Januari 2014, 10:45:37.
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "2014/01/02 10:45:37"-
Untuk detail API, lihat AbortMultipartUpload di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3Object.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini menghapus objek "sample.txt" dari bucket “test-files”. Anda diminta untuk konfirmasi sebelum perintah dieksekusi; untuk menekan prompt gunakan sakelar -Force.
Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txtContoh 2: Perintah ini menghapus versi objek yang ditentukan "sample.txt" dari bucket “test-files”, dengan asumsi bucket telah dikonfigurasi untuk mengaktifkan versi objek.
Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -VersionId HLbxnx6V9omT6AQYVpks8mmFKQcejpqtContoh 3: Perintah ini menghapus objek "sample1.txt “," sample2.txt "dan" sample3.txt "dari bucket “test-files” sebagai operasi batch tunggal. Respon layanan akan mencantumkan semua kunci yang diproses, terlepas dari status keberhasilan atau kesalahan penghapusan. Untuk mendapatkan hanya kesalahan untuk kunci yang tidak dapat diproses oleh layanan tambahkan ReportErrorsOnly parameter - (parameter ini juga dapat ditentukan dengan alias -Quiet.
Remove-S3Object -BucketName amzn-s3-demo-bucket -KeyCollection @( "sample1.txt", "sample2.txt", "sample3.txt" )Contoh 4: Contoh ini menggunakan ekspresi sebaris dengan KeyCollection parameter - untuk mendapatkan kunci objek yang akan dihapus. Get-S3Object mengembalikan kumpulan Amazon.S3.Model.S3Object instance, yang masing-masing memiliki anggota kunci dari jenis string yang mengidentifikasi objek.
Remove-S3Object -bucketname "amzn-s3-demo-bucket" -KeyCollection (Get-S3Object "test-files" -KeyPrefix "prefix/subprefix" | select -ExpandProperty Key)Contoh 5: Contoh ini memperoleh semua objek yang memiliki awalan kunci "prefix/subprefix" di bucket dan menghapusnya. Perhatikan bahwa objek yang masuk diproses satu per satu. Untuk koleksi besar, pertimbangkan untuk meneruskan koleksi ke parameter - InputObject (alias -S3ObjectCollection) cmdlet untuk mengaktifkan penghapusan terjadi sebagai batch dengan satu panggilan ke layanan.
Get-S3Object -BucketName "amzn-s3-demo-bucket" -KeyPrefix "prefix/subprefix" | Remove-S3Object -ForceContoh 6: Contoh ini menyalurkan kumpulan Amazon.S3.Model.S3ObjectVersion instance yang mewakili penanda hapus ke cmdlet untuk dihapus. Perhatikan bahwa objek yang masuk diproses satu per satu. Untuk koleksi besar, pertimbangkan untuk meneruskan koleksi ke parameter - InputObject (alias -S3ObjectCollection) cmdlet untuk mengaktifkan penghapusan terjadi sebagai batch dengan satu panggilan ke layanan.
(Get-S3Version -BucketName "amzn-s3-demo-bucket").Versions | Where {$_.IsDeleteMarker -eq "True"} | Remove-S3Object -ForceContoh 7: Script ini menunjukkan cara melakukan penghapusan batch dari sekumpulan objek (dalam hal ini hapus penanda) dengan membangun array objek yang akan digunakan dengan KeyAndVersionCollection parameter -.
$keyVersions = @() $markers = (Get-S3Version -BucketName $BucketName).Versions | Where {$_.IsDeleteMarker -eq "True"} foreach ($marker in $markers) { $keyVersions += @{ Key = $marker.Key; VersionId = $marker.VersionId } } Remove-S3Object -BucketName $BucketName -KeyAndVersionCollection $keyVersions -Force-
Untuk detail API, lihat DeleteObjects di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3ObjectTagSet.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini menghapus semua tag yang terkait dengan objek dengan kunci 'testfile.txt' di Bucket S3 yang diberikan.
Remove-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket' -Select '^Key'Output:
Confirm Are you sure you want to perform this action? Performing the operation "Remove-S3ObjectTagSet (DeleteObjectTagging)" on target "testfile.txt". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y testfile.txt-
Untuk detail API, lihat DeleteObjectTagging di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-S3PublicAccessBlock.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mematikan pengaturan akses publik blok untuk bucket yang diberikan.
Remove-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket' -Force -Select '^BucketName'Output:
amzn-s3-demo-bucket-
Untuk detail API, lihat DeletePublicAccessBlock di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanSet-S3BucketEncryption.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengaktifkan enkripsi sisi server AES256 default dengan Amazon S3 Managed Keys (SSE-S3) pada bucket yang diberikan.
$Encryptionconfig = @{ServerSideEncryptionByDefault = @{ServerSideEncryptionAlgorithm = "AES256"}} Set-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket' -ServerSideEncryptionConfiguration_ServerSideEncryptionRule $Encryptionconfig-
Untuk detail API, lihat PutBucketEncryption di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanTest-S3Bucket.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengembalikan True jika bucket ada, False sebaliknya. Perintah mengembalikan True meskipun bucket bukan milik pengguna.
Test-S3Bucket -BucketName amzn-s3-demo-bucket-
Untuk detail API, lihat Test-S3Bucket di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanWrite-S3BucketAccelerateConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengaktifkan akselerasi transfer untuk bucket S3 yang diberikan.
$statusVal = New-Object Amazon.S3.BucketAccelerateStatus('Enabled') Write-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket' -AccelerateConfiguration_Status $statusVal-
Untuk detail API, lihat PutBucketAccelerateConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanWrite-S3BucketNotification.
- Alat untuk PowerShell V5
-
Contoh 1: Contoh ini mengonfigurasi konfigurasi topik SNS untuk acara S3 ObjectRemovedDelete dan mengaktifkan notifikasi untuk bucket s3 yang diberikan
$topic = [Amazon.S3.Model.TopicConfiguration] @{ Id = "delete-event" Topic = "arn:aws:sns:eu-west-1:123456789012:topic-1" Event = [Amazon.S3.EventType]::ObjectRemovedDelete } Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -TopicConfiguration $topicContoh 2: Contoh ini mengaktifkan notifikasi ObjectCreatedAll untuk bucket yang diberikan mengirimkannya ke fungsi Lambda.
$lambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{ Events = "s3:ObjectCreated:*" FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:rdplock" Id = "ObjectCreated-Lambda" Filter = @{ S3KeyFilter = @{ FilterRules = @( @{Name="Prefix";Value="dada"} @{Name="Suffix";Value=".pem"} ) } } } Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -LambdaFunctionConfiguration $lambdaConfigContoh 3: Contoh ini membuat 2 konfigurasi Lambda yang berbeda berdasarkan akhiran kunci yang berbeda dan dikonfigurasi keduanya dalam satu perintah.
#Lambda Config 1 $firstLambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{ Events = "s3:ObjectCreated:*" FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:verifynet" Id = "ObjectCreated-dada-ps1" Filter = @{ S3KeyFilter = @{ FilterRules = @( @{Name="Prefix";Value="dada"} @{Name="Suffix";Value=".ps1"} ) } } } #Lambda Config 2 $secondlambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{ Events = [Amazon.S3.EventType]::ObjectCreatedAll FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:verifyssm" Id = "ObjectCreated-dada-json" Filter = @{ S3KeyFilter = @{ FilterRules = @( @{Name="Prefix";Value="dada"} @{Name="Suffix";Value=".json"} ) } } } Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -LambdaFunctionConfiguration $firstLambdaConfig,$secondlambdaConfig-
Untuk detail API, lihat PutBucketNotification di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanWrite-S3BucketReplication.
- Alat untuk PowerShell V5
-
Contoh 1: Contoh ini menetapkan konfigurasi replikasi dengan aturan tunggal yang memungkinkan replikasi ke bucket 'amzn-s3-demo-bucket' setiap objek baru yang dibuat dengan awalan nama kunci "" di bucket 'amzn-s3-demo-bucket'. TaxDocs
$rule1 = New-Object Amazon.S3.Model.ReplicationRule $rule1.ID = "Rule-1" $rule1.Status = "Enabled" $rule1.Prefix = "TaxDocs" $rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" } $params = @{ BucketName = "amzn-s3-demo-bucket" Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3" Configuration_Rule = $rule1 } Write-S3BucketReplication @paramsContoh 2: Contoh ini menetapkan konfigurasi replikasi dengan beberapa aturan yang memungkinkan replikasi ke bucket 'amzn-s3-demo-bucket' setiap objek baru yang dibuat dengan awalan nama kunci "" atau "”. TaxDocs OtherDocs Awalan kunci tidak boleh tumpang tindih.
$rule1 = New-Object Amazon.S3.Model.ReplicationRule $rule1.ID = "Rule-1" $rule1.Status = "Enabled" $rule1.Prefix = "TaxDocs" $rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" } $rule2 = New-Object Amazon.S3.Model.ReplicationRule $rule2.ID = "Rule-2" $rule2.Status = "Enabled" $rule2.Prefix = "OtherDocs" $rule2.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" } $params = @{ BucketName = "amzn-s3-demo-bucket" Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3" Configuration_Rule = $rule1,$rule2 } Write-S3BucketReplication @paramsContoh 3: Contoh ini memperbarui konfigurasi replikasi pada bucket yang ditentukan untuk menonaktifkan aturan yang mengendalikan replikasi objek dengan awalan nama kunci "TaxDocs" ke bucket 'amzn-s3-demo-bucket'.
$rule1 = New-Object Amazon.S3.Model.ReplicationRule $rule1.ID = "Rule-1" $rule1.Status = "Disabled" $rule1.Prefix = "TaxDocs" $rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" } $params = @{ BucketName = "amzn-s3-demo-bucket" Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3" Configuration_Rule = $rule1 } Write-S3BucketReplication @params-
Untuk detail API, lihat PutBucketReplication di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanWrite-S3BucketRequestPayment.
- Alat untuk PowerShell V5
-
Contoh 1: Memperbarui konfigurasi pembayaran permintaan untuk bucket bernama 'amzn-s3-demo-bucket' sehingga orang yang meminta unduhan dari bucket akan dikenakan biaya untuk unduhan. Secara default pemilik bucket membayar unduhan. Untuk mengatur pembayaran permintaan kembali ke default gunakan 'BucketOwner' untuk parameter RequestPaymentConfiguration _Payer.
Write-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket -RequestPaymentConfiguration_Payer Requester-
Untuk detail API, lihat PutBucketRequestPayment di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanWrite-S3BucketTagging.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini menerapkan dua tag ke bucket bernama
cloudtrail-test-2018: tag dengan kunci Stage dan nilai Test, dan tag dengan kunci Environment dan nilai Alpha. Untuk memverifikasi bahwa tag ditambahkan ke bucket, jalankanGet-S3BucketTagging -BucketName bucket_name. Hasilnya harus menunjukkan tag yang Anda terapkan ke bucket dalam perintah pertama. Perhatikan bahwaWrite-S3BucketTaggingmengganti seluruh set tag yang ada pada bucket. Untuk menambah atau menghapus tag individual, jalankan cmdlet Resource Groups dan Tagging API, dan.Add-RGTResourceTagRemove-RGTResourceTagAtau, gunakan Editor Tag di AWS Management Console untuk mengelola tag bucket S3.Write-S3BucketTagging -BucketName amzn-s3-demo-bucket -TagSet @( @{ Key="Stage"; Value="Test" }, @{ Key="Environment"; Value="Alpha" } )Contoh 2: Perintah ini menyalurkan bucket bernama
cloudtrail-test-2018ke dalamWrite-S3BucketTaggingcmdlet. Ini menerapkan tag Stage:Production dan Department:Finance ke ember. Perhatikan bahwaWrite-S3BucketTaggingmengganti seluruh set tag yang ada pada bucket.Get-S3Bucket -BucketName amzn-s3-demo-bucket | Write-S3BucketTagging -TagSet @( @{ Key="Stage"; Value="Production" }, @{ Key="Department"; Value="Finance" } )-
Untuk detail API, lihat PutBucketTagging di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanWrite-S3BucketVersioning.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah mengaktifkan pembuatan versi untuk bucket S3 yang diberikan.
Write-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket' -VersioningConfig_Status Enabled-
Untuk detail API, lihat PutBucketVersioning di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanWrite-S3BucketWebsite.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah mengaktifkan hosting situs web untuk bucket yang diberikan dengan dokumen indeks sebagai 'index.html' dan dokumen kesalahan sebagai 'error.html'.
Write-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket' -WebsiteConfiguration_IndexDocumentSuffix 'index.html' -WebsiteConfiguration_ErrorDocument 'error.html'-
Untuk detail API, lihat PutBucketWebsite di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanWrite-S3LifecycleConfiguration.
- Alat untuk PowerShell V5
-
Contoh 1: Contoh ini menulis/menggantikan konfigurasi yang disediakan di $NewRule. Konfigurasi ini memastikan untuk membatasi objek cakupan dengan nilai awalan dan tag yang diberikan.
$NewRule = [Amazon.S3.Model.LifecycleRule] @{ Expiration = @{ Days= 50 } Id = "Test-From-Write-cmdlet-1" Filter= @{ LifecycleFilterPredicate = [Amazon.S3.Model.LifecycleAndOperator]@{ Operands= @( [Amazon.S3.Model.LifecyclePrefixPredicate] @{ "Prefix" = "py" }, [Amazon.S3.Model.LifecycleTagPredicate] @{ "Tag"= @{ "Key" = "non-use" "Value" = "yes" } } ) } } "Status"= 'Enabled' NoncurrentVersionExpiration = @{ NoncurrentDays = 75 } } Write-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket -Configuration_Rule $NewRuleContoh 2: Contoh ini menetapkan beberapa aturan dengan pemfilteran. $ ArchiveRule mengatur objek untuk diarsipkan dalam 30 hari ke Glacier dan 120 ke DeepArchive. $ ked ExpireRule aluwarsa versi saat ini dan versi sebelumnya dalam 150 hari untuk objek dengan awalan 'py' dan tag:key 'diarsipkan' disetel ke 'ya'.
$ExpireRule = [Amazon.S3.Model.LifecycleRule] @{ Expiration = @{ Days= 150 } Id = "Remove-in-150-days" Filter= @{ LifecycleFilterPredicate = [Amazon.S3.Model.LifecycleAndOperator]@{ Operands= @( [Amazon.S3.Model.LifecyclePrefixPredicate] @{ "Prefix" = "py" }, [Amazon.S3.Model.LifecycleTagPredicate] @{ "Tag"= @{ "Key" = "archived" "Value" = "yes" } } ) } } Status= 'Enabled' NoncurrentVersionExpiration = @{ NoncurrentDays = 150 } } $ArchiveRule = [Amazon.S3.Model.LifecycleRule] @{ Expiration = $null Id = "Archive-to-Glacier-in-30-days" Filter= @{ LifecycleFilterPredicate = [Amazon.S3.Model.LifecycleAndOperator]@{ Operands= @( [Amazon.S3.Model.LifecyclePrefixPredicate] @{ "Prefix" = "py" }, [Amazon.S3.Model.LifecycleTagPredicate] @{ "Tag"= @{ "Key" = "reviewed" "Value" = "yes" } } ) } } Status = 'Enabled' NoncurrentVersionExpiration = @{ NoncurrentDays = 75 } Transitions = @( @{ Days = 30 "StorageClass"= 'Glacier' }, @{ Days = 120 "StorageClass"= [Amazon.S3.S3StorageClass]::DeepArchive } ) } Write-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket -Configuration_Rule $ExpireRule,$ArchiveRule-
Untuk detail API, lihat PutLifecycleConfiguration di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanWrite-S3Object.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah ini mengunggah file tunggal "local-sample.txt" ke Amazon S3, membuat objek dengan kunci "sample.txt" di bucket “test-files”.
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -File .\local-sample.txtContoh 2: Perintah ini mengunggah file tunggal "sample.txt" ke Amazon S3, membuat objek dengan kunci "sample.txt" di bucket “test-files”. Jika parameter -Key tidak disediakan, nama file digunakan sebagai kunci objek S3.
Write-S3Object -BucketName amzn-s3-demo-bucket -File .\sample.txtContoh 3: Perintah ini mengunggah file tunggal "local-sample.txt" ke Amazon S3, membuat objek dengan kunci "prefix/to/sample.txt" di bucket “test-files”.
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "prefix/to/sample.txt" -File .\local-sample.txtContoh 4: Perintah ini mengunggah semua file di subdirektori “Skrip” ke bucket “test-files” dan menerapkan awalan kunci umum "SampleScripts" untuk setiap objek. Setiap file yang diunggah akan memiliki kunci "SampleScripts/filename" di mana 'nama file' bervariasi.
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\Contoh 5: Perintah ini mengunggah semua file*.ps1 di direktur lokal “Skrip” ke bucket “test-files” dan menerapkan awalan kunci umum "" SampleScripts untuk setiap objek. Setiap file yang diunggah akan memiliki kunci "SampleScripts/filename.ps1" di mana 'nama file' bervariasi.
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\ -SearchPattern *.ps1Contoh 6: Perintah ini membuat objek S3 baru yang berisi string konten tertentu dengan kunci 'sample.txt'.
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -Content "object contents"Contoh 7: Perintah ini mengunggah file yang ditentukan (nama file digunakan sebagai kunci) dan menerapkan tag yang ditentukan ke objek baru.
Write-S3Object -BucketName amzn-s3-demo-bucket -File "sample.txt" -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}Contoh 8: Perintah ini secara rekursif mengunggah folder yang ditentukan dan menerapkan tag yang ditentukan ke semua objek baru.
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder . -KeyPrefix "TaggedFiles" -Recurse -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}-
Untuk detail API, lihat PutObject di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanWrite-S3ObjectRetention.
- Alat untuk PowerShell V5
-
Contoh 1: Perintah mengaktifkan mode retensi tata kelola hingga tanggal '31 Des 2019 00:00:00 'untuk objek' testfile.txt 'di bucket S3 yang diberikan.
Write-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt' -Retention_Mode GOVERNANCE -Retention_RetainUntilDate "2019-12-31T00:00:00"-
Untuk detail API, lihat PutObjectRetention di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-