

Versi 5 (V5) dari Alat AWS untuk PowerShell telah dirilis\$1

Untuk informasi tentang melanggar perubahan dan memigrasi aplikasi Anda, lihat [topik migrasi](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)

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

# Instal AWSPower Shell di Windows PowerShell (warisan)
<a name="ps-installing-awswindowspowershell"></a>

[Untuk informasi umum tentang menginstal Alat AWS untuk PowerShell pada Windows, termasuk prasyarat dan opsi lainnya, lihat topik induk.](pstools-getting-set-up-windows.md)

Untuk informasi tentang Alat PowerShell yang sudah diinstal sebelumnya AWS CloudShell, lihat[Diinstal pada CloudShell](pstools-getting-set-up-cloudshell.md).

**catatan**  
AWSPowerShell bukan metode yang disarankan untuk menginstal Alat AWS untuk PowerShell. Untuk metode yang direkomendasikan, lihat [Instal `AWS.Tools` (disarankan)](ps-installing-awstools.md) sebagai gantinya.

Anda dapat menginstal AWS Tools for Windows PowerShell dalam salah satu dari dua cara:
+ Mengunduh modul dari [AWSPowerShell.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.zip) dan mengekstraknya di salah satu direktori modul. Anda dapat menemukan direktori modul Anda dengan menampilkan nilai variabel `PSModulePath` lingkungan.
**Awas**  
Setelah mengunduh file ZIP dan sebelum mengekstrak konten, Anda mungkin perlu membuka blokir. Ini biasanya dilakukan dengan membuka properti file, melihat tab **Umum**, dan memilih kotak centang **Buka Blokir** jika ada.  
Jika file ZIP perlu dibuka blokir tetapi Anda tidak melakukannya, Anda mungkin menerima kesalahan yang mirip dengan yang berikut: “Modul Import: Tidak dapat memuat file atau perakitan”.
+ Menginstal dari PowerShell Galeri menggunakan `Install-Module` cmdlet seperti yang dijelaskan dalam prosedur berikut.

**Untuk menginstal AWSPower Shell dari PowerShell Galeri menggunakan cmdlet Install-Module**

Anda dapat menginstal AWSPower Shell dari PowerShell Galeri jika Anda menjalankan PowerShell 5.0 atau lebih baru, atau telah diinstal [PowerShellGet](https://www.powershellgallery.com/packages/PowerShellGet)pada PowerShell 3 atau lebih baru. Anda dapat menginstal dan memperbarui AWSPower Shell dari [PowerShellGaleri](https://www.powershellgallery.com/packages/AWSPowerShell) Microsoft dengan menjalankan perintah berikut.

```
 PS > Install-Module -Name AWSPowerShell
```

Untuk memuat modul AWSPower Shell ke dalam PowerShell sesi secara otomatis, tambahkan `import-module` cmdlet sebelumnya ke profil Anda PowerShell . Untuk informasi selengkapnya tentang mengedit PowerShell profil Anda, lihat [Tentang Profil](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-6) di PowerShell dokumentasi.

## Aktifkan Eksekusi Skrip
<a name="enable-script-execution-windows-ps"></a>

Untuk memuat Alat AWS untuk PowerShell modul, Anda harus mengaktifkan eksekusi PowerShell skrip. Untuk mengaktifkan eksekusi skrip, jalankan cmdlet `Set-ExecutionPolicy` untuk menetapkan kebijakan `RemoteSigned`. Untuk informasi selengkapnya, lihat [Tentang Kebijakan Eksekusi](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies) di situs web Microsoft Technet.

**catatan**  
Ini adalah persyaratan hanya untuk komputer yang menjalankan Windows. Pembatasan keamanan `ExecutionPolicy` tidak ada pada sistem operasi lain.

 **Untuk mengaktifkan eksekusi skrip** 

1. Hak administrator diperlukan untuk menetapkan kebijakan eksekusi. Jika Anda tidak masuk sebagai pengguna dengan hak administrator, buka PowerShell sesi sebagai Administrator. Pilih **Mulai**, lalu pilih **Semua Program**. Pilih **Aksesoris**, lalu pilih **Windows PowerShell**. Klik kanan **Windows PowerShell**, dan pada menu konteks, pilih **Jalankan sebagai administrator**.

1. Di prompt perintah, masukkan perintah berikut.

   ```
   PS > Set-ExecutionPolicy RemoteSigned 
   ```

**catatan**  
Pada sistem 64-bit, Anda harus melakukan ini secara terpisah untuk versi 32-bit PowerShell, **Windows PowerShell (x86**).

Jika kebijakan eksekusi tidak disetel dengan benar, PowerShell menampilkan kesalahan berikut setiap kali Anda mencoba menjalankan skrip, seperti profil Anda.

```
File C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1 cannot be loaded because the execution
 of scripts is disabled on this system. Please see "get-help about_signing" for more details.
At line:1 char:2
+ . <<<<  'C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1'
    + CategoryInfo          : NotSpecified: (:) [], PSSecurityException
    + FullyQualifiedErrorId : RuntimeException
```

 PowerShell Penginstal Alat untuk Windows secara otomatis memperbarui [PSModulePath](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_psmodulepath) untuk menyertakan lokasi direktori yang berisi `AWSPowerShell` modul. 

Karena `PSModulePath` menyertakan lokasi direktori AWS modul, `Get-Module -ListAvailable` cmdlet menunjukkan modul.

```
PS > Get-Module -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   AppLocker                 {}
Manifest   BitsTransfer              {}
Manifest   PSDiagnostics             {}
Manifest   TroubleshootingPack       {}
Manifest   AWSPowerShell             {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol...
```

## Penentuan versi
<a name="pstools-versioning-windows-ps"></a>

AWS merilis versi baru secara Alat AWS untuk PowerShell berkala untuk mendukung AWS layanan dan fitur baru. Untuk menentukan versi Tools yang telah Anda instal, jalankan [Get- AWSPower ShellVersion](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html) cmdlet.

Contoh:

```
PS > Get-AWSPowerShellVersion

AWS Tools for PowerShell
Version 5.0.3
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

Amazon Web Services SDK for .NET
Core Runtime Version 4.0.0.13
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/main/changelogs/CHANGELOG.ALL.md

This software includes third party software subject to the following copyrights:
- Logging from log4net, Apache License
[http://logging.apache.org/log4net/license.html]
```

Anda juga dapat menambahkan `-ListServiceVersionInfo` parameter ke AWSPower ShellVersion perintah [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html) untuk melihat daftar AWS layanan yang didukung dalam versi alat saat ini. Jika Anda menggunakan pilihan `AWS.Tools.*` termodulasikan, hanya modul yang saat ini Anda telah impor yang akan ditampilkan.

Contoh:

```
PS > Get-AWSPowerShellVersion -ListServiceVersionInfo
...

Service                            Noun Prefix Module Name                       SDK
                                                                                 Assembly
                                                                                 Version
-------                            ----------- -----------                       -----------
AWS IAM Access Analyzer            IAMAA       AWS.Tools.AccessAnalyzer          3.7.400.33
AWS Account                        ACCT        AWS.Tools.Account                 3.7.400.33
AWS Certificate Manager Private... PCA         AWS.Tools.ACMPCA                  3.7.400.34
AWS Amplify                        AMP         AWS.Tools.Amplify                 3.7.401.28
Amplify Backend                    AMPB        AWS.Tools.AmplifyBackend          3.7.400.33
...
```

Untuk menentukan versi PowerShell yang Anda jalankan, masukkan `$PSVersionTable` untuk melihat isi [variabel otomatis](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6) \$1 PSVersion Tabel.

Contoh:

```
PS > $PSVersionTable

Name                           Value
----                           -----
PSVersion                      6.2.2
PSEdition                      Core
GitCommitId                    6.2.2
OS                             Darwin 18.7.0 Darwin Kernel Version 18.7.0: Tue Aug 20 16:57:14 PDT 2019; root:xnu-4903.271.2~2/RELEASE_X86_64
Platform                       Unix
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1
WSManStackVersion              3.0
```

## Memperbarui Alat AWS untuk PowerShell pada Windows
<a name="pstools-updating-windows-ps"></a>

Secara berkala, saat versi terbaru dirilis, Anda harus memperbarui versi yang Anda jalankan secara lokal. Alat AWS untuk PowerShell 

### Perbarui Alat untuk Windows PowerShell
<a name="update-the-tools-for-windows-powershell"></a>

Jalankan `Get-AWSPowerShellVersion` cmdlet untuk menentukan versi yang Anda jalankan, dan bandingkan dengan versi Alat untuk Windows PowerShell yang tersedia di situs web [PowerShell Galeri](https://www.powershellgallery.com/packages/AWSPowerShell). Kami sarankan Anda memeriksanya setiap dua sampai tiga minggu. Support untuk perintah dan AWS layanan baru hanya tersedia setelah Anda memperbarui ke versi dengan dukungan itu.
+ Jika Anda menginstal dengan menggunakan `Install-Module`, jalankan perintah berikut.

  ```
  PS > Uninstall-Module -Name AWSPowerShell -AllVersions
  PS > Install-Module -Name AWSPowerShell
  ```
+ Jika Anda menginstal dengan menggunakan file ZIP yang diunduh:

  1. Unduh versi terbaru dari [Tools for PowerShell](https://aws.amazon.com/powershell/) web site. Bandingkan nomor versi paket dalam nama file yang diunduh dengan nomor versi yang Anda dapatkan saat menjalankan cmdlet `Get-AWSPowerShellVersion`.

  1. Jika versi unduhan adalah angka yang lebih tinggi dari versi yang telah Anda instal, tutup semua Alat untuk PowerShell konsol Windows.

  1. Instal versi yang lebih baru dari Tools untuk Windows PowerShell.

Setelah instalasi, jalankan `Import-Module AWSPowerShell` untuk memuat cmdlet yang diperbarui ke sesi Anda PowerShell . Atau jalankan Alat AWS untuk PowerShell konsol khusus dari menu **Start** Anda.