Gambaran Umum Pengaturan Prasyarat Pasang AWS.Tools Instal AWSPowerShell. NetCore Eksekusi Skrip Mengkonfigurasi Konsol PowerShell Inisialisasi Sesi Anda PowerShell Versioning Memperbarui AWS Tools for PowerShell di Linux atau macOS Informasi Terkait

Menginstal AWS Tools for PowerShell di Linux atau macOS

Topik ini memberikan petunjuk tentang cara menginstal AWS Tools for PowerShell di Linux atau macOS.

Gambaran Umum Pengaturan

Untuk menginstal AWS Tools for PowerShell di komputer Linux atau macOS, Anda dapat memilih dari dua opsi paket:

AWS.Tools— Versi termodulasi dari. AWS Tools for PowerShell Setiap AWS layanan didukung oleh modul kecil individualnya sendiri, dengan modul dukungan bersamaAWS.Tools.Common.
AWSPowerShell. NetCore— Versi modul tunggal dan besar dari. AWS Tools for PowerShell Semua AWS layanan didukung oleh modul tunggal dan besar ini.

catatan
Ketahuilah bahwa modul tunggal mungkin terlalu besar untuk digunakan dengan AWS Lambdafungsi. Sebagai gantinya, gunakan versi termodulasi yang ditunjukkan di atas.

Mengatur salah satu dari pilihan ini pada komputer yang menjalankan Linux atau macOS memerlukan tugas-tugas berikut, dijelaskan secara rinci nanti dalam topik ini:

Instal PowerShell Core 6.0 atau yang lebih baru pada sistem yang didukung.
Setelah menginstal PowerShell Core, PowerShell mulailah dengan menjalankan pwsh shell sistem Anda.
Instal salah satu AWS.Tools atau AWSPowerShell. NetCore.
Jalankan Import-Module cmdlet yang sesuai untuk mengimpor modul ke sesi Anda PowerShell.
Jalankan Initialize- AWSDefaultConfiguration cmdlet 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 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.

Pasang `AWS.Tools` pada Linux atau macOS

Anda dapat menginstal versi termodulasi AWS Tools for 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 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.InstallermembutuhkanPowerShellGet, dan secara otomatis mengunduh dan menginstal versi yang diperbarui. AWS.Tools.Installersecara 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 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`

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.

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 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 berikut.


PS > Install-Module -Name AWS.Tools.Installer -Force

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 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
Cmdlet Install-AWSToolsModule mengunduh semua modul yang diminta dari PSRepository bernama PSGallery (https://www.powershellgallery.com/) dan menganggap repositori sebagai sumber terpercaya. 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 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.

Instal AWSPowerShell. NetCore di Linux atau macOS

Untuk meningkatkan ke rilis yang lebih baru dari. AWSPowerShell NetCore, ikuti instruksi diMemperbarui AWS Tools for PowerShell di Linux atau macOS. Copot pemasangan versi sebelumnya. AWSPowerShell NetCore pertama.

Anda dapat menginstal AWSPowerShell. NetCore dalam salah satu dari dua cara:

Mengunduh modul dari 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 AWSPowerShell. 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 AWSPowerShell. 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 terpercaya", Anda akan ditanya apakah Anda tetap ingin menginstalnya. 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 AWS Tools for PowerShell untuk semua pengguna komputer. Untuk melakukan ini, jalankan perintah berikut dalam PowerShell sesi yang telah Anda mulaisudo pwsh.


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

Eksekusi Skrip

Perintah Set-ExecutionPolicy tidak tersedia pada sistem non-Windows. Anda dapat menjalankanGet-ExecutionPolicy, yang menunjukkan bahwa pengaturan kebijakan eksekusi default di PowerShell Core yang berjalan pada sistem non-Windows adalahUnrestricted. Untuk informasi selengkapnya, lihat Tentang Kebijakan Eksekusi 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…

AWSPowerShell.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 AWSPowerShell. NetCore karena ukurannya yang besar. Untuk mulai berlari AWSPowerShell. 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 AWS Tools for PowerShell, Anda harus menjalankan Initialize- AWSDefaultConfiguration untuk menentukan kunci akses mana yang akan digunakan. AWS Untuk informasi selengkapnya tentang Initialize-AWSDefaultConfiguration, lihat Menggunakan Kredenensial AWS.

catatan

Dalam rilis sebelumnya (sebelum 3.3.96.0) dari AWS Tools for PowerShell, cmdlet ini diberi nama. Initialize-AWSDefaults

Versioning

AWS merilis versi baru secara AWS Tools for PowerShell berkala untuk mendukung AWS layanan dan fitur baru. Untuk menentukan versi yang telah Anda instal, jalankan Get- AWSPowerShellVersion cmdlet. AWS Tools for PowerShell


PS > Get-AWSPowerShellVersion

Tools for PowerShell
Version 4.0.123.0
Copyright 2012-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.

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

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/master/CHANGELOG.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 AWSPowerShellVersion cmdlet Get-.

Untuk menentukan versi PowerShell yang Anda jalankan, masukkan $PSVersionTable untuk melihat konten variabel $PSVersionTable otomatis.


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 AWS Tools for PowerShell di Linux atau macOS

Secara berkala, saat versi terbaru dirilis, Anda harus memperbarui versi yang Anda jalankan secara lokal. AWS Tools for 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 modul AWS.Tools yang saat ini diinstal dan, untuk modul-modul yang berhasil diperbarui, menghapus versi sebelumnya.

catatan

Cmdlet Update-AWSToolsModule mengunduh semua modul dari PSRepository bernama PSGallery (https://www.powershellgallery.com/) dan menganggap repositori sebagai sumber terpercaya. Gunakan perintah Get-PSRepository -Name PSGallery untuk informasi lebih lanjut tentang PSRepository ini.

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. 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 yang lebih baru dari. AWSPowerShell 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

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Menginstal pada Windows

Migrasi dari AWS Tools for PowerShell Versi 3.3 ke Versi 4

Menginstal AWS Tools for PowerShell di Linux atau macOS

Gambaran Umum Pengaturan

catatan

Prasyarat

Pasang AWS.Tools pada Linux atau macOS

Untuk menginstal AWS.Tools di Linux atau macOS menggunakan modul AWS.Tools.Installer

catatan

catatan

Instal AWSPowerShell. NetCore di Linux atau macOS

catatan

Eksekusi Skrip

Konfigurasikan PowerShell Konsol untuk Menggunakan AWS Tools for PowerShell Core (AWSPowerShell. NetCore Hanya)

Inisialisasi Sesi Anda PowerShell

catatan

Versioning

Memperbarui AWS Tools for PowerShell di Linux atau macOS

Perbarui modul termodulasi AWS.Tools

catatan

Perbarui Alat untuk PowerShell Inti

Informasi Terkait

Pasang `AWS.Tools` pada Linux atau macOS

Untuk menginstal `AWS.Tools` di Linux atau macOS menggunakan modul `AWS.Tools.Installer`

Perbarui modul termodulasi `AWS.Tools`