

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.

# `pcluster update-cluster`
<a name="pcluster.update-cluster-v3"></a>

Aktualisiert einen vorhandenen Cluster so, dass er den Einstellungen einer angegebenen Konfigurationsdatei entspricht.

**Anmerkung**  
 Das Cluster-Update ist nur erfolgreich, wenn alle Clusterknoten das Update erfolgreich installiert haben. Schlägt das Update fehl, finden Sie im [`clusterStatus`Das Sehen erfolgt `UPDATE_FAILED` mit einem `pcluster describe-cluster` Befehl](troubleshooting-fc-v3-update-cluster.md#update-cluster-failure-v3) Abschnitt Anleitungen zur Fehlerbehebung. 

```
pcluster update-cluster [-h] 
                 --cluster-configuration CLUSTER_CONFIGURATION
                 --cluster-name CLUSTER_NAME
                [--debug]
                [--dryrun DRYRUN]
                [--force-update FORCE_UPDATE]
                [--query QUERY]
                [--region REGION]
                [--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
                [--validation-failure-level {INFO,WARNING,ERROR}]
```

## Benannte Argumente
<a name="pcluster-v3.update-cluster.namedargs"></a>

**-h, --help**  
Zeigt den Hilfetext für`pcluster update-cluster`.

**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***  
Gibt die YAML-Cluster-Konfigurationsdatei an.

**--cluster-name, -n *CLUSTER\$1NAME***  
Gibt den Namen des Clusters an.

**--debug**  
Aktiviert die Debug-Protokollierung.

**--dryrun *DRYRUN***  
Wenn`true`, führt die Validierung durch, ohne den Cluster zu aktualisieren und Ressourcen zu erstellen. Es kann verwendet werden, um die Image-Konfiguration und die Aktualisierungsanforderungen zu überprüfen. (Die Standardeinstellung ist`false`.)

**--force-update *FORCE\$1UPDATE***  
Wenn`true`, erzwingt die Aktualisierung, indem die Fehler bei der Aktualisierungsüberprüfung ignoriert werden. (Die Standardeinstellung ist.) `false`

**--query *QUERY***  
Gibt die JMESPath Abfrage an, die für die Ausgabe ausgeführt werden soll.

**--region, -r *REGION***  
Gibt an AWS-Region , welche verwendet werden soll. Das AWS-Region muss mithilfe der [`Region`](cluster-configuration-file-v3.md#yaml-Region)Einstellung in der Cluster-Konfigurationsdatei, der `AWS_DEFAULT_REGION` Umgebungsvariablen, der `region` Einstellung im `[default]` Abschnitt der `~/.aws/config` Datei oder des `--region` Parameters angegeben werden.

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
Identifiziert einen oder mehrere zu unterdrückende Konfigurationsprüfer.  
Format: (\$1) `ALL` `type:[A-Za-z0-9]+`

**--validation-failure-level *\$1INFO,WARNING,ERROR\$1***  
Gibt den Grad der bei der Aktualisierung gemeldeten Validierungsfehler an.

**Beispiel mit AWS ParallelCluster Version 3.1.4:**

```
$ pcluster update-cluster -c cluster-config.yaml -n cluster-v3 -r us-east-1
{
  "cluster": {
    "clusterName": "cluster-v3",
    "cloudformationStackStatus": "UPDATE_IN_PROGRESS",
    "cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
    "region": "us-east-1",
    "version": "3.1.4",
    "clusterStatus": "UPDATE_IN_PROGRESS"
  },
  "changeSet": [
    {
      "parameter": "HeadNode.Iam.S3Access",
      "requestedValue": {
        "BucketName": "amzn-s3-demo-bucket1",
        "KeyName": "output",
        "EnableWriteAccess": false
      }
    },
    {
      "parameter": "HeadNode.Iam.S3Access",
      "currentValue": {
        "BucketName": "amzn-s3-demo-bucket2",
        "KeyName": "logs",
        "EnableWriteAccess": true
      }
    }
  ]
}
```