Installation AWS Tools for PowerShell unter Linux oder macOS - AWS Tools for PowerShell
Übersicht über die EinrichtungVoraussetzungenInstallieren AWS.ToolsInstallieren Sie AWSPowerShell.NetCoreSkriptausführungKonfigurieren der PowerShell KonsoleInitialisieren Ihrer PowerShell SitzungVersionsverwaltungAktualisieren der AWS Tools for PowerShell unter Linux oder macOSVerwandte Informationen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Installation AWS Tools for PowerShell unter Linux oder macOS

Dieses Thema enthält Anweisungen zur Installation von AWS Tools for PowerShell unter Linux oder macOS.

Übersicht über die Einrichtung

Um AWS Tools for PowerShell auf einem Linux- oder macOS-Computer zu installieren, können Sie aus zwei Paketoptionen wählen:

  • AWS.Tools – Die modularisierte Version von AWS Tools for PowerShell. Jeder AWS Service wird von einem eigenen, kleinen Modul mit gemeinsam genutzten Supportmodulen unterstütztAWS.Tools.Common.

  • AWSPowerShell.NetCore – Die einzelne Large-Modul-Version von AWS Tools for PowerShell. Alle - AWS Services werden von diesem einzigen, großen Modul unterstützt.

    Anmerkung

    Beachten Sie, dass das einzelne Modul möglicherweise zu groß ist, um es mit AWS Lambda-Features zu verwenden. Verwenden Sie stattdessen die oben gezeigte modularisierte Version.

Das Einrichten eines dieser Paket auf einem Computer unter Linux oder macOS umfasst die folgenden Aufgaben, die weiter unten in diesem Thema ausführlich beschrieben werden:

  1. Installieren Sie PowerShell Core 6.0 oder höher auf einem unterstützten System.

  2. Nachdem Sie PowerShell Core installiert haben, führen Sie PowerShell zunächst pwsh in Ihrer System-Shell aus.

  3. Installieren Sie entweder AWS.Tools oder AWSPowerShellNetCore.

  4. Führen Sie das entsprechende Import-Module Cmdlet aus, um das Modul in Ihre PowerShell Sitzung zu importieren.

  5. Führen Sie das Initialize-AWSDefaultConfigurationcmdlet aus, um Ihre AWS Anmeldeinformationen bereitzustellen.

Voraussetzungen

Um die auszuführen AWS Tools for PowerShell Core, muss auf Ihrem Computer PowerShell Core 6.0 oder höher ausgeführt werden.

  • Eine Liste der unterstützten Linux-Plattformversionen und Informationen zum Installieren der neuesten Version von PowerShell auf einem Linux-basierten Computer finden Sie unter Installieren von PowerShell unter Linux auf der Microsoft-Website. Einige Linux-basierte Betriebssysteme, wie z. B. Arch, Kali und Raspbian werden nicht offiziell unterstützt, verfügen jedoch über Community-Support unterschiedlicher Stufen.

  • Informationen zu unterstützten macOS-Versionen und zur Installation der neuesten Version von PowerShell unter macOS finden Sie unter Installieren von PowerShell unter macOS auf der Microsoft-Website.

Installieren der AWS.Tools unter Linux oder macOS

Sie können die modularisierte Version von AWS Tools for PowerShell auf Computern installieren, auf denen Core 6.0 oder höher ausgeführt PowerShell wird. Informationen zur Installation von PowerShell Core finden Sie unter Installieren verschiedener Versionen von PowerShell auf der Microsoft- PowerShell Website.

Sie können AWS.Tools auf drei Arten installieren:

  • Verwenden der Cmdlets im AWS.Tools.Installer-Modul. Dieses Modul vereinfacht die Installation und Aktualisierung anderer AWS.Tools Module. AWS.Tools.Installer erfordert PowerShellGetund lädt automatisch eine aktualisierte Version davon herunter und installiert sie. hält Ihre Modulversionen AWS.Tools.Installer automatisch synchron. Wenn Sie eine neuere Version eines Moduls installieren oder aktualisieren, aktualisieren die Cmdlets in AWS.Tools.Installer automatisch alle Ihre anderen AWS.Tools Module auf dieselbe Version.

    Diese Methode wird im folgenden Verfahren beschrieben.

  • Laden Sie die Module von AWS.Tools.zip herunter und extrahieren Sie sie in einem der Modulverzeichnisse. Sie können Ihre Modulverzeichnisse erkennen, indem Sie den Wert der $Env:PSModulePath-Variablen drucken.

  • Installieren jedes Servicemoduls aus der - PowerShell Galerie mithilfe des Install-Module -Cmdlets.

So installieren Sie AWS.Tools unter Linux oder macOS mit dem -AWS.Tools.InstallerModul

  1. Starten Sie eine PowerShell Core-Sitzung, indem Sie den folgenden Befehl ausführen.

    $ pwsh
    Anmerkung

    Wir empfehlen, nicht PowerShell als Administrator mit erhöhten Berechtigungen auszuführen, es sei denn, dies ist für die jeweilige Aufgabe erforderlich. Grund ist das potenzielle Sicherheitsrisiko und weil dies im Widerspruch zum Prinzip der geringsten Zugriffsrechte stünde.

  2. Führen Sie den folgenden Befehl aus, um das modularisierte AWS.Tools-Paket mit dem AWS.Tools.Installer-Modul zu installieren.

    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

    Wenn Sie benachrichtigt werden, dass das Repository "nicht vertrauenswürdig" ist, werden Sie gefragt, ob trotzdem installiert werden soll. Geben Sie einy, um die Installation des Moduls PowerShell zu erlauben. Um die Eingabeaufforderung zu vermeiden und das Modul zu installieren, ohne dem Repository zu vertrauen, können Sie den folgenden Befehl ausführen:

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

  3. Sie können das Modul jetzt für jeden Dienst installieren, den Sie verwenden möchten. Mit dem folgenden Befehl werden beispielsweise die Module Amazon EC2 und Amazon S3 installiert. Mit diesem Befehl werden auch alle abhängigen Module installiert, die für die Funktionsfähigkeit des angegebenen Moduls erforderlich sind. Wenn Sie beispielsweise Ihr erstes AWS.Tools-Servicemodul installieren, wird damit auch AWS.Tools.Common installiert. Dies ist ein gemeinsam genutztes Modul, das von allen AWS Servicemodulen benötigt wird. Damit werden auch ältere Versionen der Module entfernt und weitere Module auf dieselbe neuere Version aktualisiert.

    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
    Anmerkung

    Über das Cmdlet Install-AWSToolsModule werden alle Module aus dem PSRepository namens PSGallery heruntergeladen (https://www.powershellgallery.com/) und das Repository als vertrauenswürdige Quelle betrachtet. Für weitere Informationen zu diesem PSRepository verwenden Sie den Befehl Get-PSRepository -Name PSGallery.

    Mit dem vorherigen Befehl werden Module in den Standardverzeichnissen auf Ihrem System installiert. Die tatsächlichen Verzeichnisse hängen von Ihrer Betriebssystemverteilung und -version sowie von der PowerShell installierten Version von ab. Wenn Sie beispielsweise PowerShell 7 auf einem RHEL-ähnlichen System installiert haben, befinden sich die Standardmodule höchstwahrscheinlich in /opt/microsoft/powershell/7/Modules (oder $PSHOME/Modules) und Benutzermodule höchstwahrscheinlich in ~/.local/share/powershell/Modules. Weitere Informationen finden Sie unter Installieren PowerShell von unter Linux auf der Microsoft- PowerShell Website. Wenn Sie anzeigen möchten, wo Module installiert sind, führen Sie den folgenden Befehl aus:

    PS > Get-Module -ListAvailable

    Um andere Module zu installieren, führen Sie ähnliche Befehle mit den entsprechenden Modulnamen aus, wie in der PowerShell -Galerie zu finden.

Installieren von AWSPowerShell.NetCore on Linux oder macOS

Um auf eine neuere Version von zu aktualisieren AWSPowerShellNetCore, folgen Sie den Anweisungen unter Aktualisieren der AWS Tools for PowerShell unter Linux oder macOS. Deinstallieren Sie frühere Versionen von AWSPowerShell.NetCore first.

Sie können auf AWSPowerShellNetCore zwei Arten installieren:

  • Laden Sie das Modul von AWSPowerShell.NetCore.zip herunter und extrahieren Sie es in einem der Modulverzeichnisse. Sie können Ihre Modulverzeichnisse erkennen, indem Sie den Wert der $Env:PSModulePath-Variablen drucken.

  • Installieren von aus der - PowerShell Galerie mithilfe des Install-Module -Cmdlets, wie im folgenden Verfahren beschrieben.

So installieren Sie AWSPowerShell.NetCore on Linux oder macOS mit dem Cmdlet Install-Module

Starten Sie eine PowerShell Core-Sitzung, indem Sie den folgenden Befehl ausführen.

$ pwsh
Anmerkung

Wir empfehlen Ihnen, nicht mit der Ausführung PowerShell von PowerShell mit erhöhten Administratorrechten sudo pwsh zu beginnen. Grund ist das potenzielle Sicherheitsrisiko und weil dies im Widerspruch zum Prinzip der geringsten Zugriffsrechte stünde.

Führen Sie den folgenden Befehl aus, um das AWSPowerShell.NetCore single-module-Paket aus der - PowerShell Galerie zu installieren.

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

Wenn Sie benachrichtigt werden, dass das Repository "nicht vertrauenswürdig" ist, werden Sie gefragt, ob trotzdem installiert werden soll. Geben Sie einy, um die Installation des Moduls PowerShell zu erlauben. Um die Eingabeaufforderung zu vermeiden, ohne dem Repository zu vertrauen, können Sie den folgenden Befehl ausführen:

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

Sie müssen diesen Befehl nicht als Stamm ausführen, es sei denn, Sie möchten die AWS Tools for PowerShell für alle Benutzer eines Computers installieren. Führen Sie dazu den folgenden Befehl in einer PowerShell Sitzung aus, die Sie mit gestartet habensudo pwsh.

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

Skriptausführung

Der Befehl Set-ExecutionPolicy ist auf Nicht-Windows-Systemen nicht verfügbar. Sie können ausführenGet-ExecutionPolicy, was zeigt, dass die Standardeinstellung für die Ausführungsrichtlinie in PowerShell Core, die auf Nicht-Windows-Systemen ausgeführt wird, istUnrestricted. Weitere Informationen finden Sie auf der Microsoft-Technet-Website unter About Execution Policies (Über Ausführungsrichtlinien).

Da die den Speicherort des AWS Modulverzeichnisses PSModulePath enthält, zeigt das Get-Module -ListAvailable Cmdlet das installierte Modul an.

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

Konfigurieren einer PowerShell Konsole für die Verwendung der AWS Tools for PowerShell Core (AWSPowerShellNetCore nur )

PowerShell Core lädt Module in der Regel automatisch, wenn Sie ein Cmdlet im Modul ausführen. Dies funktioniert jedoch nicht für AWSPowerShell. NetCore Aufgrund seiner großen Größe. Um mit der Ausführung von AWSPowerShell.NetCore cmdlets zu beginnen, müssen Sie zuerst den Import-Module AWSPowerShell.NetCore Befehl ausführen. Dies ist für Cmdlets in AWS.Tools-Modulen nicht erforderlich.

Initialisieren Ihrer PowerShell Sitzung

Wenn Sie nach der Installation der PowerShell auf einem Linux-basierten oder macOS-basierten System beginnen AWS Tools for PowerShell, müssen Sie Initialize-AWSDefaultConfiguration ausführen, um anzugeben, welcher AWS Zugriffsschlüssel verwendet werden soll. Mehr über Initialize-AWSDefaultConfiguration erfahren Sie unter Verwenden von AWS-Anmeldeinformationen.

Anmerkung

In früheren Versionen (vor 3.3.96.0) von wurde AWS Tools for PowerShell dieses Cmdlet als bezeichnetInitialize-AWSDefaults.

Versionsverwaltung

AWS veröffentlicht AWS Tools for PowerShell regelmäßig neue Versionen von , um neue AWS Services und Funktionen zu unterstützen. Um die Version des zu ermitteln AWS Tools for PowerShell , das Sie installiert haben, führen Sie das Get-cmdletAWSPowerShellVersion aus.

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]

Um eine Liste der unterstützten AWS Services in der aktuellen Version der Tools anzuzeigen, fügen Sie den -ListServiceVersionInfo Parameter zu einem Get-AWSPowerShellVersion-Cmdlet hinzu.

Um die Version von zu ermitteln, PowerShell die Sie ausführen, geben Sie ein, $PSVersionTable um den Inhalt der $PSVersionTable automatischen Variablen anzuzeigen.

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

Aktualisieren der AWS Tools for PowerShell unter Linux oder macOS

Wenn aktualisierte Versionen von veröffentlicht AWS Tools for PowerShell werden, sollten Sie regelmäßig die Version aktualisieren, die Sie lokal ausführen.

Aktualisieren der modularisierten AWS.Tools Module

Führen Sie den folgenden Befehl aus, um Ihre AWS.Tools Module auf die neueste Version zu aktualisieren:

PS > Update-AWSToolsModule -CleanUp

Mit diesem Befehl werden alle aktuell installierten AWS.Tools-Module aktualisiert und die früheren Versionen für die Module, die erfolgreich aktualisiert wurden, entfernt.

Anmerkung

Über das Cmdlet Update-AWSToolsModule werden alle Module aus dem PSRepository namens PSGallery heruntergeladen (https://www.powershellgallery.com/) und als vertrauenswürdige Quelle betrachtet. Für weitere Informationen zu diesem PSRepository verwenden Sie den Befehl Get-PSRepository -Name PSGallery.

Aktualisieren der Tools for PowerShell Core

Führen Sie das Get-AWSPowerShellVersion Cmdlet aus, um die Version zu ermitteln, die Sie ausführen, und vergleichen Sie diese mit der Version von Tools for Windows PowerShell , die auf der PowerShell Gallery-Website verfügbar ist. Wir empfehlen Ihnen, dies alle zwei bis drei Wochen zu überprüfen. Die Unterstützung für neue Befehle und AWS Services ist erst verfügbar, nachdem Sie auf eine Version mit dieser Unterstützung aktualisiert haben.

Bevor Sie eine neuere Version von installieren AWSPowerShellNetCore, deinstallieren Sie das vorhandene -Modul. Schließen Sie alle offenen PowerShell Sitzungen, bevor Sie das vorhandene Paket deinstallieren. Führen Sie zur Deinstallation den folgenden Befehl aus.

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

Nachdem das Paket deinstalliert wurde, installieren Sie das aktualisierte Modul, indem Sie den folgenden Befehl ausführen.

PS > Install-Module -Name AWSPowerShell.NetCore

Führen Sie nach der Installation den Befehl aus, Import-Module AWSPowerShell.NetCore um die aktualisierten Cmdlets in Ihre PowerShell Sitzung zu laden.

Verwandte Informationen