Menginstal AWS Tools for PowerShell pada Windows - AWS Tools for PowerShell
PrasyaratInstal AWS.ToolsInstal AWSPowerShell. NetCoreInstal AWSPowerShellAktifkan Eksekusi SkripVersioningMemperbarui AWS Tools for PowerShell

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

Menginstal AWS Tools for PowerShell pada Windows

Komputer berbasis Windows dapat menjalankan salah satu opsi AWS Tools for PowerShell paket:

  • AWS.Tools- Versi termodulasi dari. AWS Tools for PowerShell Setiap AWS layanan didukung oleh modul kecil individualnya sendiri, dengan modul dukungan bersama AWS.Tools.Common danAWS.Tools.Installer.

  • AWSPowerShell. NetCore- Versi tunggal, modul 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.

  • AWSPowerShell- Versi lama khusus Windows, tunggal, modul besar dari. AWS Tools for PowerShell Semua AWS layanan didukung oleh modul tunggal dan besar ini.

Paket yang Anda pilih tergantung pada rilis dan edisi Windows yang sedang Anda jalankan.

catatan

Alat untuk Windows PowerShell (AWSPowerShell modul) diinstal secara default pada semua Gambar Mesin Amazon (AMI) berbasis Windows.

Menyiapkan AWS Tools for PowerShell melibatkan tugas-tugas tingkat tinggi berikut, dijelaskan secara rinci dalam topik ini.

  1. Instal opsi AWS Tools for PowerShell paket yang sesuai untuk lingkungan Anda.

  2. Verifikasi bahwa eksekusi skrip diaktifkan dengan menjalankan cmdlet Get-ExecutionPolicy.

  3. Impor AWS Tools for 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 di situs Web Microsoft.

Instal AWS.Tools di Windows

Anda dapat menginstal versi termodulasi AWS Tools for 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 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.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 folder modul. Anda dapat menemukan folder modul Anda dengan menampilkan nilai variabel PSModulePath lingkungan.

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

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

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

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

Instal AWSPowerShell. NetCore pada Windows

Anda dapat menginstal AWSPowerShell. 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 di PowerShell situs web Microsoft.

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 menampilkan nilai variabel PSModulePath lingkungan.

  • Menginstal dari PowerShell Galeri menggunakan Install-Module cmdlet, seperti yang dijelaskan dalam prosedur berikut.

Untuk menginstal AWSPowerShell. NetCore dari PowerShell Galeri menggunakan cmdlet Install-Module

Untuk menginstal AWSPowerShell. NetCore dari PowerShell Galeri, komputer Anda harus menjalankan PowerShell 5.0 atau lebih baru, atau berjalan PowerShellGetpada PowerShell 3 atau lebih baru. Jalankan perintah berikut.

PS > Install-Module -name AWSPowerShell.NetCore

Jika Anda menjalankan PowerShell sebagai administrator, perintah sebelumnya akan diinstal AWS Tools for PowerShell untuk semua pengguna di komputer. Jika Anda menjalankan PowerShell sebagai pengguna standar tanpa izin administrator, perintah yang sama akan diinstal hanya AWS Tools for 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 Anda menjalankan cmdlet dalam modul, file. AWSPowerShell NetCore modul terlalu besar untuk mendukung fungsi ini. Anda harus memuat file secara eksplisit. AWSPowerShell NetCore Modul inti ke PowerShell sesi Anda dengan menjalankan perintah berikut.

PS > Import-Module AWSPowerShell.NetCore

Untuk memuat AWSPowerShell. 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 di PowerShell dokumentasi.

Instal AWSPowerShell di Windows PowerShell

Anda dapat menginstal AWS Tools for Windows PowerShell dalam salah satu dari dua cara:

  • Mengunduh modul AWSPowerShelldari.zip dan mengekstraknya di salah satu direktori modul. Anda dapat menemukan direktori modul Anda dengan menampilkan nilai variabel PSModulePath lingkungan.

  • Menginstal dari PowerShell Galeri menggunakan Install-Module cmdlet seperti yang dijelaskan dalam prosedur berikut.

Untuk menginstal AWSPowerShell dari PowerShell Galeri menggunakan cmdlet Install-Module

Anda dapat menginstal AWSPowerShell dari PowerShell Galeri jika Anda menjalankan PowerShell 5.0 atau lebih baru, atau telah diinstal PowerShellGetpada PowerShell 3 atau lebih baru. Anda dapat menginstal dan memperbarui AWSPowerShell dari PowerShellGaleri Microsoft dengan menjalankan perintah berikut.

 PS > Install-Module -Name AWSPowerShell

Untuk memuat AWSPowerShell modul 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 di PowerShell dokumentasi.

catatan

Alat untuk Windows diinstal PowerShell secara default di semua Gambar Mesin Amazon (AMI) berbasis Windows.

Aktifkan Eksekusi Skrip

Untuk memuat AWS Tools for 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 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.

  2. 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 PS ModulePath untuk memasukkan 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...

Versioning

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

PS > Get-AWSPowerShellVersion

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

Amazon Web Services SDK for .NET
Core Runtime Version 3.7.0.12
Copyright 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]

Anda juga dapat menambahkan -ListServiceVersionInfo parameter ke AWSPowerShellVersion perintah Get- 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.

PS > Get-AWSPowerShellVersion -ListServiceVersionInfo
...

Service                            Noun Prefix Module Name                       SDK
                                                                                 Assembly
                                                                                 Version
-------                            ----------- -----------                       -----------
Alexa For Business                 ALXB        AWS.Tools.AlexaForBusiness        3.7.0.11
Amplify Backend                    AMPB        AWS.Tools.AmplifyBackend          3.7.0.11
Amazon API Gateway                 AG          AWS.Tools.APIGateway              3.7.0.11
Amazon API Gateway Management API  AGM         AWS.Tools.ApiGatewayManagementApi 3.7.0.11
Amazon API Gateway V2              AG2         AWS.Tools.ApiGatewayV2            3.7.0.11
Amazon Appflow                     AF          AWS.Tools.Appflow                 3.7.1.4
Amazon Route 53                    R53         AWS.Tools.Route53                 3.7.0.12
Amazon Route 53 Domains            R53D        AWS.Tools.Route53Domains          3.7.0.11
Amazon Route 53 Resolver           R53R        AWS.Tools.Route53Resolver         3.7.1.5
Amazon Simple Storage Service (S3) S3          AWS.Tools.S3                      3.7.0.13
...

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

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 pada Windows

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, setelah berhasil melakukan pembaruan, menghapus versi lain yang terpasang.

catatan

Cmdlet Update-AWSToolsModule mengunduh semua modul dari PSRepository bernama PSGallery (https://www.powershellgallery.com/) dan menganggapnya 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 .

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. 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 web site. Bandingkan nomor versi paket dalam nama file yang diunduh dengan nomor versi yang Anda dapatkan saat menjalankan cmdlet Get-AWSPowerShellVersion.

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

    3. 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 AWS Tools for PowerShell konsol khusus dari menu Start Anda.