• Das AWS Systems Manager CloudWatch Dashboard wird nach dem 30. April 2026 nicht mehr verfügbar sein. Kunden können weiterhin die CloudWatch Amazon-Konsole verwenden, um ihre CloudWatch Amazon-Dashboards anzusehen, zu erstellen und zu verwalten, so wie sie es heute tun. Weitere Informationen finden Sie in der [Amazon CloudWatch Dashboard-Dokumentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
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.
# Installieren oder Aktualisieren von Distributor-Paketen
Sie können Pakete auf Ihren AWS Systems Manager verwalteten Knoten bereitstellenDistributor, indem Sie ein Tool in verwenden AWS Systems Manager. Um die Pakete bereitzustellen, verwenden Sie entweder AWS-Managementkonsole oder AWS Command Line Interface (AWS CLI). Sie können pro Befehl eine Version eines Pakets bereitstellen. Sie können neue Pakete installieren oder vorhandene Installationen direkt aktualisieren. Sie können wählen, ob Sie eine bestimmte Version oder stets die aktuelle Version eines Pakets bereitstellen möchten. Wir empfehlenState Manager, zur Installation von Paketen ein Tool in AWS Systems Manager zu verwenden. Mit der Verwendung von State Manager stellen Sie sicher, dass Ihre verwalteten Knoten immer die aktuellste Version Ihres Pakets ausführen.
**Wichtig**
Mit Distributor installierte Pakete sollten nur mithilfe von Distributor deinstalliert werden. Andernfalls kann Systems Manager die Anwendung weiterhin als `INSTALLED` erkennen und es können andere unbeabsichtigte Ergebnisse auftreten.
| Präferenz | AWS Systems Manager Aktion | Weitere Informationen |
| --- | --- | --- |
| Installieren oder aktualisieren Sie ein Paket sofort. | Run Command | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) |
| Installieren Sie ein Paket nach einem Zeitplan, sodass die Installation immer die Standardversion enthält. | State Manager | [See the AWS documentation website for more details](http://docs.aws.amazon.com/de_de/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) |
| Installieren Sie ein Paket automatisch auf neuen verwalteten Knoten, die ein bestimmtes Tag oder einen bestimmten Satz von Tags besitzen. Zum Beispiel die Installation des CloudWatch Amazon-Agenten auf neuen Instances. | State Manager | Eine Möglichkeit besteht in der Anwendung von Tags auf neue verwaltete Knoten und die anschließende Auflistung der Tags als Ziele in der State Manager-Zuordnung. State Manager installiert automatisch das Paket in einer Zuordnung auf verwalteten Knoten, deren Tags übereinstimmen. Siehe [Verstehen von Zielen und Ratensteuerungen in State Manager Zuordnungen](systems-manager-state-manager-targets-and-rate-controls.md). |
**Topics**
+ [Einmaliges Installieren oder Aktualisieren eines Pakets mithilfe der Konsole](#distributor-deploy-pkg-console)
+ [Planen einer Paketinstallation oder -aktualisierung mithilfe der Konsole](#distributor-deploy-sm-pkg-console)
+ [Einmaliges Installieren eines Pakets mit dem AWS CLI](#distributor-deploy-pkg-cli)
+ [Einmaliges Aktualisieren eines Pakets mit dem AWS CLI](#distributor-update-pkg-cli)
+ [Planung einer Paketinstallation mit dem AWS CLI](#distributor-smdeploy-pkg-cli)
+ [Planung eines Paket-Updates mit dem AWS CLI](#distributor-smupdate-pkg-cli)
## Einmaliges Installieren oder Aktualisieren eines Pakets mithilfe der Konsole
Sie können die AWS Systems Manager Konsole verwenden, um ein Paket einmal zu installieren oder zu aktualisieren. Wenn Sie eine einmalige Installation konfigurieren[AWS Systems Manager Run Command](run-command.md), Distributor verwendet ein Tool in AWS Systems Manager, um die Installation durchzuführen.
**So installieren oder aktualisieren Sie ein Paket einmalig mithilfe der Konsole**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählen Sie auf der Distributor-Startseite das Paket aus, das Sie installieren möchten.
1. Wählen Sie **Install one time (Einmal installieren)** aus.
Dieser Befehl öffnet Run Command mit dem Befehlsdokument `AWS-ConfigureAWSPackage`. Ihr Distributor-Paket ist vorausgewählt.
1. Wählen Sie unter **Document version (Dokumentversion)** die Version des `AWS-ConfigureAWSPackage`-Dokuments aus, das Sie ausführen möchten.
1. Wählen Sie für **Action (Aktion)** die Option **Install (Installieren)**.
1. Wählen Sie unter **Installation type (Installationstyp)** eine der folgenden Optionen aus:
+ **Uninstall and reinstall (Deinstallieren und neu installieren)**: Das Paket wird vollständig deinstalliert und dann neu installiert. Die Anwendung ist bis zum Abschluss der Neuinstallation nicht verfügbar.
+ **In-place Update**: Nur neue oder geänderte Dateien werden der bestehenden Installation gemäß den Anweisungen hinzugefügt, die Sie in einem `update` Skript angeben. Die Anwendung ist während des Aktualisierungsprozesses weiterhin verfügbar. Diese Option wird für AWS veröffentlichte Pakete außer dem `AWSEC2Launch-Agent` Paket nicht unterstützt.
1. Überprüfen Sie, ob unter **Name** der Name des ausgewählten Pakets angegeben ist.
1. (Optional) Geben Sie unter **Version** den Versionsnamen des Pakets ein. Wenn Sie dieses Feld leer lassen, installiert Run Command die von Ihnen in Distributor ausgewählte Standardversion.
1. Wählen Sie im Abschnitt **Targets** (Ziele) die verwalteten Knoten, auf denen Sie diese Operation ausführen möchten, indem Sie Tags angeben, Instances oder Geräte manuell auswählen oder eine Ressourcengruppe angeben.
**Anmerkung**
Wenn kein verwalteter Knoten in der Liste angezeigt wird, lesen Sie [Problembehandlung bei der Verfügbarkeit verwalteter Knoten](fleet-manager-troubleshooting-managed-nodes.md).
1. Für **Weitere Parameter**:
+ Geben Sie im Feld **Kommentar** Informationen zu diesem Befehl ein.
+ Geben Sie für **Timeout (Sekunden)** in Sekunden an, wie lange gewartet werden soll, bis für die gesamte Befehlsausführung ein Fehler auftritt.
1. Für **Rate control** (Temposteuerung):
+ Geben Sie unter **Concurrency** (Nebenläufigkeit) entweder eine Zahl oder einen Prozentsatz von Zielen an, auf denen der Befehl gleichzeitig ausgeführt werden soll.
**Anmerkung**
Wenn Sie Ziele ausgewählt haben, indem Sie Tags oder Ressourcengruppen angeben, und Sie noch nicht sicher sind, wie viele verwaltete Knoten anvisiert sind, sollten Sie die Anzahl von Zielen, die das Dokument gleichzeitig ausführen können, beschränken, indem Sie einen Prozentsatz angeben.
+ Geben Sie unter **Error threshold** (Fehlerschwellenwert) an, wann die Ausführung des Befehls auf anderen Zielen beendet werden soll, nachdem dafür entweder auf einer bestimmten Anzahl oder einem Prozentsatz von verwalteten Knoten ein Fehler aufgetreten ist. Falls Sie beispielsweise drei Fehler angeben, sendet Systems Manager keinen Befehl mehr, wenn der vierte Fehler empfangen wird. Von verwalteten Knoten, auf denen der Befehl noch verarbeitet wird, werden unter Umständen ebenfalls Fehler gesendet.
1. (Optional) Wenn Sie im Abschnitt **Ausgabeoptionen** die Befehlsausgabe in einer Datei speichern möchten, aktivieren Sie das Kontrollkästchen **Schreiben in einen S3-Bucket aktivieren**. Geben Sie die Namen für den Bucket und das Präfix (Ordner) in die Textfelder ein.
**Anmerkung**
Die S3-Berechtigungen zum Schreiben von Daten in einen S3-Bucket sind diejenigen des Instance-Profils (für EC2-Instances) oder der IAM-Servicerolle (hybrid-aktivierte Maschinen), die der Instance zugewiesen sind, und nicht diejenigen des IAM-Benutzers, der diese Aufgabe ausführt. Weitere Informationen finden Sie unter [Instance-Berechtigungen für Systems Manager konfigurieren](setup-instance-permissions.md) oder [Eine IAM-Servicerolle für eine Hybrid-Umgebung erstellen](hybrid-multicloud-service-role.md). Wenn sich der angegebene S3-Bucket in einem anderen AWS-Konto befindet, stellen Sie außerdem sicher, dass das Instance-Profil oder die IAM-Servicerolle, die dem verwalteten Knoten zugeordnet ist, über die erforderlichen Berechtigungen zum Schreiben in diesen Bucket verfügt.
1. Aktivieren Sie das Kontrollkästchen **SNS-Benachrichtigungen aktivieren** im Abschnitt **SNS-Benachrichtigungen**, wenn Sie über den Status der Befehlsausführung benachrichtigt werden möchten,
Weitere Informationen zum Konfigurieren von Amazon SNS-Benachrichtigungen für Run Command finden Sie unter [Überwachung von Systems Manager-Statusänderungen mit Amazon SNS-Benachrichtigungen](monitoring-sns-notifications.md).
1. Wenn Sie bereit sind, das Paket zu installieren, klicken Sie auf **Run (Ausführen)**.
1. Im Bereich **Command status (Befehlsstatus)** wird der Fortschritt der Installation angezeigt. Wenn der Befehl noch ausgeführt wird, klicken Sie oben links in der Konsole auf das Aktualisierungssymbol, bis in der Spalte **Overall status (Gesamtstatus)** oder **Detailed status (Detailstatus)** der Status **Success (Erfolgreich)** oder **Failed (Fehlgeschlagen)** angezeigt wird.
1. Klicken Sie im Bereich **Targets and outputs** (Ziele und Ausgaben) auf die Schaltfläche neben dem Namen eines verwalteten Knotens und wählen Sie dann **View output** (Ausgabe anzeigen).
Der Befehlsausgabeseite zeigt die Ergebnisse der Befehlsausführung an.
1. (Optional) Wenn Sie die Befehlsausgabe in einen Amazon S3-Bucket schreiben möchten, wählen Sie **Amazon S3**, um die Ausgabeprotokolldaten anzuzeigen.
## Planen einer Paketinstallation oder -aktualisierung mithilfe der Konsole
Sie können die AWS Systems Manager Konsole verwenden, um die Installation oder Aktualisierung eines Pakets zu planen. Wenn Sie die Paketinstallation oder -aktualisierung planen, verwendet Distributor [AWS Systems Manager State Manager](systems-manager-state.md) zum Installieren oder Aktualisieren.
**So planen Sie eine Paketinstallation mithilfe der Konsole**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählen Sie auf der Distributor-Startseite das Paket aus, das Sie installieren oder aktualisieren möchten.
1. Wählen Sie unter **Package (Paket)** die Option **Install on a schedule (Nach Plan installieren)** aus.
Dieser Befehl öffnet State Manager zu einer neuen Zuordnung, die für Sie erstellt wurde.
1. Geben Sie unter **Name** einen Namen ein (z. B. **Deploy-test-agent-package**). Dies ist zwar optional, wird aber empfohlen. Der Name darf keine Leerzeichen enthalten.
1. In der Liste **Document (Dokument)** ist der Dokumentname `AWS-ConfigureAWSPackage` bereits ausgewählt.
1. Überprüfen Sie unter **Action (Aktion)**, ob **Install (Installieren)** ausgewählt ist.
1. Wählen Sie unter **Installation type (Installationstyp)** eine der folgenden Optionen aus:
+ **Uninstall and reinstall (Deinstallieren und neu installieren)**: Das Paket wird vollständig deinstalliert und dann neu installiert. Die Anwendung ist bis zum Abschluss der Neuinstallation nicht verfügbar.
+ **In-place Update**: Nur neue oder geänderte Dateien werden der bestehenden Installation gemäß den Anweisungen hinzugefügt, die Sie in einem `update` Skript angeben. Die Anwendung ist während des Aktualisierungsprozesses weiterhin verfügbar.
1. Überprüfen Sie unter **Name**, ob der Name Ihres Pakets angegeben ist.
1. Geben Sie unter **Version** die Versionskennung ein, wenn Sie eine andere Paketversion als die zuletzt veröffentlichte Version installieren möchten.
1. Wählen Sie unter **Targets (Ziele)** die Optionen **Selecting all managed instances in this account (Alle verwalteten Instances in diesem Konto auswählen)**, **Specifying tags (Tags angeben)** oder **Manually Selecting Instance (Instance manuell auswählen)** aus. Wenn Sie die Zielressourcen mithilfe von Tags ausgewählt haben, geben Sie einen Tag-Schlüssel und einen Tag-Wert in die entsprechenden Felder ein.
**Anmerkung**
Sie können verwaltete AWS IoT Greengrass Kerngeräte **auswählen, indem Sie entweder Alle verwalteten Instanzen in diesem Konto** auswählen oder **Instanz manuell auswählen wählen**.
1. Wählen Sie unter **Specify schedule (Plan angeben)** die Option **On Schedule (Nach Plan)** aus, um die Zuordnung nach einem regelmäßigen Zeitplan auszuführen, oder **No Schedule (Kein Plan)**, um die Zuordnung einmalig auszuführen. Weitere Informationen zu diesen Optionen finden Sie unter [Arbeiten mit Zuordnungen in Systems Manager](state-manager-associations.md). Verwenden Sie die Steuerelemente, um einen `cron`- oder Rate-Zeitplan für die Zuordnung zu erstellen.
1. Wählen Sie **Zuordnung erstellen**.
1. Klicken Sie auf der Seite **Association (Zuordnung)** auf die Schaltfläche neben der von Ihnen erstellten Zuordnung und wählen Sie dann **Apply association now (Zuordnung jetzt anwenden)** aus.
State Manager erstellt die Zuordnung und führt sie sofort auf den angegebenen Zielen aus. Weitere Informationen zu den Ergebnissen der Ausführung von Zuordnungen finden Sie unter [Arbeiten mit Zuordnungen in Systems Manager](state-manager-associations.md) in diesem Handbuch.
Weitere Informationen zur Verwendung der Optionen unter **Advanced Options (Erweiterte Optionen)**, **Rate control (Ratensteuerung)** und **Output options (Ausgabeoptionen)** finden Sie unter [Arbeiten mit Zuordnungen in Systems Manager](state-manager-associations.md).
## Einmaliges Installieren eines Pakets mit dem AWS CLI
Sie können **send-command** den ausführen AWS CLI , um ein Distributor Paket einmal zu installieren. Wenn das Paket bereits installiert ist, wird die Anwendung offline geschaltet, während das Paket deinstalliert und stattdessen die neue Version installiert wird.
**Um ein Paket einmal zu installieren, verwenden Sie AWS CLI**
+ Führen Sie in der AWS CLI den folgenden aus.
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "{{instance-IDs}}" \
--parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["{{package-name (in same account) or package-ARN (shared from different account)}}"]}'
```
**Anmerkung**
Das Standardverhalten für `installationType` ist `Uninstall and reinstall`. Sie können `"installationType":["Uninstall and reinstall"]` im Befehl weglassen, wenn Sie ein komplettes Paket installieren.
Im Folgenden wird ein -Beispiel gezeigt.
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "i-00000000000000" \
--parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["ExamplePackage"]}'
```
Informationen zu anderen Optionen, die Sie mit dem **send-command** Befehl verwenden können, finden Sie [https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html)im AWS Systems Manager Abschnitt der *AWS CLI Befehlsreferenz*.
## Einmaliges Aktualisieren eines Pakets mit dem AWS CLI
Sie können das Programm ausführen **send-command** AWS CLI , um ein Distributor Paket zu aktualisieren, ohne die zugehörige Anwendung offline zu schalten. Nur neue oder aktualisierte Dateien im Paket werden ersetzt.
**Um ein Paket einmal zu aktualisieren, verwenden Sie AWS CLI**
+ Führen Sie in der AWS CLI den folgenden aus.
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "{{instance-IDs}}" \
--parameters '{"action":["Install"],"installationType":["In-place update"],"name":["{{package-name (in same account) or package-ARN (shared from different account)}}"]}'
```
**Anmerkung**
Wenn Sie neue oder geänderte Dateien hinzufügen, müssen Sie `"installationType":["In-place update"]` in den Befehl einschließen.
Im Folgenden wird ein -Beispiel gezeigt.
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "i-02573cafcfEXAMPLE" \
--parameters '{"action":["Install"],"installationType":["In-place update"],"name":["ExamplePackage"]}'
```
Informationen zu anderen Optionen, die Sie mit dem **send-command** Befehl verwenden können, finden Sie [https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html)im AWS Systems Manager Abschnitt der *AWS CLI Befehlsreferenz*.
## Planung einer Paketinstallation mit dem AWS CLI
Sie können **create-association** den ausführen AWS CLI , um ein Distributor Paket nach einem Zeitplan zu installieren. Der Wert für `--name`, d. h. der Name des Dokuments, ist stets `AWS-ConfigureAWSPackage`. Der folgende Befehl verwendet den Schlüssel `InstanceIds` zur Angabe von verwalteten Knoten als Ziel. Wenn das Paket bereits installiert ist, wird die Anwendung offline geschaltet, während das Paket deinstalliert und stattdessen die neue Version installiert wird.
```
aws ssm create-association \
--name "AWS-ConfigureAWSPackage" \
--parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["{{package-name (in same account) or package-ARN (shared from different account)}}"]}' \
--targets [{\"Key\":\"InstanceIds\",\"Values\":[\"{{instance-ID1}}\",\"{{instance-ID2}}\"]}]
```
**Anmerkung**
Das Standardverhalten für `installationType` ist `Uninstall and reinstall`. Sie können `"installationType":["Uninstall and reinstall"]` im Befehl weglassen, wenn Sie ein komplettes Paket installieren.
Im Folgenden wird ein -Beispiel gezeigt.
```
aws ssm create-association \
--name "AWS-ConfigureAWSPackage" \
--parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["Test-ConfigureAWSPackage"]}' \
--targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-02573cafcfEXAMPLE\",\"i-0471e04240EXAMPLE\"]}]
```
Informationen zu anderen Optionen, die Sie mit dem **create-association** Befehl verwenden können, finden Sie [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html)im AWS Systems Manager Abschnitt der *AWS CLI Befehlsreferenz*.
## Planung eines Paket-Updates mit dem AWS CLI
Sie können den ausführen **create-association** AWS CLI , um ein Distributor Paket nach einem Zeitplan zu aktualisieren, ohne die zugehörige Anwendung offline zu nehmen. Nur neue oder aktualisierte Dateien im Paket werden ersetzt. Der Wert für `--name`, d. h. der Name des Dokuments, ist stets `AWS-ConfigureAWSPackage`. Der folgende Befehl verwendet den Schlüssel `InstanceIds` zur Angabe von Ziel-Instances.
```
aws ssm create-association \
--name "AWS-ConfigureAWSPackage" \
--parameters '{"action":["Install"],"installationType":["In-place update"],"name":["{{package-name (in same account) or package-ARN (shared from different account)}}"]}' \
--targets [{\"Key\":\"InstanceIds\",\"Values\":[\"{{instance-ID1}}\",\"{{instance-ID2}}\"]}]
```
**Anmerkung**
Wenn Sie neue oder geänderte Dateien hinzufügen, müssen Sie `"installationType":["In-place update"]` in den Befehl einschließen.
Im Folgenden wird ein -Beispiel gezeigt.
```
aws ssm create-association \
--name "AWS-ConfigureAWSPackage" \
--parameters '{"action":["Install"],"installationType":["In-place update"],"name":["Test-ConfigureAWSPackage"]}' \
--targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-02573cafcfEXAMPLE\",\"i-0471e04240EXAMPLE\"]}]
```
Informationen zu anderen Optionen, die Sie mit dem **create-association** Befehl verwenden können, finden Sie [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html)im AWS Systems Manager Abschnitt der *AWS CLI Befehlsreferenz*.