Aktivieren der Skriptausführung Versionsverwaltung Aktualisierung AWS -Tools für PowerShell

Installieren Sie AWSPower Shell. NetCore unter Windows

Allgemeine Informationen zur Installation von AWS -Tools für PowerShell unter Windows, einschließlich Voraussetzungen und anderer Optionen, finden Sie im übergeordneten Thema.

Informationen zu den Tools dafür PowerShell , die auf vorinstalliert sind AWS CloudShell, finden Sie unterInstalliert auf CloudShell.

Anmerkung

AWSPowerSchale. NetCore ist nicht die empfohlene Methode für die Installation von AWS -Tools für PowerShell. Informationen zur empfohlenen Methode finden Sie Installation AWS.Tools (empfohlen) stattdessen unter.

Sie können die AWSPower Shell installieren. 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 AWSPower Shell installieren. NetCore auf eine von zwei Arten

Das Modul wird von AWSPowerShell heruntergeladen. NetCore.zip und Extrahieren 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.

Um Shell zu installieren AWSPower. NetCore aus der PowerShell Galerie mit dem Cmdlet Install-Module

Um die Shell zu installieren. AWSPower 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 für PowerShell für alle Benutzer auf dem Computer installiert. Wenn Sie PowerShell als Standardbenutzer ohne Administratorrechte arbeiten, wird derselbe Befehl nur AWS -Tools für 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

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


PS > Import-Module AWSPowerShell.NetCore

Um die AWSPower Shell zu laden. 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.

Aktivieren der Skriptausführung

Um die AWS -Tools für 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

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.
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 den PSModulePfad automatisch, sodass er 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 für PowerShell regelmäßig neue Versionen von, um neue AWS Dienste und Funktionen zu unterstützen. Führen Sie das AWSPower ShellVersion Cmdlet Get- aus, um die Version der Tools zu ermitteln, die Sie installiert haben.

Zum Beispiel:


PS > Get-AWSPowerShellVersion

AWS Tools for PowerShell
Version 5.0.3
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

Amazon Web Services SDK for .NET
Core Runtime Version 4.0.0.13
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/main/changelogs/CHANGELOG.ALL.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.

Zum Beispiel:


PS > Get-AWSPowerShellVersion -ListServiceVersionInfo
...

Service                            Noun Prefix Module Name                       SDK
                                                                                 Assembly
                                                                                 Version
-------                            ----------- -----------                       -----------
AWS IAM Access Analyzer            IAMAA       AWS.Tools.AccessAnalyzer          3.7.400.33
AWS Account                        ACCT        AWS.Tools.Account                 3.7.400.33
AWS Certificate Manager Private... PCA         AWS.Tools.ACMPCA                  3.7.400.34
AWS Amplify                        AMP         AWS.Tools.Amplify                 3.7.401.28
Amplify Backend                    AMPB        AWS.Tools.AmplifyBackend          3.7.400.33
...

Um festzustellen PowerShell , welche Version Sie ausführen, geben Sie ein, $PSVersionTable um den Inhalt der automatischen Variablen $ PSVersion Table 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 der AWS -Tools für PowerShell unter Windows

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

Aktualisieren Sie die Tools für PowerShell Core

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.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Installation AWS.Tools (empfohlen)

Installieren Sie AWSPower Shell (Legacy)