

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. NetCore di Linux atau macOS
<a name="install-netcore-on-linux-macos"></a>

[Untuk informasi umum tentang menginstal Alat AWS untuk PowerShell di Linux atau macOS, termasuk prasyarat dan opsi lainnya, lihat topik induk.](pstools-getting-set-up-linux-mac.md)

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

**catatan**  
AWSPowerCangkang. NetCore bukan metode yang disarankan untuk menginstal Alat AWS untuk PowerShell. Untuk metode yang direkomendasikan, lihat [Instal `AWS.Tools` (disarankan)](install-aws.tools-on-linux-macos.md) sebagai gantinya.

Untuk meng-upgrade ke rilis AWSPower Shell yang lebih baru. NetCore, ikuti instruksi di[Memperbarui Alat AWS untuk PowerShell di Linux atau macOS](#pstools-updating-linux-netcore). Copot pemasangan AWSPower Shell versi sebelumnya. NetCore pertama.

Anda dapat menginstal AWSPower Shell. NetCore dalam salah satu dari dua cara:
+ Mengunduh modul dari `[AWSPowerShell.NetCore.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.NetCore.zip)` dan mengekstraknya di salah satu direktori modul. Anda dapat menemukan direktori modul Anda dengan mencetak nilai variabel `$Env:PSModulePath`.
+ Menginstal dari PowerShell Galeri menggunakan `Install-Module` cmdlet seperti yang dijelaskan dalam prosedur berikut.

**Untuk menginstal AWSPower Shell. NetCore di Linux atau macOS menggunakan cmdlet Install-Module**

Mulai sesi PowerShell Core dengan menjalankan perintah berikut.

```
$ pwsh
```

**catatan**  
Kami menyarankan Anda untuk *tidak* memulai PowerShell dengan menjalankan `sudo pwsh` untuk menjalankan PowerShell dengan hak administrator yang tinggi. Hal ini karena potensi risiko keamanan dan tidak sesuai dengan prinsip batasan akses yang paling rendah.

Untuk menginstal AWSPower Shell. NetCore paket modul tunggal dari PowerShell Galeri, jalankan perintah berikut.

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

Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure
 you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): y
```

Jika Anda diberi tahu bahwa repositori “tidak dipercaya”, Anda akan ditanya apakah Anda ingin tetap menginstal. Masukkan **y** untuk memungkinkan PowerShell untuk menginstal modul. Untuk menghindari prompt tanpa mempercayai repositori, Anda dapat menjalankan perintah berikut.

```
PS > Install-Module -Name AWSPowerShell.NetCore -Force
```

Anda tidak perlu menjalankan perintah ini sebagai root, kecuali jika Anda ingin menginstal Alat AWS untuk PowerShell untuk semua pengguna komputer. Untuk melakukan ini, jalankan perintah berikut dalam PowerShell sesi yang telah Anda mulai`sudo pwsh`.

```
PS > Install-Module -Scope AllUsers -Name AWSPowerShell.NetCore -Force
```

## Eksekusi Skrip
<a name="enable-script-execution-netcore"></a>

Perintah `Set-ExecutionPolicy` tidak tersedia pada sistem non-Windows. Anda dapat menjalankan`Get-ExecutionPolicy`, yang menunjukkan bahwa pengaturan kebijakan eksekusi default di PowerShell Core yang berjalan pada sistem non-Windows adalah`Unrestricted`. Untuk informasi selengkapnya, lihat [Tentang Kebijakan Eksekusi](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-5.1) di situs web Microsoft Technet.

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

**AWSPowerCangkang. NetCore**

```
PS > Get-Module -ListAvailable

Directory: /Users/username/.local/share/powershell/Modules

ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                ----------------
Binary     3.3.563.1  AWSPowerShell.NetCore
```

## Konfigurasikan PowerShell Konsol untuk Menggunakan AWS Tools for PowerShell Core (AWSPowerShell. NetCore Hanya)
<a name="pstools-config-ps-window-netcore"></a>

PowerShell Inti biasanya memuat modul secara otomatis setiap kali Anda menjalankan cmdlet dalam modul. Tapi ini tidak berhasil untuk AWSPower Shell. NetCore karena ukurannya yang besar. Untuk mulai menjalankan AWSPower Shell. NetCore cmdlets, Anda harus terlebih dahulu menjalankan perintah. `Import-Module AWSPowerShell.NetCore` Ini tidak diperlukan untuk cmdlet di modul `AWS.Tools`.

## Inisialisasi Sesi Anda PowerShell
<a name="linux-config-init-netcore"></a>

Ketika Anda memulai PowerShell pada sistem berbasis Linux atau MacOS setelah Anda menginstal Alat AWS untuk PowerShell, Anda harus menjalankan [Initialize- AWSDefault Configuration](https://docs.aws.amazon.com/powershell/v5/reference/items/Initialize-AWSDefaultConfiguration.html) untuk menentukan kunci akses mana yang akan digunakan. AWS Untuk informasi selengkapnya tentang `Initialize-AWSDefaultConfiguration`, lihat [Menggunakan AWS Kredensial](specifying-your-aws-credentials.md).

**catatan**  
Dalam rilis sebelumnya (sebelum 3.3.96.0) dari Alat AWS untuk PowerShell, cmdlet ini diberi nama. `Initialize-AWSDefaults`

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

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

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]
```

Untuk melihat daftar AWS layanan yang didukung dalam versi alat saat ini, tambahkan `-ListServiceVersionInfo` parameter ke AWSPower ShellVersion cmdlet [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html).

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

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 di Linux atau macOS
<a name="pstools-updating-linux-netcore"></a>

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

### Perbarui Alat untuk PowerShell Inti
<a name="update-netcore-all-systems"></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.

Sebelum Anda menginstal rilis AWSPower Shell yang lebih baru. NetCore, hapus instalan modul yang ada. Tutup PowerShell sesi terbuka sebelum Anda menghapus paket yang ada. Jalankan perintah berikut untuk menghapus paket.

```
PS > Uninstall-Module -Name AWSPowerShell.NetCore -AllVersions
```

Setelah paket dihapus, instal modul diperbarui dengan menjalankan perintah berikut.

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

Setelah instalasi, jalankan perintah `Import-Module AWSPowerShell.NetCore` untuk memuat cmdlet yang diperbarui ke sesi Anda PowerShell .

## Informasi Terkait
<a name="pstools-seealso-setup-netcore"></a>
+  [Mengkonfigurasi dan menggunakan Alat AWS untuk PowerShell](pstools-getting-started.md) 
+  [AWS Layanan panggilan di Alat AWS untuk PowerShell](pstools-using.md) 