Installation AWS -Tools für PowerShell unter Linux oder macOS - AWS -Tools für PowerShell (Ausführung 4)

Die AWS -Tools für PowerShell Version 5 (V5) befindet sich in der Vorschauversion. Informationen zum Inhalt von Version 5 (Änderungen vorbehalten) und zum Ausprobieren der neuen Version finden Sie im Benutzerhandbuch für Version 5 (Vorschau). Spezifische Informationen zu grundlegenden Änderungen und zur Migration auf Version 5 finden Sie im Migrationsthema in diesem Handbuch.

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 für PowerShell unter Linux oder macOS

Dieses Thema enthält Anweisungen zur Installation von AWS -Tools für PowerShell unter Linux oder macOS.

Übersicht über die Einrichtung

Für die Installation AWS -Tools für PowerShell auf einem Linux- oder macOS-Computer können Sie aus zwei Paketoptionen wählen:

  • AWS.Tools— Die modularisierte Version von. AWS -Tools für PowerShell Jeder AWS Dienst wird von einem eigenen, kleinen Modul mit gemeinsam genutzten Unterstützungsmodulen AWS.Tools.Common unterstützt.

  • AWSPowerSchale. NetCore — Die einzelne Version mit großen Modulen von. AWS -Tools für PowerShell Alle AWS Dienste 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. Starten Sie nach der Installation PowerShell von PowerShell Core zunächst pwsh in Ihrer Systemshell.

  3. Installieren Sie entweder AWS.Tools oder AWSPower Shell. NetCore.

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

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

Voraussetzungen

Um das ausführen zu können 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 zur Installation der neuesten Version von PowerShell auf einem Linux-basierten Computer finden Sie unter Installation unter Linux PowerShell 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 auf macOS finden Sie unter Installation PowerShell auf macOS auf der Microsoft-Website.

Installieren der AWS.Tools unter Linux oder macOS

Sie können die modularisierte Version von AWS -Tools für PowerShell auf Computern installieren, auf denen PowerShell Core 6.0 oder höher ausgeführt wird. Informationen zur Installation von PowerShell Core finden Sie unter Installation verschiedener Versionen von PowerShell auf der PowerShell Microsoft-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.Installerbenötigt PowerShellGet und lädt automatisch eine aktualisierte Version davon herunter und installiert sie. AWS.Tools.Installerhält Ihre Modulversionen automatisch synchron. Wenn Sie ein Modul installieren oder auf eine neuere Version aktualisieren, aktualisieren die Cmdlets 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.

  • Installation der einzelnen Servicemodule aus der PowerShell Galerie mithilfe des Install-Module Cmdlets.

Zur Installation AWS.Tools unter Linux oder macOS mit dem AWS.Tools.Installer Modul
  1. Starten Sie eine PowerShell Core-Sitzung, indem Sie den folgenden Befehl ausführen.

    $ pwsh
    Anmerkung

    Wir empfehlen, dass Sie nicht PowerShell als Administrator mit erhöhten Rechten arbeiten, 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 y die Eingabetaste ein PowerShell , um die Installation des Moduls zuzulassen. 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 Amazon EC2 - und Amazon S3 S3-Module 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

    Das Install-AWSToolsModule Cmdlet lädt alle angeforderten Module aus PSRepository dem angegebenen Verzeichnis PSGallery (https://www.powershellgallery.com/) herunter und betrachtet das Repository als vertrauenswürdige Quelle. 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 der Distribution und Version Ihres Betriebssystems sowie von der Version ab, die PowerShell Sie installiert haben. 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 Installation unter Linux PowerShell auf der PowerShell Microsoft-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, die Sie in der PowerShell Galerie finden.

Installieren Sie AWSPower Shell. NetCore unter Linux oder macOS

Um auf eine neuere Version von AWSPower Shell zu aktualisieren. NetCore, folgen Sie den Anweisungen unterAktualisierung des AWS -Tools für PowerShell unter Linux oder macOS. Deinstallieren Sie frühere Versionen von AWSPower Shell. NetCore zuerst.

Sie können AWSPower Shell installieren. NetCore auf eine von zwei Arten:

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

  • Installation aus der PowerShell Galerie mit dem Install-Module Cmdlet, wie im folgenden Verfahren beschrieben.

Um Shell zu installieren AWSPower. NetCore unter 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, dass Sie das Programm nicht PowerShell zunächst PowerShell mit erhöhten Administratorrechten ausführen. sudo pwsh Grund ist das potenzielle Sicherheitsrisiko und weil dies im Widerspruch zum Prinzip der geringsten Zugriffsrechte stünde.

Um die AWSPower Shell zu installieren. NetCore Führen Sie den folgenden Befehl für ein einzelnes Modulpaket aus der PowerShell Galerie aus.

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 y die Eingabetaste ein, PowerShell um die Installation des Moduls zu ermöglichen. 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 Root-Benutzer ausführen, es sei denn, Sie möchten den AWS -Tools für PowerShell für alle Benutzer eines Computers installieren. Führen Sie dazu den folgenden Befehl in einer PowerShell Sitzung aus, mit der Sie begonnen 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, lautetUnrestricted. Weitere Informationen finden Sie auf der Microsoft-Technet-Website unter About Execution Policies (Über Ausführungsrichtlinien).

Da das den Speicherort des AWS Modulverzeichnisses PSModulePath beinhaltet, zeigt das Get-Module -ListAvailable Cmdlet das Modul an, das Sie installiert haben.

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 Sie eine PowerShell Konsole für die Verwendung der AWS Tools for PowerShell Core (AWSPowerShell. NetCore Nur)

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

Initialisieren Sie Ihre Sitzung PowerShell

Wenn Sie nach der Installation PowerShell auf einem Linux- oder MacOS-basierten System starten, müssen Sie Initialize- AWSDefault Configuration ausführen AWS -Tools für PowerShell, um anzugeben, welcher AWS Zugriffsschlüssel verwendet werden soll. Mehr über Initialize-AWSDefaultConfiguration erfahren Sie unter AWS Anmeldeinformationen verwenden.

Anmerkung

In früheren Versionen (vor 3.3.96.0) von wurde dieses Cmdlet benannt. AWS -Tools für PowerShellInitialize-AWSDefaults

Versionsverwaltung

AWS veröffentlicht AWS -Tools für PowerShell regelmäßig neue Versionen von, um neue Dienste und Funktionen zu unterstützen. AWS Führen Sie das AWSPower ShellVersion Cmdlet Get- aus AWS -Tools für PowerShell , um die Version von zu ermitteln, die Sie installiert haben.

Zum Beispiel:

PS > Get-AWSPowerShellVersion AWS Tools for PowerShell Version 4.1.675 Copyright 2012-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved. Amazon Web Services SDK for .NET Core Runtime Version 3.7.400.33 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]

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

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

Zum Beispiel:

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

Aktualisierung des AWS -Tools für PowerShell unter Linux oder macOS

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

Aktualisieren Sie die modularisierten Module AWS.Tools

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

Das Update-AWSToolsModule Cmdlet lädt alle Module von der angegebenen Quelle PSGallery (PSRepositoryhttps://www.powershellgallery.com/) herunter und betrachtet sie als vertrauenswürdige Quelle. Für weitere Informationen zu diesem PSRepository verwenden Sie den Befehl Get-PSRepository -Name PSGallery.

Aktualisieren Sie die Tools für Core PowerShell

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

Bevor Sie eine neuere Version von AWSPower Shell installieren. NetCore, deinstallieren Sie das vorhandene Modul. Schließen Sie alle geöffneten 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