Alat AWS untuk PowerShell V4 telah memasuki mode pemeliharaan.

Kami menyarankan Anda bermigrasi ke [Alat AWS untuk PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/). Untuk detail dan informasi tambahan tentang cara bermigrasi, silakan lihat [pengumuman mode pemeliharaan](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/) kami.

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

# Amazon S3 dan Alat untuk Windows PowerShell
<a name="pstools-s3"></a>

Di bagian ini, kami membuat situs web statis AWS Tools for Windows PowerShell menggunakan Amazon S3 dan. CloudFront Dalam prosesnya, kami menunjukkan sejumlah tugas umum dengan layanan ini. Panduan ini dimodelkan setelah Panduan Memulai untuk [Host Situs Web Statis](https://aws.amazon.com/getting-started/projects/host-static-website/), yang menjelaskan proses serupa menggunakan [Konsol Manajemen AWS](https://console.aws.amazon.com/s3/home).

Perintah yang ditampilkan di sini mengasumsikan bahwa Anda telah menetapkan kredensi default dan wilayah default untuk sesi Anda PowerShell . Oleh karena itu, kredensial dan wilayah tidak termasuk dalam invokasi cmdlet.

**catatan**  
Saat ini tidak ada API Amazon S3 untuk mengganti nama bucket atau objek, dan oleh karena itu, tidak ada satu pun PowerShell cmdlet Alat untuk Windows untuk melakukan tugas ini. Untuk mengganti nama objek di S3, kami sarankan Anda menyalin objek ke objek dengan nama baru, dengan menjalankan [Copy-S3Object](https://docs.aws.amazon.com/powershell/v4/reference/items/Copy-S3Object.html)cmdlet, dan kemudian menghapus objek asli dengan menjalankan cmdlet. [Remove-S3Object](https://docs.aws.amazon.com/powershell/v4/reference/items/Remove-S3Object.html)

**Lihat juga**
+  [Bekerja dengan AWS layanan di Alat AWS untuk PowerShell](pstools-using.md) 
+  [Hosting Situs Web Statis di Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html) 
+  [Konsol Amazon S3](https://console.aws.amazon.com/s3/home) 

**Topics**
+ [Membuat Bucket Amazon S3, Memverifikasi Wilayahnya, dan Memilih Menghapusnya](pstools-s3-bucket-create.md)
+ [Konfigurasi Bucket Amazon S3 sebagai Situs Web dan Aktifkan Pencatatan](pstools-s3-create-website.md)
+ [Unggah Objek ke Bucket Amazon S3](pstools-s3-upload-object.md)
+ [Hapus Obyek dan Bucket Amazon S3](pstools-s3-delete-website.md)
+ [Unggah Konten Teks Selaras ke Amazon S3](pstools-s3-upload-in-line-text.md)

# Membuat Bucket Amazon S3, Memverifikasi Wilayahnya, dan Memilih Menghapusnya
<a name="pstools-s3-bucket-create"></a>

Menggunakan cmdlet `New-S3Bucket` untuk membuat bucket Amazon S3 baru. Contoh berikut membuat bucket dengan nama `website-example`. Nama bucket harus unik di semua wilayah. Contoh tersebut membuat bucket di wilayah `us-west-1`.

```
PS > New-S3Bucket -BucketName website-example -Region us-west-2

CreationDate         BucketName
------------         ----------
8/16/19 8:45:38 PM   website-example
```

Anda dapat memverifikasi wilayah tempat bucket berada menggunakan cmdlet `Get-S3BucketLocation`.

```
PS > Get-S3BucketLocation -BucketName website-example

Value
-----
us-west-2
```

Setelah selesai dengan tutorial ini, Anda dapat menggunakan baris berikut untuk menghapus bucket ini. Kami menyarankan agar Anda membiarkan bucket ini di tempatnya karena kami menggunakannya dalam contoh berikutnya.

```
PS > Remove-S3Bucket -BucketName website-example
```

Perhatikan bahwa proses penghapusan bucket dapat memakan waktu lama hingga selesai. Jika Anda mencoba untuk membuat ulang bucket dengan nama yang sama secara langsung, cmdlet `New-S3Bucket` tidak akan dapat melakukannya hingga bucket lama sepenuhnya hilang.

## Lihat Juga
<a name="pstools-seealso-s3-bucket-create"></a>
+  [Bekerja dengan AWS layanan di Alat AWS untuk PowerShell](pstools-using.md) 
+  [Put Bucket (Referensi Layanan Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUT.html) 
+  [AWS PowerShell Wilayah untuk Amazon S3](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region) 

# Konfigurasi Bucket Amazon S3 sebagai Situs Web dan Aktifkan Pencatatan
<a name="pstools-s3-create-website"></a>

Gunakan cmdlet `Write-S3BucketWebsite` untuk mengkonfigurasi bucket Amazon S3 sebagai situs web statis. Contoh berikut menentukan nama `index.html` untuk halaman web konten default dan nama `error.html` untuk halaman web kesalahan default. Perhatikan bahwa cmdlet ini tidak membuat halaman tersebut. Halaman-halaman tersebut harus [diunggah sebagai objek Amazon S3](pstools-s3-upload-object.md).

```
PS > Write-S3BucketWebsite -BucketName website-example -WebsiteConfiguration_IndexDocumentSuffix index.html -WebsiteConfiguration_ErrorDocument error.html
RequestId      : A1813E27995FFDDD
AmazonId2      : T7hlDOeLqA5Q2XfTe8j2q3SLoP3/5XwhUU3RyJBGHU/LnC+CIWLeGgP0MY24xAlI
ResponseStream :
Headers        : {x-amz-id-2, x-amz-request-id, Content-Length, Date...}
Metadata       : {}
ResponseXml    :
```

## Lihat Juga
<a name="pstools-seealso-s3-create-website"></a>
+  [Bekerja dengan AWS layanan di Alat AWS untuk PowerShell](pstools-using.md) 
+  [Letakkan Situs Web Bucket (Referensi API Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTwebsite.html) 
+  [Letakkan Bucket ACL (Referensi API Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTacl.html) 

# Unggah Objek ke Bucket Amazon S3
<a name="pstools-s3-upload-object"></a>

Gunakan cmdlet `Write-S3Object` untuk meng-unggah file dari sistem file lokal ke bucket Amazon S3 sebagai objek. Contoh di bawah ini menciptakan dan meng-unggah dua file HTML sederhana ke bucket Amazon S3, dan memverifikasi keberadaan objek yang di-unggah. Parameter `-File` ke `Write-S3Object` menentukan nama file dalam sistem file lokal. Parameter `-Key` menentukan nama yang akan dimiliki objek terkait di Amazon S3.

Amazon menyimpulkan konten-jenis objek dari ekstensi file, dalam hal ini, ".html".

```
PS > # Create the two files using here-strings and the Set-Content cmdlet
PS > $index_html = @"
>> <html>
>>   <body>
>>     <p>
>>       Hello, World!
>>     </p>
>>   </body>
>> </html>
>> "@
>>
PS > $index_html | Set-Content index.html
PS > $error_html = @"
>> <html>
>>   <body>
>>     <p>
>>       This is an error page.
>>     </p>
>>   </body>
>> </html>
>> "@
>>
>>$error_html | Set-Content error.html
>># Upload the files to Amazon S3 using a foreach loop
>>foreach ($f in "index.html", "error.html") {
>> Write-S3Object -BucketName website-example -File $f -Key $f -CannedACLName public-read
>> }
>>
PS > # Verify that the files were uploaded
PS > Get-S3BucketWebsite -BucketName website-example

IndexDocumentSuffix                                         ErrorDocument
-------------------                                         -------------
index.html                                                  error.html
```

 *Opsi ACL Kalengan* 

Nilai untuk menentukan kalengan ACLs dengan Alat untuk Windows PowerShell sama dengan yang digunakan oleh. AWS SDK untuk .NET Perhatikan, bagaimanapun, ini berbeda dari nilai-nilai yang digunakan oleh tindakan`Put Object` Amazon S3. Alat untuk Windows PowerShell mendukung kaleng berikut ini ACLs:
+ NoACL
+ private
+ public-read
+ public-read-write
+ aws-exec-read
+ authenticated-read
+ bucket-owner-read
+ bucket-owner-full-control
+ log-delivery-write

Untuk informasi selengkapnya tentang pengaturan canned ACL, lihat [Gambaran Umum Daftar Kontrol Akses](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl).

## Catatan Mengenai Unggahan Multipart
<a name="note-regarding-multipart-upload"></a>

Jika Anda menggunakan API Amazon S3 untuk meng-upload file yang berukuran lebih besar dari 5 GB, Anda perlu menggunakan unggahan multipart. Namun, `Write-S3Object` cmdlet yang disediakan oleh Tools for Windows PowerShell dapat secara transparan menangani unggahan file yang lebih besar dari 5 GB.

### Uji Situs Webnya
<a name="pstools-amazon-s3-test-website"></a>

Pada titik ini, Anda dapat menguji situs web dengan menavigasi ke sana menggunakan browser. URLs untuk situs web statis yang dihosting di Amazon S3 ikuti format standar.

```
http://<bucket-name>.s3-website-<region>.amazonaws.com
```

Misalnya:

```
http://website-example.s3-website-us-west-1.amazonaws.com
```

### Lihat Juga
<a name="pstools-seealso-amazon-s3-test-website"></a>
+  [Bekerja dengan AWS layanan di Alat AWS untuk PowerShell](pstools-using.md) 
+  [Letakkan Objek (Referensi API Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html) 
+  [Kalengan ACLs (Referensi API Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/dev/ACLOverview.html#CannedACL) 

# Hapus Obyek dan Bucket Amazon S3
<a name="pstools-s3-delete-website"></a>

Bagian ini menjelaskan cara menghapus situs web yang Anda buat di bagian sebelumnya. Anda cukup menghapus objek untuk file HTML, dan kemudian menghapus bucket Amazon S3 untuk situs tersebut.

Pertama, jalankan cmdlet `Remove-S3Object` untuk menghapus objek untuk file HTML dari bucket Amazon S3.

```
PS > foreach ( $obj in "index.html", "error.html" ) {
>> Remove-S3Object -BucketName website-example -Key $obj
>> }
>> 
IsDeleteMarker
--------------
False
```

Respon `False` merupakan artefak yang diharapkan dari cara Amazon S3 memproses permintaan. Dalam hal ini, ini bukanlah masalah.

Sekarang Anda dapat menjalankan cmdlet `Remove-S3Bucket` untuk menghapus bucket Amazon S3 yang sudah kosong untuk situs tersebut.

```
PS > Remove-S3Bucket -BucketName website-example

RequestId      : E480ED92A2EC703D
AmazonId2      : k6tqaqC1nMkoeYwbuJXUx1/UDa49BJd6dfLN0Ls1mWYNPHjbc8/Nyvm6AGbWcc2P
ResponseStream :
Headers        : {x-amz-id-2, x-amz-request-id, Date, Server}
Metadata       : {}
ResponseXml    :
```

Di 1.1 dan versi yang lebih baru Alat AWS untuk PowerShell, Anda dapat menambahkan `-DeleteBucketContent` parameter ke`Remove-S3Bucket`, yang pertama-tama menghapus semua objek dan versi objek di bucket yang ditentukan sebelum mencoba menghapus bucket itu sendiri. Bergantung pada jumlah objek atau versi objek dalam bucket, operasi ini dapat memerlukan waktu lama. Dalam versi Tools untuk Windows PowerShell yang lebih tua dari 1.1, bucket harus kosong sebelum `Remove-S3Bucket` bisa menghapusnya.

**catatan**  
Kecuali Anda menambahkan `-Force` parameter, Alat AWS untuk PowerShell meminta Anda untuk konfirmasi sebelum cmdlet berjalan.

## Lihat Juga
<a name="pstools-seealso-amazon-s3-delete-website"></a>
+  [Bekerja dengan AWS layanan di Alat AWS untuk PowerShell](pstools-using.md) 
+  [Hapus Objek (Referensi API Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html) 
+  [DeleteBucket (Referensi API Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketDELETE.html) 

# Unggah Konten Teks Selaras ke Amazon S3
<a name="pstools-s3-upload-in-line-text"></a>

Cmdlet `Write-S3Object` mendukung kemampuan untuk meng-upload konten teks selaras ke Amazon S3. Menggunakan parameter `-Content` (alias `-Text`), Anda dapat menentukan konten berbasis teks yang harus di-unggah ke Amazon S3 tanpa perlu menempatkannya ke dalam file terlebih dahulu. Parameter tersebut menerima string satu baris sederhana serta here string yang berisi beberapa baris.

```
PS > # Specifying content in-line, single line text:
PS > write-s3object amzn-s3-demo-bucket -key myobject.txt -content "file content"

PS > # Specifying content in-line, multi-line text: (note final newline needed to end in-line here-string)
PS > write-s3object amzn-s3-demo-bucket -key myobject.txt -content @"
>> line 1
>> line 2
>> line 3
>> "@
>> 
PS > # Specifying content from a variable: (note final newline needed to end in-line here-string)
PS > $x = @"
>> line 1
>> line 2
>> line 3
>> "@
>> 
PS > write-s3object amzn-s3-demo-bucket -key myobject.txt -content $x
```