Installation des AWS Tools for PowerShell unter Windows - AWS Tools for PowerShell
VoraussetzungenInstallieren AWS.ToolsInstallieren AWSPowerShell. NetCoreInstallieren AWSPowerShellAktivieren der SkriptausführungVersionsverwaltungAktualisierung AWS Tools for PowerShell

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 des AWS Tools for PowerShell unter Windows

Auf einem Windows-Computer können alle Paketoptionen ausgeführt werden: AWS Tools for PowerShell

  • AWS.Tools- Die modularisierte Version von. AWS Tools for PowerShell Jeder AWS Dienst wird durch ein eigenes, kleines Modul mit gemeinsam genutzten Unterstützungsmodulen AWS.Tools.Common und AWS.Tools.Installer unterstützt.

  • AWSPowerShell. NetCore- Die einzelne Version mit großen Modulen von. AWS Tools for 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.

  • AWSPowerShell- Die ältere Windows-spezifische Einzelversion mit großen Modulen von. AWS Tools for PowerShell Alle AWS Dienste werden von diesem einzigen, großen Modul unterstützt.

Das ausgewählte Paket hängt von der Version und Edition von Windows ab, die Sie ausführen.

Anmerkung

Die Tools für Windows PowerShell (AWSPowerShellModul) sind standardmäßig auf allen Windows-basierten Amazon Machine Images () AMIs installiert.

Die Einrichtung von AWS Tools for PowerShell umfasst die folgenden allgemeinen Aufgaben, die in diesem Thema ausführlich beschrieben werden.

  1. Installieren Sie die AWS Tools for PowerShell Paketoption, die für Ihre Umgebung geeignet ist.

  2. Sicherstellen, dass die Skriptausführung aktiviert ist, indem Sie das Cmdlet Get-ExecutionPolicy ausführen

  3. Importieren Sie das AWS Tools for PowerShell Modul in Ihre PowerShell Sitzung.

Voraussetzungen

Neuere Versionen von PowerShell, einschließlich PowerShell Core, sind als Downloads von Microsoft unter Installing various versions of PowerShell auf der Microsoft-Website verfügbar.

Installieren von AWS.Tools unter Windows.

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

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 Modulordner. Sie können Ihre Modulordner erkennen, indem Sie den Wert der PSModulePath-Umgebungsvariablen anzeigen.

    Warnung

    Nach dem Herunterladen der ZIP Datei und vor dem Extrahieren des Inhalts müssen Sie sie möglicherweise entsperren. Dies erfolgt in der Regel, indem Sie die Eigenschaften der Datei öffnen, die Registerkarte Allgemein aufrufen und das Kontrollkästchen Entsperren aktivieren, falls eines vorhanden ist.

    Wenn die ZIP Datei entsperrt werden muss, Sie dies aber nicht tun, erhalten Sie möglicherweise eine Fehlermeldung ähnlich der folgenden: „Import-Modul: Datei oder Assembly konnte nicht geladen werden“.

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

Zur Installation AWS.Tools unter Windows mithilfe des Moduls AWS.Tools.Installer

  1. Startet eine PowerShell Sitzung.

    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 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 die Installation trotzdem erfolgen 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 Befehl mit dem -Force-Parameter ausführen:

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

  3. Sie können jetzt das Modul für jeden AWS Dienst, den Sie verwenden möchten, mithilfe des Install-AWSToolsModule Cmdlets installieren. 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 von der angegebenen Quelle PSRepository PSGallery (https://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.

    Standardmäßig werden über diesen Befehl Module im %USERPROFILE%\Documents\WindowsPowerShell\Modules-Ordner installiert. Um das AWS Tools for PowerShell für alle Benutzer eines Computers zu installieren, müssen Sie den folgenden Befehl in einer PowerShell Sitzung ausführen, die Sie als Administrator gestartet haben. Mit dem folgenden Befehl wird das IAM Modul beispielsweise in dem %ProgramFiles%\WindowsPowerShell\Modules Ordner installiert, auf den alle Benutzer zugreifen können.

    PS > Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers

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

Installieren AWSPowerShell. NetCore unter Windows

Sie können das installieren AWSPowerShell. NetCore auf Computern, auf denen Windows mit PowerShell Version 3 bis 5.1 oder 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 installieren AWSPowerShell. NetCore auf eine von zwei Arten

  • Das Modul wird heruntergeladen von AWSPowerShell. NetCore.zip und entpacken in eines der Modulverzeichnisse. Sie können Ihre Modulverzeichnisse erkennen, indem Sie den Wert der PSModulePath-Umgebungsvariablen anzeigen.

    Warnung

    Nach dem Herunterladen der ZIP Datei und vor dem Extrahieren des Inhalts müssen Sie sie möglicherweise entsperren. Dies erfolgt in der Regel, indem Sie die Eigenschaften der Datei öffnen, die Registerkarte Allgemein aufrufen und das Kontrollkästchen Entsperren aktivieren, falls eines vorhanden ist.

    Wenn die ZIP Datei entsperrt werden muss, Sie dies aber nicht tun, erhalten Sie möglicherweise eine Fehlermeldung ähnlich der folgenden: „Import-Modul: Datei oder Assembly konnte nicht geladen werden“.

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

Zur Installation. AWSPowerShell NetCore aus der PowerShell Galerie mit dem Cmdlet Install-Module

Um das zu installieren. AWSPowerShell NetCore aus der PowerShell Galerie muss auf Ihrem Computer PowerShell 5.0 oder höher oder Version PowerShell 3 oder höher PowerShellGetausgeführt werden. Führen Sie den folgenden Befehl aus.

PS > Install-Module -name AWSPowerShell.NetCore

Wenn Sie PowerShell als Administrator arbeiten, wird der vorherige Befehl AWS Tools for PowerShell für alle Benutzer auf dem Computer installiert. Wenn Sie PowerShell als Standardbenutzer ohne Administratorrechte arbeiten, wird derselbe Befehl nur AWS Tools for PowerShell für den aktuellen Benutzer installiert.

Um nur für den aktuellen Benutzer zu installieren, wenn dieser Benutzer über Administratorberechtigungen verfügt, führen Sie den Befehl mit dem festgelegten Parameter -Scope CurrentUser wie folgt aus.

PS > Install-Module -name AWSPowerShell.NetCore -Scope CurrentUser

In Versionen PowerShell 3.0 und höher werden zwar in der Regel Module in Ihre PowerShell Sitzung geladen, wenn Sie zum ersten Mal ein Cmdlet im Modul ausführen, aber AWSPowerShell NetCore Das Modul ist zu groß, um diese Funktionalität zu unterstützen. Sie müssen stattdessen das explizit laden AWSPowerShell. NetCore Kernmodul in Ihre PowerShell Sitzung, indem Sie den folgenden Befehl ausführen.

PS > Import-Module AWSPowerShell.NetCore

Um das zu laden AWSPowerShell. NetCore Automatisches Modul in eine PowerShell Sitzung, fügen Sie diesen Befehl zu Ihrem PowerShell Profil hinzu. Weitere Informationen zur Bearbeitung Ihres PowerShell Profils finden Sie in der PowerShell Dokumentation unter Über Profile.

Unter AWSPowerShell Windows installieren PowerShell

Sie können das AWS Tools for Windows PowerShell auf zwei Arten installieren:

  • Laden Sie das Modul aus der AWSPowerShellZIP-Datei herunter und entpacken Sie es in eines der Modulverzeichnisse. Sie können Ihre Modulverzeichnisse erkennen, indem Sie den Wert der PSModulePath-Umgebungsvariablen anzeigen.

    Warnung

    Nach dem Herunterladen der ZIP Datei und vor dem Extrahieren des Inhalts müssen Sie sie möglicherweise entsperren. Dies erfolgt in der Regel, indem Sie die Eigenschaften der Datei öffnen, die Registerkarte Allgemein aufrufen und das Kontrollkästchen Entsperren aktivieren, falls eines vorhanden ist.

    Wenn die ZIP Datei entsperrt werden muss, Sie dies aber nicht tun, erhalten Sie möglicherweise eine Fehlermeldung ähnlich der folgenden: „Import-Modul: Datei oder Assembly konnte nicht geladen werden“.

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

So installieren Sie die Installation AWSPowerShell aus der PowerShell Galerie mit dem Cmdlet Install-Module

Sie können das AWSPowerShell aus der PowerShell Galerie installieren, wenn Sie PowerShell 5.0 oder höher ausführen oder Version 3 oder höher PowerShellGetinstalliert PowerShell haben. Sie können die Installation und Aktualisierung über die PowerShellGalerie AWSPowerShell von Microsoft durchführen, indem Sie den folgenden Befehl ausführen.

 PS > Install-Module -Name AWSPowerShell

Um das AWSPowerShell Modul automatisch in eine PowerShell Sitzung zu laden, fügen Sie Ihrem PowerShell Profil das vorherige import-module Cmdlet hinzu. Weitere Informationen zur Bearbeitung Ihres PowerShell Profils finden Sie in der PowerShell Dokumentation unter Über Profile.

Anmerkung

Die Tools für Windows PowerShell sind standardmäßig auf allen Windows-basierten Amazon Machine Images () AMIs installiert.

Aktivieren der Skriptausführung

Um die AWS Tools for PowerShell Module zu laden, müssen Sie die PowerShell Skriptausführung aktivieren. Weisen Sie zur Aktivierung der Skriptausführung mit dem Cmdlet Set-ExecutionPolicy die Richtlinie RemoteSigned zu. Weitere Informationen finden Sie auf der Microsoft-Technet-Website unter About Execution Policies (Über Ausführungsrichtlinien).

Anmerkung

Dies ist nur für Computer erforderlich, auf denen Windows ausgeführt wird. Die Sicherheitseinschränkung ExecutionPolicy ist auf anderen Betriebssystemen nicht vorhanden.

So aktivieren Sie die Skriptausführung

  1. Zum Festlegen der Ausführungsrichtlinien sind Administratorrechte erforderlich. Wenn Sie nicht als Benutzer mit Administratorrechten angemeldet sind, öffnen Sie eine PowerShell Sitzung als Administrator. Wählen Sie Start und dann All Programs (Alle Programme). Wählen Sie „Zubehör“ und anschließend „Windows“ PowerShell. Klicken Sie mit der rechten Maustaste auf Windows PowerShell und wählen Sie im Kontextmenü die Option Als Administrator ausführen aus.

  2. Geben Sie in der Eingabeaufforderung Folgendes ein.

    PS > Set-ExecutionPolicy RemoteSigned
Anmerkung

Auf einem 64-Bit-System müssen Sie dies für die 32-Bit-Version von PowerShell Windows PowerShell (x86) separat tun.

Wenn Sie die Ausführungsrichtlinie nicht richtig eingestellt haben, PowerShell wird bei jedem Versuch, ein Skript auszuführen, z. B. Ihr Profil, die folgende Fehlermeldung angezeigt.

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

Das PowerShell Installationsprogramm für Tools für Windows aktualisiert das automatisch PSModulePath, sodass es den Speicherort des Verzeichnisses enthält, das das AWSPowerShell Modul enthält.

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

PS > Get-Module -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   AppLocker                 {}
Manifest   BitsTransfer              {}
Manifest   PSDiagnostics             {}
Manifest   TroubleshootingPack       {}
Manifest   AWSPowerShell             {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol...

Versionsverwaltung

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

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]

Sie können den -ListServiceVersionInfo Parameter auch einem AWSPowerShellVersionGet-Befehl hinzufügen, um eine Liste der AWS Dienste anzuzeigen, die in der aktuellen Version der Tools unterstützt werden. Wenn Sie die modularisierte Option AWS.Tools.* verwenden, werden nur die Module angezeigt, die Sie aktuell importiert haben.

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

Um festzustellen PowerShell , welche Version 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

Aktualisierung der AWS Tools for PowerShell unter Windows

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

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 nach erfolgreicher Aktualisierung andere installierte Versionen 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 installieren AWSPowerShell. 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.

Aktualisieren Sie die Tools für Windows 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.

  • Wenn Sie die Installation mithilfe des Cmdlets Install-Module vorgenommen haben, führen Sie die folgenden Befehle aus.

    PS > Uninstall-Module -Name AWSPowerShell -AllVersions
PS > Install-Module -Name AWSPowerShell

  • Wenn Sie die Installation mithilfe einer heruntergeladenen ZIP Datei durchgeführt haben:

    1. Laden Sie die neueste Version von der PowerShell Website Tools for herunter. Vergleichen Sie die Paketversionsnummer im heruntergeladenn Dateinamen mit der Versionsnummer, die Sie beim Ausführen des Cmdlets Get-AWSPowerShellVersion erhalten.

    2. Wenn die Download-Version höher ist als die Version, die Sie installiert haben, schließen Sie alle Tools für PowerShell Windows-Konsolen.

    3. Installieren Sie die neuere Version der Tools für Windows PowerShell.

Führen Sie nach der Installation den Befehl aus, Import-Module AWSPowerShell um die aktualisierten Cmdlets in Ihre PowerShell Sitzung zu laden. Oder führen Sie die benutzerdefinierte AWS Tools for PowerShell Konsole über Ihr Startmenü aus.