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.
# Memulai dengan Alat AWS untuk PowerShell
Topik berikut menunjukkan cara menginstal Alat AWS untuk PowerShell cmdlet dengan sukses dan mengatur otentikasi. AWS
**Topics**
+ [Diinstal pada CloudShell](pstools-getting-set-up-cloudshell.md)
+ [Menginstal pada Windows](pstools-getting-set-up-windows.md)
+ [Memasang pada Linux atau macOS](pstools-getting-set-up-linux-mac.md)
+ [Autentikasi dengan AWS](creds-idc.md)
# Diinstal Alat AWS untuk PowerShell pada AWS CloudShell
`AWS.Tools`sudah diinstal sebelumnya AWS CloudShell seperti yang dijelaskan dalam [perangkat lunak Pra-instal](https://docs.aws.amazon.com/cloudshell/latest/userguide/vm-specs.html#pre-installed-software) di [AWS CloudShell Panduan Pengguna](https://docs.aws.amazon.com/cloudshell/latest/userguide/). Karena kredenal konsol secara otomatis diteruskan ke CloudShell, pengguna dengan izin untuk membuka CloudShell dapat segera menjalankan Alat untuk PowerShell cmdlet tanpa instalasi atau konfigurasi tambahan.
Untuk menggunakan Alat AWS untuk PowerShell on CloudShell, lakukan langkah-langkah yang mirip dengan berikut ini:
1. Buka [CloudShellKonsol](https://console.aws.amazon.com/cloudshell/home).
1. Jalankan `pwsh`.
1. Jalankan `AWS.Tools` PowerShell perintah apa pun yang Anda butuhkan seperti`Get-S3Bucket`.
# Menginstal Alat AWS untuk PowerShell pada Windows
Untuk informasi tentang Alat PowerShell yang sudah diinstal sebelumnya AWS CloudShell, lihat[Diinstal pada CloudShell](pstools-getting-set-up-cloudshell.md).
Komputer berbasis Windows dapat menjalankan salah satu opsi Alat AWS untuk PowerShell paket:
+ [**`AWS.Tools`**](ps-installing-awstools.md)- Versi termodulasi dari. Alat AWS untuk PowerShell Setiap AWS layanan didukung oleh modul kecil individualnya sendiri, dengan modul dukungan bersama `AWS.Tools.Common` dan`AWS.Tools.Installer`.
+ [**AWSPowerCangkang. NetCore**](ps-installing-awspowershellnetcore.md) - Versi tunggal, modul besar dari. Alat AWS untuk PowerShell Semua AWS layanan didukung oleh modul tunggal dan besar ini.
**catatan**
Ketahuilah bahwa modul tunggal mungkin terlalu besar untuk digunakan dengan [AWS Lambda](https://aws.amazon.com/lambda/)fungsi. Sebagai gantinya, gunakan versi termodulasi yang ditunjukkan di atas.
+ [**AWSPowerShell**](ps-installing-awswindowspowershell.md) - Versi lama, khusus Windows, tunggal, modul besar dari. Alat AWS untuk PowerShell Semua AWS layanan didukung oleh modul tunggal dan besar ini.
Paket yang Anda pilih tergantung pada rilis dan edisi Windows yang Anda jalankan.
**catatan**
Alat AWS untuk PowerShell Ini diinstal secara default pada semua Gambar Mesin Amazon berbasis Windows ()AMIs. Opsi yang diinstal tergantung pada AMI. Banyak yang AMIs memiliki modul AWSPower Shell, tetapi beberapa mungkin memiliki opsi yang berbeda. Misalnya, Amazon EC2 AMIs untuk Windows Server 2025 menggunakan `AWS.Tools` opsi modular.
Menyiapkan Alat AWS untuk PowerShell melibatkan tugas-tugas tingkat tinggi berikut, dijelaskan secara rinci dalam topik berikutnya.
1. Instal opsi Alat AWS untuk PowerShell paket yang sesuai untuk lingkungan Anda.
1. Verifikasi bahwa eksekusi skrip diaktifkan dengan menjalankan cmdlet `Get-ExecutionPolicy`.
1. Impor Alat AWS untuk PowerShell modul ke PowerShell sesi Anda.
## Prasyarat
Versi yang lebih baru PowerShell, termasuk PowerShell Core, tersedia sebagai unduhan dari Microsoft di [Menginstal berbagai versi PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell) di situs Web Microsoft.
**Topics**
+ [Prasyarat](#prerequisites)
+ [Instal `AWS.Tools` (disarankan)](ps-installing-awstools.md)
+ [Instal AWSPower Shell. NetCore](ps-installing-awspowershellnetcore.md)
+ [Instal AWSPower Shell (warisan)](ps-installing-awswindowspowershell.md)
# Instal `AWS.Tools` di Windows (disarankan)
[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).
Anda dapat menginstal versi termodulasi Alat AWS untuk PowerShell pada komputer yang menjalankan Windows dengan Windows PowerShell 5.1, atau PowerShell Core 6.0 atau yang lebih baru. Untuk informasi tentang cara menginstal PowerShell Core, lihat [Menginstal berbagai versi PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell) di situs Web Microsoft.
Anda dapat memasang `AWS.Tools` dengan memilih satu dari tiga cara:
+ Menggunakan cmdlet di modul `AWS.Tools.Installer`. Modul ini menyederhanakan instalasi dan pembaruan `AWS.Tools` modul lainnya. `AWS.Tools.Installer`membutuhkan`PowerShellGet`, dan secara otomatis mengunduh dan menginstal versi yang diperbarui. `AWS.Tools.Installer`secara otomatis membuat versi modul Anda tetap sinkron. Saat Anda menginstal atau memperbarui ke versi yang lebih baru dari satu modul, cmdlet secara `AWS.Tools.Installer` otomatis memperbarui semua `AWS.Tools` modul Anda yang lain ke versi yang sama.
Metode ini dijelaskan dalam prosedur berikut.
+ Mengunduh modul dari `[AWS.Tools.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWS.Tools.zip)` dan mengekstraknya di salah satu folder modul. Anda dapat menemukan folder 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 setiap modul layanan dari PowerShell Galeri menggunakan `Install-Module` cmdlet.
**Untuk menginstal `AWS.Tools` pada Windows menggunakan `AWS.Tools.Installer` modul**
1. Mulai PowerShell sesi.
**catatan**
Kami menyarankan agar Anda *tidak* menjalankan PowerShell sebagai administrator dengan izin yang ditinggikan kecuali jika diperlukan oleh tugas yang ada. Hal ini karena potensi risiko keamanan dan tidak sesuai dengan prinsip batasan akses yang paling rendah.
1. Untuk menginstal paket `AWS.Tools` termodulasi, jalankan perintah berikut.
```
PS > Install-Module -Name AWS.Tools.Installer
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 terpercaya", Anda akan ditanya apakah Anda tetap ingin menginstalnya. Masukkan **y** untuk memungkinkan PowerShell untuk menginstal modul. Untuk menghindari prompt dan menginstal modul tanpa mempercayai repositori, Anda dapat menjalankan perintah dengan parameter `-Force`.
```
PS > Install-Module -Name AWS.Tools.Installer -Force
```
1. Anda sekarang dapat menginstal modul untuk setiap AWS layanan yang ingin Anda gunakan dengan menggunakan `Install-AWSToolsModule` cmdlet. Misalnya, perintah berikut menginstal modul Amazon EC2 dan Amazon S3. Perintah ini juga menginstal setiap modul tergantung yang diperlukan untuk modul tertentu yang akan dikerjakan. Misalnya, saat Anda menginstal modul layanan `AWS.Tools`, maka secara otomatis akan menginstal `AWS.Tools.Common`. Ini adalah modul bersama yang dibutuhkan oleh semua modul AWS layanan. Tindakan ini juga akan menghapus versi modul yang lebih lama, dan memperbarui modul lain ke versi yang sama barunya.
```
PS > Install-AWSToolsModule AWS.Tools.EC2,AWS.Tools.S3 -CleanUp
Confirm
Are you sure you want to perform this action?
Performing the operation "Install-AWSToolsModule" on target "AWS Tools version 4.0.0.0".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
Installing module AWS.Tools.Common version 4.0.0.0
Installing module AWS.Tools.EC2 version 4.0.0.0
Installing module AWS.Tools.Glacier version 4.0.0.0
Installing module AWS.Tools.S3 version 4.0.0.0
Uninstalling AWS.Tools version 3.3.618.0
Uninstalling module AWS.Tools.Glacier
Uninstalling module AWS.Tools.S3
Uninstalling module AWS.Tools.SimpleNotificationService
Uninstalling module AWS.Tools.SQS
Uninstalling module AWS.Tools.Common
```
**catatan**
`Install-AWSToolsModule`Cmdlet mengunduh semua modul yang diminta dari `PSRepository` nama `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) dan menganggapnya sebagai sumber tepercaya. Gunakan perintah `Get-PSRepository -Name PSGallery` untuk informasi lebih lanjut tentang `PSRepository` ini.
Secara default, perintah sebelumnya menginstal modul ke dalam `%USERPROFILE%\Documents\WindowsPowerShell\Modules` folder. Untuk menginstal Alat AWS untuk PowerShell untuk semua pengguna komputer, Anda harus menjalankan perintah berikut dalam PowerShell sesi yang Anda mulai sebagai administrator. Misalnya, perintah berikut menginstal modul IAM ke `%ProgramFiles%\WindowsPowerShell\Modules` folder yang dapat diakses oleh semua pengguna.
```
PS > Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers
```
Untuk menginstal modul lain, jalankan perintah serupa dengan nama modul yang sesuai, seperti yang ditemukan di [PowerShell Galeri](https://www.powershellgallery.com/packages?q=aws).
## Aktifkan Eksekusi Skrip
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
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
Secara berkala, saat versi terbaru dirilis, Anda harus memperbarui versi yang Anda jalankan secara lokal. Alat AWS untuk PowerShell
### Perbarui modul termodulasi `AWS.Tools`
Untuk memperbarui `AWS.Tools` modul Anda ke versi terbaru, jalankan perintah berikut:
```
PS > Update-AWSToolsModule -CleanUp
```
Perintah ini memperbarui semua `AWS.Tools` modul yang saat ini diinstal dan, setelah pembaruan berhasil, menghapus versi sebelumnya.
**catatan**
`Update-AWSToolsModule`Cmdlet mengunduh semua modul dari `PSRepository` nama `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) dan menganggapnya sebagai sumber tepercaya. Gunakan `Get-PSRepository -Name PSGallery` perintah untuk informasi lebih lanjut tentang ini`PSRepository`.
# Instal AWSPower Shell. NetCore pada Windows
[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**
AWSPowerCangkang. NetCore 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 AWSPower Shell. NetCore pada komputer yang menjalankan Windows dengan PowerShell versi 3 hingga 5.1, atau PowerShell Core 6.0 atau yang lebih baru. Untuk informasi tentang cara menginstal PowerShell Core, lihat [Menginstal berbagai versi PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell) di PowerShell situs web Microsoft.
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 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. NetCore dari PowerShell Galeri menggunakan cmdlet Install-Module**
Untuk menginstal AWSPower Shell. NetCore dari PowerShell Galeri, komputer Anda harus menjalankan PowerShell 5.0 atau lebih baru, atau berjalan [PowerShellGet](https://www.powershellgallery.com/packages/PowerShellGet)pada PowerShell 3 atau lebih baru. Jalankan perintah berikut.
```
PS > Install-Module -name AWSPowerShell.NetCore
```
Jika Anda menjalankan PowerShell sebagai administrator, perintah sebelumnya diinstal Alat AWS untuk PowerShell untuk semua pengguna di komputer. Jika Anda menjalankan PowerShell sebagai pengguna standar tanpa izin administrator, perintah yang sama dipasang hanya Alat AWS untuk PowerShell untuk pengguna saat ini.
Untuk menginstal untuk hanya pengguna saat ini ketika pengguna tersebut memiliki izin administrator, jalankan perintah dengan parameter `-Scope CurrentUser` yang ditetapkan, sebagai berikut.
```
PS > Install-Module -name AWSPowerShell.NetCore -Scope CurrentUser
```
Meskipun rilis PowerShell 3.0 dan yang lebih baru biasanya memuat modul ke PowerShell sesi Anda saat pertama kali menjalankan cmdlet di modul, Shell. AWSPower NetCore modul terlalu besar untuk mendukung fungsi ini. Anda harus memuat Shell secara eksplisit. AWSPower NetCore Modul inti ke PowerShell sesi Anda dengan menjalankan perintah berikut.
```
PS > Import-Module AWSPowerShell.NetCore
```
Untuk memuat AWSPower Shell. NetCore modul ke PowerShell sesi secara otomatis, tambahkan perintah itu ke PowerShell profil Anda. Untuk informasi selengkapnya tentang mengedit PowerShell profil Anda, lihat [Tentang Profil](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles) di PowerShell dokumentasi.
## Aktifkan Eksekusi Skrip
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 menampilkan 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
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.
Misalnya:
```
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.
Misalnya:
```
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.
Misalnya:
```
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
Secara berkala, saat versi terbaru dirilis, Anda harus memperbarui versi yang Anda jalankan secara lokal. Alat AWS untuk PowerShell
### Perbarui Alat untuk PowerShell Inti
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 .
# Instal AWSPower Shell di Windows PowerShell (warisan)
[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
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
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
Secara berkala, saat versi terbaru dirilis, Anda harus memperbarui versi yang Anda jalankan secara lokal. Alat AWS untuk PowerShell
### Perbarui Alat untuk Windows PowerShell
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.
# Menginstal Alat AWS untuk PowerShell di Linux atau macOS
Untuk informasi tentang Alat PowerShell yang sudah diinstal sebelumnya AWS CloudShell, lihat[Diinstal pada CloudShell](pstools-getting-set-up-cloudshell.md).
Untuk menginstal Alat AWS untuk PowerShell di komputer Linux atau macOS, Anda dapat memilih dari dua opsi paket:
+ [**`AWS.Tools`**](install-aws.tools-on-linux-macos.md)— Versi termodulasi dari. Alat AWS untuk PowerShell Setiap AWS layanan didukung oleh modul kecil individualnya sendiri, dengan modul dukungan bersama`AWS.Tools.Common`.
+ [**AWSPowerCangkang. NetCore**](install-netcore-on-linux-macos.md) — Versi modul tunggal dan besar dari. Alat AWS untuk PowerShell Semua AWS layanan didukung oleh modul tunggal dan besar ini.
**catatan**
Ketahuilah bahwa modul tunggal mungkin terlalu besar untuk digunakan dengan [AWS Lambda](https://aws.amazon.com/lambda/)fungsi. Sebagai gantinya, gunakan versi termodulasi yang ditunjukkan di atas.
Menyiapkan salah satu dari ini di komputer yang menjalankan Linux atau macOS melibatkan tugas-tugas berikut, yang dijelaskan secara rinci dalam topik berikut:
1. Instal PowerShell Core 6.0 atau yang lebih baru pada sistem yang didukung.
1. Setelah menginstal PowerShell Core, PowerShell mulailah dengan menjalankan `pwsh` shell sistem Anda.
1. Instal salah satu `AWS.Tools` atau AWSPower Shell. NetCore.
1. Jalankan `Import-Module` cmdlet yang sesuai untuk mengimpor modul ke sesi Anda PowerShell.
1. Jalankan cmdlet [Initialize- AWSDefault Configuration](https://docs.aws.amazon.com/powershell/v5/reference/items/Initialize-AWSDefaultConfiguration.html) untuk memberikan kredensil Anda. AWS
## Prasyarat
Untuk menjalankan AWS Tools for PowerShell Core, komputer Anda harus menjalankan PowerShell Core 6.0 atau yang lebih baru.
+ Untuk daftar rilis platform Linux yang didukung dan untuk informasi tentang cara menginstal versi terbaru PowerShell pada komputer berbasis Linux, lihat [Menginstal PowerShell di Linux di situs web](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-core-on-linux) Microsoft. Beberapa sistem operasi berbasis Linux, seperti Arch, Kali, dan Raspbian, tidak didukung secara resmi, tetapi memiliki berbagai tingkat dukungan masyarakat.
+ Untuk informasi tentang versi macOS yang didukung dan tentang cara menginstal versi terbaru di PowerShell macOS, lihat Menginstal [di PowerShell macOS di situs web Microsoft](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-core-on-macos).
**Topics**
+ [Prasyarat](#prerequisites)
+ [Instal `AWS.Tools` (disarankan)](install-aws.tools-on-linux-macos.md)
+ [Instal AWSPower Shell. NetCore](install-netcore-on-linux-macos.md)
# Instal `AWS.Tools` di Linux atau macOS (disarankan)
[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).
Anda dapat menginstal versi termodulasi Alat AWS untuk PowerShell pada komputer yang menjalankan PowerShell Core 6.0 atau yang lebih baru. Untuk informasi tentang cara menginstal PowerShell Core, lihat [Menginstal berbagai versi PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell) di PowerShell situs web Microsoft.
Anda dapat memasang `AWS.Tools` dengan memilih satu dari tiga cara:
+ Menggunakan cmdlet di modul `AWS.Tools.Installer`. Modul ini menyederhanakan instalasi dan pembaruan `AWS.Tools` modul lainnya. `AWS.Tools.Installer`membutuhkan`PowerShellGet`, dan secara otomatis mengunduh dan menginstal versi yang diperbarui. `AWS.Tools.Installer`secara otomatis membuat versi modul Anda tetap sinkron. Saat Anda menginstal atau memperbarui ke versi yang lebih baru dari satu modul, cmdlet secara `AWS.Tools.Installer` otomatis memperbarui semua `AWS.Tools` modul Anda yang lain ke versi yang sama.
Metode ini dijelaskan dalam prosedur berikut.
+ Mengunduh modul dari `[AWS.Tools.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWS.Tools.zip)` dan mengekstraknya di salah satu direktori modul. Anda dapat menemukan direktori modul Anda dengan mencetak nilai variabel `$Env:PSModulePath`.
+ Menginstal setiap modul layanan dari PowerShell Galeri menggunakan `Install-Module` cmdlet.
**Untuk menginstal `AWS.Tools` di Linux atau macOS menggunakan modul `AWS.Tools.Installer`**
1. Mulai sesi PowerShell Core dengan menjalankan perintah berikut.
```
$ pwsh
```
**catatan**
Kami menyarankan agar Anda *tidak* menjalankan PowerShell sebagai administrator dengan izin yang ditinggikan kecuali jika diperlukan oleh tugas yang ada. Hal ini karena potensi risiko keamanan dan tidak sesuai dengan prinsip batasan akses yang paling rendah.
1. Untuk menginstal paket `AWS.Tools` termodulasi menggunakan modul `AWS.Tools.Installer`, jalankan perintah berikut.
```
PS > Install-Module -Name AWS.Tools.Installer
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 dan menginstal modul tanpa mempercayai repositori, Anda dapat menjalankan perintah berikut.
```
PS > Install-Module -Name AWS.Tools.Installer -Force
```
1. Anda sekarang dapat menginstal modul untuk setiap layanan yang ingin Anda gunakan. Misalnya, perintah berikut menginstal modul Amazon EC2 dan Amazon S3. Perintah ini juga menginstal setiap modul tergantung yang diperlukan untuk modul tertentu yang akan dikerjakan. Misalnya, saat Anda menginstal modul layanan `AWS.Tools`, maka secara otomatis akan menginstal `AWS.Tools.Common`. Ini adalah modul bersama yang diperlukan oleh semua modul layanan AWS . Tindakan ini juga akan menghapus versi modul yang lebih lama, dan memperbarui modul lain ke versi yang sama barunya.
```
PS > Install-AWSToolsModule AWS.Tools.EC2,AWS.Tools.S3 -CleanUp
Confirm
Are you sure you want to perform this action?
Performing the operation "Install-AWSToolsModule" on target "AWS Tools version 4.0.0.0".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
Installing module AWS.Tools.Common version 4.0.0.0
Installing module AWS.Tools.EC2 version 4.0.0.0
Installing module AWS.Tools.Glacier version 4.0.0.0
Installing module AWS.Tools.S3 version 4.0.0.0
Uninstalling AWS.Tools version 3.3.618.0
Uninstalling module AWS.Tools.Glacier
Uninstalling module AWS.Tools.S3
Uninstalling module AWS.Tools.SimpleNotificationService
Uninstalling module AWS.Tools.SQS
Uninstalling module AWS.Tools.Common
```
**catatan**
`Install-AWSToolsModule`Cmdlet mengunduh semua modul yang diminta dari `PSRepository` nama `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) dan menganggap repositori sebagai sumber tepercaya. Gunakan perintah `Get-PSRepository -Name PSGallery` untuk informasi lebih lanjut tentang `PSRepository` ini.
Perintah sebelumnya menginstal modul ke direktori default pada sistem Anda. Direktori sebenarnya tergantung pada distribusi dan versi sistem operasi Anda dan pada versi yang PowerShell Anda instal. Misalnya, jika Anda menginstal PowerShell 7 pada sistem seperti RHEL, modul default kemungkinan besar terletak di `/opt/microsoft/powershell/7/Modules` (atau`$PSHOME/Modules`) dan modul pengguna kemungkinan besar berada di. `~/.local/share/powershell/Modules` Untuk informasi selengkapnya, lihat [Menginstal PowerShell di Linux](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-linux) di PowerShell situs web Microsoft. Untuk melihat di mana modul diinstal, jalankan perintah berikut:
```
PS > Get-Module -ListAvailable
```
Untuk menginstal modul lain, jalankan perintah serupa dengan nama modul yang sesuai, seperti yang ditemukan di [PowerShell Galeri](https://www.powershellgallery.com/packages?q=aws).
## Eksekusi Skrip
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.
**`AWS.Tools`**
```
PS > Get-Module -ListAvailable
Directory: /Users/username/.local/share/powershell/Modules
ModuleType Version Name PSEdition ExportedCommands
---------- ------- ---- --------- ----------------
Binary 3.3.563.1 AWS.Tools.Common Desk {Clear-AWSHistory, Set-AWSHistoryConfiguration, Initialize-AWSDefaultConfiguration, Clear-AWSDefaultConfigurat…
```
## Inisialisasi Sesi Anda PowerShell
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
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
Secara berkala, saat versi terbaru dirilis, Anda harus memperbarui versi yang Anda jalankan secara lokal. Alat AWS untuk PowerShell
### Perbarui modul termodulasi `AWS.Tools`
Untuk memperbarui `AWS.Tools` modul Anda ke versi terbaru, jalankan perintah berikut:
```
PS > Update-AWSToolsModule -CleanUp
```
Perintah ini memperbarui semua `AWS.Tools` modul yang saat ini diinstal dan, setelah pembaruan berhasil, menghapus versi sebelumnya.
**catatan**
`Update-AWSToolsModule`Cmdlet mengunduh semua modul dari `PSRepository` nama `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) dan menganggapnya sebagai sumber tepercaya. Gunakan `Get-PSRepository -Name PSGallery` perintah untuk informasi lebih lanjut tentang ini`PSRepository`.
## Informasi Terkait
+ [Mengkonfigurasi dan menggunakan Alat AWS untuk PowerShell](pstools-getting-started.md)
+ [AWS Layanan panggilan di Alat AWS untuk PowerShell](pstools-using.md)
# Instal AWSPower Shell. NetCore di Linux atau macOS
[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
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)
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
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
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
Secara berkala, saat versi terbaru dirilis, Anda harus memperbarui versi yang Anda jalankan secara lokal. Alat AWS untuk PowerShell
### Perbarui Alat untuk PowerShell Inti
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
+ [Mengkonfigurasi dan menggunakan Alat AWS untuk PowerShell](pstools-getting-started.md)
+ [AWS Layanan panggilan di Alat AWS untuk PowerShell](pstools-using.md)
# Mengautentikasi dengan Alat AWS untuk PowerShell AWS
Anda harus menetapkan bagaimana kode Anda mengautentikasi AWS saat mengembangkan dengan Layanan AWS. Ada berbagai cara di mana Anda dapat mengonfigurasi akses terprogram ke AWS sumber daya, tergantung pada lingkungan dan AWS akses yang tersedia untuk Anda.
Untuk melihat berbagai metode otentikasi untuk Alat untuk PowerShell, lihat [Otentikasi dan akses](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) di Panduan *Referensi Alat AWS SDKs dan Alat*.
Topik ini mengasumsikan bahwa pengguna baru sedang berkembang secara lokal, belum diberikan metode otentikasi oleh majikan mereka, dan akan digunakan AWS IAM Identity Center untuk mendapatkan kredensil sementara. Jika lingkungan Anda tidak termasuk dalam asumsi ini, beberapa informasi dalam topik ini mungkin tidak berlaku untuk Anda, atau beberapa informasi mungkin telah diberikan kepada Anda.
Mengkonfigurasi lingkungan ini memerlukan beberapa langkah, yang dirangkum sebagai berikut:
1. [Login menggunakan kredenal konsol](#login-con-creds)
1. [Aktifkan dan konfigurasikan Pusat Identitas IAM](#idc-config-sso)
1. [Konfigurasikan Alat PowerShell untuk menggunakan IAM Identity Center.](#idc-config-sdk)
1. [Mulai sesi portal AWS akses](#idc-start-portal)
## Login menggunakan kredenal konsol
Anda dapat menggunakan kredenal masuk Konsol AWS Manajemen yang ada untuk akses terprogram. Layanan AWS Setelah alur otentikasi berbasis browser, buat Alat AWS untuk PowerShell kredensil sementara yang berfungsi di seluruh alat pengembangan lokal seperti, dan. AWS SDKs Alat AWS untuk PowerShell AWS CLI Fitur ini menyederhanakan proses konfigurasi dan pengelolaan kredensional CLI, terutama jika Anda lebih memilih otentikasi interaktif daripada mengelola kunci akses jangka panjang.
Dengan proses ini, Anda dapat mengautentikasi menggunakan kredensi root yang dibuat selama pengaturan akun awal, pengguna IAM, atau identitas federasi dari penyedia identitas Anda, dan Alat untuk PowerShell secara otomatis mengelola kredensil sementara untuk Anda. Pendekatan ini meningkatkan keamanan dengan menghilangkan kebutuhan untuk menyimpan kredensil jangka panjang secara lokal.
Saat menjalankan `Invoke-AWSLogin` cmdlet, Anda dapat memilih dari sesi konsol aktif, atau masuk melalui alur otentikasi berbasis browser dan ini akan secara otomatis menghasilkan kredensi sementara. Alat AWS untuk PowerShell akan secara otomatis menyegarkan kredensil ini hingga 12 jam.
Setelah dikonfigurasi, sesi Anda dapat digunakan di Alat AWS untuk PowerShell dan semua alat lainnya AWS SDKs .
### Prasyarat
+ Akses untuk masuk ke Konsol AWS Manajemen sebagai pengguna root, pengguna IAM, atau melalui federasi dengan IAM. Jika Anda menggunakan IAM Identity Center, pergi ke [Konfigurasikan Alat PowerShell untuk menggunakan IAM Identity Center.](#idc-config-sdk) sebagai gantinya.
+ Pastikan identitas IAM memiliki izin yang sesuai. Lampirkan kebijakan [SignInLocalDevelopmentAccess](https://docs.aws.amazon.com/signin/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-SignInLocalDevelopmentAccess)terkelola ke pengguna, peran, atau grup IAM Anda. Jika Anda masuk sebagai pengguna root, tidak diperlukan izin tambahan.
### Masuk AWS dengan Invoke- Cmdlet AWSLogin
Jalankan `Invoke-AWSLogin` cmdlet untuk mengautentikasi menggunakan kredenal AWS Management Console yang ada. Jika sebelumnya Anda belum mengonfigurasi profil, Anda akan diminta untuk informasi tambahan.
Untuk masuk atau mengonfigurasi profil, ikuti langkah-langkah di bawah ini.
1. Pastikan Anda telah mengimpor modul yang benar yang telah Anda instal dari panduan instalasi.
**catatan**
Kami memiliki tiga modul berbeda untuk PowerShell -`AWS.Tools`, `AWSPowerShell.NetCore` dan`AWSPowerShell`. Untuk informasi selengkapnya, lihat [Apa yang dimaksud dengan Alat AWS untuk PowerShell?](pstools-welcome.md).
+ Di PowerShell terminal Anda, jalankan cmdlet. Ini akan menggunakan `default` profil.
```
PS > Invoke-AWSLogin
```
+ Untuk masuk ke profil bernama atau membuat yang baru, gunakan `-ProfileName` parameter.
```
PS > Invoke-AWSLogin -ProfileName 'my-dev-profile'
```
+ Jika ini adalah profil baru atau tidak Wilayah AWS telah ditentukan atau dikonfigurasi di salah satu profiles/environment variabel Anda sebelumnya, cmdlet meminta Anda untuk menyediakan wilayah.
```
Press Ctrl+C to cancel the following login prompts.
Specify AWS Region
No AWS region has been configured. The AWS region is the geographic location of your AWS resources.
If you've used AWS before and already have resources in your account, tell us which region they were created in. If you
haven't created resources in your account before, you can pick the region closest to you:
https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-regions.html
AWS Region:
```
1. Alat AWS untuk PowerShell Upaya untuk membuka browser default Anda untuk proses masuk AWS akun Anda.
```
Using region 'us-west-2'
Attempting to open the login page for 'us-west-2' in your default browser.
If the browser does not open, use the following URL to complete your login:
https://signin.us-west-2.amazonaws.com/authorize?
If you cannot connect to this URL, make sure that you have specified a valid region.
```
+ Jika perangkat yang menggunakan Alat AWS untuk PowerShell tidak memiliki browser, Anda dapat menggunakan `-Remote` parameter untuk menyediakan URL untuk Anda buka pada perangkat yang mendukung browser.
```
PS > Invoke-AWSLogin -Remote
```
+ Jika Anda menggunakan `-Remote` parameter, instruksi untuk memulai proses masuk secara manual ditampilkan berdasarkan jenis otorisasi yang Anda gunakan. URL yang ditampilkan adalah URL unik yang dimulai dengan: https://signin.us-east-1.amazonaws.com /authorize. Setelah Anda menyelesaikan login browser, Anda harus menyalin dan menempelkan kode otorisasi yang dihasilkan kembali di terminal.
```
Press Ctrl+C to cancel the following login prompts.
Using region 'us-west-2' determined by profile/environment defaults. To override, specify '-Region' parameter.
Please complete the login workflow via the following URL:
https://us-west-2.signin.aws.amazon.com/v1/authorize?
Please enter the authorization code displayed in the browser:
```
1. Di browser, pilih kredensil Anda untuk digunakan dari daftar yang ditampilkan dan kemudian kembali ke terminal Anda.
+ Jika profil yang Anda konfigurasikan memiliki sesi login yang dikonfigurasi sebelumnya yang tidak cocok dengan sesi baru Anda, akan Alat AWS untuk PowerShell meminta Anda untuk mengonfirmasi bahwa Anda mengganti sesi yang sesuai dengan profil yang ada.
```
WARNING: Previously profile default was configured for arn:aws:iam::0123456789012:user/ReadOnly,
and is now being updated to arn:aws:iam::0123456789012:user/Admin.
Do you wish to change the identity that default is associated with? (y/n)
```
1. Pesan terakhir menjelaskan konfigurasi profil yang telah selesai.
```
Login completed successfully for profile 'my-dev-profile'.
```
Token otentikasi di-cache ke disk di bawah file. aws/login/cachedirektori dengan nama file hash berdasarkan profil yang diselesaikan.
#### File konfigurasi yang dihasilkan
Langkah-langkah ini menghasilkan pembuatan profil default atau yang ditentukan dalam file konfigurasi yang terlihat seperti berikut:
```
[default]
login_session = arn:aws:iam::0123456789012:user/username
region = us-east-1
[my-dev-profile]
login_session = arn:aws:iam::0123456789012:user/username
region = us-east-1
```
#### Jalankan perintah dengan profil Anda
Setelah masuk, Anda dapat menggunakan kredensil Anda untuk memanggil Alat untuk PowerShell cmdlet dengan profil terkait. Contoh berikut memanggil `Get-STSCallerIdentity` cmdlet menggunakan profil default:
```
PS > Get-STSCallerIdentity
```
Untuk memeriksa sesi tertentu, gunakan `-ProfileName` parameter.
```
PS > Get-STSCallerIdentity -ProfileName 'my-dev-profile'
```
Token kredenal sementara akan kedaluwarsa dalam 15 menit, tetapi Alat AWS untuk PowerShell dan SDKs secara otomatis menyegarkan token saat diperlukan selama permintaan Anda. Sesi keseluruhan akan berlaku hingga 12 jam, setelah itu Anda harus menjalankan `Invoke-AWSLogin` cmdlet lagi.
#### Keluar dari sesi Anda menggunakan `Invoke-AWSLogout` cmdlet
Setelah selesai dengan sesi, Anda dapat membiarkan kredensialnya kedaluwarsa, atau menjalankan `Invoke-AWSLogout` cmdlet untuk menghapus kredenal cache Anda. Jika tidak ada profil yang ditentukan dalam CLI atau di variabel AWS\$1PROFILE lingkungan, perintah akan membuat Anda keluar dari profil default Anda. Contoh berikut membuat Anda keluar dari profil default Anda.
```
PS > Invoke-AWSLogout
```
Untuk keluar dari sesi profil tertentu, gunakan `-ProfileName` parameter.
```
PS > Invoke-AWSLogout -ProfileName 'my-dev-profile'
```
Untuk keluar dari semua sesi profil yang telah Anda login, gunakan `-All` parameter.
```
PS > Invoke-AWSLogout -All
```
#### Kredensial Cached
Kredensi cache sementara, serta metadata yang diperlukan untuk menyegarkannya disimpan secara default di Windows atau `%USERPROFILE%\.aws\login\cache` di Linux dan macOS. `~/.aws/login/cache`
Anda dapat mengganti lokasi ini dengan mengatur variabel `AWS_LOGIN_CACHE_DIRECTORY` lingkungan.
## Aktifkan dan konfigurasikan Pusat Identitas IAM
Untuk menggunakannya AWS IAM Identity Center, pertama-tama harus diaktifkan dan dikonfigurasi. Untuk melihat detail tentang cara melakukannya PowerShell, lihat **Langkah 1** dalam topik [autentikasi Pusat Identitas IAM](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) di Panduan *Referensi Alat AWS SDKs dan Alat*. Secara khusus, ikuti instruksi yang diperlukan di bawah **Saya tidak memiliki akses yang ditetapkan melalui Pusat Identitas IAM**.
## Konfigurasikan Alat PowerShell untuk menggunakan IAM Identity Center.
**catatan**
Dimulai dengan versi 4.1.538 dari Tools for PowerShell, metode yang disarankan untuk mengonfigurasi kredensi SSO dan memulai sesi portal AWS akses adalah dengan menggunakan [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration)dan [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin)cmdlet, seperti yang dijelaskan dalam topik ini. Jika Anda tidak memiliki akses ke versi Alat untuk PowerShell (atau yang lebih baru) atau tidak dapat menggunakan cmdlet tersebut, Anda masih dapat melakukan tugas-tugas ini dengan menggunakan. AWS CLI Untuk mengetahui caranya, lihat[Gunakan AWS CLI untuk login portal](creds-idc-cli.md).
Prosedur berikut memperbarui AWS `config` file bersama dengan informasi SSO yang Alat untuk PowerShell digunakan untuk mendapatkan kredensi sementara. Sebagai konsekuensi dari prosedur ini, sesi portal AWS akses juga dimulai. Jika `config` file bersama sudah memiliki informasi SSO dan Anda hanya ingin tahu cara memulai sesi portal akses menggunakan Alat untuk PowerShell, lihat bagian selanjutnya dalam topik ini,[Mulai sesi portal AWS akses](#idc-start-portal).
1. Jika Anda belum melakukannya, buka PowerShell dan instal yang Alat AWS untuk PowerShell sesuai untuk sistem operasi dan lingkungan Anda, termasuk cmdlet umum. Untuk informasi tentang cara melakukan ini, lihat [Memulai dengan Alat AWS untuk PowerShell](pstools-getting-set-up.md).
Misalnya, jika menginstal versi Tools termodulasi untuk PowerShell Windows, kemungkinan besar Anda akan menjalankan perintah yang mirip dengan yang berikut ini:
```
Install-Module -Name AWS.Tools.Installer
Install-AWSToolsModule AWS.Tools.Common
```
1. Jalankan perintah berikut. Ganti nilai properti contoh dengan nilai dari konfigurasi Pusat Identitas IAM Anda. Untuk informasi tentang properti ini dan cara menemukannya, lihat [setelan penyedia kredensi Pusat Identitas IAM di Panduan](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#feature-sso-credentials-profile) *Referensi Alat AWS SDKs dan Alat*.
```
$params = @{
ProfileName = 'my-sso-profile'
AccountId = '111122223333'
RoleName = 'SamplePermissionSet'
SessionName = 'my-sso-session'
StartUrl = 'https://provided-domain.awsapps.com/start'
SSORegion = 'us-west-2'
RegistrationScopes = 'sso:account:access'
};
Initialize-AWSSSOConfiguration @params
```
Atau, Anda cukup menggunakan cmdlet dengan sendirinya`Initialize-AWSSSOConfiguration`, dan Alat untuk PowerShell meminta Anda untuk nilai properti.
Pertimbangan untuk nilai properti tertentu:
+ Jika Anda hanya mengikuti instruksi untuk [mengaktifkan dan mengkonfigurasi IAM Identity Center](#idc-config-sso), nilainya `-RoleName` mungkin`PowerUserAccess`. Tetapi jika Anda membuat izin Pusat Identitas IAM yang ditetapkan khusus untuk PowerShell pekerjaan, gunakan itu sebagai gantinya.
+ Pastikan untuk menggunakan Wilayah AWS tempat Anda telah mengkonfigurasi Pusat Identitas IAM.
1. Pada titik ini, AWS `config` file bersama berisi profil yang dipanggil `my-sso-profile` dengan serangkaian nilai konfigurasi yang dapat direferensikan dari Alat untuk PowerShell. Untuk menemukan lokasi file ini, lihat [Lokasi file bersama di](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) *Panduan Referensi Alat AWS SDKs dan*.
Alat untuk PowerShell menggunakan penyedia token SSO profil untuk memperoleh kredensil sebelum mengirim permintaan ke. AWS`sso_role_name`Nilai, yang merupakan peran IAM yang terhubung ke set izin Pusat Identitas IAM, harus memungkinkan akses ke yang Layanan AWS digunakan dalam aplikasi Anda.
Contoh berikut menunjukkan profil yang dibuat dengan menggunakan perintah yang ditunjukkan di atas. Beberapa nilai properti dan urutannya mungkin berbeda di profil Anda yang sebenarnya. `sso-session`Properti profil mengacu pada bagian bernama`my-sso-session`, yang berisi pengaturan untuk memulai sesi portal AWS akses.
```
[profile my-sso-profile]
sso_account_id=111122223333
sso_role_name=SamplePermissionSet
sso_session=my-sso-session
[sso-session my-sso-session]
sso_region=us-west-2
sso_registration_scopes=sso:account:access
sso_start_url=https://provided-domain.awsapps.com/start/
```
1. Jika Anda sudah memiliki sesi portal AWS akses aktif, Alat untuk PowerShell memberi tahu Anda bahwa Anda sudah masuk.
Jika bukan itu masalahnya, Alat untuk PowerShell mencoba membuka halaman otorisasi SSO secara otomatis di browser web default Anda. Ikuti petunjuk di browser Anda, yang mungkin termasuk kode otorisasi SSO, nama pengguna dan kata sandi, dan izin untuk mengakses AWS IAM Identity Center akun dan set izin.
Alat untuk PowerShell memberi tahu Anda bahwa login SSO berhasil.
## Mulai sesi portal AWS akses
Sebelum menjalankan perintah yang mengakses Layanan AWS, Anda memerlukan sesi portal AWS akses aktif sehingga Alat untuk PowerShell dapat menggunakan autentikasi IAM Identity Center untuk menyelesaikan kredensil. Untuk masuk ke portal AWS akses, jalankan perintah berikut di PowerShell, di mana `-ProfileName my-sso-profile` nama profil yang dibuat di `config` file bersama saat Anda mengikuti prosedur di bagian sebelumnya dari topik ini.
```
Invoke-AWSSSOLogin -ProfileName my-sso-profile
```
Jika Anda sudah memiliki sesi portal AWS akses aktif, Alat untuk PowerShell memberi tahu Anda bahwa Anda sudah masuk.
Jika bukan itu masalahnya, Alat untuk PowerShell mencoba membuka halaman otorisasi SSO secara otomatis di browser web default Anda. Ikuti petunjuk di browser Anda, yang mungkin termasuk kode otorisasi SSO, nama pengguna dan kata sandi, dan izin untuk mengakses AWS IAM Identity Center akun dan set izin.
Alat untuk PowerShell memberi tahu Anda bahwa login SSO berhasil.
Untuk menguji apakah Anda sudah memiliki sesi aktif, jalankan perintah berikut setelah menginstal atau mengimpor `AWS.Tools.SecurityToken` modul sesuai kebutuhan.
```
Get-STSCallerIdentity -ProfileName my-sso-profile
```
Respons terhadap `Get-STSCallerIdentity` cmdlet melaporkan akun IAM Identity Center dan set izin yang dikonfigurasi dalam file bersama. `config`
## Contoh
Berikut ini adalah contoh bagaimana menggunakan IAM Identity Center dengan Tools for PowerShell. Ini mengasumsikan sebagai berikut:
+ Anda telah mengaktifkan IAM Identity Center dan mengonfigurasinya seperti yang dijelaskan sebelumnya dalam topik ini. Properti SSO ada di `my-sso-profile` profil, yang telah dikonfigurasi sebelumnya dalam topik ini.
+ Saat Anda masuk melalui `Initialize-AWSSSOConfiguration` atau `Invoke-AWSSSOLogin` cmdlet, pengguna memiliki setidaknya izin hanya-baca untuk Amazon S3.
+ Beberapa bucket S3 tersedia untuk dilihat pengguna tersebut.
Instal atau impor `AWS.Tools.S3` modul sesuai kebutuhan dan kemudian gunakan PowerShell perintah berikut untuk menampilkan daftar bucket S3.
```
Get-S3Bucket -ProfileName my-sso-profile
```
## Informasi tambahan
+ Untuk opsi lebih lanjut tentang otentikasi Alat untuk PowerShell, seperti penggunaan profil dan variabel lingkungan, lihat bagian [konfigurasi](https://docs.aws.amazon.com/sdkref/latest/guide/creds-config-files.html) di *Panduan Referensi Alat AWS SDKs dan Alat*.
+ Beberapa perintah memerlukan AWS Region untuk ditentukan. Ada beberapa cara untuk melakukannya, termasuk opsi `-Region` cmdlet, `[default]` profil, dan variabel `AWS_REGION` lingkungan. Untuk informasi selengkapnya, lihat [Tentukan AWS Wilayah untuk Alat AWS untuk PowerShell](pstools-installing-specifying-region.md) di panduan ini dan [AWS Wilayah](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) di *Panduan Referensi Alat AWS SDKs dan Alat*.
+ Untuk mempelajari lebih lanjut tentang praktik terbaik, lihat [Praktik terbaik keamanan di IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) di *Panduan Pengguna IAM*.
+ *Untuk membuat AWS kredensil jangka pendek, lihat [Kredenal Keamanan Sementara](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) di Panduan Pengguna IAM.*
+ Untuk mempelajari tentang penyedia kredensi lainnya, lihat Penyedia kredensi [terstandarisasi di Panduan Referensi](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) Alat *AWS SDKs dan* Alat.
**Topics**
+ [Login menggunakan kredenal konsol](#login-con-creds)
+ [Aktifkan dan konfigurasikan Pusat Identitas IAM](#idc-config-sso)
+ [Konfigurasikan Alat PowerShell untuk menggunakan IAM Identity Center.](#idc-config-sdk)
+ [Mulai sesi portal AWS akses](#idc-start-portal)
+ [Contoh](#idc-short-example)
+ [Informasi tambahan](#idc-additional-info)
+ [Gunakan AWS CLI](creds-idc-cli.md)
# Gunakan AWS CLI untuk login portal
Dimulai dengan versi 4.1.538 dari Tools for PowerShell, metode yang disarankan untuk mengonfigurasi kredensi SSO dan memulai sesi portal AWS akses adalah dengan menggunakan [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration)dan [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin)cmdlet, seperti yang dijelaskan dalam. [Mengautentikasi dengan Alat AWS untuk PowerShell AWS](creds-idc.md) Jika Anda tidak memiliki akses ke versi Alat untuk PowerShell (atau yang lebih baru) atau tidak dapat menggunakan cmdlet tersebut, Anda masih dapat melakukan tugas-tugas ini dengan menggunakan. AWS CLI
## Konfigurasikan Alat PowerShell untuk menggunakan Pusat Identitas IAM melalui. AWS CLI
Jika Anda belum melakukannya, pastikan untuk [Aktifkan dan konfigurasi IAM Identity Center](creds-idc.md#idc-config-sso) sebelum Anda melanjutkan.
Informasi tentang cara mengkonfigurasi Alat PowerShell untuk menggunakan Pusat Identitas IAM melalui AWS CLI adalah di **Langkah 2** dalam topik untuk [otentikasi Pusat Identitas IAM](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) di *AWS SDKs dan Panduan Referensi Alat*. Setelah Anda menyelesaikan konfigurasi ini, sistem Anda harus berisi elemen-elemen berikut:
+ Itu AWS CLI, yang Anda gunakan untuk memulai sesi portal AWS akses sebelum Anda menjalankan aplikasi Anda.
+ AWS `config`File bersama yang berisi [`[default]`profil](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) dengan serangkaian nilai konfigurasi yang dapat direferensikan dari Alat untuk PowerShell. Untuk menemukan lokasi file ini, lihat [Lokasi file bersama di](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) *Panduan Referensi Alat AWS SDKs dan*. Alat untuk PowerShell menggunakan penyedia token SSO profil untuk memperoleh kredensil sebelum mengirim permintaan ke. AWS`sso_role_name`Nilai, yang merupakan peran IAM yang terhubung ke set izin Pusat Identitas IAM, harus memungkinkan akses ke yang Layanan AWS digunakan dalam aplikasi Anda.
`config`File contoh berikut menunjukkan `[default]` profil yang disiapkan dengan penyedia token SSO. `sso_session`Pengaturan profil mengacu pada `sso-session` bagian bernama. `sso-session`Bagian ini berisi pengaturan untuk memulai sesi portal AWS akses.
```
[default]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole
region = us-east-1
output = json
[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://provided-domain.awsapps.com/start
sso_registration_scopes = sso:account:access
```
**penting**
PowerShell Sesi Anda harus memiliki modul berikut diinstal dan diimpor sehingga resolusi SSO dapat bekerja:
`AWS.Tools.SSO`
`AWS.Tools.SSOOIDC`
Jika Anda menggunakan versi Tools yang lebih lama PowerShell dan Anda tidak memiliki modul ini, Anda akan mendapatkan kesalahan yang mirip dengan berikut: “Assembly AWSSDK .SSOOIDC tidak dapat ditemukan...”.
## Memulai sesi portal AWS akses
Sebelum menjalankan perintah yang mengakses Layanan AWS, Anda memerlukan sesi portal AWS akses aktif sehingga Alat untuk Windows PowerShell dapat menggunakan autentikasi IAM Identity Center untuk menyelesaikan kredensil. Bergantung pada panjang sesi yang dikonfigurasi, akses Anda pada akhirnya akan kedaluwarsa dan Alat untuk Windows PowerShell akan mengalami kesalahan otentikasi. Untuk masuk ke portal AWS akses, jalankan perintah berikut di AWS CLI.
```
aws sso login
```
Karena Anda menggunakan `[default]` profil, Anda tidak perlu memanggil perintah dengan `--profile` opsi. Jika konfigurasi penyedia token SSO Anda menggunakan profil bernama, perintahnya adalah `aws sso login --profile named-profile` sebagai gantinya. Untuk informasi selengkapnya tentang profil bernama, lihat bagian [Profil](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) di *Panduan Referensi Alat AWS SDKs dan Alat*.
Untuk menguji apakah Anda sudah memiliki sesi aktif, jalankan AWS CLI perintah berikut (dengan pertimbangan yang sama untuk profil bernama):
```
aws sts get-caller-identity
```
Respons terhadap perintah ini harus melaporkan akun IAM Identity Center dan set izin yang dikonfigurasi dalam `config` file bersama.
**catatan**
Jika Anda sudah memiliki sesi portal AWS akses aktif dan menjalankannya`aws sso login`, Anda tidak akan diminta untuk memberikan kredensil.
Proses masuk mungkin meminta Anda untuk mengizinkan AWS CLI akses ke data Anda. Karena AWS CLI dibangun di atas SDK untuk Python, pesan izin mungkin berisi variasi nama. `botocore`
## Contoh
Berikut ini adalah contoh bagaimana menggunakan IAM Identity Center dengan Tools for PowerShell. Ini mengasumsikan sebagai berikut:
+ Anda telah mengaktifkan IAM Identity Center dan mengonfigurasinya seperti yang dijelaskan sebelumnya dalam topik ini. Properti SSO ada di `[default]` profil.
+ Saat Anda masuk melalui AWS CLI by using`aws sso login`, pengguna tersebut memiliki setidaknya izin hanya-baca untuk Amazon S3.
+ Beberapa bucket S3 tersedia untuk dilihat pengguna tersebut.
Gunakan PowerShell perintah berikut untuk menampilkan daftar bucket S3:
```
Install-Module AWS.Tools.Installer
Install-AWSToolsModule S3
# And if using an older version of the AWS Tools for PowerShell:
Install-AWSToolsModule SSO, SSOOIDC
# In older versions of the AWS Tools for PowerShell, we're not invoking a cmdlet from these modules directly,
# so we must import them explicitly:
Import-Module AWS.Tools.SSO
Import-Module AWS.Tools.SSOOIDC
# Older versions of the AWS Tools for PowerShell don't support the SSO login flow, so login with the CLI
aws sso login
# Now we can invoke cmdlets using the SSO profile
Get-S3Bucket
```
Seperti disebutkan di atas, karena Anda menggunakan `[default]` profil, Anda tidak perlu memanggil `Get-S3Bucket` cmdlet dengan opsi. `-ProfileName` Jika konfigurasi penyedia token SSO Anda menggunakan profil bernama, perintahnya adalah`Get-S3Bucket -ProfileName named-profile`. Untuk informasi selengkapnya tentang profil bernama, lihat bagian [Profil](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) di *Panduan Referensi Alat AWS SDKs dan Alat*.
## Informasi tambahan
+ Untuk opsi lebih lanjut tentang otentikasi Alat untuk PowerShell, seperti penggunaan profil dan variabel lingkungan, lihat bagian [konfigurasi](https://docs.aws.amazon.com/sdkref/latest/guide/creds-config-files.html) di *Panduan Referensi Alat AWS SDKs dan Alat*.
+ Beberapa perintah memerlukan AWS Region untuk ditentukan. Ada beberapa cara untuk melakukannya, termasuk opsi `-Region` cmdlet, `[default]` profil, dan variabel `AWS_REGION` lingkungan. Untuk informasi selengkapnya, lihat [Tentukan AWS Wilayah untuk Alat AWS untuk PowerShell](pstools-installing-specifying-region.md) di panduan ini dan [AWS Wilayah](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) di *Panduan Referensi Alat AWS SDKs dan Alat*.
+ Untuk mempelajari lebih lanjut tentang praktik terbaik, lihat [Praktik terbaik keamanan di IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) di *Panduan Pengguna IAM*.
+ *Untuk membuat AWS kredensil jangka pendek, lihat [Kredensial Keamanan Sementara di Panduan Pengguna](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) IAM.*
+ Untuk mempelajari tentang penyedia kredensi lainnya, lihat Penyedia kredensi [terstandarisasi di Panduan Referensi](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) Alat *AWS SDKs dan* Alat.