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.

# Systemmanager-Agent
<a name="systems-manager-agent-component"></a>

Die AWS Systems Manager Agent-Komponente (`aws.greengrass.SystemsManagerAgent`) installiert den Systems Manager Agent, sodass Sie Kerngeräte mit Systems Manager verwalten können. Systems Manager ist ein AWS Service, mit dem Sie Ihre Infrastruktur anzeigen und steuern können AWS, einschließlich EC2 Amazon-Instances, lokalen Servern und virtuellen Maschinen (VMs) sowie Edge-Geräten. Systems Manager ermöglicht es Ihnen, Betriebsdaten einzusehen, Betriebsaufgaben zu automatisieren und Sicherheit und Compliance aufrechtzuerhalten. Weitere Informationen finden Sie unter [Was ist AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) und [Über Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) im *AWS Systems Manager Benutzerhandbuch*.

<a name="about-systems-manager-capabilities"></a>Die Tools und Funktionen von Systems Manager werden *Funktionen* genannt. Greengrass-Kerngeräte unterstützen alle Systems Manager Manager-Funktionen. Weitere Informationen zu diesen Funktionen und zur Verwendung von Systems Manager zur Verwaltung von Kerngeräten finden Sie unter [Systems Manager Manager-Funktionen](https://docs.aws.amazon.com/systems-manager/latest/userguide/features.html) im *AWS Systems Manager Benutzerhandbuch*.

**Topics**
+ [Versionen](#systems-manager-agent-component-versions)
+ [Typ](#systems-manager-agent-component-type)
+ [Betriebssystem](#systems-manager-agent-component-os-support)
+ [Voraussetzungen](#systems-manager-agent-component-requirements)
+ [Abhängigkeiten](#systems-manager-agent-component-dependencies)
+ [Konfiguration](#systems-manager-agent-component-configuration)
+ [Lokale Protokolldatei](#systems-manager-agent-component-log-file)
+ [Weitere Informationen finden Sie auch unter](#systems-manager-agent-component-see-also)
+ [Änderungsprotokoll](#systems-manager-agent-component-changelog)

## Versionen
<a name="systems-manager-agent-component-versions"></a>

Diese Komponente hat die folgenden Versionen:
+ 1.3.x
+ 1.2.x
+ 1.1.x
+ 1.0.x

## Typ
<a name="systems-manager-agent-component-type"></a>

<a name="public-component-type-generic"></a>Diese <a name="public-component-type-generic-phrase"></a>Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.

<a name="public-component-type-more-information"></a>Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).

## Betriebssystem
<a name="systems-manager-agent-component-os-support"></a>

Diese Komponente kann nur auf Linux-Core-Geräten installiert werden.

## Voraussetzungen
<a name="systems-manager-agent-component-requirements"></a>

Für diese Komponente gelten die folgenden Anforderungen:
+ Ein Greengrass-Core-Gerät, das auf einer 64-Bit-Linux-Plattform läuft: Armv8 (AArch64) oder x86\$164.
+ Sie müssen über eine AWS Identity and Access Management (IAM-) Servicerolle verfügen, die Systems Manager übernehmen kann. Diese Rolle muss die von [Amazon SSMManaged InstanceCore](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) verwaltete Richtlinie oder eine benutzerdefinierte Richtlinie enthalten, die entsprechende Berechtigungen definiert. Weitere Informationen finden Sie unter [Erstellen einer IAM-Servicerolle für Edge-Geräte](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices.html#systems-manager-setting-up-edge-devices-service-role) im *AWS Systems Manager Benutzerhandbuch*.

  Wenn Sie diese Komponente bereitstellen, müssen Sie den Namen dieser Rolle für den `SSMRegistrationRole` Konfigurationsparameter angeben.
+ Die [Greengrass-Geräterolle](device-service-role.md) muss die `ssm:RegisterManagedInstance` Aktionen `ssm:AddTagsToResource` und zulassen. Die Geräterolle muss auch die `iam:PassRole` Aktion für die IAM-Servicerolle zulassen, die die vorherige Anforderung erfüllt. Die folgende Beispiel-IAM-Richtlinie gewährt diese Berechtigungen.

  ```
  {
    "Version": "2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "iam:PassRole"
        ],
        "Effect": "Allow",
        "Resource": [
          "arn:aws:iam::account-id:role/SSMServiceRole"
        ]
      },
      {
        "Action": [
          "ssm:AddTagsToResource",
          "ssm:RegisterManagedInstance"
        ],
        "Effect": "Allow",
        "Resource": "*"
      }
    ]
  }
  ```

### Endpunkte und Ports
<a name="systems-manager-agent-component-endpoints"></a>

Diese Komponente muss in der Lage sein, ausgehende Anfragen an die folgenden Endpunkte und Ports auszuführen, zusätzlich zu den Endpunkten und Ports, die für den Basisbetrieb erforderlich sind. Weitere Informationen finden Sie unter [Geräteverkehr über einen Proxy oder eine Firewall zulassen](allow-device-traffic.md).


| Endpoint | Port | Erforderlich | Description | 
| --- | --- | --- | --- | 
|  `ec2messages.region.amazonaws.com`  | 443 | Ja |  Kommunizieren Sie mit dem Systems Manager Manager-Dienst in der AWS Cloud.  | 
|  `ssm.region.amazonaws.com`  | 443 | Ja |  Registrieren Sie das Kerngerät als von Systems Manager verwalteten Knoten.  | 
|  `ssmmessages.region.amazonaws.com`  | 443 | Ja |  Kommunizieren Sie mit Session Manager, einer Funktion von Systems Manager, in der AWS Cloud.  | 

*Weitere Informationen finden Sie unter [Referenz: ec2messages, ssmmessages und andere API-Aufrufe im Benutzerhandbuch](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-messageAPIs.html).AWS Systems Manager *

## Abhängigkeiten
<a name="systems-manager-agent-component-dependencies"></a>

Wenn Sie eine Komponente bereitstellen, stellt sie AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereit. Das bedeutet, dass Sie die Anforderungen für die Komponente und all ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitstellen zu können. In diesem Abschnitt werden die Abhängigkeiten für die [veröffentlichten Versionen](#systems-manager-agent-component-changelog) dieser Komponente sowie die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können die Abhängigkeiten für jede Version der Komponente auch in der [AWS IoT Greengrass Konsole](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.0.0 bis 1.3.0 dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit | 
| --- | --- | --- | 
| [Token-Austauschdienst](token-exchange-service-component.md) |  >=2.0.0 <3.0.0 | Hart | 

[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Konfiguration
<a name="systems-manager-agent-component-configuration"></a>

Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.

`SSMRegistrationRole`  
Die IAM-Servicerolle, die Systems Manager übernehmen kann und die die von [Amazon SSMManaged InstanceCore](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) verwaltete Richtlinie oder eine benutzerdefinierte Richtlinie umfasst, die entsprechende Berechtigungen definiert. Weitere Informationen finden Sie im *AWS Systems Manager Benutzerhandbuch* unter [Erstellen einer IAM-Servicerolle für Edge-Geräte](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices-service-role.html).

`SSMOverrideExistingRegistration`  
(Optional) Wenn auf dem Kerngerät bereits der Systems Manager Agent ausgeführt wird, der mit einer Hybrid-Aktivierung registriert ist, können Sie die bestehende Systems Manager Agent-Registrierung des Geräts überschreiben. Stellen Sie diese Option auf ein`true`, um das Kerngerät mithilfe des Systems Manager Agents, den diese Komponente bereitstellt, als verwalteten Knoten zu registrieren.  
Diese Option gilt nur für Geräte, die mit einer Hybridaktivierung registriert wurden. Wenn das Kerngerät auf einer EC2 Amazon-Instance läuft, auf der der Systems Manager Agent installiert und eine Instance-Profilrolle konfiguriert ist, beginnt die bestehende verwaltete Knoten-ID der EC2 Amazon-Instance mit`i-`. Wenn Sie die Systems Manager Agent-Komponente installieren, registriert der Systems Manager Agent einen neuen verwalteten Knoten, dessen ID mit `mi-` statt mit beginnt`i-`. Anschließend können Sie den verwalteten Knoten, dessen ID mit beginnt, verwenden`mi-`, um das Kerngerät mit Systems Manager zu verwalten.
Standard: `false`

`SSMResourceTags`  
(Optional) Die Tags, die dem verwalteten Systems Manager Manager-Knoten hinzugefügt werden sollen, den diese Komponente für das Kerngerät erstellt. Sie können diese Tags verwenden, um Gruppen von Kerngeräten mit Systems Manager zu verwalten. Sie können beispielsweise einen Befehl auf allen Geräten ausführen, die über ein von Ihnen angegebenes Tag verfügen.  
Geben Sie eine Liste an, in der jedes Tag ein Objekt mit einem `Key` und a ist`Value`. Der folgende Wert für `SSMResourceTags` weist diese Komponente beispielsweise an, das **Owner** Tag auf dem verwalteten Knoten des Kerngeräts **richard-roe** auf zu setzen.  

```
[
  {
    "Key": "Owner",
    "Value": "richard-roe"
  }
]
```
Diese Komponente ignoriert diese Tags, wenn der verwaltete Knoten bereits existiert und `SSMOverrideExistingRegistration` existiert. `false`

**Example Beispiel: Aktualisierung der Konfigurationszusammenführung**  
In der folgenden Beispielkonfiguration wird die Verwendung einer Servicerolle mit `SSMServiceRole` dem Namen so angegeben, dass sich das Kerngerät registrieren und mit Systems Manager kommunizieren kann.  

```
{
  "SSMRegistrationRole": "SSMServiceRole",
  "SSMOverrideExistingRegistration": false,
  "SSMResourceTags": [
    {
      "Key": "Owner",
      "Value": "richard-roe"
    },
    {
      "Key": "Team",
      "Value": "solar"
    }
  ]
}
```

## Lokale Protokolldatei
<a name="systems-manager-agent-component-log-file"></a>

Die Systems Manager Agent-Software schreibt Protokolle in einen Ordner außerhalb des Greengrass-Stammordners. Weitere Informationen finden Sie im *AWS Systems Manager Benutzerhandbuch* unter [Anzeigen von Systems Manager Agent-Protokollen](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-agent-logs.html).

Die Systems Manager Agent-Komponente verwendet Shell-Skripts, um den Systems Manager Agent zu installieren, zu starten und zu beenden. Die Ausgabe dieser Skripts finden Sie in der folgenden Protokolldatei.

```
/greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log
```

**Um die Protokolle dieser Komponente einzusehen**
+ Führen Sie den folgenden Befehl auf dem Kerngerät aus, um die Protokolldatei dieser Komponente in Echtzeit anzuzeigen. `/greengrass/v2`Ersetzen Sie es durch den Pfad zum AWS IoT Greengrass Stammordner.

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log
  ```

## Weitere Informationen finden Sie auch unter
<a name="systems-manager-agent-component-see-also"></a>
+ [Verwalten Sie Greengrass-Kerngeräte mit AWS Systems Manager](manage-with-systems-manager.md)
+ [Was ist AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) im *AWS Systems Manager Benutzerhandbuch*
+ [Informationen zum Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) im *AWS Systems Manager Benutzerhandbuch*

## Änderungsprotokoll
<a name="systems-manager-agent-component-changelog"></a>

In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.


|  **Version**  |  **Änderungen**  | 
| --- | --- | 
|  1.3.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.2.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.2.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.1.0  |  Diese Version enthält Fehlerkorrekturen und Verbesserungen.  | 
|  1.0.0  |  Erste Version  |