

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.

# `AWSPremiumSupport-ExtendVolumesOnWindows`
<a name="automation-awspremiumsupport-extendvolumesonwindows"></a>

 **Beschreibung** 

Das `AWSPremiumSupport-ExtendVolumesOnWindows` Runbook erweitert die Amazon Elastic Block Store (Amazon EBS) -Volumes, ihre Partitionen und Dateisysteme auf einer Amazon Elastic Compute Cloud (Amazon EC2) -Zielinstanz.

**Wichtige Überlegungen**  
**Auswirkungen auf den Betrieb und Volumenstatus**: Änderungen des Amazon EBS-Volumens erfolgen in drei Phasen: `modifying``optimizing`, und`completed`. Diese Automatisierung wird mit der Dateisystemerweiterung fortgesetzt, wenn das Volume den `optimizing` Status erreicht. Während des `optimizing` Zustands kann es zu vorübergehenden Leistungseinbußen und möglichen Störungen auf Dateisystemebene bei der Größenänderung von Partitionen kommen. Sie können [den Fortschritt der Amazon EBS-Volumenänderungen überwachen](https://docs.aws.amazon.com//ebs/latest/userguide/monitoring-volume-modifications.html).
**Kosten und Einschränkungen**: Die Erhöhung der Größe eines Amazon EBS-Volumes führt zu höheren monatlichen Speicherkosten. Weitere Informationen finden Sie in der [Amazon EBS-Preisübersicht](https://aws.amazon.com/ebs/pricing). Für das Backup-AMI und die zugehörigen Snapshots, die von diesem Runbook erstellt werden, fallen zusätzliche Gebühren an, die von ihrer Größe und der Dauer der Aufbewahrung abhängen. Wenn Sie bei einigen Volumetypen nach der Erweiterung das gleiche Verhältnis von IOPS pro GB beibehalten möchten, müssen Sie möglicherweise die bereitgestellten IOPS ändern.
**Backup und Wiederherstellung**: Das Runbook erstellt ein Backup-AMI, bevor Änderungen an den Volumes vorgenommen werden. Das AMI und die zugehörigen Snapshots werden nicht automatisch aus Ihrem Konto entfernt. Sie sollten diese Backups manuell entfernen, falls sie nicht mehr benötigt werden. Im Falle eines Fehlers können Volumes aus den Snapshots des zugehörigen AMI wiederhergestellt werden, wie unter [Ersetzen eines Amazon EBS-Volumes mithilfe eines](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ebs-restoring-volume.html) Snapshots beschrieben.

 **Wie funktioniert das?** 

Dieses Runbook führt die folgenden Operationen aus:
+ Überprüft, ob die Zielinstanz von Systems Manager verwaltet wird und Windows Server ausgeführt wird
+ Stellt sicher, dass dieses Runbook nur einmal ausgeführt wird, das auf die aktuelle Amazon EC2 EC2-Instance abzielt
+ Erstellt ein Backup-Amazon Machine Image (AMI) von der Ziel-Instance
+ Erweitert die Amazon EBS-Volumes, die für die Erweiterung spezifiziert wurden
+ Erweitert die Dateisysteme auf der Ziel-Instance mithilfe von Befehlen PowerShell 

**Wichtig**  
Für den Zugriff auf `AWSPremiumSupport-*` Runbooks ist ein Abonnement für Business \$1 Support, Enterprise Support oder Unified Operations erforderlich. Weitere Informationen finden Sie unter [AWS Support Tarife vergleichen](https://aws.amazon.com/premiumsupport/plans/).

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ExtendVolumesOnWindows) 

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+ `ec2:DescribeInstances`
+ `ec2:CreateImage`
+ `ec2:DescribeImages`
+ `ec2:DescribeVolumes`
+ `ec2:ModifyVolume`
+ `ssm:SendCommand`
+ `ssm:ListCommandInvocations`
+ `ssm:DescribeInstanceInformation`

Beispiel für eine IAM-Richtlinie:

```
 {
     "Version": "2012-10-17",		 	 	 
     "Statement": [
         {
             "Effect": "Allow",
             "Action": [
                 "ec2:DescribeInstances",
                 "ec2:CreateImage",
                 "ec2:DescribeImages",
                 "ec2:DescribeVolumes",
                 "ec2:ModifyVolume",
                 "ssm:SendCommand",
                 "ssm:DescribeInstanceInformation",
                 "ssm:ListCommandInvocations"
             ],
             "Resource": "*"
         }
     ]
 }
```

 **Anweisungen** 

Gehen Sie wie folgt vor, um die Automatisierung zu konfigurieren:

1. Navigieren Sie [https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description)im Systems Manager unter Dokumente zu.

1. Wählen Sie **Execute automation (Automatisierung ausführen)**.

1. Geben Sie für die Eingabeparameter Folgendes ein:
   + **AutomationAssumeRole (Fakultativ):**
     + Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der IAM-Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
     + Typ: `AWS::IAM::Role::Arn`
   + **InstanceId (Erforderlich):**
     + Beschreibung: (Erforderlich) Die ID der Amazon EC2-Instance.
     + Typ: `String`
     + Muster zulassen: `^i-[0-9a-f]{8,17}$`
   + **VolumeExpansionCapSize (Erforderlich):**
     + Beschreibung: (Erforderlich) Maximale Größe (in GiB), mit der die Amazon EBS-Volumes erhöht werden.
     + Typ: `String`
     + Muster zulassen: `^[0-9]{1,4}$`
   + **DiagnosticResults (Erforderlich):**
     + Beschreibung: (Erforderlich) Die Ergebnisse des Prechecks-Skripts aus dem `DiagnoseDiskUsage` Dokument, formatiert als einzeiliges CSV-Format. Die Zeichenfolge beginnt mit, `EXTEND;` gefolgt von kommagetrennten Volumeninformationen für jeden Datenträger, wobei die Volumen durch Semikolons getrennt sind. Zu den Informationen jedes Volumes gehören: Volume-ID, Laufwerksbuchstabe, Erweiterungskennzeichnung (1 zum Erweitern, 0 zum Überspringen), Neue Größe in GB, AWS Region und Grund/Aktion.
     + Typ: `String`
     + Muster zulassen: `^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$`

1. Wählen Sie **Ausführen aus**.

1. Die Automatisierung wird initiiert.

1. Das Dokument führt die folgenden Schritte aus:
   + **AssertInstanceIsManagedInstance**:

     Überprüft, ob die Zielinstanz von Systems Manager verwaltet wird.
   + **DescribeInstance**:

     Ruft die Plattforminformationen der Amazon EC2 EC2-Zielinstanz ab.
   + **BranchOnPlatform**:

     Bestätigt, dass die Amazon EC2 EC2-Instance-Zielplattform Windows Server ist.
   + **CheckConcurrency**:

     Stellt sicher, dass dieses Runbook nur einmal ausgeführt wird, das auf die aktuelle Amazon EC2 EC2-Instance abzielt.
   + **CreateImage**:

     Erstellt ein Backup-Amazon Machine Image (AMI) von der Ziel-Instance.
   + **WaitUntilImageReady**:

     Wartet darauf, dass das Amazon Machine Image (AMI) die Erstellung abgeschlossen hat und den `available` Status erreicht hat.
   + **Verlängern EBSVolume**:

     Erweitert die Amazon EBS-Volumes der Ziel-Instance, die für die Erweiterung angegeben wurden.
   + **DescribeVolumes**:

     Beschreibt die Amazon EBS-Volumes der Ziel-Instance, die für die Erweiterung angegeben wurden.
   + **ExtendFilesystem**:

     Erweitert die Dateisysteme der Ziel-Instance mithilfe PowerShell von Befehlen.

1. Nach Abschluss der Ausführung finden Sie im Abschnitt **Ausgaben** die detaillierten Ergebnisse der Ausführung.

**Referenzen**

Systems Manager Automation
+ [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnWindows/description)
+ [Führen Sie eine Automatisierung aus](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Eine Automatisierung einrichten](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Support Sie Automatisierungs-Workflows](https://aws.amazon.com/premiumsupport/technology/saw/)
+ [Amazon EBS-Volumenänderungen anfordern](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/requesting-ebs-volume-modifications.html)