AWS-TOOLS FÜR POWERSHELL - BENUTZERHANDBUCH - AWS-TOOLS FÜR POWERSHELL: BENUTZERHANDBUCH - AMAZON.COM
←
→
Transkription von Seiteninhalten
Wenn Ihr Browser die Seite nicht korrekt rendert, bitte, lesen Sie den Inhalt der Seite unten
AWS-Tools für PowerShell
Benutzerhandbuch
AWS-Tools für PowerShell: Benutzerhandbuch
Copyright © 2021 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.AWS-Tools für PowerShell Benutzerhandbuch Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by Amazon.
AWS-Tools für PowerShell Benutzerhandbuch
Table of Contents
Was sind die AWS Tools for PowerShell? .............................................................................................. 1
Wartung und Support für SDK-Hauptversionen ................................................................................ 1
AWS.Tools ................................................................................................................................ 1
AWSPowerShell.NetCore ............................................................................................................. 2
AWSPowerShell ......................................................................................................................... 3
Verwendung dieses Handbuchs .................................................................................................... 3
Installation ......................................................................................................................................... 4
Voraussetzungen ........................................................................................................................ 4
Installation unter Windows ........................................................................................................... 6
Voraussetzungen ................................................................................................................ 6
Installieren von AWS.Tools .................................................................................................. 6
Installieren von AWSPowerShell.NetCore ............................................................................... 8
Installieren von AWSPowerShell ........................................................................................... 9
Aktivieren der Skriptausführung ............................................................................................ 9
Versioning ........................................................................................................................ 10
Aktualisieren von AWS Tools for PowerShell ......................................................................... 12
Installation unter Linux oder macOS ............................................................................................ 13
Übersicht über die Einrichtung ............................................................................................ 13
Voraussetzungen ................................................................................................................ 6
Installieren von AWS.Tools ................................................................................................. 14
Installieren von AWSPowerShell.NetCore ............................................................................. 16
Skriptausführung ................................................................................................................. 9
Konfigurieren der PowerShell-Konsole .................................................................................. 17
Initialisieren der PowerShell-Sitzung .................................................................................... 17
Versioning ........................................................................................................................ 10
Aktualisieren der AWS Tools for PowerShell unter Linux oder macOS ....................................... 19
Verwandte Informationen .................................................................................................... 20
Migrieren von der AWS Tools for PowerShell-Version 3.3 zu Version 4 .............................................. 20
Neue vollständig modularisierte AWS.Tools-Version ............................................................... 20
Neues Get-AWSService-Cmdlet ........................................................................................ 21
Neuer -Select-Parameter zum Steuern des von einem Cmdlet zurückgegebenen Objekts .......... 21
Konsistentere Begrenzung der Anzahl der Elemente in der Ausgabe ......................................... 22
Einfachere Verwendung von Stream-Parametern ................................................................... 23
Erweitern der Pipe um den Eigenschaftsnamen ..................................................................... 23
Statische gängige Parameter .............................................................................................. 23
AWS.Tools deklariert und erzwingt obligatorische Parameter ................................................... 24
Alle Parameter sind löschbar .............................................................................................. 24
Entfernen von zuvor nicht unterstützten Funktionen ................................................................ 24
AWS-Konto und Zugriffsschlüssel ................................................................................................ 24
So erhalten Sie Ihre Zugriffsschlüssel-ID und Ihren geheimen Zugriffsschlüssel ........................... 25
Erste Schritte ................................................................................................................................... 26
AWS-Anmeldeinformationen ....................................................................................................... 26
Speicherorte für Anmeldeinformationen ................................................................................ 26
Verwalten von Profilen ....................................................................................................... 27
Festlegen von Anmeldeinformationen ................................................................................... 28
Suchreihenfolge für Anmeldeinformationen ............................................................................ 30
Verarbeitung von Anmeldeinformationen in AWS-Tools für PowerShell Core ............................... 31
Gemeinsame Anmeldeinformationen ............................................................................................ 32
Verwenden einer IAM-Rolle mit AWS Tools for PowerShell ...................................................... 32
Verwenden der Anmeldeinformationsprofil-Typen ................................................................... 34
Der allgemeine Parameter ProfilesLocation ................................................................... 34
Anzeigen von Anmeldeinformationsprofilen ........................................................................... 35
Entfernen von Anmeldeinformationsprofilen ........................................................................... 35
Wichtige Hinweise ............................................................................................................. 35
iiiAWS-Tools für PowerShell Benutzerhandbuch
AWS-Regionen ......................................................................................................................... 36
Angeben eines benutzerdefinierten oder nicht standardmäßigen Endpunkts ................................ 37
Cmdlet-Erkennung und -Aliasse .................................................................................................. 37
Cmdlet-Erkennung ............................................................................................................. 38
Cmdlet-Namen und -Aliasse ............................................................................................... 42
Pipeline-Ausführung und $AWSHistory ......................................................................................... 44
$AWSHistory .................................................................................................................... 45
Konfigurieren einer Verbundidentität ............................................................................................ 48
Voraussetzungen .............................................................................................................. 48
Wie ein Identitätsverbundbenutzer Verbundzugriff auf AWS-Service-APIs erhält .......................... 48
So unterstützt SAML Arbeiten in den AWS Tools for PowerShell .............................................. 49
Verwenden der PowerShell-Cmdlets für die SAML-Konfiguration .............................................. 50
Weiterführende Lektüre ...................................................................................................... 54
Verwendung von AWS-Tools für Windows PowerShell ............................................................................ 55
PowerShell File-Verkettungscodierung .......................................................................................... 55
Zurückgegebene Objekte für die PowerShell-Tools ......................................................................... 56
Amazon EC2 ............................................................................................................................ 56
Amazon S3 .............................................................................................................................. 56
AWS Identity and Access Management ........................................................................................ 56
AWS Lambda und Lambda-Tools für PowerShell .......................................................................... 57
Amazon SNS und Amazon SQS ................................................................................................. 57
CloudWatch ............................................................................................................................ 57
Weitere Informationen finden Sie auch unter: ................................................................................ 57
Amazon S3 und Tools für Windows PowerShell ............................................................................ 57
Weitere Informationen finden Sie auch unter: ........................................................................ 57
Erstellen eines Amazon S3-Buckets, Verifizieren der Region und (optional) Entfernen des
Buckets ........................................................................................................................... 58
Konfigurieren eines Amazon S3-Buckets als Website und Aktivieren der Protokollierung ............... 59
Hochladen von Objekten in einen Amazon S3-Bucket ............................................................. 59
Löschen von Amazon S3-Objekten und -Buckets ................................................................... 61
Hochladen von Inline-Textinhalt nach Amazon S3 .................................................................. 62
IAM und Tools für Windows PowerShell ....................................................................................... 62
Erstellen von neuen IAM-Benutzern und -Gruppen ................................................................. 62
Festlegen einer IAM-Richtlinie für einen IAM-Benutzer ............................................................ 63
Festlegen eines anfänglichen Passworts für einen IAM-Benutzer .............................................. 64
Amazon EC2 und Tools für Windows PowerShell .......................................................................... 65
Erstellen eines Schlüsselpaares .......................................................................................... 65
Erstellen einer Sicherheitsgruppe ........................................................................................ 67
Suchen eines AMI ............................................................................................................. 70
Starten einer Instance ....................................................................................................... 72
AWS Lambda und AWS Tools for PowerShell ............................................................................... 75
Voraussetzungen ................................................................................................................ 6
Installieren Sie das AWSLambdaPSCore-Modul. .................................................................... 76
Weitere Informationen finden Sie auch unter: ........................................................................ 57
Amazon SQS, Amazon SNS und Tools für Windows PowerShell ...................................................... 76
Erstellen einer Amazon SQS-Warteschlange und Abrufen des Warteschlangen-ARN ................... 76
Erstellen eines Amazon SNS-Themas .................................................................................. 77
Gewähren von Berechtigungen für das SNS-Thema ............................................................... 77
Abonnieren der Warteschlange für das SNS-Thema ............................................................... 77
Gewähren von Berechtigungen ........................................................................................... 78
Überprüfen der Ergebnisse ................................................................................................. 78
CloudWatch aus AWS-Tools für Windows PowerShell .................................................................... 79
Veröffentlichen einer benutzerdefinierten Kennzahl im CloudWatch-Dashboard ........................... 79
Weitere Informationen finden Sie auch unter: ........................................................................ 57
Sicherheit ........................................................................................................................................ 81
Datenschutz ............................................................................................................................. 81
Datenverschlüsselung ........................................................................................................ 82
ivAWS-Tools für PowerShell Benutzerhandbuch
Identitäts- und Zugriffsverwaltung ................................................................................................ 82
Compliance-Validierung .............................................................................................................. 83
Dokumentverlauf .............................................................................................................................. 85
.................................................................................................................................................. lxxxix
vAWS-Tools für PowerShell Benutzerhandbuch
Wartung und Support für SDK-Hauptversionen
Was sind die AWS Tools for
PowerShell?
Die Schaltfläche AWS Tools for PowerShell sind eine Reihe von PowerShell Module, die auf der
Funktionalität basieren, die von der AWS SDK für .NET. Die Schaltfläche AWS Tools for PowerShell
ermöglichen es Ihnen, Operationen auf Ihrem AWS Ressourcen aus dem PowerShell Befehlszeile.
Die cmdlets bieten eine idiomatische PowerShell Erfahrung bei der Festlegung von Parametern und der
Handhabung von Ergebnissen, auch wenn sie mit den verschiedenen AWS HTTP-Abfrage des Dienstes
APIs. (z. B.. Beispielsweise die cmdlets für die AWS Tools for PowerShell Unterstützung PowerShell
Rohrleitung—das heißt, man kann PowerShell Objekte in und aus den cmdlets.
Die AWS Tools for PowerShell bieten verschiedene Möglichkeiten zum Verarbeiten von
Anmeldeinformationen, einschließlich des Supports für die AWS Identity and Access Management(IAM)-
Infrastruktur. Sie können die Tools mit IAM-Benutzeranmeldeinformationen, temporären Sicherheitstoken
und IAM-Rollen verwenden.
Die AWS Tools for PowerShell unterstützen dieselben Services und AWS-Regionen wie das SDK. Sie
können die AWS Tools for PowerShell auf Computern mit Windows, Linux oder macOS Betriebssysteme.
Note
AWS Tools for PowerShell Version 4 ist die neueste Hauptversion und ein abwärtskompatibles
Update für AWS Tools for PowerShell Version 3.3. Es wurde um erhebliche Verbesserungen
ergänzt, gleichzeitig bleibt das vorhandene Cmdlet-Verhalten beibehalten. Ihre vorhandenen
Skripts sollten nach dem Upgrade auf die neue Version weiterhin funktionieren. Wir empfehlen
jedoch, sie vor dem Aktualisieren gründlich zu testen. Weitere Hinweise zu den Änderungen
in Version 4 finden Sie unter Migrieren von der AWS Tools for PowerShell-Version 3.3 zu
Version 4 (p. 20).
Die AWS Tools for PowerShell sind als folgende drei unterschiedliche Pakete erhältlich:
• AWS.Tools (p. 1)
• AWSPowerShell.NetCore (p. 2)
• AWSPowerShell (p. 3)
Wartung und Support für SDK-Hauptversionen
Informationen zur Wartung und Unterstützung für SDK-Hauptversionen und deren zugrunde liegenden
Abhängigkeiten finden Sie im Folgenden im AWS SDKs and Tools Shared Configuration and Credentials
Guide:
• AWS SDKs and Tools Maintenance Policy
• AWS SDKs and Tools Version Support Matrix
AWS.Tools – Eine modularisierte Version von AWS
Tools for PowerShell
1AWS-Tools für PowerShell Benutzerhandbuch
AWSPowerShell.NetCore
Diese Version von AWS Tools for PowerShell ist die empfohlene Version für jeden Computer, auf dem
PowerShell in einer Produktionsumgebung. Da es modularisiert ist, müssen Sie nur die Module für die
Services herunterladen und laden, die Sie verwenden möchten. Dies reduziert die Downloadzeiten sowie
die Speicherbelegung und ermöglicht den automatischen Import von AWS.Tools-Cmdlets, wobei Import-
Module zuerst manuell aufgerufen werden muss.
Dies ist die neueste Version von AWS Tools for PowerShell und läuft auf allen unterstützten
Betriebssystemen, einschließlich Windows, Linux und macOS. (z. B.. Dieses Paket enthält ein
Installationsmodul, AWS.Tools.Installer, ein gemeinsames Modul, AWS.Tools.Commonund jeweils
ein Modul AWS z. B. AWS.Tools.EC2, , und Sie haben die Möglichkeit AWS.Tools.IAM, , und Sie haben
die Möglichkeit AWS.Tools.S3und so weiter.
Das Modul AWS.Tools.Installer stellt Cmdlets bereit, mit denen Sie die Module für die einzelnen
AWS-Services installieren, aktualisieren und entfernen können. Die Cmdlets in diesem Modul stellen
automatisch sicher, dass Sie über alle abhängigen Module verfügen, die zur Unterstützung der von Ihnen
gewünschten Module erforderlich sind.
Das Modul AWS.Tools.Common stellt Cmdlets für Konfiguration und Authentifizierung bereit, die nicht
servicespezifisch sind. Um die Cmdlets für einen AWS-Service zu verwenden, führen Sie einfach den
Befehl aus. PowerShell importiert automatisch die AWS.Tools.Common und das Modul für die AWS
Service, dessen cmdlet Sie ausführen möchten. Dieses Modul wird automatisch installiert, wenn Sie das
AWS.Tools.Installer-Modul zur Installation der Servicemodule verwenden.
Sie können diese Version von AWS Tools for PowerShell auf Computern installieren, auf denen Folgendes
ausgeführt wird:
• PowerShell Core 6.0 oder höher unter Windows, Linux oder macOS.
• Fenster PowerShell 5.1 oder höher unter Windows mit dem.NET Framework 4.7.2 oder höher.
Wenn wir in diesem Handbuch nur diese Version angeben müssen, verweisen wir darauf mit seinem
Modulnamen: AWS.Tools.
AWSPowerShell.NetCore – Die Einzelmodulversion
von AWS Tools for PowerShell
Diese Version besteht aus einem einzigen, großen Modul, das Support für alle AWS-Services enthält.
Bevor Sie dieses Modul verwenden können, müssen Sie es manuell importieren.
Sie können diese Version von AWS Tools for PowerShell auf Computern installieren, auf denen Folgendes
ausgeführt wird:
• PowerShell Core 6.0 oder höher unter Windows, Linux oder macOS.
• Fenster PowerShell 3.0 oder höher unter Windows mit dem.NET Framework 4.7.2 oder höher.
Wenn wir in diesem Handbuch nur diese Version angeben müssen, verweisen wir darauf mit seinem
Modulnamen: AWSPowerShell.NetCore.
2AWS-Tools für PowerShell Benutzerhandbuch
AWSPowerShell
AWSPowerShell - Eine Einzelmodulversion für
Windows PowerShell
Diese Version von AWS Tools für PowerShell ist kompatibel mit und installierbar nur auf Windows-
Computern, auf denen Windows ausgeführt wird PowerShell -Versionen 2.0 bis 5.1. Es ist nicht kompatibel
mit PowerShell Core 6.0 oder höher oder ein anderes Betriebssystem (Linux oder macOS). Diese Version
besteht aus einem einzigen, großen Modul, das Support für alle AWS-Services enthält.
Wenn wir in diesem Handbuch nur diese Version angeben müssen, verweisen wir darauf mit seinem
Modulnamen: AWSPowerShell.
Verwendung dieses Handbuchs
Das Handbuch ist in die folgenden Abschnitte unterteilt:
Installieren der AWS Tools for PowerShell (p. 4)
In diesem Abschnitt wird erläutert, wie Sie die AWS Tools for PowerShell installieren. Es enthält
Informationen darüber, wie Sie sich für AWS registrieren, wenn Sie noch kein Konto haben, und wie
Sie einen IAM-Benutzer erstellen, mit dem Sie die Cmdlets ausführen können.
Erste Schritte mit AWS-Tools für Windows PowerShell (p. 26)
In diesem Abschnitt werden die Grundlagen der Verwendung der AWS Tools for PowerShell
beschrieben, wie beispielsweise das Angeben von Anmeldeinformationen und AWS-Regionen, das
Suchen von Cmdlets für einen bestimmten Service und die Verwendung von Aliasnamen für Cmdlets.
Verwendung von AWS-Tools für Windows PowerShell (p. 55)
Dieser Abschnitt enthält Informationen zur Verwendung der AWS Tools for PowerShell für einige der
häufigsten AWS-Aufgaben.
3AWS-Tools für PowerShell Benutzerhandbuch
Voraussetzungen
Installieren der AWS Tools for
PowerShell
Informationen zur erfolgreichen Installation und Verwendung der AWS Tools for PowerShell-Cmdlets finden
Sie in den folgenden Themen.
Themen
• Voraussetzungen für die Einrichtung von AWS Tools for PowerShell (p. 4)
• Installieren von AWS Tools for PowerShell unter Windows (p. 6)
• Installation der AWS Tools for PowerShell unter Linux oder macOS (p. 13)
• Migrieren von der AWS Tools for PowerShell-Version 3.3 zu Version 4 (p. 20)
• AWS-Konto und Zugriffsschlüssel (p. 24)
Voraussetzungen für die Einrichtung von AWS
Tools for PowerShell
Um die AWS Tools for PowerShell verwenden zu können, müssen Sie zuerst die folgenden Schritte
ausführen.
1. Registrieren für ein AWS-Konto
Wenn Sie noch nicht über ein AWS-Konto verfügen, finden Sie im folgenden Thema vollständige
Anweisungen zur Registrierung:
https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/
2. Erstellen eines IAM-Benutzers
Nachdem Sie sich für Ihr Konto registriert haben, müssen Sie Benutzer im AWS Identity and Access
Management(IAM)-Service erstellen. Jeder Benutzer hat seine eigenen Anmeldeinformationen und
Berechtigungen. Die Anmeldeinformationen werden verwendet, um den Benutzer zu authentifizieren,
der eine Anfrage stellt. Die Berechtigungen legen fest, welche AWS-Ressourcen und -Operationen für
diesen Benutzer autorisiert sind.
Das Erstellen eines Benutzers wird in diesem Thema nicht beschrieben. Wenn Sie jedoch noch keine
Erfahrung mit AWS haben, empfehlen wir, Folgendes zu lesen:
• Informationen zu Benutzeranmeldeinformationen und bewährten Methoden für ihre Verwaltung
finden Sie unter AWS-Sicherheitsanmeldeinformationen im Allgemeine Amazon Web Services-
Referenz.
• Eine Schritt-für-Schritt-Anleitung zum Erstellen eines Benutzers mit Administratorberechtigungen,
die Sie zum Ausführen von AWS Tools for PowerShell-Befehlen verwenden können, finden Sie unter
Erstellen Ihres ersten Administratorbenutzers und Ihrer ersten Administratorgruppe in IAM im IAM-
Benutzerhandbuch.
3. Erstellen eines Zugriffsschlüssels für Ihren IAM Benutzer
Für AWS Tools for PowerShell ist es erforderlich, dass jedes Cmdlet mit entsprechenden
Anmeldeinformationen gesendet wird. Dazu müssen Sie in der Regel einen Zugriffsschlüssel
4AWS-Tools für PowerShell Benutzerhandbuch
Voraussetzungen
für jeden Benutzer erstellen, der die AWS Tools for PowerShell-Cmdlets verwenden muss. Ein
Zugriffsschlüssel besteht aus einer Zugriffsschlüssel-ID und einem geheimen Zugriffsschlüssel. Diese
werden verwendet, um programmgesteuerte Anfragen an AWS-Services zu signieren (also zum Zweck
der Authentifizierung zu verschlüsseln). Wenn Sie nicht über einen Zugriffsschlüssel verfügen, können
Sie einen mithilfe der IAM-Konsole unter https://console.aws.amazon.com/iam/ erstellen. Wie in AWS-
Sicherheitsanmeldeinformationen beschrieben, empfehlen wir, Zugriffsschlüssel für IAM-Benutzer
anstelle von AWS-Root-Konto-Zugriffsschlüsseln zu verwenden. IAM ermöglicht es Ihnen die sichere
Kontrolle des Zugriffs auf AWS-Services und -Ressourcen in Ihrem AWS-Konto.
Wie bei jeder AWS-Operation erfordert das Erstellen von Zugriffsschlüsseln Berechtigungen zum
Ausführen der zugehörigen IAM-Aktionen. Weitere Informationen finden Sie unter Berechtigungen für
die Verwaltung von IAM-Identitäten im IAM-Benutzerhandbuch.
Nachdem Sie den Zugriffsschlüssel für den ersten Benutzer in der AWS-Konsole erstellt haben,
können Sie diesen Benutzer und seinen Zugriffsschlüssel verwenden, um AWS Tools for PowerShell-
Cmdlets auszuführen und Zugriffsschlüssel für die anderen Benutzer zu erstellen. Das folgende
Beispiel zeigt, wie Sie mit dem Cmdlet New-IAMAccessKey einen Zugriffsschlüssel und einen
geheimen Schlüssel für einen IAM-Benutzer erstellen.
PS > New-IAMAccessKey -UserName alice
AccessKeyId : AKIAIOSFODNN7EXAMPLE
CreateDate : 9/4/19 12:46:18 PM
SecretAccessKey : wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Status : Active
UserName : alice
Speichern Sie diese Anmeldeinformationen an einem sicheren Ort. Sie benötigen sie zu
einem späteren Zeitpunkt, um die Datei mit AWS Tools for PowerShell-Anmeldeinformationen
zu konfigurieren. Weitere Informationen finden Sie unter Verwenden von AWS-
Anmeldeinformationen (p. 26).
Important
Sie können den geheimen Zugriffsschlüssel (das Äquivalent eines Passworts) nur sehen,
wenn Sie den Zugriffsschlüssel erstellen. Sie können es später nicht abrufen. Wenn Sie den
geheimen Schlüssel verlieren, müssen Sie den Zugriffsschlüssel/das geheime Schlüsselpaar
löschen und neu erstellen.
Ein IAM-Benutzer kann nur über zwei Zugriffsschlüssel gleichzeitig verfügen. Wenn Sie versuchen,
einen dritten Satz zu erstellen, gibt das Cmdlet New-IAMAccessKey einen Fehler aus. Um einen
weiteren Satz zu erstellen, müssen Sie zuerst einen der beiden vorhandenen löschen.
Sie können mithilfe des Cmdlets Remove-IAMAccessKey einen Satz von Anmeldeinformationen für
einen IAM-Benutzer zu löschen. Sie müssen sowohl UserName als auch AccessKeyId angeben.
PS > Remove-IAMAccessKey -UserName alice -AccessKeyId -AccessKeyId AKIAIOSFODNN7EXAMPLE
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-IAMAccessKey (DeleteAccessKey)" on target
"AKIAIOSFODNN7EXAMPLE".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is
"Y"): y
PS >
5AWS-Tools für PowerShell Benutzerhandbuch
Installation unter Windows
Installieren von AWS Tools for PowerShell unter
Windows
Auf einem Windows-basierten Computer können alle AWS Tools for PowerShell-Paketoptionen ausgeführt
werden:
• AWS.Tools (p. 6) - die modularisierte Version von AWS Tools for PowerShell. Jeder AWS-Service
wird von einem eigenen, kleinen Modul unterstützt, mit den gemeinsam genutzten Supportmodulen
AWS.Tools.Common und AWS.Tools.Installer.
• AWSPowerShell.NetCore (p. 8) – Die AWS Tools for PowerShell-Version mit einem großen
Einzelmodul. Alle AWS-Services werden von diesem einzigen großen Modul unterstützt.
• AWSPowerShell (p. 9) – Die ältere Windows-spezifische große Einzelmodulversion von AWS Tools
for PowerShell. Alle AWS-Services 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.
Note
Die Tools für Windows PowerShell (AWSPowerShell-Modul) sind standardmäßig auf allen
Windows-basierten Amazon Machine Images (AMIs) installiert.
Das Einrichten von AWS Tools for PowerShell umfasst die folgenden allgemeinen Aufgaben, die in diesem
Thema ausführlich beschrieben werden.
1. Installieren der 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 es AWS Tools for PowerShell-Moduls in Ihre PowerShell-Sitzung
Voraussetzungen
Stellen Sie sicher, dass Sie die in Voraussetzungen für die Einrichtung von AWS Tools for
PowerShell (p. 4) aufgeführten Anforderungen erfüllen.
Neuere Versionen von PowerShell, einschließlich PowerShell Core, stehen als Downloads von Microsoft
auf der Microsoft-Website unter Installieren verschiedener Versionen von PowerShell zur Verfügung.
Installieren von AWS.Tools unter Windows
Sie können die modularisierte Version von AWS Tools for PowerShell auf Computern installieren, auf
denen Windows PowerShell 5.1 oder PowerShell Core 6.0 oder höher ausgeführt wird. Informationen zum
Installieren von PowerShell Core finden Sie auf der Website von Microsoft unter Installieren verschiedener
Versionen von PowerShell.
Sie können AWS.Tools auf drei Arten installieren:
• Verwenden der Cmdlets im AWS.Tools-Modul. Das AWS.Tools.Installer-Modul vereinfacht die
Installation und Aktualisierung anderer AWS.Tools-Module. Die AWS.Tools.Installer verlangt
eine aktualisierte Version von PowerShellGet, lädt diese automatisch herunter und installiert sie..
Das AWS.Tools.Installer-Modul hält zudem Ihre Modulversionen automatisch synchron. Wenn
Sie eine neuere Version eines Moduls installieren oder aktualisieren, aktualisieren die Cmdlets im
AWS.Tools.Installer automatisch alle anderen AWS.Tools-Module auf dieselbe Version.
6AWS-Tools für PowerShell Benutzerhandbuch
Installieren von AWS.Tools
• 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 $Env:PSModulePath-Variablen drucken.
• Installieren der einzelnen Dienstmodule aus der PowerShell Gallery mithilfe des Install-Module-
Cmdlets, wie im folgenden Verfahren beschrieben.
So installieren Sie AWS.Tools unter Windows mit dem Cmdlet Install-Module:
1. Starten Sie eine PowerShell-Sitzung.
Note
Wir empfehlen, PowerShell nicht 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 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 ein, damit PowerShell das Modul installieren
kann. 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 das Modul nun mittels Install-AWSToolsModule-Cmdlet für jeden AWS-Service
installieren, den Sie verwenden möchten. Mit dem folgenden Befehl wird beispielsweise das IAM-
Modul 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
7AWS-Tools für PowerShell Benutzerhandbuch
Installieren von AWSPowerShell.NetCore
Uninstalling module AWS.Tools.SQS
Uninstalling module AWS.Tools.Common
Note
Über das Cmdlet Install-AWSToolsModule werden alle angeforderten 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.
Standardmäßig werden über diesen Befehl Module im $home\Documents\PowerShell\Modules-
Ordner installiert. Um die 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. Dadurch werden Module im $env:ProgramFiles\PowerShell\Modules-Ordner
installiert, auf den alle Benutzer zugreifen können.
PS > Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers
Installieren von AWSPowerShell.NetCore unter
Windows.
Sie können den AWSPowerShell.NetCore auf Computern installieren, auf denen Windows mit den
PowerShell-Versionen 3 bis 5.1 oder PowerShell Core 6.0 oder höher ausgeführt wird. Informationen zum
Installieren von PowerShell Core finden Sie unter Installieren verschiedener Versionen von PowerShell auf
der Microsoft PowerShell-Website.
Sie können AWSPowerShell.NetCore auf 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.
• Installation über die PowerShell Gallery mithilfe des Install-Module-Cmdlets, wie im folgenden
Verfahren beschrieben.
So installieren Sie AWSPowerShell.NetCore mithilfe des Cmdlets Install-Module aus der PowerShell
Gallery
Um den AWSPowerShell.NetCore aus der PowerShell Gallery zu installieren, muss auf Ihrem Computer
PowerShell 5.0 oder höher oder PowerShellGet auf PowerShell 3 oder höher ausgeführt werden. Führen
Sie den folgenden Befehl aus.
PS > Install-Module -name AWSPowerShell.NetCore
Wenn Sie PowerShell als Administrator ausführen, installiert der vorherige Befehl AWS Tools for
PowerShell für alle Benutzer auf dem Computer. Wenn Sie PowerShell als Standardbenutzer ohne
Administratorberechtigungen ausführen, installiert derselbe Befehl AWS Tools for PowerShell nur für den
aktuellen Benutzer.
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
8AWS-Tools für PowerShell Benutzerhandbuch
Installieren von AWSPowerShell
Obwohl PowerShell 3.0 und höhere Versionen Module in der Regel in Ihre PowerShell-Sitzung laden,
sobald Sie zum ersten Mal ein Cmdlet in dem Modul ausführen, ist das AWSPowerShell.NetCore-Modul für
diese Funktionalität zu groß. Sie müssen stattdessen explizit das AWSPowerShell.NetCore Core-Modul in
Ihre PowerShell-Sitzung laden, indem Sie den folgenden Befehl ausführen.
PS > Import-Module AWSPowerShell.NetCore
Um das AWSPowerShell.NetCore-Modul automatisch in eine PowerShell-Sitzung zu laden, fügen Sie
diesen Befehl zu Ihrem PowerShell-Profil hinzu. Weitere Informationen zum Bearbeiten Ihres PowerShell-
Profils finden Sie unter About Profiles in der PowerShell-Dokumentation.
Installieren von AWSPowerShell unter Windows
PowerShell
Sie können das AWS-Tools für Windows PowerShell auf drei Arten installieren:
• Laden Sie das Modul von AWSPowerShell.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.
• Verwenden des Tools für Windows PowerShell-Installationsprogramms. Dieses Verfahren zur Installation
vonAWSPowerShell ist veraltet, und es wird empfohlen, stattdessen Install-Module zu verwenden.
• Installation über die PowerShell Gallery mithilfe des Install-Module-Cmdlets, wie im folgenden
Verfahren beschrieben.
So installieren Sie AWSPowerShell mithilfe des Cmdlets Install-Module aus der PowerShell Gallery
Sie können den AWSPowerShell aus der PowerShell Gallery installieren, wenn Sie PowerShell 5.0
oder höher ausführen oder PowerShellGet auf PowerShell 3 oder höher installiert haben. Sie können
AWSPowerShell aus der Microsoft PowerShell Gallery installieren und aktualisieren, 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 das vorherige
Cmdlet import-module zu Ihrem PowerShell-Profil hinzu. Weitere Informationen zum Bearbeiten Ihres
PowerShell-Profils finden Sie unter About Profiles in der PowerShell-Dokumentation.
Note
Die Tools für Windows PowerShell werden in allen Windows Amazon Machine Images (AMIs)
standardmäßig installiert.
Aktivieren der Skriptausführung
Um die AWS Tools for PowerShell-Module laden zu können, 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).
Note
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
9AWS-Tools für PowerShell Benutzerhandbuch
Versioning
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 Accessories
(Zubehör) und dann Windows PowerShell. Klicken Sie mit der rechten Maustaste auf Windows
PowerShell und wählen Sie im Kontextmenü Run as administrator (Als Administrator ausführen).
2. Geben Sie in der Eingabeaufforderung Folgendes ein.
PS > Set-ExecutionPolicy RemoteSigned
Note
Auf einem 64-Bit-System müssen Sie diesen Schritt für die 32-Bit-Version von PowerShell
(Windows PowerShell (x86)) separat durchführen.
Wenn die Ausführungsrichtlinie nicht korrekt festgelegt ist, zeigt PowerShell beim Ausführen eines Skripts,
z. B. des Profils, den folgenden Fehler an.
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
+ .AWS-Tools für PowerShell Benutzerhandbuch
Versioning
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]
Sie können auch den Parameter -ListServiceVersionInfo zum Befehl Get-AWSPowerShellVersion
hinzufügen, um eine Liste der AWS-Services anzuzeigen, die von 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
AWS Tools for Windows PowerShell
Version 3.3.96.0
Copyright 2012-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
Amazon Web Services SDK for .NET
Core Runtime Version 3.3.14.0
Copyright 2009-2015 Amazon.com, Inc. or its affiliates. All Rights Reserved.
Release notes: https://aws.amazon.com/releasenotes/PowerShell
This software includes third party software subject to the following copyrights:
- Logging from log4net, Apache License
[http://logging.apache.org/log4net/license.html]
Service Noun Prefix Version
------- ----------- -------
AWS AppStream APS 2016-12-01
AWS Batch BAT 2016-08-10
AWS Budgets BGT 2016-10-20
AWS Certificate Manager ACM 2015-12-08
AWS Cloud Directory CDIR 2016-05-10
AWS Cloud HSM HSM 2014-05-30
AWS CloudFormation CFN 2010-05-15
AWS CloudTrail CT 2013-11-01
AWS CodeBuild CB 2016-10-06
AWS CodeCommit CC 2015-04-13
AWS CodeDeploy CD 2014-10-06
AWS CodePipeline CP 2015-07-09
AWS CodeStar CST 2017-04-19
AWS Config CFG 2014-11-12
AWS Cost and Usage Report CUR 2017-01-06
AWS Data Pipeline DP 2012-10-29
AWS Database Migration Service DMS 2016-01-01
AWS Device Farm DF 2015-06-23
AWS Direct Connect DC 2012-10-25
AWS Directory Service DS 2015-04-16
AWS Elastic Beanstalk EB 2010-12-01
...
Um festzustellen, mit welcher PowerShell-Version Sie arbeiten, zeigen Sie mit dem Befehl
$PSVersionTable den Inhalt der automatischen Variable $PSVersionTable an.
PS > $PSVersionTable
Name Value
---- -----
11AWS-Tools für PowerShell Benutzerhandbuch
Aktualisieren von AWS Tools for PowerShell
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 von AWS Tools for PowerShell unter
Windows
Es ist ratsam, die lokal ausgeführte Version der AWS Tools for PowerShell mit den in regelmäßigen
Abständen veröffentlichten neuen Versionen zu aktualisieren.
Aktualisieren der modularisierten 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.
Note
Über das Cmdlet Update-AWSToolsModule werden alle Module aus dem PSRepository
namens PSGalleryheruntergeladen (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 von Tools für PowerShell Core
Ermitteln Sie mit dem Cmdlet Get-AWSPowerShellVersion, welche Version Sie ausführen, und
vergleichen Sie diese Version mit der Version von Tools für Windows PowerShell, die auf der Website
PowerShell Gallery 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, wenn Sie auf eine Version mit diesem
Support aktualisiert haben.
Bevor Sie eine neuere Version von AWSPowerShell.NetCore installieren, 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 Import-Module AWSPowerShell.NetCore aus, um die
aktualisierten Cmdlets in Ihre PowerShell-Sitzung zu laden.
12AWS-Tools für PowerShell Benutzerhandbuch
Installation unter Linux oder macOS
Aktualisieren von Tools für Windows PowerShell
Ermitteln Sie mit dem Cmdlet Get-AWSPowerShellVersion, welche Version Sie ausführen, und
vergleichen Sie diese Version mit der Version von Tools für Windows PowerShell, die auf der Website
PowerShell Gallery 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, wenn Sie auf eine Version mit diesem
Support 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 des Paketinstallationsprogramms .msi vorgenommen haben:
1. Laden Sie die neueste Version des MSI-Pakets von AWS Tools für PowerShellherunter. Vergleichen
Sie die Paketversionsnummer im MSI-Dateinamen mit der Versionsnummer, die Sie beim Ausführen
des Cmdlets Get-AWSPowerShellVersion erhalten.
2. Wenn die Download-Version eine neuere als die von Ihnen installierte Version ist, schließen Sie alle
Tools für Windows PowerShell-Konsolen.
3. Installieren Sie die neuere Version von Tools für Windows PowerShell, indem Sie das
heruntergeladene MSI-Paket ausführen.
Führen Sie nach der Installation Import-Module AWSPowerShell aus, um die aktualisierten Cmdlets
in Ihre PowerShell-Sitzung zu laden. Oder führen Sie die benutzerdefinierte AWS Tools for PowerShell-
Konsole über das Start-Menü aus.
Installation der AWS Tools for PowerShell unter
Linux oder macOS
In diesem Thema erhalten Sie Anweisungen zur Installation der AWS Tools for PowerShell unter Linux oder
macOS.
Übersicht über die Einrichtung
Für eine Installation der AWS Tools for PowerShell auf einem Linux- oder macOS-Computer können Sie
zwischen zwei Paketoptionen wählen:
• AWS.Tools (p. 14) – die modularisierte Version von AWS Tools for PowerShell. Jeder AWS-Service
wird von einem eigenen, kleinen Modul unterstützt, mit gemeinsam genutzten AWS.Tools.Common-
Supportmodulen.
• AWSPowerShell.NetCore (p. 16) – die AWS Tools for PowerShell-Version mit einem großen
Einzelmodul. Alle AWS-Services werden von diesem einzigen großen Modul unterstützt.
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 PowerShell nach der Installation von PowerShell Core, indem Sie pwsh in Ihrer Systemshell
ausführen.
3. Installieren Sie entweder AWS.Tools oder AWSPowerShell.NetCore.
13AWS-Tools für PowerShell Benutzerhandbuch
Voraussetzungen
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-AWSDefaultConfiguration aus, um Ihre AWS-Anmeldeinformationen
bereitzustellen.
Voraussetzungen
Stellen Sie sicher, dass Sie die unter Voraussetzungen für die Einrichtung von AWS Tools for
PowerShell (p. 4) aufgeführten Anforderungen erfüllen.
Um die AWS-Tools für PowerShell Core ausführen zu können, muss auf Ihrem Computer PowerShell Core
6.0 oder höher ausgeführt werden.
• Eine Liste der unterstützten Linux-Versionen und Informationen zur Installation von PowerShell Core
6.0 oder höher auf einem Linux-basierten Computer finden Sie unter Installieren von PowerShell Core
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.
• Eine Liste der unterstützten macOS-Versionen und Informationen zur Installation von PowerShell Core
6.0 unter macOS 10.12 oder höher finden Sie unter Installieren von PowerShell Core 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 PowerShell Core 6.0 oder höher ausgeführt wird. Informationen zum Installieren 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. Das AWS.Tools.Installer-Modul
vereinfacht die Installation und Aktualisierung weiterer AWS Tools-Module. AWS.Tools.Installer
erfordert und lädt automatisch eine aktualisierte Version von PowerShellGet herunter und installiert
diese. Das AWS.Tools.Installer-Modul hält zudem Ihre Modulversionen automatisch synchron.
Wenn Sie eine neuere Version eines Moduls installieren oder aktualisieren, aktualisieren die Cmdlets im
AWS.Tools.Installer automatisch alle anderen AWS.Tools-Module auf dieselbe Version.
• 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 der einzelnen Dienstmodule aus der PowerShell Gallery mithilfe des Install-Module-
Cmdlets, wie im folgenden Verfahren beschrieben.
So installieren Sie AWS.Tools unter Linux oder macOS mit dem Cmdlet Install-Module
1. Starten Sie eine PowerShell Core-Sitzung, indem Sie den folgenden Befehl ausführen.
$ pwsh
Note
Wir empfehlen, PowerShell nicht als Administrator mit erhöhten Berechtigungen auszuführen,
es sei denn, dies ist für die jeweilige Aufgabe erforderlich. Grund ist das potenzielle
14AWS-Tools für PowerShell Benutzerhandbuch
Installieren von AWS.Tools
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 ein, damit PowerShell das Modul installieren kann.
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 wird beispielsweise das IAM-Modul 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
Note
Ü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.
Standardmäßig werden dadurch Module im $home\Documents\PowerShell\Modules-Ordner
installiert. Um das AWS.Tools-Modul für alle Benutzer eines Computers zu installieren, müssen Sie
15Sie können auch lesen
