La version 5 (V5) du Outils AWS pour PowerShell est sortie \$1
Pour plus d'informations sur les modifications majeures et la migration de vos applications, consultez la [rubrique relative à la migration](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples d'Amazon EKS utilisant des outils pour la PowerShell version 5
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la Outils AWS pour PowerShell V5 avec Amazon EKS.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `Add-EKSResourceTag`
L'exemple de code suivant montre comment utiliser`Add-EKSResourceTag`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande associe les balises spécifiées à la resourceArn spécifiée.**
```
Add-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD" -Tag @{Name = "EKSPRODCLUSTER"}
```
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-EKSCluster`
L'exemple de code suivant montre comment utiliser`Get-EKSCluster`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande renvoie des informations descriptives sur un cluster Amazon EKS.**
```
Get-EKSCluster -Name "PROD"
```
**Sortie** :
```
Arn : arn:aws:eks:us-west-2:012345678912:cluster/PROD
CertificateAuthority : Amazon.EKS.Model.Certificate
ClientRequestToken :
CreatedAt : 12/25/2019 6:46:17 AM
Endpoint : https://669608765450FBBE54D1D78A3D71B72C.gr8.us-west-2.eks.amazonaws.com
Identity : Amazon.EKS.Model.Identity
Logging : Amazon.EKS.Model.Logging
Name : PROD
PlatformVersion : eks.7
ResourcesVpcConfig : Amazon.EKS.Model.VpcConfigResponse
RoleArn : arn:aws:iam::012345678912:role/eks-iam-role
Status : ACTIVE
Tags : {}
Version : 1.14
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeCluster](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-EKSClusterList`
L'exemple de code suivant montre comment utiliser`Get-EKSClusterList`.
**Outils pour PowerShell V5**
**Exemple 1 : Cette applet de commande répertorie les clusters Amazon EKS présents Compte AWS dans la région spécifiée.**
```
Get-EKSClusterList
```
**Sortie** :
```
PROD
```
+ Pour plus de détails sur l'API, reportez-vous [ListClusters](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-EKSFargateProfile`
L'exemple de code suivant montre comment utiliser`Get-EKSFargateProfile`.
**Outils pour PowerShell V5**
**Exemple 1 : Cette applet de commande renvoie des informations descriptives sur un profil Fargate AWS .**
```
Get-EKSFargateProfile -FargateProfileName "EKSFargate" -ClusterName "TEST"
```
**Sortie** :
```
ClusterName : TEST
CreatedAt : 12/26/2019 12:34:47 PM
FargateProfileArn : arn:aws:eks:us-east-2:012345678912:fargateprofile/TEST/EKSFargate/42b7a119-e16b-a279-ce97-bdf303adec92
FargateProfileName : EKSFargate
PodExecutionRoleArn : arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole
Selectors : {Amazon.EKS.Model.FargateProfileSelector}
Status : ACTIVE
Subnets : {subnet-0cd976f08d5fbfaae, subnet-02f6ff500ff2067a0}
Tags : {}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeFargateProfile](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-EKSFargateProfileList`
L'exemple de code suivant montre comment utiliser`Get-EKSFargateProfileList`.
**Outils pour PowerShell V5**
**Exemple 1 : Cette applet de commande répertorie les profils AWS Fargate associés au cluster spécifié dans votre région spécifiée. Compte AWS **
```
Get-EKSFargateProfileList -ClusterName "TEST"
```
**Sortie** :
```
EKSFargate
EKSFargateProfile
```
+ Pour plus de détails sur l'API, reportez-vous [ListFargateProfiles](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-EKSNodegroup`
L'exemple de code suivant montre comment utiliser`Get-EKSNodegroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande renvoie des informations descriptives sur un groupe de nœuds Amazon EKS.**
```
Get-EKSNodegroup -NodegroupName "ProdEKSNodeGroup" -ClusterName "PROD"
```
**Sortie** :
```
AmiType : AL2_x86_64
ClusterName : PROD
CreatedAt : 12/25/2019 10:16:45 AM
DiskSize : 40
Health : Amazon.EKS.Model.NodegroupHealth
InstanceTypes : {t3.large}
Labels : {}
ModifiedAt : 12/25/2019 10:16:45 AM
NodegroupArn : arn:aws:eks:us-west-2:012345678912:nodegroup/PROD/ProdEKSNodeGroup/7eb79e47-82b6-04d9-e984-95110db6fa85
NodegroupName : ProdEKSNodeGroup
NodeRole : arn:aws:iam::012345678912:role/NodeInstanceRole
ReleaseVersion : 1.14.7-20190927
RemoteAccess :
Resources :
ScalingConfig : Amazon.EKS.Model.NodegroupScalingConfig
Status : CREATING
Subnets : {subnet-0d1a9fff35efa7691, subnet-0a3f4928edbc224d4}
Tags : {}
Version : 1.14
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeNodegroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-EKSNodegroupList`
L'exemple de code suivant montre comment utiliser`Get-EKSNodegroupList`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande répertorie les groupes de nœuds Amazon EKS associés au cluster spécifié Compte AWS dans votre région.**
```
Get-EKSNodegroupList -ClusterName PROD
```
**Sortie** :
```
ProdEKSNodeGroup
```
+ Pour plus de détails sur l'API, reportez-vous [ListNodegroups](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-EKSResourceTag`
L'exemple de code suivant montre comment utiliser`Get-EKSResourceTag`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande répertorie les balises d’une ressource Amazon EKS.**
```
Get-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD"
```
**Sortie** :
```
Key Value
--- -----
Name EKSPRODCLUSTER
```
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-EKSUpdate`
L'exemple de code suivant montre comment utiliser`Get-EKSUpdate`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande renvoie des informations descriptives relatives à une mise à jour concernant votre cluster Amazon EKS ou le groupe de nœuds gérés associé.**
```
Get-EKSUpdate -Name "PROD" -UpdateId "ee708232-7d2e-4ed7-9270-d0b5176f0726"
```
**Sortie** :
```
CreatedAt : 12/25/2019 5:03:07 PM
Errors : {}
Id : ee708232-7d2e-4ed7-9270-d0b5176f0726
Params : {Amazon.EKS.Model.UpdateParam}
Status : Successful
Type : LoggingUpdate
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeUpdate](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Get-EKSUpdateList`
L'exemple de code suivant montre comment utiliser`Get-EKSUpdateList`.
**Outils pour PowerShell V5**
**Exemple 1 : Cette applet de commande répertorie les mises à jour associées à un cluster Amazon EKS ou à un groupe de nœuds gérés dans votre Compte AWS région spécifiée.**
```
Get-EKSUpdateList -Name "PROD"
```
**Sortie** :
```
ee708232-7d2e-4ed7-9270-d0b5176f0726
```
+ Pour plus de détails sur l'API, reportez-vous [ListUpdates](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-EKSCluster`
L'exemple de code suivant montre comment utiliser`New-EKSCluster`.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée un nouveau cluster appelé « prod ».**
```
New-EKSCluster -Name prod -ResourcesVpcConfig @{SubnetIds=@("subnet-0a1b2c3d","subnet-3a2b1c0d");SecurityGroupIds="sg-6979fe18"} -RoleArn "arn:aws:iam::012345678901:role/eks-service-role"
```
**Sortie** :
```
Arn : arn:aws:eks:us-west-2:012345678901:cluster/prod
CertificateAuthority : Amazon.EKS.Model.Certificate
ClientRequestToken :
CreatedAt : 12/10/2018 9:25:31 PM
Endpoint :
Name : prod
PlatformVersion : eks.3
ResourcesVpcConfig : Amazon.EKS.Model.VpcConfigResponse
RoleArn : arn:aws:iam::012345678901:role/eks-service-role
Status : CREATING
Version : 1.10
```
+ Pour plus de détails sur l'API, reportez-vous [CreateCluster](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-EKSFargateProfile`
L'exemple de code suivant montre comment utiliser`New-EKSFargateProfile`.
**Outils pour PowerShell V5**
**Exemple 1 : Cette applet de commande crée un profil Fargate pour votre AWS cluster Amazon EKS. Vous devez avoir au moins un profil Fargate dans un cluster pour pouvoir planifier des pods sur une infrastructure Fargate.**
```
New-EKSFargateProfile -FargateProfileName EKSFargateProfile -ClusterName TEST -Subnet "subnet-02f6ff500ff2067a0", "subnet-0cd976f08d5fbfaae" -PodExecutionRoleArn arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole -Selector @{Namespace="default"}
```
**Sortie** :
```
ClusterName : TEST
CreatedAt : 12/26/2019 12:38:21 PM
FargateProfileArn : arn:aws:eks:us-east-2:012345678912:fargateprofile/TEST/EKSFargateProfile/20b7a11b-8292-41c1-bc56-ffa5e60f6224
FargateProfileName : EKSFargateProfile
PodExecutionRoleArn : arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole
Selectors : {Amazon.EKS.Model.FargateProfileSelector}
Status : CREATING
Subnets : {subnet-0cd976f08d5fbfaae, subnet-02f6ff500ff2067a0}
Tags : {}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateFargateProfile](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `New-EKSNodeGroup`
L'exemple de code suivant montre comment utiliser`New-EKSNodeGroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande crée un groupe de composants master gérés pour un cluster Amazon EKS. Vous pouvez uniquement créer un groupe de nœuds pour votre cluster qui soit égal à la version Kubernetes actuelle du cluster. Tous les groupes de nœuds sont créés avec la dernière version de l’AMI pour la version Kubernetes mineure correspondante du cluster. **
```
New-EKSNodeGroup -NodeGroupName "ProdEKSNodeGroup" -AmiType "AL2_x86_64" -DiskSize 40 -ClusterName "PROD" -ScalingConfig_DesiredSize 2 -ScalingConfig_MinSize 2 -ScalingConfig_MaxSize 5 -InstanceType t3.large -NodeRole "arn:aws:iam::012345678912:role/NodeInstanceRole" -Subnet "subnet-0d1a9fff35efa7691","subnet-0a3f4928edbc224d4"
```
**Sortie** :
```
AmiType : AL2_x86_64
ClusterName : PROD
CreatedAt : 12/25/2019 10:16:45 AM
DiskSize : 40
Health : Amazon.EKS.Model.NodegroupHealth
InstanceTypes : {t3.large}
Labels : {}
ModifiedAt : 12/25/2019 10:16:45 AM
NodegroupArn : arn:aws:eks:us-west-2:012345678912:nodegroup/PROD/ProdEKSNodeGroup/7eb79e47-82b6-04d9-e984-95110db6fa85
NodegroupName : ProdEKSNodeGroup
NodeRole : arn:aws:iam::012345678912:role/NodeInstanceRole
ReleaseVersion : 1.14.7-20190927
RemoteAccess :
Resources :
ScalingConfig : Amazon.EKS.Model.NodegroupScalingConfig
Status : CREATING
Subnets : {subnet-0d1a9fff35efa7691, subnet-0a3f4928edbc224d4}
Tags : {}
Version : 1.14
```
+ Pour plus de détails sur l'API, reportez-vous [CreateNodegroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-EKSCluster`
L'exemple de code suivant montre comment utiliser`Remove-EKSCluster`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande supprime le plan de contrôle du cluster Amazon EKS.**
```
Remove-EKSCluster -Name "DEV-KUBE-CL"
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSCluster (DeleteCluster)" on target "DEV-KUBE-CL".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Arn : arn:aws:eks:us-west-2:012345678912:cluster/DEV-KUBE-CL
CertificateAuthority : Amazon.EKS.Model.Certificate
ClientRequestToken :
CreatedAt : 12/25/2019 9:33:25 AM
Endpoint : https://02E6D31E3E4F8C15D7BE7F58D527776A.yl4.us-west-2.eks.amazonaws.com
Identity : Amazon.EKS.Model.Identity
Logging : Amazon.EKS.Model.Logging
Name : DEV-KUBE-CL
PlatformVersion : eks.7
ResourcesVpcConfig : Amazon.EKS.Model.VpcConfigResponse
RoleArn : arn:aws:iam::012345678912:role/eks-iam-role
Status : DELETING
Tags : {}
Version : 1.14
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteCluster](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-EKSFargateProfile`
L'exemple de code suivant montre comment utiliser`Remove-EKSFargateProfile`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande supprime un profil AWS Fargate. Lorsque vous supprimez un profil Fargate, tous les pods s’exécutant sur Fargate qui étaient créées avec le profil sont supprimés.**
```
Remove-EKSFargateProfile -FargateProfileName "EKSFargate" -ClusterName "TEST"
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSFargateProfile (DeleteFargateProfile)" on target "EKSFargate".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
ClusterName : TEST
CreatedAt : 12/26/2019 12:34:47 PM
FargateProfileArn : arn:aws:eks:us-east-2:012345678912:fargateprofile/TEST/EKSFargate/42b7a119-e16b-a279-ce97-bdf303adec92
FargateProfileName : EKSFargate
PodExecutionRoleArn : arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole
Selectors : {Amazon.EKS.Model.FargateProfileSelector}
Status : DELETING
Subnets : {subnet-0cd976f08d5fbfaae, subnet-02f6ff500ff2067a0}
Tags : {}
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteFargateProfile](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-EKSNodegroup`
L'exemple de code suivant montre comment utiliser`Remove-EKSNodegroup`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande supprime un groupe de nœuds Amazon EKS pour un cluster.**
```
Remove-EKSNodegroup -NodegroupName "ProdEKSNodeGroup" -ClusterName "PROD"
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSNodegroup (DeleteNodegroup)" on target "ProdEKSNodeGroup".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
AmiType : AL2_x86_64
ClusterName : PROD
CreatedAt : 12/25/2019 10:16:45 AM
DiskSize : 40
Health : Amazon.EKS.Model.NodegroupHealth
InstanceTypes : {t3.large}
Labels : {}
ModifiedAt : 12/25/2019 11:01:16 AM
NodegroupArn : arn:aws:eks:us-west-2:012345678912:nodegroup/PROD/ProdEKSNodeGroup/7eb79e47-82b6-04d9-e984-95110db6fa85
NodegroupName : ProdEKSNodeGroup
NodeRole : arn:aws:iam::012345678912:role/NodeInstanceRole
ReleaseVersion : 1.14.7-20190927
RemoteAccess :
Resources : Amazon.EKS.Model.NodegroupResources
ScalingConfig : Amazon.EKS.Model.NodegroupScalingConfig
Status : DELETING
Subnets : {subnet-0d1a9fff35efa7691, subnet-0a3f4928edbc224d4}
Tags : {}
Version : 1.14
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteNodegroup](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Remove-EKSResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-EKSResourceTag`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande supprime les balises spécifiées d’une ressource EKS.**
```
Remove-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD" -TagKey "Name"
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EKSResourceTag (UntagResource)" on target "arn:aws:eks:us-west-2:012345678912:cluster/PROD".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
```
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-EKSClusterConfig`
L'exemple de code suivant montre comment utiliser`Update-EKSClusterConfig`.
**Outils pour PowerShell V5**
**Exemple 1 : met à jour la configuration d’un cluster Amazon EKS. Votre cluster continue de fonctionner pendant la mise à jour.**
```
Update-EKSClusterConfig -Name "PROD" -Logging_ClusterLogging @{Types="api","audit","authenticator","controllerManager","scheduler",Enabled="True"}
```
**Sortie** :
```
CreatedAt : 12/25/2019 5:03:07 PM
Errors : {}
Id : ee708232-7d2e-4ed7-9270-d0b5176f0726
Params : {Amazon.EKS.Model.UpdateParam}
Status : InProgress
Type : LoggingUpdate
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateClusterConfig](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
### `Update-EKSClusterVersion`
L'exemple de code suivant montre comment utiliser`Update-EKSClusterVersion`.
**Outils pour PowerShell V5**
**Exemple 1 : cette applet de commande met à jour un cluster Amazon EKS vers la version Kubernetes spécifiée. Votre cluster continue de fonctionner pendant la mise à jour.**
```
Update-EKSClusterVersion -Name "PROD-KUBE-CL" -Version 1.14
```
**Sortie** :
```
CreatedAt : 12/26/2019 9:50:37 AM
Errors : {}
Id : ef186eff-3b3a-4c25-bcfc-3dcdf9e898a8
Params : {Amazon.EKS.Model.UpdateParam, Amazon.EKS.Model.UpdateParam}
Status : InProgress
Type : VersionUpdate
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateClusterVersion](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.