D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
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 de code pour Tools for PowerShell V4
Les exemples de code suivants vous montrent comment utiliser le Outils AWS pour PowerShell V4 avec AWS.
Les *principes de base* sont des exemples de code qui vous montrent comment effectuer les opérations essentielles au sein d’un service.
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.
Les *scénarios* sont des exemples de code qui vous montrent comment accomplir des tâches spécifiques en appelant plusieurs fonctions au sein d’un même service ou combinés à d’autres Services AWS.
Certains services contiennent des exemples de catégories supplémentaires qui montrent comment tirer parti des bibliothèques ou des fonctions spécifiques au service.
**Ressources supplémentaires**
+ **[Guide du développeur Tools for PowerShell V4](https://docs.aws.amazon.com/powershell/latest/v4/pstools-welcome.html)** — En savoir plus sur l'utilisation PowerShell avec AWS.
+ **[Centre pour développeurs AWS](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-programming-language=programming-language%23) ** : exemples de code que vous pouvez filtrer par catégorie ou par recherche en texte intégral.
+ **[AWS Exemples de SDK](https://github.com/awsdocs/aws-doc-sdk-examples)** : GitHub dépôt avec code complet dans les langues préférées. Inclut des instructions sur la configuration et l’exécution du code.
**Topics**
+ [ACM](powershell_4_acm_code_examples.md)
+ [Application Autoscaling](powershell_4_application-auto-scaling_code_examples.md)
+ [WorkSpaces Demandes](powershell_4_appstream_code_examples.md)
+ [Aurora](powershell_4_aurora_code_examples.md)
+ [Auto Scaling](powershell_4_auto-scaling_code_examples.md)
+ [AWS Budgets](powershell_4_budgets_code_examples.md)
+ [AWS Cloud9](powershell_4_cloud9_code_examples.md)
+ [CloudFormation](powershell_4_cloudformation_code_examples.md)
+ [CloudFront](powershell_4_cloudfront_code_examples.md)
+ [CloudTrail](powershell_4_cloudtrail_code_examples.md)
+ [CloudWatch](powershell_4_cloudwatch_code_examples.md)
+ [CodeCommit](powershell_4_codecommit_code_examples.md)
+ [CodeDeploy](powershell_4_codedeploy_code_examples.md)
+ [CodePipeline](powershell_4_codepipeline_code_examples.md)
+ [Amazon Cognito Identity](powershell_4_cognito-identity_code_examples.md)
+ [AWS Config](powershell_4_config-service_code_examples.md)
+ [Device Farm](powershell_4_device-farm_code_examples.md)
+ [Directory Service](powershell_4_directory-service_code_examples.md)
+ [AWS DMS](powershell_4_database-migration-service_code_examples.md)
+ [DynamoDB](powershell_4_dynamodb_code_examples.md)
+ [Amazon EC2](powershell_4_ec2_code_examples.md)
+ [Amazon ECR](powershell_4_ecr_code_examples.md)
+ [Amazon ECS](powershell_4_ecs_code_examples.md)
+ [Amazon EFS](powershell_4_efs_code_examples.md)
+ [Amazon EKS](powershell_4_eks_code_examples.md)
+ [Elastic Load Balancing – version 1](powershell_4_elastic-load-balancing_code_examples.md)
+ [Elastic Load Balancing – version 2](powershell_4_elastic-load-balancing-v2_code_examples.md)
+ [Amazon FSx](powershell_4_fsx_code_examples.md)
+ [Amazon Glacier](powershell_4_glacier_code_examples.md)
+ [AWS Glue](powershell_4_glue_code_examples.md)
+ [AWS Health](powershell_4_health_code_examples.md)
+ [IAM](powershell_4_iam_code_examples.md)
+ [Kinesis](powershell_4_kinesis_code_examples.md)
+ [Lambda](powershell_4_lambda_code_examples.md)
+ [Amazon ML](powershell_4_machine-learning_code_examples.md)
+ [Macie](powershell_4_macie2_code_examples.md)
+ [AWS Price List](powershell_4_pricing_code_examples.md)
+ [Groupes de ressources](powershell_4_resource-groups_code_examples.md)
+ [API de balisage des groupes de ressources](powershell_4_resource-groups-tagging-api_code_examples.md)
+ [Route 53](powershell_4_route-53_code_examples.md)
+ [Amazon S3](powershell_4_s3_code_examples.md)
+ [Security Hub CSPM](powershell_4_securityhub_code_examples.md)
+ [Amazon SES](powershell_4_ses_code_examples.md)
+ [API Amazon SES v2](powershell_4_sesv2_code_examples.md)
+ [Amazon SNS](powershell_4_sns_code_examples.md)
+ [Amazon SQS](powershell_4_sqs_code_examples.md)
+ [AWS STS](powershell_4_sts_code_examples.md)
+ [Support](powershell_4_support_code_examples.md)
+ [Systems Manager](powershell_4_ssm_code_examples.md)
+ [Amazon Translate](powershell_4_translate_code_examples.md)
+ [AWS WAFV2](powershell_4_wafv2_code_examples.md)
+ [WorkSpaces](powershell_4_workspaces_code_examples.md)
# Exemples d'ACM utilisant Tools for V4 PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec ACM.
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
### `Get-ACMCertificate`
L'exemple de code suivant montre comment utiliser`Get-ACMCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre comment renvoyer un certificat et sa chaîne à l’aide de l’ARN du certificat.**
```
Get-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
+ Pour plus de détails sur l'API, reportez-vous [GetCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ACMCertificateDetail`
L'exemple de code suivant montre comment utiliser`Get-ACMCertificateDetail`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les détails du certificat spécifié.**
```
Get-ACMCertificateDetail -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
**Sortie** :
```
CertificateArn : arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
CreatedAt : 1/21/2016 5:55:59 PM
DomainName : www.example.com
DomainValidationOptions : {www.example.com}
InUseBy : {}
IssuedAt : 1/1/0001 12:00:00 AM
Issuer :
KeyAlgorithm : RSA-2048
NotAfter : 1/1/0001 12:00:00 AM
NotBefore : 1/1/0001 12:00:00 AM
RevocationReason :
RevokedAt : 1/1/0001 12:00:00 AM
Serial :
SignatureAlgorithm : SHA256WITHRSA
Status : PENDING_VALIDATION
Subject : CN=www.example.com
SubjectAlternativeNames : {www.example.net}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ACMCertificateList`
L'exemple de code suivant montre comment utiliser`Get-ACMCertificateList`.
**Outils pour PowerShell V4**
**Exemple 1 : récupère la liste de tous vos certificats ARNs et le nom de domaine de chacun d'entre eux. L'applet de commande pagine automatiquement pour récupérer tous les. ARNs Pour contrôler manuellement la pagination, utilisez le MaxItem paramètre - pour contrôler le nombre de certificats ARNs renvoyés pour chaque appel de service et le NextToken paramètre - pour indiquer le point de départ de chaque appel.**
```
Get-ACMCertificateList
```
**Sortie** :
```
CertificateArn DomainName
-------------- ----------
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012 www.example.com
```
**Exemple 2 : récupère une liste de tous vos certificats ARNs dont le statut correspond aux états fournis.**
```
Get-ACMCertificateList -CertificateStatus "VALIDATION_TIMED_OUT","FAILED"
```
**Exemple 3 : cet exemple renvoie une liste de tous les certificats de la région us-east-1 dont le type de clé est RSA\$12048 et dont l’utilisation ou l’objectif étendu de la clé est CODE\$1SIGNING. Vous trouverez les valeurs de ces paramètres de filtrage dans la rubrique de référence de l'API ListCertificates Filters : https://docs.aws.amazon.com/acm/ latest/APIReference/API \$1Filters.html.**
```
Get-ACMCertificateList -Region us-east-1 -Includes_KeyType RSA_2048 -Includes_ExtendedKeyUsage CODE_SIGNING
```
**Sortie** :
```
CertificateArn DomainName
-------------- ----------
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-d7c0-48c1-af8d-2133d8f30zzz *.route53docs.com
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-98a5-443d-a734-800430c80zzz nerdzizm.net
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-2be6-4376-8fa7-bad559525zzz
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-e7ca-44c5-803e-24d9f2f36zzz
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-1241-4b71-80b1-090305a62zzz
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-8709-4568-8c64-f94617c99zzz
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-a8fa-4a61-98cf-e08ccc0eezzz
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-fa47-40fe-a714-2d277d3eezzz *.route53docs.com
```
+ Pour plus de détails sur l'API, reportez-vous [ListCertificates](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ACMCertificate`
L'exemple de code suivant montre comment utiliser`New-ACMCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un nouveau certificat. Le service renvoie l’ARN du nouveau certificat.**
```
New-ACMCertificate -DomainName "www.example.com"
```
**Sortie** :
```
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
```
**Exemple 2 : crée un nouveau certificat. Le service renvoie l’ARN du nouveau certificat.**
```
New-ACMCertificate -DomainName "www.example.com" -SubjectAlternativeName "example.com","www.example.net"
```
**Sortie** :
```
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
```
+ Pour plus de détails sur l'API, reportez-vous [RequestCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ACMCertificate`
L'exemple de code suivant montre comment utiliser`Remove-ACMCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime le certificat identifié par l’ARN fourni et la clé privée associée. L’applet de commande vous invite à confirmer avant de poursuivre ; ajoutez le commutateur -Force pour supprimer la confirmation.**
```
Remove-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Send-ACMValidationEmail`
L'exemple de code suivant montre comment utiliser`Send-ACMValidationEmail`.
**Outils pour PowerShell V4**
**Exemple 1 : demande que l’e-mail de validation de la propriété du domaine pour « www.exemple.com » soit envoyé. Si le \$1 de votre shell ConfirmPreference est défini sur « Moyen » ou inférieur, l'applet de commande vous demandera une confirmation avant de continuer. Ajoutez le commutateur -Force pour supprimer les invites de confirmation.**
```
$params = @{
CertificateArn="arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
Domain="www.example.com"
ValidationDomain="example.com"
}
Send-ACMValidationEmail @params
```
+ Pour plus de détails sur l'API, reportez-vous [ResendValidationEmail](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Application Auto Scaling utilisant Tools for PowerShell V4
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 V4 avec Application Auto Scaling.
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-AASScalableTarget`
L'exemple de code suivant montre comment utiliser`Add-AASScalableTarget`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande enregistre ou met à jour une cible évolutive. Une cible évolutive est une ressource qu’Application Auto Scaling peut augmenter et diminuer.**
```
Add-AASScalableTarget -ServiceNamespace AppStream -ResourceId fleet/MyFleet -ScalableDimension appstream:fleet:DesiredCapacity -MinCapacity 2 -MaxCapacity 10
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterScalableTarget](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-AASScalableTarget`
L'exemple de code suivant montre comment utiliser`Get-AASScalableTarget`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple fournit des informations sur les cibles évolutives Application Auto·Scaling dans l’espace de noms spécifié.**
```
Get-AASScalableTarget -ServiceNamespace "AppStream"
```
**Sortie** :
```
CreationTime : 11/7/2019 2:30:03 AM
MaxCapacity : 5
MinCapacity : 1
ResourceId : fleet/Test
RoleARN : arn:aws:iam::012345678912:role/aws-service-role/appstream.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_AppStreamFleet
ScalableDimension : appstream:fleet:DesiredCapacity
ServiceNamespace : appstream
SuspendedState : Amazon.ApplicationAutoScaling.Model.SuspendedState
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScalableTargets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-AASScalingActivity`
L'exemple de code suivant montre comment utiliser`Get-AASScalingActivity`.
**Outils pour PowerShell V4**
**Exemple 1 : fournit des informations descriptives pour les activités de mise à l’échelle avec un espace de noms de service spécifié pour les six dernières semaines.**
```
Get-AASScalingActivity -ServiceNamespace AppStream
```
**Sortie** :
```
ActivityId : 2827409f-b639-4cdb-a957-8055d5d07434
Cause : monitor alarm Appstream2-MyFleet-default-scale-in-Alarm in state ALARM triggered policy default-scale-in
Description : Setting desired capacity to 2.
Details :
EndTime : 12/14/2019 11:32:49 AM
ResourceId : fleet/MyFleet
ScalableDimension : appstream:fleet:DesiredCapacity
ServiceNamespace : appstream
StartTime : 12/14/2019 11:32:14 AM
StatusCode : Successful
StatusMessage : Successfully set desired capacity to 2. Change successfully fulfilled by appstream.
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScalingActivities](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-AASScalingPolicy`
L'exemple de code suivant montre comment utiliser`Get-AASScalingPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande décrit les politiques de mise à l’échelle d’Application Auto Scaling pour l’espace de noms de service spécifié.**
```
Get-AASScalingPolicy -ServiceNamespace AppStream
```
**Sortie** :
```
Alarms : {Appstream2-LabFleet-default-scale-out-Alarm}
CreationTime : 9/3/2019 2:48:15 AM
PolicyARN : arn:aws:autoscaling:us-west-2:012345678912:scalingPolicy:5659b069-b5cd-4af1-9f7f-3e956d36233e:resource/appstream/fleet/LabFleet:
policyName/default-scale-out
PolicyName : default-scale-out
PolicyType : StepScaling
ResourceId : fleet/LabFleet
ScalableDimension : appstream:fleet:DesiredCapacity
ServiceNamespace : appstream
StepScalingPolicyConfiguration : Amazon.ApplicationAutoScaling.Model.StepScalingPolicyConfiguration
TargetTrackingScalingPolicyConfiguration :
Alarms : {Appstream2-LabFleet-default-scale-in-Alarm}
CreationTime : 9/3/2019 2:48:15 AM
PolicyARN : arn:aws:autoscaling:us-west-2:012345678912:scalingPolicy:5659b069-b5cd-4af1-9f7f-3e956d36233e:resource/appstream/fleet/LabFleet:
policyName/default-scale-in
PolicyName : default-scale-in
PolicyType : StepScaling
ResourceId : fleet/LabFleet
ScalableDimension : appstream:fleet:DesiredCapacity
ServiceNamespace : appstream
StepScalingPolicyConfiguration : Amazon.ApplicationAutoScaling.Model.StepScalingPolicyConfiguration
TargetTrackingScalingPolicyConfiguration :
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScalingPolicies](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-AASScheduledAction`
L'exemple de code suivant montre comment utiliser`Get-AASScheduledAction`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande répertorie les actions planifiées pour votre groupe Auto Scaling qui n’ont pas été exécutées ou qui n’ont pas atteint leur heure de fin. **
```
Get-AASScheduledAction -ServiceNamespace AppStream
```
**Sortie** :
```
CreationTime : 12/22/2019 9:25:52 AM
EndTime : 1/1/0001 12:00:00 AM
ResourceId : fleet/MyFleet
ScalableDimension : appstream:fleet:DesiredCapacity
ScalableTargetAction : Amazon.ApplicationAutoScaling.Model.ScalableTargetAction
Schedule : cron(0 0 8 ? * MON-FRI *)
ScheduledActionARN : arn:aws:autoscaling:us-west-2:012345678912:scheduledAction:4897ca24-3caa-4bf1-8484-851a089b243c:resource/appstream/fleet/MyFleet:scheduledActionName
/WeekDaysFleetScaling
ScheduledActionName : WeekDaysFleetScaling
ServiceNamespace : appstream
StartTime : 1/1/0001 12:00:00 AM
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScheduledActions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-AASScalableTarget`
L'exemple de code suivant montre comment utiliser`Remove-AASScalableTarget`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande annule l’enregistrement d’une cible évolutive Application Auto Scaling. Le désenregistrement d’une cible évolutive supprime les politiques de mise à l’échelle qui lui sont associées.**
```
Remove-AASScalableTarget -ResourceId fleet/MyFleet -ScalableDimension appstream:fleet:DesiredCapacity -ServiceNamespace AppStream
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-AASScalableTarget (DeregisterScalableTarget)" on target "fleet/MyFleet".
[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 [DeregisterScalableTarget](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-AASScalingPolicy`
L'exemple de code suivant montre comment utiliser`Remove-AASScalingPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande supprime la stratégie de mise à l’échelle spécifiée pour une cible évolutive Application Auto Scaling.**
```
Remove-AASScalingPolicy -ServiceNamespace AppStream -PolicyName "default-scale-out" -ResourceId fleet/Test -ScalableDimension appstream:fleet:DesiredCapacity
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteScalingPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-AASScheduledAction`
L'exemple de code suivant montre comment utiliser`Remove-AASScheduledAction`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande supprime l’action planifiée spécifiée pour une cible évolutive Application Auto Scaling.**
```
Remove-AASScheduledAction -ServiceNamespace AppStream -ScheduledActionName WeekDaysFleetScaling -ResourceId fleet/MyFleet -ScalableDimension appstream:fleet:DesiredCapacity
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-AASScheduledAction (DeleteScheduledAction)" on target "WeekDaysFleetScaling".
[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 [DeleteScheduledAction](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-AASScalingPolicy`
L'exemple de code suivant montre comment utiliser`Set-AASScalingPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande crée ou met à jour une politique pour une cible évolutive Application Auto Scaling. Chaque cible évolutive est identifiée par un espace de noms de service, un ID de ressource et une dimension évolutive.**
```
Set-AASScalingPolicy -ServiceNamespace AppStream -PolicyName ASFleetScaleInPolicy -PolicyType StepScaling -ResourceId fleet/MyFleet -ScalableDimension appstream:fleet:DesiredCapacity -StepScalingPolicyConfiguration_AdjustmentType ChangeInCapacity -StepScalingPolicyConfiguration_Cooldown 360 -StepScalingPolicyConfiguration_MetricAggregationType Average -StepScalingPolicyConfiguration_StepAdjustments @{ScalingAdjustment = -1; MetricIntervalUpperBound = 0}
```
**Sortie** :
```
Alarms PolicyARN
------ ---------
{} arn:aws:autoscaling:us-west-2:012345678912:scalingPolicy:4897ca24-3caa-4bf1-8484-851a089b243c:resource/appstream/fleet/MyFleet:policyName/ASFleetScaleInPolicy
```
+ Pour plus de détails sur l'API, reportez-vous [PutScalingPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-AASScheduledAction`
L'exemple de code suivant montre comment utiliser`Set-AASScheduledAction`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande crée ou met à jour une action planifiée pour une cible évolutive Application Auto Scaling. Chaque cible évolutive est identifiée par un espace de noms de service, un ID de ressource et une dimension évolutive.**
```
Set-AASScheduledAction -ServiceNamespace AppStream -ResourceId fleet/MyFleet -Schedule "cron(0 0 8 ? * MON-FRI *)" -ScalableDimension appstream:fleet:DesiredCapacity -ScheduledActionName WeekDaysFleetScaling -ScalableTargetAction_MinCapacity 5 -ScalableTargetAction_MaxCapacity 10
```
+ Pour plus de détails sur l'API, reportez-vous [PutScheduledAction](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# WorkSpaces Exemples d'applications utilisant Tools for PowerShell V4
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 version 4 avec WorkSpaces applications.
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-APSResourceTag`
L'exemple de code suivant montre comment utiliser`Add-APSResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute une étiquette de ressource à la AppStream ressource**
```
Add-APSResourceTag -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest -Tag @{StackState='Test'} -Select ^Tag
```
**Sortie** :
```
Name Value
---- -----
StackState Test
```
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Copy-APSImage`
L'exemple de code suivant montre comment utiliser`Copy-APSImage`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple copie une image dans une autre région**
```
Copy-APSImage -DestinationImageName TestImageCopy -DestinationRegion us-west-2 -SourceImageName Powershell
```
**Sortie** :
```
TestImageCopy
```
+ Pour plus de détails sur l'API, reportez-vous [CopyImage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Disable-APSUSer`
L'exemple de code suivant montre comment utiliser`Disable-APSUSer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple désactive un utilisateur dans USERPOOL**
```
Disable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com
```
+ Pour plus de détails sur l'API, reportez-vous [DisableUser](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-APSUser`
L'exemple de code suivant montre comment utiliser`Enable-APSUser`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active un utilisateur désactivé dans USERPOOL**
```
Enable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com
```
+ Pour plus de détails sur l'API, reportez-vous [EnableUser](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSAssociatedFleetList`
L'exemple de code suivant montre comment utiliser`Get-APSAssociatedFleetList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche la flotte associée à une pile**
```
Get-APSAssociatedFleetList -StackName PowershellStack
```
**Sortie** :
```
PowershellFleet
```
+ Pour plus de détails sur l'API, reportez-vous [ListAssociatedFleets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSAssociatedStackList`
L'exemple de code suivant montre comment utiliser`Get-APSAssociatedStackList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche la pile associée à une flotte**
```
Get-APSAssociatedStackList -FleetName PowershellFleet
```
**Sortie** :
```
PowershellStack
```
+ Pour plus de détails sur l'API, reportez-vous [ListAssociatedStacks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSDirectoryConfigList`
L'exemple de code suivant montre comment utiliser`Get-APSDirectoryConfigList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple affiche les configurations de répertoire créées dans AppStream**
```
Get-APSDirectoryConfigList | Select DirectoryName, OrganizationalUnitDistinguishedNames, CreatedTime
```
**Sortie** :
```
DirectoryName OrganizationalUnitDistinguishedNames CreatedTime
------------- ------------------------------------ -----------
Test.com {OU=AppStream,DC=Test,DC=com} 9/6/2019 10:56:40 AM
contoso.com {OU=AppStream,OU=contoso,DC=contoso,DC=com} 8/9/2019 9:08:50 AM
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeDirectoryConfigs](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSFleetList`
L'exemple de code suivant montre comment utiliser`Get-APSFleetList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche les détails d’une flotte**
```
Get-APSFleetList -Name Test
```
**Sortie** :
```
Arn : arn:aws:appstream:us-east-1:1234567890:fleet/Test
ComputeCapacityStatus : Amazon.AppStream.Model.ComputeCapacityStatus
CreatedTime : 9/12/2019 5:00:45 PM
Description : Test
DisconnectTimeoutInSeconds : 900
DisplayName : Test
DomainJoinInfo :
EnableDefaultInternetAccess : False
FleetErrors : {}
FleetType : ON_DEMAND
IamRoleArn :
IdleDisconnectTimeoutInSeconds : 900
ImageArn : arn:aws:appstream:us-east-1:1234567890:image/Test
ImageName : Test
InstanceType : stream.standard.medium
MaxUserDurationInSeconds : 57600
Name : Test
State : STOPPED
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeFleets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSImageBuilderList`
L'exemple de code suivant montre comment utiliser`Get-APSImageBuilderList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple affiche les détails d'un ImageBuilder**
```
Get-APSImageBuilderList -Name TestImage
```
**Sortie** :
```
AccessEndpoints : {}
AppstreamAgentVersion : 06-19-2019
Arn : arn:aws:appstream:us-east-1:1234567890:image-builder/TestImage
CreatedTime : 1/14/2019 4:33:05 AM
Description :
DisplayName : TestImage
DomainJoinInfo :
EnableDefaultInternetAccess : False
IamRoleArn :
ImageArn : arn:aws:appstream:us-east-1::image/Base-Image-Builder-05-02-2018
ImageBuilderErrors : {}
InstanceType : stream.standard.large
Name : TestImage
NetworkAccessConfiguration : Amazon.AppStream.Model.NetworkAccessConfiguration
Platform : WINDOWS
State : STOPPED
StateChangeReason :
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeImageBuilders](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSImageList`
L'exemple de code suivant montre comment utiliser`Get-APSImageList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple affiche des AppStream images privées**
```
Get-APSImageList -Type PRIVATE | select DisplayName, ImageBuilderName, Visibility, arn
```
**Sortie** :
```
DisplayName ImageBuilderName Visibility Arn
----------- ---------------- ---------- ---
OfficeApps OfficeApps PRIVATE arn:aws:appstream:us-east-1:123456789012:image/OfficeApps
SessionScriptV2 SessionScriptTest PRIVATE arn:aws:appstream:us-east-1:123456789012:image/SessionScriptV2
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeImages](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSImagePermission`
L'exemple de code suivant montre comment utiliser`Get-APSImagePermission`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple affiche les autorisations relatives aux images sur une AppStream image partagée**
```
Get-APSImagePermission -Name Powershell | select SharedAccountId, @{n="AllowFleet";e={$_.ImagePermissions.AllowFleet}}, @{n="AllowImageBuilder";e={$_.ImagePermissions.AllowImageBuilder}}
```
**Sortie** :
```
SharedAccountId AllowFleet AllowImageBuilder
--------------- ---------- -----------------
123456789012 True True
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeImagePermissions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSSessionList`
L'exemple de code suivant montre comment utiliser`Get-APSSessionList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche la liste des sessions d’une flotte**
```
Get-APSSessionList -FleetName PowershellFleet -StackName PowershellStack
```
**Sortie** :
```
AuthenticationType : API
ConnectionState : CONNECTED
FleetName : PowershellFleet
Id : d8987c70-4394-4324-a396-2d485c26f2a2
MaxExpirationTime : 12/27/2019 4:54:07 AM
NetworkAccessConfiguration : Amazon.AppStream.Model.NetworkAccessConfiguration
StackName : PowershellStack
StartTime : 12/26/2019 12:54:12 PM
State : ACTIVE
UserId : Test
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSessions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSStackList`
L'exemple de code suivant montre comment utiliser`Get-APSStackList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple affiche la liste des AppStream Stack**
```
Get-APSStackList | Select DisplayName, Arn, CreatedTime
```
**Sortie** :
```
DisplayName Arn CreatedTime
----------- --- -----------
PowershellStack arn:aws:appstream:us-east-1:123456789012:stack/PowershellStack 4/24/2019 8:49:29 AM
SessionScriptTest arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest 9/12/2019 3:23:12 PM
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeStacks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSTagsForResourceList`
L'exemple de code suivant montre comment utiliser`Get-APSTagsForResourceList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche les balises d'une AppStream ressource**
```
Get-APSTagsForResourceList -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest
```
**Sortie** :
```
Key Value
--- -----
StackState Test
```
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSUsageReportSubscription`
L'exemple de code suivant montre comment utiliser`Get-APSUsageReportSubscription`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche les détails AppStreamUsageReport de configuration**
```
Get-APSUsageReportSubscription
```
**Sortie** :
```
LastGeneratedReportDate S3BucketName Schedule SubscriptionErrors
----------------------- ------------ -------- ------------------
1/1/0001 12:00:00 AM appstream-logs-us-east-1-123456789012-sik1hnxe DAILY {}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeUsageReportSubscriptions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSUser`
L'exemple de code suivant montre comment utiliser`Get-APSUser`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche la liste des utilisateurs dont le statut est activé**
```
Get-APSUser -AuthenticationType USERPOOL | Select-Object UserName, AuthenticationType, Enabled
```
**Sortie** :
```
UserName AuthenticationType Enabled
-------- ------------------ -------
foo1@contoso.com USERPOOL True
foo2@contoso.com USERPOOL True
foo3@contoso.com USERPOOL True
foo4@contoso.com USERPOOL True
foo5@contoso.com USERPOOL True
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeUsers](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-APSUserStackAssociation`
L'exemple de code suivant montre comment utiliser`Get-APSUserStackAssociation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche la liste des utilisateurs assignés à une pile**
```
Get-APSUserStackAssociation -StackName PowershellStack
```
**Sortie** :
```
AuthenticationType SendEmailNotification StackName UserName
------------------ --------------------- --------- --------
USERPOOL False PowershellStack TestUser1@lab.com
USERPOOL False PowershellStack TestUser2@lab.com
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeUserStackAssociations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-APSDirectoryConfig`
L'exemple de code suivant montre comment utiliser`New-APSDirectoryConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée une configuration de répertoire dans AppStream**
```
New-APSDirectoryConfig -ServiceAccountCredentials_AccountName contoso\ServiceAccount -ServiceAccountCredentials_AccountPassword MyPass -DirectoryName contoso.com -OrganizationalUnitDistinguishedName "OU=AppStream,OU=Contoso,DC=Contoso,DC=com"
```
**Sortie** :
```
CreatedTime DirectoryName OrganizationalUnitDistinguishedNames ServiceAccountCredentials
----------- ------------- ------------------------------------ -------------------------
12/27/2019 11:00:30 AM contoso.com {OU=AppStream,OU=Contoso,DC=Contoso,DC=com} Amazon.AppStream.Model.ServiceAccountCredentials
```
+ Pour plus de détails sur l'API, reportez-vous [CreateDirectoryConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-APSFleet`
L'exemple de code suivant montre comment utiliser`New-APSFleet`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée une nouvelle AppStream flotte**
```
New-APSFleet -ComputeCapacity_DesiredInstance 1 -InstanceType stream.standard.medium -Name TestFleet -DisplayName TestFleet -FleetType ON_DEMAND -EnableDefaultInternetAccess $True -VpcConfig_SubnetIds "subnet-123ce32","subnet-a1234cfd" -VpcConfig_SecurityGroupIds sg-4d012a34 -ImageName SessionScriptTest -Region us-west-2
```
**Sortie** :
```
Arn : arn:aws:appstream:us-west-2:123456789012:fleet/TestFleet
ComputeCapacityStatus : Amazon.AppStream.Model.ComputeCapacityStatus
CreatedTime : 12/27/2019 11:24:42 AM
Description :
DisconnectTimeoutInSeconds : 900
DisplayName : TestFleet
DomainJoinInfo :
EnableDefaultInternetAccess : True
FleetErrors : {}
FleetType : ON_DEMAND
IamRoleArn :
IdleDisconnectTimeoutInSeconds : 0
ImageArn : arn:aws:appstream:us-west-2:123456789012:image/SessionScriptTest
ImageName : SessionScriptTest
InstanceType : stream.standard.medium
MaxUserDurationInSeconds : 57600
Name : TestFleet
State : STOPPED
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ Pour plus de détails sur l'API, reportez-vous [CreateFleet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-APSImageBuilder`
L'exemple de code suivant montre comment utiliser`New-APSImageBuilder`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un Image Builder dans AppStream**
```
New-APSImageBuilder -InstanceType stream.standard.medium -Name TestIB -DisplayName TestIB -ImageName AppStream-WinServer2012R2-12-12-2019 -EnableDefaultInternetAccess $True -VpcConfig_SubnetId subnet-a1234cfd -VpcConfig_SecurityGroupIds sg-2d012a34 -Region us-west-2
```
**Sortie** :
```
AccessEndpoints : {}
AppstreamAgentVersion : 12-16-2019
Arn : arn:aws:appstream:us-west-2:123456789012:image-builder/TestIB
CreatedTime : 12/27/2019 11:39:24 AM
Description :
DisplayName : TestIB
DomainJoinInfo :
EnableDefaultInternetAccess : True
IamRoleArn :
ImageArn : arn:aws:appstream:us-west-2::image/AppStream-WinServer2012R2-12-12-2019
ImageBuilderErrors : {}
InstanceType : stream.standard.medium
Name : TestIB
NetworkAccessConfiguration :
Platform : WINDOWS
State : PENDING
StateChangeReason :
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ Pour plus de détails sur l'API, reportez-vous [CreateImageBuilder](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-APSImageBuilderStreamingURL`
L'exemple de code suivant montre comment utiliser`New-APSImageBuilderStreamingURL`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée une URL de ImageBuilder diffusion d'une validité de 2 heures**
```
New-APSImageBuilderStreamingURL -Name TestIB -Validity 7200 -Region us-west-2
```
**Sortie** :
```
Expires StreamingURL
------- ------------
12/27/2019 1:49:13 PM https://appstream2.us-west-2.aws.amazon.com/authenticate?parameters=eyJ0eXBlIjoiQURNSU4iLCJleHBpcmVzIjoiMTU3NzQ1NDU1MyIsImF3c0FjY291bnRJZCI6IjM5MzQwMzgxMTQwNyIsInVzZXJJZCI6ImFkbWluIiwiY2F
```
+ Pour plus de détails sur l'API, voir [CreateImageBuilderStreamingURL](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-APSStack`
L'exemple de code suivant montre comment utiliser`New-APSStack`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée une nouvelle AppStream pile**
```
New-APSStack -Name TestStack -DisplayName TestStack -ApplicationSettings_Enabled $True -ApplicationSettings_SettingsGroup TestStack -Region us-west-2
```
**Sortie** :
```
AccessEndpoints : {}
ApplicationSettings : Amazon.AppStream.Model.ApplicationSettingsResponse
Arn : arn:aws:appstream:us-west-2:123456789012:stack/TestStack
CreatedTime : 12/27/2019 12:34:19 PM
Description :
DisplayName : TestStack
EmbedHostDomains : {}
FeedbackURL :
Name : TestStack
RedirectURL :
StackErrors : {}
StorageConnectors : {}
UserSettings : {Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateStack](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-APSStreamingURL`
L'exemple de code suivant montre comment utiliser`New-APSStreamingURL`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une URL de streaming de pile**
```
New-APSStreamingURL -StackName SessionScriptTest -FleetName SessionScriptNew -UserId TestUser
```
**Sortie** :
```
Expires StreamingURL
------- ------------
12/27/2019 12:43:37 PM https://appstream2.us-east-1.aws.amazon.com/authenticate?parameters=eyJ0eXBlIjoiRU5EX1VTRVIiLCJleHBpcmVzIjoiMTU3NzQ1MDYxNyIsImF3c0FjY291bnRJZCI6IjM5MzQwMzgxMTQwNyIsInVzZXJJZCI6IlRlc3RVc2
```
+ Pour plus de détails sur l'API, voir [CreateStreamingURL](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-APSUsageReportSubscription`
L'exemple de code suivant montre comment utiliser`New-APSUsageReportSubscription`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple active les rapports AppStream d'utilisation**
```
New-APSUsageReportSubscription
```
**Sortie** :
```
S3BucketName Schedule
------------ --------
appstream-logs-us-east-1-123456789012-sik2hnxe DAILY
```
+ Pour plus de détails sur l'API, reportez-vous [CreateUsageReportSubscription](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-APSUser`
L'exemple de code suivant montre comment utiliser`New-APSUser`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un utilisateur dans USERPOOL**
```
New-APSUser -UserName Test@lab.com -AuthenticationType USERPOOL -FirstName 'kt' -LastName 'aws' -Select ^UserName
```
**Sortie** :
```
Test@lab.com
```
+ Pour plus de détails sur l'API, reportez-vous [CreateUser](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-APSFleet`
L'exemple de code suivant montre comment utiliser`Register-APSFleet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre une flotte avec une pile**
```
Register-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2
```
+ Pour plus de détails sur l'API, reportez-vous [AssociateFleet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-APSUserStackBatch`
L'exemple de code suivant montre comment utiliser`Register-APSUserStackBatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple attribue une pile à un utilisateur dans USERPOOL**
```
Register-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="TestUser1@lab.com"}
```
+ Pour plus de détails sur l'API, reportez-vous [BatchAssociateUserStack](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-APSDirectoryConfig`
L'exemple de code suivant montre comment utiliser`Remove-APSDirectoryConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la configuration du AppStream répertoire**
```
Remove-APSDirectoryConfig -DirectoryName contoso.com
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSDirectoryConfig (DeleteDirectoryConfig)" on target "contoso.com".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteDirectoryConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-APSFleet`
L'exemple de code suivant montre comment utiliser`Remove-APSFleet`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime et supprime une flotte AppStream **
```
Remove-APSFleet -Name TestFleet -Region us-west-2
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSFleet (DeleteFleet)" on target "TestFleet".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteFleet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-APSImage`
L'exemple de code suivant montre comment utiliser`Remove-APSImage`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime une image**
```
Remove-APSImage -Name TestImage -Region us-west-2
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSImage (DeleteImage)" on target "TestImage".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
Applications : {}
AppstreamAgentVersion : LATEST
Arn : arn:aws:appstream:us-west-2:123456789012:image/TestImage
BaseImageArn :
CreatedTime : 12/27/2019 1:34:10 PM
Description :
DisplayName : TestImage
ImageBuilderName :
ImageBuilderSupported : True
ImagePermissions :
Name : TestImage
Platform : WINDOWS
PublicBaseImageReleasedDate : 6/12/2018 12:00:00 AM
State : AVAILABLE
StateChangeReason :
Visibility : PRIVATE
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteImage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-APSImageBuilder`
L'exemple de code suivant montre comment utiliser`Remove-APSImageBuilder`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime un ImageBuilder**
```
Remove-APSImageBuilder -Name TestIB -Region us-west-2
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSImageBuilder (DeleteImageBuilder)" on target "TestIB".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
AccessEndpoints : {}
AppstreamAgentVersion : 12-16-2019
Arn : arn:aws:appstream:us-west-2:123456789012:image-builder/TestIB
CreatedTime : 12/27/2019 11:39:24 AM
Description :
DisplayName : TestIB
DomainJoinInfo :
EnableDefaultInternetAccess : True
IamRoleArn :
ImageArn : arn:aws:appstream:us-west-2::image/AppStream-WinServer2012R2-12-12-2019
ImageBuilderErrors : {}
InstanceType : stream.standard.medium
Name : TestIB
NetworkAccessConfiguration : Amazon.AppStream.Model.NetworkAccessConfiguration
Platform : WINDOWS
State : DELETING
StateChangeReason :
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteImageBuilder](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-APSImagePermission`
L'exemple de code suivant montre comment utiliser`Remove-APSImagePermission`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime les autorisations d’une image**
```
Remove-APSImagePermission -Name Powershell -SharedAccountId 123456789012
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSImagePermission (DeleteImagePermissions)" on target "Powershell".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteImagePermissions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-APSResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-APSResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime une balise de ressource de la AppStream ressource**
```
Remove-APSResourceTag -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest -TagKey StackState
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSResourceTag (UntagResource)" on target "arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-APSStack`
L'exemple de code suivant montre comment utiliser`Remove-APSStack`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime une pile**
```
Remove-APSStack -Name TestStack -Region us-west-2
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSStack (DeleteStack)" on target "TestStack".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteStack](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-APSUsageReportSubscription`
L'exemple de code suivant montre comment utiliser`Remove-APSUsageReportSubscription`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple désactive l'abonnement au rapport AppStream d'utilisation**
```
Remove-APSUsageReportSubscription
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSUsageReportSubscription (DeleteUsageReportSubscription)" on target "".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteUsageReportSubscription](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-APSUser`
L'exemple de code suivant montre comment utiliser`Remove-APSUser`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime un utilisateur de USERPOOL**
```
Remove-APSUser -UserName TestUser@lab.com -AuthenticationType USERPOOL
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-APSUser (DeleteUser)" on target "TestUser@lab.com".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): A
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteUser](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Revoke-APSSession`
L'exemple de code suivant montre comment utiliser`Revoke-APSSession`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple révoque une session dans le AppStream parc**
```
Revoke-APSSession -SessionId 6cd2f9a3-f948-4aa1-8014-8a7dcde14877
```
+ Pour plus de détails sur l'API, reportez-vous [ExpireSession](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Start-APSFleet`
L'exemple de code suivant montre comment utiliser`Start-APSFleet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple démarre une flotte**
```
Start-APSFleet -Name PowershellFleet
```
+ Pour plus de détails sur l'API, reportez-vous [StartFleet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Start-APSImageBuilder`
L'exemple de code suivant montre comment utiliser`Start-APSImageBuilder`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple démarre un ImageBuilder**
```
Start-APSImageBuilder -Name TestImage
```
**Sortie** :
```
AccessEndpoints : {}
AppstreamAgentVersion : 06-19-2019
Arn : arn:aws:appstream:us-east-1:123456789012:image-builder/TestImage
CreatedTime : 1/14/2019 4:33:05 AM
Description :
DisplayName : TestImage
DomainJoinInfo :
EnableDefaultInternetAccess : False
IamRoleArn :
ImageArn : arn:aws:appstream:us-east-1::image/Base-Image-Builder-05-02-2018
ImageBuilderErrors : {}
InstanceType : stream.standard.large
Name : TestImage
NetworkAccessConfiguration : Amazon.AppStream.Model.NetworkAccessConfiguration
Platform : WINDOWS
State : PENDING
StateChangeReason :
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ Pour plus de détails sur l'API, reportez-vous [StartImageBuilder](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-APSFleet`
L'exemple de code suivant montre comment utiliser`Stop-APSFleet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple arrête une flotte**
```
Stop-APSFleet -Name PowershellFleet
```
+ Pour plus de détails sur l'API, reportez-vous [StopFleet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-APSImageBuilder`
L'exemple de code suivant montre comment utiliser`Stop-APSImageBuilder`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple arrête un ImageBuilder**
```
Stop-APSImageBuilder -Name TestImage
```
**Sortie** :
```
AccessEndpoints : {}
AppstreamAgentVersion : 06-19-2019
Arn : arn:aws:appstream:us-east-1:123456789012:image-builder/TestImage
CreatedTime : 1/14/2019 4:33:05 AM
Description :
DisplayName : TestImage
DomainJoinInfo :
EnableDefaultInternetAccess : False
IamRoleArn :
ImageArn : arn:aws:appstream:us-east-1::image/Base-Image-Builder-05-02-2018
ImageBuilderErrors : {}
InstanceType : stream.standard.large
Name : TestImage
NetworkAccessConfiguration : Amazon.AppStream.Model.NetworkAccessConfiguration
Platform : WINDOWS
State : STOPPING
StateChangeReason :
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ Pour plus de détails sur l'API, reportez-vous [StopImageBuilder](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-APSFleet`
L'exemple de code suivant montre comment utiliser`Unregister-APSFleet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple annule l’enregistrement d’une flotte à partir d’une pile**
```
Unregister-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2
```
+ Pour plus de détails sur l'API, reportez-vous [DisassociateFleet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-APSUserStackBatch`
L'exemple de code suivant montre comment utiliser`Unregister-APSUserStackBatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime un utilisateur d’une pile assignée**
```
Unregister-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="TestUser1@lab.com"}
```
+ Pour plus de détails sur l'API, reportez-vous [BatchDisassociateUserStack](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-APSDirectoryConfig`
L'exemple de code suivant montre comment utiliser`Update-APSDirectoryConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple met à jour la configuration du répertoire créée dans AppStream**
```
Update-APSDirectoryConfig -ServiceAccountCredentials_AccountName contoso\ServiceAccount -ServiceAccountCredentials_AccountPassword MyPass@1$@# -DirectoryName contoso.com -OrganizationalUnitDistinguishedName "OU=AppStreamNew,OU=Contoso,DC=Contoso,DC=com"
```
**Sortie** :
```
CreatedTime DirectoryName OrganizationalUnitDistinguishedNames ServiceAccountCredentials
----------- ------------- ------------------------------------ -------------------------
12/27/2019 3:50:02 PM contoso.com {OU=AppStreamNew,OU=Contoso,DC=Contoso,DC=com} Amazon.AppStream.Model.ServiceAccountCredentials
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateDirectoryConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-APSFleet`
L'exemple de code suivant montre comment utiliser`Update-APSFleet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour les propriétés d’une flotte**
```
Update-APSFleet -Name PowershellFleet -EnableDefaultInternetAccess $True -DisconnectTimeoutInSecond 950
```
**Sortie** :
```
Arn : arn:aws:appstream:us-east-1:123456789012:fleet/PowershellFleet
ComputeCapacityStatus : Amazon.AppStream.Model.ComputeCapacityStatus
CreatedTime : 4/24/2019 8:39:41 AM
Description : PowershellFleet
DisconnectTimeoutInSeconds : 950
DisplayName : PowershellFleet
DomainJoinInfo :
EnableDefaultInternetAccess : True
FleetErrors : {}
FleetType : ON_DEMAND
IamRoleArn :
IdleDisconnectTimeoutInSeconds : 900
ImageArn : arn:aws:appstream:us-east-1:123456789012:image/Powershell
ImageName : Powershell
InstanceType : stream.standard.medium
MaxUserDurationInSeconds : 57600
Name : PowershellFleet
State : STOPPED
VpcConfig : Amazon.AppStream.Model.VpcConfig
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateFleet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-APSImagePermission`
L'exemple de code suivant montre comment utiliser`Update-APSImagePermission`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple partage une AppStream image avec un autre compte**
```
Update-APSImagePermission -Name Powershell -SharedAccountId 123456789012 -ImagePermissions_AllowFleet $True -ImagePermissions_AllowImageBuilder $True
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateImagePermissions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-APSStack`
L'exemple de code suivant montre comment utiliser`Update-APSStack`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour (active) la persistance des paramètres de l’application et les dossiers de base sur une pile**
```
Update-APSStack -Name PowershellStack -ApplicationSettings_Enabled $True -ApplicationSettings_SettingsGroup PowershellStack -StorageConnector @{ConnectorType="HOMEFOLDERS"}
```
**Sortie** :
```
AccessEndpoints : {}
ApplicationSettings : Amazon.AppStream.Model.ApplicationSettingsResponse
Arn : arn:aws:appstream:us-east-1:123456789012:stack/PowershellStack
CreatedTime : 4/24/2019 8:49:29 AM
Description : PowershellStack
DisplayName : PowershellStack
EmbedHostDomains : {}
FeedbackURL :
Name : PowershellStack
RedirectURL :
StackErrors : {}
StorageConnectors : {Amazon.AppStream.Model.StorageConnector, Amazon.AppStream.Model.StorageConnector}
UserSettings : {Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting, Amazon.AppStream.Model.UserSetting}
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateStack](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Aurora utilisant Tools for PowerShell V4
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 V4 avec Aurora.
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
### `Get-RDSOrderableDBInstanceOption`
L'exemple de code suivant montre comment utiliser`Get-RDSOrderableDBInstanceOption`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les versions de moteur de base de données qui prennent en charge une classe d’instance de base de données spécifique dans une Région AWS.**
```
$params = @{
Engine = 'aurora-postgresql'
DBInstanceClass = 'db.r5.large'
Region = 'us-east-1'
}
Get-RDSOrderableDBInstanceOption @params
```
**Exemple 2 : cet exemple répertorie les classes d’instance de base de données prises en charge pour une version de moteur de base de données spécifique dans une Région AWS.**
```
$params = @{
Engine = 'aurora-postgresql'
EngineVersion = '13.6'
Region = 'us-east-1'
}
Get-RDSOrderableDBInstanceOption @params
```
+ Pour plus de détails sur l'API, consultez la section [DescribeOrderableDBInstanceOptions](https://docs.aws.amazon.com/powershell/v4/reference) de la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Auto Scaling utilisant Tools for PowerShell V4
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 V4 avec Auto Scaling.
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-ASLoadBalancer`
L'exemple de code suivant montre comment utiliser`Add-ASLoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple attache l’équilibreur de charge spécifié au groupe Auto Scaling spécifié.**
```
Add-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [AttachLoadBalancers](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Complete-ASLifecycleAction`
L'exemple de code suivant montre comment utiliser`Complete-ASLifecycleAction`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple complète l’action du cycle de vie spécifiée.**
```
Complete-ASLifecycleAction -LifecycleHookName myLifecycleHook -AutoScalingGroupName my-asg -LifecycleActionResult CONTINUE -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635
```
+ Pour plus de détails sur l'API, reportez-vous [CompleteLifecycleAction](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Disable-ASMetricsCollection`
L'exemple de code suivant montre comment utiliser`Disable-ASMetricsCollection`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple désactive la surveillance des métriques spécifiées pour le groupe Auto Scaling spécifié.**
```
Disable-ASMetricsCollection -AutoScalingGroupName my-asg -Metric @("GroupMinSize", "GroupMaxSize")
```
**Exemple 2 : cet exemple désactive la surveillance de toutes les métriques pour le groupe Auto Scaling spécifié.**
```
Disable-ASMetricsCollection -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [DisableMetricsCollection](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Dismount-ASInstance`
L'exemple de code suivant montre comment utiliser`Dismount-ASInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple détache l’instance spécifiée du groupe Auto Scaling spécifié et réduit la capacité souhaitée afin qu’Auto Scaling ne lance pas d’instance de remplacement.**
```
Dismount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true
```
**Sortie** :
```
ActivityId : 06733445-ce94-4039-be1b-b9f1866e276e
AutoScalingGroupName : my-asg
Cause : At 2015-11-20T22:34:59Z instance i-93633f9b was detached in response to a user request, shrinking
the capacity from 2 to 1.
Description : Detaching EC2 instance: i-93633f9b
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 50
StartTime : 11/20/2015 2:34:59 PM
StatusCode : InProgress
StatusMessage :
```
**Exemple 2 : cet exemple détache l’instance spécifiée du groupe Auto Scaling spécifié sans réduire la capacité souhaitée. Auto Scaling lance une instance de remplacement.**
```
Dismount-ASInstance -InstanceId i-7bf746a2 -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false
```
**Sortie** :
```
ActivityId : f43a3cd4-d38c-4af7-9fe0-d76ec2307b6d
AutoScalingGroupName : my-asg
Cause : At 2015-11-20T22:34:59Z instance i-7bf746a2 was detached in response to a user request.
Description : Detaching EC2 instance: i-7bf746a2
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 50
StartTime : 11/20/2015 2:34:59 PM
StatusCode : InProgress
StatusMessage :
```
+ Pour plus de détails sur l'API, reportez-vous [DetachInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Dismount-ASLoadBalancer`
L'exemple de code suivant montre comment utiliser`Dismount-ASLoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple détache l’équilibreur de charge spécifié du groupe Auto Scaling spécifié.**
```
Dismount-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [DetachLoadBalancers](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-ASMetricsCollection`
L'exemple de code suivant montre comment utiliser`Enable-ASMetricsCollection`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active la surveillance des métriques spécifiées pour le groupe Auto Scaling spécifié.**
```
Enable-ASMetricsCollection -Metric @("GroupMinSize", "GroupMaxSize") -AutoScalingGroupName my-asg -Granularity 1Minute
```
**Exemple 2 : cet exemple active la surveillance de toutes les métriques pour le groupe Auto Scaling spécifié.**
```
Enable-ASMetricsCollection -AutoScalingGroupName my-asg -Granularity 1Minute
```
+ Pour plus de détails sur l'API, reportez-vous [EnableMetricsCollection](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enter-ASStandby`
L'exemple de code suivant montre comment utiliser`Enter-ASStandby`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met l’instance spécifiée en mode veille et réduit la capacité souhaitée afin qu’Auto Scaling ne lance pas d’instance de remplacement.**
```
Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true
```
**Sortie** :
```
ActivityId : e36a5a54-ced6-4df8-bd19-708e2a59a649
AutoScalingGroupName : my-asg
Cause : At 2015-11-22T15:48:06Z instance i-95b8484f was moved to standby in response to a user request,
shrinking the capacity from 2 to 1.
Description : Moving EC2 instance to Standby: i-95b8484f
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 50
StartTime : 11/22/2015 7:48:06 AM
StatusCode : InProgress
StatusMessage :
```
**Exemple 2 : cet exemple met l’instance spécifiée en mode veille sans diminuer la capacité souhaitée. Auto Scaling lance une instance de remplacement.**
```
Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false
```
**Sortie** :
```
ActivityId : e36a5a54-ced6-4df8-bd19-708e2a59a649
AutoScalingGroupName : my-asg
Cause : At 2015-11-22T15:48:06Z instance i-95b8484f was moved to standby in response to a user request.
Description : Moving EC2 instance to Standby: i-95b8484f
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 50
StartTime : 11/22/2015 7:48:06 AM
StatusCode : InProgress
StatusMessage :
```
+ Pour plus de détails sur l'API, reportez-vous [EnterStandby](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Exit-ASStandby`
L'exemple de code suivant montre comment utiliser`Exit-ASStandby`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple fait sortir l’instance spécifiée du mode veille.**
```
Exit-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg
```
**Sortie** :
```
ActivityId : 1833d3e8-e32f-454e-b731-0670ad4c6934
AutoScalingGroupName : my-asg
Cause : At 2015-11-22T15:51:21Z instance i-95b8484f was moved out of standby in response to a user
request, increasing the capacity from 1 to 2.
Description : Moving EC2 instance out of Standby: i-95b8484f
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 30
StartTime : 11/22/2015 7:51:21 AM
StatusCode : PreInService
StatusMessage :
```
+ Pour plus de détails sur l'API, reportez-vous [ExitStandby](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASAccountLimit`
L'exemple de code suivant montre comment utiliser`Get-ASAccountLimit`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple décrit les limites de ressources Auto Scaling pour votre AWS compte.**
```
Get-ASAccountLimit
```
**Sortie** :
```
MaxNumberOfAutoScalingGroups : 20
MaxNumberOfLaunchConfigurations : 100
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAccountLimits](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASAdjustmentType`
L'exemple de code suivant montre comment utiliser`Get-ASAdjustmentType`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les types de réglage qui sont pris en charge par Auto Scaling.**
```
Get-ASAdjustmentType
```
**Sortie** :
```
Type
----
ChangeInCapacity
ExactCapacity
PercentChangeInCapacity
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAdjustmentTypes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASAutoScalingGroup`
L'exemple de code suivant montre comment utiliser`Get-ASAutoScalingGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les noms de vos groupes Auto Scaling.**
```
Get-ASAutoScalingGroup | format-table -property AutoScalingGroupName
```
**Sortie** :
```
AutoScalingGroupName
--------------------
my-asg-1
my-asg-2
my-asg-3
my-asg-4
my-asg-5
my-asg-6
```
**Exemple 2 : cet exemple décrit le groupe Auto Scaling spécifié.**
```
Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1
```
**Sortie** :
```
AutoScalingGroupARN : arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:930d940e-891e-4781-a11a-7b0acd480
f03:autoScalingGroupName/my-asg-1
AutoScalingGroupName : my-asg-1
AvailabilityZones : {us-west-2b, us-west-2a}
CreatedTime : 3/1/2015 9:05:31 AM
DefaultCooldown : 300
DesiredCapacity : 2
EnabledMetrics : {}
HealthCheckGracePeriod : 300
HealthCheckType : EC2
Instances : {my-lc}
LaunchConfigurationName : my-lc
LoadBalancerNames : {}
MaxSize : 0
MinSize : 0
PlacementGroup :
Status :
SuspendedProcesses : {}
Tags : {}
TerminationPolicies : {Default}
VPCZoneIdentifier : subnet-e4f33493,subnet-5264e837
```
**Exemple 3 : cet exemple décrit les deux groupes Auto Scaling spécifiés.**
```
Get-ASAutoScalingGroup -AutoScalingGroupName @("my-asg-1", "my-asg-2")
```
**Exemple 4 : cet exemple décrit les instances Auto Scaling pour le groupe Auto Scaling spécifié.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1).Instances
```
**Exemple 5 : cet exemple décrit tous vos groupes Auto Scaling.**
```
Get-ASAutoScalingGroup
```
**Exemple 6 : Cet LaunchTemplate exemple décrit le groupe Auto Scaling spécifié. Cet exemple suppose que les « Options d’achat d’instance » sont définies sur « Adhérer au modèle de lancement ». Si cette option est définie sur « Combiner les options d'achat et les types d'instances », elle est LaunchTemplate accessible à l'aide de « »MixedInstancesPolicy. LaunchTemplate« propriété.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-ag-1).LaunchTemplate
```
**Sortie** :
```
LaunchTemplateId LaunchTemplateName Version
---------------- ------------------ -------
lt-06095fd619cb40371 test-launch-template $Default
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAutoScalingGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASAutoScalingInstance`
L'exemple de code suivant montre comment utiliser`Get-ASAutoScalingInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple répertorie vos instances Auto Scaling. IDs **
```
Get-ASAutoScalingInstance | format-table -property InstanceId
```
**Sortie** :
```
InstanceId
----------
i-12345678
i-87654321
i-abcd1234
```
**Exemple 2 : cet exemple décrit l’instance Auto Scaling spécifiée.**
```
Get-ASAutoScalingInstance -InstanceId i-12345678
```
**Sortie** :
```
AutoScalingGroupName : my-asg
AvailabilityZone : us-west-2b
HealthStatus : HEALTHY
InstanceId : i-12345678
LaunchConfigurationName : my-lc
LifecycleState : InService
```
**Exemple 3 : cet exemple décrit les deux instances Auto Scaling spécifiées.**
```
Get-ASAutoScalingInstance -InstanceId @("i-12345678", "i-87654321")
```
**Exemple 4 : cet exemple décrit les instances Auto Scaling pour le groupe Auto Scaling spécifié.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-asg).Instances | Get-ASAutoScalingInstance
```
**Exemple 5 : cet exemple décrit toutes vos instances Auto Scaling.**
```
Get-ASAutoScalingInstance
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAutoScalingInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASAutoScalingNotificationType`
L'exemple de code suivant montre comment utiliser`Get-ASAutoScalingNotificationType`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les types de notification qui sont pris en charge par Auto Scaling.**
```
Get-ASAutoScalingNotificationType
```
**Sortie** :
```
autoscaling:EC2_INSTANCE_LAUNCH
autoscaling:EC2_INSTANCE_LAUNCH_ERROR
autoscaling:EC2_INSTANCE_TERMINATE
autoscaling:EC2_INSTANCE_TERMINATE_ERROR
autoscaling:TEST_NOTIFICATION
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAutoScalingNotificationTypes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASLaunchConfiguration`
L'exemple de code suivant montre comment utiliser`Get-ASLaunchConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les noms de vos configurations de lancement.**
```
Get-ASLaunchConfiguration | format-table -property LaunchConfigurationName
```
**Sortie** :
```
LaunchConfigurationName
-----------------------
my-lc-1
my-lc-2
my-lc-3
my-lc-4
my-lc-5
```
**Exemple 2 : cet exemple décrit la configuration de lancement spécifiée.**
```
Get-ASLaunchConfiguration -LaunchConfigurationName my-lc-1
```
**Sortie** :
```
AssociatePublicIpAddress : True
BlockDeviceMappings : {/dev/xvda}
ClassicLinkVPCId :
ClassicLinkVPCSecurityGroups : {}
CreatedTime : 12/12/2014 3:22:08 PM
EbsOptimized : False
IamInstanceProfile :
ImageId : ami-043a5034
InstanceMonitoring : Amazon.AutoScaling.Model.InstanceMonitoring
InstanceType : t2.micro
KernelId :
KeyName :
LaunchConfigurationARN : arn:aws:autoscaling:us-west-2:123456789012:launchConfiguration:7e5f31e4-693b-4604-9322-
e6f68d7fafad:launchConfigurationName/my-lc-1
LaunchConfigurationName : my-lc-1
PlacementTenancy :
RamdiskId :
SecurityGroups : {sg-67ef0308}
SpotPrice :
UserData :
```
**Exemple 3 : cet exemple décrit les deux configurations de lancement spécifiées.**
```
Get-ASLaunchConfiguration -LaunchConfigurationName @("my-lc-1", "my-lc-2")
```
**Exemple 4 : cet exemple décrit toutes vos configurations de lancement.**
```
Get-ASLaunchConfiguration
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLaunchConfigurations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASLifecycleHook`
L'exemple de code suivant montre comment utiliser`Get-ASLifecycleHook`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le hook de cycle de vie spécifié.**
```
Get-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook
```
**Sortie** :
```
AutoScalingGroupName : my-asg
DefaultResult : ABANDON
GlobalTimeout : 172800
HeartbeatTimeout : 3600
LifecycleHookName : myLifecycleHook
LifecycleTransition : auto-scaling:EC2_INSTANCE_LAUNCHING
NotificationMetadata :
NotificationTargetARN : arn:aws:sns:us-west-2:123456789012:my-topic
RoleARN : arn:aws:iam::123456789012:role/my-iam-role
```
**Exemple 2 : cet exemple décrit tous les hooks de cycle de vie pour le groupe Auto Scaling spécifié.**
```
Get-ASLifecycleHook -AutoScalingGroupName my-asg
```
**Exemple 3 : cet exemple décrit tous les hooks du cycle de vie pour tous vos groupes Auto Scaling.**
```
Get-ASLifecycleHook
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLifecycleHooks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASLifecycleHookType`
L'exemple de code suivant montre comment utiliser`Get-ASLifecycleHookType`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les types de hooks de cycle de vie pris en charge par Auto Scaling.**
```
Get-ASLifecycleHookType
```
**Sortie** :
```
autoscaling:EC2_INSTANCE_LAUNCHING
auto-scaling:EC2_INSTANCE_TERMINATING
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLifecycleHookTypes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASLoadBalancer`
L'exemple de code suivant montre comment utiliser`Get-ASLoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les équilibreurs de charge pour le groupe Auto Scaling spécifié.**
```
Get-ASLoadBalancer -AutoScalingGroupName my-asg
```
**Sortie** :
```
LoadBalancerName State
---------------- -----
my-lb Added
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLoadBalancers](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASMetricCollectionType`
L'exemple de code suivant montre comment utiliser`Get-ASMetricCollectionType`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les types de collecte de métriques pris en charge par Auto Scaling.**
```
(Get-ASMetricCollectionType).Metrics
```
**Sortie** :
```
Metric
------
GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupTerminatingInstances
GroupStandbyInstances
GroupTotalInstances
```
**Exemple 2 : cet exemple répertorie les granularités correspondantes.**
```
(Get-ASMetricCollectionType).Granularities
```
**Sortie** :
```
Granularity
-----------
1Minute
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMetricCollectionTypes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASNotificationConfiguration`
L'exemple de code suivant montre comment utiliser`Get-ASNotificationConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les actions de notification associées au groupe Auto Scaling spécifié.**
```
Get-ASNotificationConfiguration -AutoScalingGroupName my-asg | format-list
```
**Sortie** :
```
AutoScalingGroupName : my-asg
NotificationType : auto-scaling:EC2_INSTANCE_LAUNCH
TopicARN : arn:aws:sns:us-west-2:123456789012:my-topic
AutoScalingGroupName : my-asg
NotificationType : auto-scaling:EC2_INSTANCE_TERMINATE
TopicARN : arn:aws:sns:us-west-2:123456789012:my-topic
```
**Exemple 2 : cet exemple décrit les actions de notification associées à tous vos groupes Auto Scaling.**
```
Get-ASNotificationConfiguration
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeNotificationConfigurations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASPolicy`
L'exemple de code suivant montre comment utiliser`Get-ASPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit toutes les stratégies pour le groupe Auto Scaling spécifié.**
```
Get-ASPolicy -AutoScalingGroupName my-asg
```
**Sortie** :
```
AdjustmentType : ChangeInCapacity
Alarms : {}
AutoScalingGroupName : my-asg
Cooldown : 0
EstimatedInstanceWarmup : 0
MetricAggregationType :
MinAdjustmentMagnitude : 0
MinAdjustmentStep : 0
PolicyARN : arn:aws:auto-scaling:us-west-2:123456789012:scalingPolicy:aa3836ab-5462-42c7-adab-e1d769fc24ef
:autoScalingGroupName/my-asg:policyName/myScaleInPolicy
PolicyName : myScaleInPolicy
PolicyType : SimpleScaling
ScalingAdjustment : -1
StepAdjustments : {}
```
**Exemple 2 : cet exemple décrit les stratégies spécifiées pour le groupe Auto Scaling spécifié.**
```
Get-ASPolicy -AutoScalingGroupName my-asg -PolicyName @("myScaleOutPolicy", "myScaleInPolicy")
```
**Exemple 3 : cet exemple décrit toutes les politiques pour tous vos groupes Auto Scaling.**
```
Get-ASPolicy
```
+ Pour plus de détails sur l'API, reportez-vous [DescribePolicies](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASScalingActivity`
L'exemple de code suivant montre comment utiliser`Get-ASScalingActivity`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les activités de mise à l’échelle des six dernières semaines pour le groupe Auto Scaling spécifié.**
```
Get-ASScalingActivity -AutoScalingGroupName my-asg
```
**Sortie** :
```
ActivityId : 063308ae-aa22-4a9b-94f4-9fae4EXAMPLE
AutoScalingGroupName : my-asg
Cause : At 2015-11-22T15:45:16Z a user request explicitly set group desired capacity changing the desired
capacity from 1 to 2. At 2015-11-22T15:45:34Z an instance was started in response to a difference
between desired and actual capacity, increasing the capacity from 1 to 2.
Description : Launching a new EC2 instance: i-26e715fc
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime : 11/22/2015 7:46:09 AM
Progress : 100
StartTime : 11/22/2015 7:45:35 AM
StatusCode : Successful
StatusMessage :
ActivityId : ce719997-086d-4c73-a2f1-ab703EXAMPLE
AutoScalingGroupName : my-asg
Cause : At 2015-11-20T22:57:53Z a user request created an AutoScalingGroup changing the desired capacity
from 0 to 1. At 2015-11-20T22:57:58Z an instance was started in response to a difference betwe
en desired and actual capacity, increasing the capacity from 0 to 1.
Description : Launching a new EC2 instance: i-93633f9b
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime : 11/20/2015 2:58:32 PM
Progress : 100
StartTime : 11/20/2015 2:57:59 PM
StatusCode : Successful
StatusMessage :
```
**Exemple 2 : cet exemple décrit l’activité de mise à l’échelle spécifiée.**
```
Get-ASScalingActivity -ActivityId "063308ae-aa22-4a9b-94f4-9fae4EXAMPLE"
```
**Exemple 3 : cet exemple décrit les activités de mise à l’échelle des six dernières semaines pour tous vos groupes Auto Scaling.**
```
Get-ASScalingActivity
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScalingActivities](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASScalingProcessType`
L'exemple de code suivant montre comment utiliser`Get-ASScalingProcessType`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les types de processus pris en charge par Auto Scaling.**
```
Get-ASScalingProcessType
```
**Sortie** :
```
ProcessName
-----------
AZRebalance
AddToLoadBalancer
AlarmNotification
HealthCheck
Launch
ReplaceUnhealthy
ScheduledActions
Terminate
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScalingProcessTypes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASScheduledAction`
L'exemple de code suivant montre comment utiliser`Get-ASScheduledAction`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les actions de mise à l’échelle planifiées pour le groupe Auto Scaling spécifié.**
```
Get-ASScheduledAction -AutoScalingGroupName my-asg
```
**Sortie** :
```
AutoScalingGroupName : my-asg
DesiredCapacity : 10
EndTime :
MaxSize :
MinSize :
Recurrence :
ScheduledActionARN : arn:aws:autoscaling:us-west-2:123456789012:scheduledUpdateGroupAction:8a4c5f24-6ec6-4306-a2dd-f7
2c3af3a4d6:autoScalingGroupName/my-asg:scheduledActionName/myScheduledAction
ScheduledActionName : myScheduledAction
StartTime : 11/30/2015 8:00:00 AM
Time : 11/30/2015 8:00:00 AM
```
**Exemple 2 : cet exemple décrit les actions de mise à l’échelle planifiées spécifiées.**
```
Get-ASScheduledAction -ScheduledActionName @("myScheduledScaleOut", "myScheduledScaleIn")
```
**Exemple 3 : cet exemple décrit les actions de mise à l’échelle planifiées qui commencent à l’heure spécifiée.**
```
Get-ASScheduledAction -StartTime "2015-12-01T08:00:00Z"
```
**Exemple 4 : cet exemple décrit les actions de mise à l’échelle planifiées qui se terminent à l’heure spécifiée.**
```
Get-ASScheduledAction -EndTime "2015-12-30T08:00:00Z"
```
**Exemple 5 : cet exemple décrit les actions de mise à l’échelle planifiées pour tous vos groupes Auto Scaling.**
```
Get-ASScheduledAction
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScheduledActions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASTag`
L'exemple de code suivant montre comment utiliser`Get-ASTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les balises dont la valeur clé est « myTag » ou « myTag2 ». Les valeurs possibles pour le nom du filtre sont auto-scaling-group « », « key », « value » et « propagate-at-launch ». La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } )
```
**Sortie** :
```
Key : myTag2
PropagateAtLaunch : True
ResourceId : my-asg
ResourceType : auto-scaling-group
Value : myTagValue2
Key : myTag
PropagateAtLaunch : True
ResourceId : my-asg
ResourceType : auto-scaling-group
Value : myTagValue
```
**Exemple 2 : avec PowerShell la version 2, vous devez utiliser New-Object pour créer le filtre pour le paramètre Filter.**
```
$keys = New-Object string[] 2
$keys[0] = "myTag"
$keys[1] = "myTag2"
$filter = New-Object Amazon.AutoScaling.Model.Filter
$filter.Name = "key"
$filter.Values = $keys
Get-ASTag -Filter @( $filter )
```
**Exemple 3 : cet exemple décrit toutes les balises pour tous vos groupes Auto Scaling.**
```
Get-ASTag
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASTerminationPolicyType`
L'exemple de code suivant montre comment utiliser`Get-ASTerminationPolicyType`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les politiques de résiliation prises en charge par Auto Scaling.**
```
Get-ASTerminationPolicyType
```
**Sortie** :
```
ClosestToNextInstanceHour
Default
NewestInstance
OldestInstance
OldestLaunchConfiguration
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTerminationPolicyTypes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Mount-ASInstance`
L'exemple de code suivant montre comment utiliser`Mount-ASInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple attache l’instance spécifiée au groupe Auto Scaling spécifié. Auto Scaling augmente automatiquement la capacité souhaitée du groupe Auto Scaling.**
```
Mount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [AttachInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ASAutoScalingGroup`
L'exemple de code suivant montre comment utiliser`New-ASAutoScalingGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un groupe Auto Scaling avec le nom et les attributs spécifiés. La capacité souhaitée par défaut est la taille minimale. Par conséquent, ce groupe Auto Scaling lance deux instances, une dans chacune des deux zones de disponibilité spécifiées.**
```
New-ASAutoScalingGroup -AutoScalingGroupName my-asg -LaunchConfigurationName my-lc -MinSize 2 -MaxSize 6 -AvailabilityZone @("us-west-2a", "us-west-2b")
```
+ Pour plus de détails sur l'API, reportez-vous [CreateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ASLaunchConfiguration`
L'exemple de code suivant montre comment utiliser`New-ASLaunchConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une configuration de lancement nommée « my-lc ». Les instances EC2 lancées par les groupes Auto Scaling qui utilisent cette configuration de lancement utilisent le type d’instance, l’AMI, le groupe de sécurité et le rôle IAM spécifiés.**
```
New-ASLaunchConfiguration -LaunchConfigurationName my-lc -InstanceType "m3.medium" -ImageId "ami-12345678" -SecurityGroup "sg-12345678" -IamInstanceProfile "myIamRole"
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLaunchConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ASAutoScalingGroup`
L'exemple de code suivant montre comment utiliser`Remove-ASAutoScalingGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le groupe Auto Scaling spécifié s’il ne possède aucune instance en cours d’exécution. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASAutoScalingGroup (DeleteAutoScalingGroup)" on Target "my-asg".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -Force
```
**Exemple 3 : cet exemple supprime le groupe Auto Scaling spécifié et résilie toutes les instances en cours d’exécution qu’il contient.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -ForceDelete $true -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteAutoScalingGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ASLaunchConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-ASLaunchConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la configuration de lancement spécifiée si elle n’est pas attachée à un groupe Auto Scaling. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASLaunchConfiguration (DeleteLaunchConfiguration)" on Target "my-lc".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLaunchConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ASLifecycleHook`
L'exemple de code suivant montre comment utiliser`Remove-ASLifecycleHook`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le hook de cycle de vie spécifié pour le groupe Auto Scaling spécifié. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASLifecycleHook (DeleteLifecycleHook)" on Target "myLifecycleHook".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLifecycleHook](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ASNotificationConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-ASNotificationConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’action de notification spécifiée. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASNotificationConfiguration (DeleteNotificationConfiguration)" on Target
"arn:aws:sns:us-west-2:123456789012:my-topic".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic" -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteNotificationConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ASPolicy`
L'exemple de code suivant montre comment utiliser`Remove-ASPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la politique spécifiée pour le groupe Auto Scaling spécifié. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASPolicy (DeletePolicy)" on Target "myScaleInPolicy".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeletePolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ASScheduledAction`
L'exemple de code suivant montre comment utiliser`Remove-ASScheduledAction`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’action planifiée spécifiée pour le groupe Auto Scaling spécifié. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction"
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ASScheduledAction (DeleteScheduledAction)" on Target "myScheduledAction".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction" -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteScheduledAction](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ASTag`
L'exemple de code suivant montre comment utiliser`Remove-ASTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la balise spécifiée du groupe Auto Scaling spécifié. Vous êtes invité à confirmer avant que l’opération ne se poursuive. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } )
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ASTag (DeleteTags)" on target "Amazon.AutoScaling.Model.Tag".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : si vous spécifiez le paramètre Force, aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } ) -Force
```
**Exemple 3 : avec PowerShell version 2, vous devez utiliser New-Object pour créer la balise pour le paramètre Balise.**
```
$tag = New-Object Amazon.AutoScaling.Model.Tag
$tag.ResourceType = "auto-scaling-group"
$tag.ResourceId = "my-asg"
$tag.Key = "myTag"
Remove-ASTag -Tag $tag -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Resume-ASProcess`
L'exemple de code suivant montre comment utiliser`Resume-ASProcess`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple reprend le processus Auto Scaling spécifié pour le groupe Auto Scaling spécifié.**
```
Resume-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification"
```
**Exemple 2 : cet exemple reprend tous les processus Auto Scaling suspendus pour le groupe Auto Scaling spécifié.**
```
Resume-ASProcess -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [ResumeProcesses](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ASDesiredCapacity`
L'exemple de code suivant montre comment utiliser`Set-ASDesiredCapacity`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple définit la taille du groupe Auto Scaling spécifié.**
```
Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2
```
**Exemple 2 : cet exemple définit la taille du groupe Auto Scaling spécifié et attend la fin du temps de stabilisation avant de le mettre à la nouvelle taille.**
```
Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2 -HonorCooldown $true
```
+ Pour plus de détails sur l'API, reportez-vous [SetDesiredCapacity](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ASInstanceHealth`
L'exemple de code suivant montre comment utiliser`Set-ASInstanceHealth`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple définit le statut de l’instance spécifiée sur « Non fonctionnelle », la mettant hors service. Auto Scaling résilie l’instance et la remplace.**
```
Set-ASInstanceHealth -HealthStatus Unhealthy -InstanceId i-93633f9b
```
**Exemple 2 : cet exemple définit le statut de l’instance spécifiée sur « Saine », afin de la maintenir en service. Aucune période de grâce de la surveillance de l’état pour le groupe Auto Scaling n’est respectée.**
```
Set-ASInstanceHealth -HealthStatus Healthy -InstanceId i-93633f9b -ShouldRespectGracePeriod $false
```
+ Pour plus de détails sur l'API, reportez-vous [SetInstanceHealth](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ASInstanceProtection`
L'exemple de code suivant montre comment utiliser`Set-ASInstanceProtection`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active la protection de l’instance pour l’instance spécifiée.**
```
Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $true
```
**Exemple 2 : cet exemple désactive la protection d’instance pour l’instance spécifiée.**
```
Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $false
```
+ Pour plus de détails sur l'API, reportez-vous [SetInstanceProtection](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ASTag`
L'exemple de code suivant montre comment utiliser`Set-ASTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute une balise unique au groupe Auto Scaling spécifié. La clé de balise est « MyTag » et la valeur de la balise est « myTagValue ». Auto Scaling propage cette balise aux instances EC2 suivantes lancées par le groupe Auto Scaling. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
Set-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag"; Value="myTagValue"; PropagateAtLaunch=$true} )
```
**Exemple 2 : avec PowerShell la version 2, vous devez utiliser New-Object pour créer la balise pour le paramètre Tag.**
```
$tag = New-Object Amazon.AutoScaling.Model.Tag
$tag.ResourceType = "auto-scaling-group"
$tag.ResourceId = "my-asg"
$tag.Key = "myTag"
$tag.Value = "myTagValue"
$tag.PropagateAtLaunch = $true
Set-ASTag -Tag $tag
```
+ Pour plus de détails sur l'API, reportez-vous [CreateOrUpdateTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Start-ASPolicy`
L'exemple de code suivant montre comment utiliser`Start-ASPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple exécute la politique spécifiée pour le groupe Auto Scaling spécifié.**
```
Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy"
```
**Exemple 2 : cet exemple exécute la politique spécifiée pour le groupe Auto Scaling spécifié, après avoir attendu la fin du temps de stabilisation.**
```
Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy" -HonorCooldown $true
```
+ Pour plus de détails sur l'API, reportez-vous [ExecutePolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-ASInstanceInAutoScalingGroup`
L'exemple de code suivant montre comment utiliser`Stop-ASInstanceInAutoScalingGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple résilie l’instance spécifiée et réduit la capacité souhaitée de son groupe Auto Scaling afin qu’Auto Scaling ne lance pas d’instance de remplacement.**
```
Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $true
```
**Sortie** :
```
ActivityId : 2e40d9bd-1902-444c-abf3-6ea0002efdc5
AutoScalingGroupName :
Cause : At 2015-11-22T16:09:03Z instance i-93633f9b was taken out of service in response to a user
request, shrinking the capacity from 2 to 1.
Description : Terminating EC2 instance: i-93633f9b
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 0
StartTime : 11/22/2015 8:09:03 AM
StatusCode : InProgress
StatusMessage :
```
**Exemple 2 : cet exemple résilie l’instance spécifiée sans réduire la capacité souhaitée de son groupe Auto Scaling. Auto Scaling lance une instance de remplacement.**
```
Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $false
```
**Sortie** :
```
ActivityId : 2e40d9bd-1902-444c-abf3-6ea0002efdc5
AutoScalingGroupName :
Cause : At 2015-11-22T16:09:03Z instance i-93633f9b was taken out of service in response to a user
request.
Description : Terminating EC2 instance: i-93633f9b
Details : {"Availability Zone":"us-west-2b","Subnet ID":"subnet-5264e837"}
EndTime :
Progress : 0
StartTime : 11/22/2015 8:09:03 AM
StatusCode : InProgress
StatusMessage :
```
+ Pour plus de détails sur l'API, reportez-vous [TerminateInstanceInAutoScalingGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Suspend-ASProcess`
L'exemple de code suivant montre comment utiliser`Suspend-ASProcess`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple suspend le processus Auto Scaling spécifié pour le groupe Auto Scaling spécifié.**
```
Suspend-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification"
```
**Exemple 2 : cet exemple suspend tous les processus Auto Scaling pour le groupe Auto Scaling spécifié.**
```
Suspend-ASProcess -AutoScalingGroupName my-asg
```
+ Pour plus de détails sur l'API, reportez-vous [SuspendProcesses](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-ASAutoScalingGroup`
L'exemple de code suivant montre comment utiliser`Update-ASAutoScalingGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la taille minimale et maximale du groupe Auto Scaling spécifié.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -MaxSize 5 -MinSize 1
```
**Exemple 2 : cet exemple met à jour le temps de stabilisation par défaut du groupe Auto Scaling spécifié.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -DefaultCooldown 10
```
**Exemple 3 : cet exemple met à jour les zones de disponibilité du groupe Auto Scaling spécifié.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -AvailabilityZone @("us-west-2a", "us-west-2b")
```
**Exemple 4 : cet exemple met à jour le groupe Auto Scaling spécifié pour utiliser les surveillances de l’état Elastic Load Balancing.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -HealthCheckType ELB -HealthCheckGracePeriod 60
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateAutoScalingGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-ASLifecycleActionHeartbeat`
L'exemple de code suivant montre comment utiliser`Write-ASLifecycleActionHeartbeat`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre une pulsation pour l’action du cycle de vie spécifiée. Cela permet de maintenir l’instance en attente jusqu’à ce que vous ayez terminé l’action personnalisée.**
```
Write-ASLifecycleActionHeartbeat -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635
```
+ Pour plus de détails sur l'API, reportez-vous [RecordLifecycleActionHeartbeat](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-ASLifecycleHook`
L'exemple de code suivant montre comment utiliser`Write-ASLifecycleHook`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute le hook de cycle de vie spécifié au groupe Auto Scaling spécifié.**
```
Write-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName "myLifecycleHook" -LifecycleTransition "autoscaling:EC2_INSTANCE_LAUNCHING" -NotificationTargetARN "arn:aws:sns:us-west-2:123456789012:my-sns-topic" -RoleARN "arn:aws:iam::123456789012:role/my-iam-role"
```
+ Pour plus de détails sur l'API, reportez-vous [PutLifecycleHook](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-ASNotificationConfiguration`
L'exemple de code suivant montre comment utiliser`Write-ASNotificationConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple configure le groupe Auto Scaling spécifié pour envoyer une notification à la rubrique SNS spécifiée lorsqu’il lance des instances EC2.**
```
Write-ASNotificationConfiguration -AutoScalingGroupName my-asg -NotificationType "autoscaling:EC2_INSTANCE_LAUNCH" -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
**Exemple 2 : cet exemple configure le groupe Auto Scaling spécifié pour envoyer une notification à la rubrique SNS spécifiée lorsqu’il lance ou résilie des instances EC2.**
```
Write-ASNotificationConfiguration -AutoScalingGroupName my-asg -NotificationType @("autoscaling:EC2_INSTANCE_LAUNCH", "autoscaling:EC2_INSTANCE_TERMINATE") -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
+ Pour plus de détails sur l'API, reportez-vous [PutNotificationConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-ASScalingPolicy`
L'exemple de code suivant montre comment utiliser`Write-ASScalingPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute la politique spécifiée au groupe Auto Scaling spécifié. Le type de réglage spécifié détermine la manière d'interpréter le ScalingAdjustment paramètre. Avec « ChangeInCapacity », une valeur positive augmente la capacité du nombre d'instances spécifié et une valeur négative diminue la capacité du nombre d'instances spécifié.**
```
Write-ASScalingPolicy -AutoScalingGroupName my-asg -AdjustmentType "ChangeInCapacity" -PolicyName "myScaleInPolicy" -ScalingAdjustment -1
```
**Sortie** :
```
arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:aa3836ab-5462-42c7-adab-e1d769fc24ef:autoScalingGroupName/my-asg
:policyName/myScaleInPolicy
```
+ Pour plus de détails sur l'API, reportez-vous [PutScalingPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-ASScheduledUpdateGroupAction`
L'exemple de code suivant montre comment utiliser`Write-ASScheduledUpdateGroupAction`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée ou met à jour une action planifiée unique pour modifier la capacité souhaitée à l’heure de début spécifiée.**
```
Write-ASScheduledUpdateGroupAction -AutoScalingGroupName my-asg -ScheduledActionName "myScheduledAction" -StartTime "2015-12-01T00:00:00Z" -DesiredCapacity 10
```
+ Pour plus de détails sur l'API, reportez-vous [PutScheduledUpdateGroupAction](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# AWS Budgets exemples utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec AWS Budgets.
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
### `New-BGTBudget`
L'exemple de code suivant montre comment utiliser`New-BGTBudget`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un nouveau budget avec les contraintes budgétaires et temporelles spécifiées avec des notifications par e-mail.**
```
$notification = @{
NotificationType = "ACTUAL"
ComparisonOperator = "GREATER_THAN"
Threshold = 80
}
$addressObject = @{
Address = @("user@domain.com")
SubscriptionType = "EMAIL"
}
$subscriber = New-Object Amazon.Budgets.Model.NotificationWithSubscribers
$subscriber.Notification = $notification
$subscriber.Subscribers.Add($addressObject)
$startDate = [datetime]::new(2017,09,25)
$endDate = [datetime]::new(2017,10,25)
New-BGTBudget -Budget_BudgetName "Tester" -Budget_BudgetType COST -CostTypes_IncludeTax $true -Budget_TimeUnit MONTHLY -BudgetLimit_Unit USD -TimePeriod_Start $startDate -TimePeriod_End $endDate -AccountId 123456789012 -BudgetLimit_Amount 200 -NotificationsWithSubscriber $subscriber
```
+ Pour plus de détails sur l'API, reportez-vous [CreateBudget](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# AWS Cloud9 exemples utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec AWS Cloud9.
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
### `Get-C9EnvironmentData`
L'exemple de code suivant montre comment utiliser`Get-C9EnvironmentData`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple permet d'obtenir des informations sur les environnements de développement AWS Cloud9 spécifiés.**
```
Get-C9EnvironmentData -EnvironmentId 685f892f431b45c2b28cb69eadcdb0EX,1980b80e5f584920801c09086667f0EX
```
**Sortie** :
```
Arn : arn:aws:cloud9:us-east-1:123456789012:environment:685f892f431b45c2b28cb69eadcdb0EX
Description : Created from CodeStar.
Id : 685f892f431b45c2b28cb69eadcdb0EX
Lifecycle : Amazon.Cloud9.Model.EnvironmentLifecycle
Name : my-demo-ec2-env
OwnerArn : arn:aws:iam::123456789012:user/MyDemoUser
Type : ec2
Arn : arn:aws:cloud9:us-east-1:123456789012:environment:1980b80e5f584920801c09086667f0EX
Description :
Id : 1980b80e5f584920801c09086667f0EX
Lifecycle : Amazon.Cloud9.Model.EnvironmentLifecycle
Name : my-demo-ssh-env
OwnerArn : arn:aws:iam::123456789012:user/MyDemoUser
Type : ssh
```
**Exemple 2 : Cet exemple permet d'obtenir des informations sur l'état du cycle de vie de l'environnement de développement AWS Cloud9 spécifié.**
```
(Get-C9EnvironmentData -EnvironmentId 685f892f431b45c2b28cb69eadcdb0EX).Lifecycle
```
**Sortie** :
```
FailureResource Reason Status
--------------- ------ ------
CREATED
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEnvironments](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-C9EnvironmentList`
L'exemple de code suivant montre comment utiliser`Get-C9EnvironmentList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple permet d'obtenir une liste des identifiants d'environnement de développement AWS Cloud9 disponibles.**
```
Get-C9EnvironmentList
```
**Sortie** :
```
685f892f431b45c2b28cb69eadcdb0EX
1980b80e5f584920801c09086667f0EX
```
+ Pour plus de détails sur l'API, reportez-vous [ListEnvironments](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-C9EnvironmentMembershipList`
L'exemple de code suivant montre comment utiliser`Get-C9EnvironmentMembershipList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple permet d'obtenir des informations sur les membres de l'environnement de développement AWS Cloud9 spécifié.**
```
Get-C9EnvironmentMembershipList -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
**Sortie** :
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : read-write
UserArn : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId : AIDAJ3BA6O2FMJWCWXHEX
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : owner
UserArn : arn:aws:iam::123456789012:user/MyDemoUser
UserId : AIDAJ3LOROMOUXTBSU6EX
```
**Exemple 2 : Cet exemple permet d'obtenir des informations sur le propriétaire de l'environnement de développement AWS Cloud9 spécifié.**
```
Get-C9EnvironmentMembershipList -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission owner
```
**Sortie** :
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : owner
UserArn : arn:aws:iam::123456789012:user/MyDemoUser
UserId : AIDAJ3LOROMOUXTBSU6EX
```
**Exemple 3 : Cet exemple permet d'obtenir des informations sur le membre d'environnement spécifié pour plusieurs environnements de développement AWS Cloud9.**
```
Get-C9EnvironmentMembershipList -UserArn arn:aws:iam::123456789012:user/MyDemoUser
```
**Sortie** :
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/17/2018 7:48:14 PM
Permissions : owner
UserArn : arn:aws:iam::123456789012:user/MyDemoUser
UserId : AIDAJ3LOROMOUXTBSU6EX
EnvironmentId : 1980b80e5f584920801c09086667f0EX
LastAccess : 1/16/2018 11:21:24 PM
Permissions : owner
UserArn : arn:aws:iam::123456789012:user/MyDemoUser
UserId : AIDAJ3LOROMOUXTBSU6EX
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEnvironmentMemberships](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-C9EnvironmentStatus`
L'exemple de code suivant montre comment utiliser`Get-C9EnvironmentStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple obtient des informations d'état pour l'environnement de développement AWS Cloud9 spécifié.**
```
Get-C9EnvironmentStatus -EnvironmentId 349c86d4579e4e7298d500ff57a6b2EX
```
**Sortie** :
```
Message Status
------- ------
Environment is ready to use ready
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEnvironmentStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-C9EnvironmentEC2`
L'exemple de code suivant montre comment utiliser`New-C9EnvironmentEC2`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un environnement de développement AWS Cloud9 avec les paramètres spécifiés, lance une instance Amazon Elastic Compute Cloud (Amazon EC2), puis se connecte de l'instance à l'environnement.**
```
New-C9EnvironmentEC2 -Name my-demo-env -AutomaticStopTimeMinutes 60 -Description "My demonstration development environment." -InstanceType t2.micro -OwnerArn arn:aws:iam::123456789012:user/MyDemoUser -SubnetId subnet-d43a46EX
```
**Sortie** :
```
ffd88420d4824eeeaeaa8a04bfde8cEX
```
+ Pour plus de détails sur l'API, reportez-vous à la section [CreateEnvironmentEc2](https://docs.aws.amazon.com/powershell/v4/reference) du *Outils AWS pour PowerShell manuel Cmdlet Reference (V4)*.
### `New-C9EnvironmentMembership`
L'exemple de code suivant montre comment utiliser`New-C9EnvironmentMembership`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple ajoute le membre d'environnement spécifié à l'environnement de développement AWS Cloud9 spécifié.**
```
New-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission read-write
```
**Sortie** :
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : read-write
UserArn : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId : AIDAJ3BA6O2FMJWCWXHEX
```
+ Pour plus de détails sur l'API, reportez-vous [CreateEnvironmentMembership](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-C9Environment`
L'exemple de code suivant montre comment utiliser`Remove-C9Environment`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime l'environnement de développement AWS Cloud9 spécifié. Si une instance Amazon EC2 est connectée à l’environnement, l’instance est également résiliée.**
```
Remove-C9Environment -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteEnvironment](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-C9EnvironmentMembership`
L'exemple de code suivant montre comment utiliser`Remove-C9EnvironmentMembership`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime le membre d'environnement spécifié de l'environnement de développement AWS Cloud9 spécifié.**
```
Remove-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteEnvironmentMembership](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-C9Environment`
L'exemple de code suivant montre comment utiliser`Update-C9Environment`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple modifie les paramètres spécifiés de l'environnement de développement AWS Cloud9 existant spécifié.**
```
Update-C9Environment -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Description "My changed demonstration development environment." -Name my-changed-demo-env
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateEnvironment](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-C9EnvironmentMembership`
L'exemple de code suivant montre comment utiliser`Update-C9EnvironmentMembership`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple modifie les paramètres du membre d'environnement existant spécifié pour l'environnement de développement AWS Cloud9 spécifié.**
```
Update-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission read-only
```
**Sortie** :
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : read-only
UserArn : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId : AIDAJ3BA6O2FMJWCWXHEX
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateEnvironmentMembership](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# CloudFormation exemples utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec CloudFormation.
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
### `Get-CFNStack`
L'exemple de code suivant montre comment utiliser`Get-CFNStack`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie une collection d’instances Stack décrivant toutes les piles de l’utilisateur.**
```
Get-CFNStack
```
**Exemple 2 : renvoie une instance Stack décrivant la pile spécifiée**
```
Get-CFNStack -StackName "myStack"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeStacks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFNStackEvent`
L'exemple de code suivant montre comment utiliser`Get-CFNStackEvent`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie tous les événements associés à une pile spécifiée.**
```
Get-CFNStackEvent -StackName "myStack"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeStackEvents](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFNStackResource`
L'exemple de code suivant montre comment utiliser`Get-CFNStackResource`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie la description d'une ressource identifiée dans le modèle associé à la pile spécifiée par l'identifiant logique DBInstance « My ».**
```
Get-CFNStackResource -StackName "myStack" -LogicalResourceId "MyDBInstance"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeStackResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFNStackResourceList`
L'exemple de code suivant montre comment utiliser`Get-CFNStackResourceList`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les descriptions de AWS ressources pour un maximum de 100 ressources associées à la pile spécifiée. Pour obtenir des informations détaillées sur toutes les ressources associées à une pile, utilisez le Get- CFNStackResourceSummary, qui prend également en charge la pagination manuelle des résultats.**
```
Get-CFNStackResourceList -StackName "myStack"
```
**Exemple 2 : renvoie la description de l’instance Amazon EC2 identifiée dans le modèle associé à la pile spécifiée par l’ID logique « Ec2Instance ».**
```
Get-CFNStackResourceList -StackName "myStack" -LogicalResourceId "Ec2Instance"
```
**Exemple 3 : renvoie la description d’un maximum de 100 ressources associées à la pile contenant une instance Amazon EC2 identifiée par l’ID d’instance « i-123456 ». Pour obtenir des informations détaillées sur toutes les ressources associées à une pile, utilisez le Get- CFNStackResourceSummary, qui prend également en charge la pagination manuelle des résultats.**
```
Get-CFNStackResourceList -PhysicalResourceId "i-123456"
```
**Exemple 4 : renvoie la description de l’instance Amazon EC2 identifiée par l’ID logique « Ec2Instance » dans le modèle pour une pile. La pile est identifiée à l’aide de l’ID de ressource physique d’une ressource qu’elle contient, dans ce cas également une instance Amazon EC2 avec l’ID d’instance « i-123456 ». Une ressource physique différente peut également être utilisée pour identifier la pile en fonction du contenu du modèle, par exemple un compartiment Amazon S3.**
```
Get-CFNStackResourceList -PhysicalResourceId "i-123456" -LogicalResourceId "Ec2Instance"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeStackResources](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFNStackResourceSummary`
L'exemple de code suivant montre comment utiliser`Get-CFNStackResourceSummary`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les descriptions de toutes les ressources associées à la pile spécifiée.**
```
Get-CFNStackResourceSummary -StackName "myStack"
```
+ Pour plus de détails sur l'API, reportez-vous [ListStackResources](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFNStackSummary`
L'exemple de code suivant montre comment utiliser`Get-CFNStackSummary`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie des informations récapitulatives pour toutes les piles.**
```
Get-CFNStackSummary
```
**Exemple 2 : renvoie des informations récapitulatives pour toutes les piles en cours de création.**
```
Get-CFNStackSummary -StackStatusFilter "CREATE_IN_PROGRESS"
```
**Exemple 3 : renvoie des informations récapitulatives pour toutes les piles en cours de création ou de mise à jour.**
```
Get-CFNStackSummary -StackStatusFilter @("CREATE_IN_PROGRESS", "UPDATE_IN_PROGRESS")
```
+ Pour plus de détails sur l'API, reportez-vous [ListStacks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFNTemplate`
L'exemple de code suivant montre comment utiliser`Get-CFNTemplate`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie le modèle associé à la pile spécifiée.**
```
Get-CFNTemplate -StackName "myStack"
```
+ Pour plus de détails sur l'API, reportez-vous [GetTemplate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Measure-CFNTemplateCost`
L'exemple de code suivant montre comment utiliser`Measure-CFNTemplateCost`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie l'URL d'un calculateur mensuel AWS simple avec une chaîne de requête qui décrit les ressources nécessaires pour exécuter le modèle. Le modèle est obtenu à partir de l’URL Amazon S3 spécifiée et du seul paramètre de personnalisation appliqué. Le paramètre peut également être spécifié en utilisant « Key » et « Value » au lieu de ParameterKey « » et « ParameterValue ».**
```
Measure-CFNTemplateCost -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
-Region us-west-1 `
-Parameter @{ ParameterKey="KeyName"; ParameterValue="myKeyPairName" }
```
**Exemple 2 : renvoie l'URL d'un calculateur mensuel AWS simple avec une chaîne de requête qui décrit les ressources nécessaires pour exécuter le modèle. Le modèle est analysé à partir du contenu fourni et des paramètres de personnalisation appliqués (cet exemple suppose que le contenu du modèle aurait déclaré deux paramètres, « KeyName » et « InstanceType »). Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de ParameterKey « » et « ParameterValue ».**
```
Measure-CFNTemplateCost -TemplateBody "{TEMPLATE CONTENT HERE}" `
-Parameter @( @{ ParameterKey="KeyName"; ParameterValue="myKeyPairName" },`
@{ ParameterKey="InstanceType"; ParameterValue="m1.large" })
```
**Exemple 3 : Utilise New-Object pour créer l'ensemble des paramètres du modèle et renvoie une URL de calculateur mensuel AWS simple avec une chaîne de requête qui décrit les ressources requises pour exécuter le modèle. Le modèle est analysé à partir du contenu fourni, avec des paramètres de personnalisation (cet exemple suppose que le contenu du modèle aurait déclaré deux paramètres, « KeyName » et « InstanceType »).**
```
$p1 = New-Object -Type Amazon.CloudFormation.Model.Parameter
$p1.ParameterKey = "KeyName"
$p1.ParameterValue = "myKeyPairName"
$p2 = New-Object -Type Amazon.CloudFormation.Model.Parameter
$p2.ParameterKey = "InstanceType"
$p2.ParameterValue = "m1.large"
Measure-CFNTemplateCost -TemplateBody "{TEMPLATE CONTENT HERE}" -Parameter @( $p1, $p2 )
```
+ Pour plus de détails sur l'API, reportez-vous [EstimateTemplateCost](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CFNStack`
L'exemple de code suivant montre comment utiliser`New-CFNStack`.
**Outils pour PowerShell V4**
**Exemple 1 : crée une nouvelle pile avec le nom spécifié. Le modèle est analysé à partir du contenu fourni avec des paramètres de personnalisation (PK1« » et « PK2 » représentent les noms des paramètres déclarés dans le contenu du modèle, « PV1 » et « PV2 » représentent les valeurs de ces paramètres. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de ParameterKey « » et « ParameterValue ». Si la création de la pile échoue, elle ne sera pas annulée.**
```
New-CFNStack -StackName "myStack" `
-TemplateBody "{TEMPLATE CONTENT HERE}" `
-Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" }) `
-DisableRollback $true
```
**Exemple 2 : crée une nouvelle pile avec le nom spécifié. Le modèle est analysé à partir du contenu fourni avec des paramètres de personnalisation (PK1« » et « PK2 » représentent les noms des paramètres déclarés dans le contenu du modèle, « PV1 » et « PV2 » représentent les valeurs de ces paramètres. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de ParameterKey « » et « ParameterValue ». Si la création de la pile échoue, elle sera annulée.**
```
$p1 = New-Object -Type Amazon.CloudFormation.Model.Parameter
$p1.ParameterKey = "PK1"
$p1.ParameterValue = "PV1"
$p2 = New-Object -Type Amazon.CloudFormation.Model.Parameter
$p2.ParameterKey = "PK2"
$p2.ParameterValue = "PV2"
New-CFNStack -StackName "myStack" `
-TemplateBody "{TEMPLATE CONTENT HERE}" `
-Parameter @( $p1, $p2 ) `
-OnFailure "ROLLBACK"
```
**Exemple 3 : crée une nouvelle pile avec le nom spécifié. Le modèle est obtenu à partir de l'URL Amazon S3 avec des paramètres de personnalisation (PK1« » représente le nom d'un paramètre déclaré dans le contenu du modèle, PV1 « » représente la valeur du paramètre. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de ParameterKey « » et « ParameterValue ». Si la création de la pile échoue, elle sera annulée (comme si vous spécifiez - DisableRollback \$1false).**
```
New-CFNStack -StackName "myStack" `
-TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
-Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }
```
**Exemple 4 : crée une nouvelle pile avec le nom spécifié. Le modèle est obtenu à partir de l'URL Amazon S3 avec des paramètres de personnalisation (PK1« » représente le nom d'un paramètre déclaré dans le contenu du modèle, PV1 « » représente la valeur du paramètre. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de ParameterKey « » et « ParameterValue ». Si la création de la pile échoue, elle sera annulée (comme si vous spécifiez - DisableRollback \$1false). La notification spécifiée AENs recevra les événements publiés liés à la pile.**
```
New-CFNStack -StackName "myStack" `
-TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
-Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" } `
-NotificationARN @( "arn1", "arn2" )
```
+ Pour plus de détails sur l'API, reportez-vous [CreateStack](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CFNStack`
L'exemple de code suivant montre comment utiliser`Remove-CFNStack`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime la pile spécifiée.**
```
Remove-CFNStack -StackName "myStack"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteStack](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Resume-CFNUpdateRollback`
L'exemple de code suivant montre comment utiliser`Resume-CFNUpdateRollback`.
**Outils pour PowerShell V4**
**Exemple 1 : poursuit l’annulation de la pile nommée, qui doit avoir l’état « UPDATE\$1ROLLBACK\$1FAILED ». Si la restauration continue réussit, la pile entrera dans l’état « UPDATE\$1ROLLBACK\$1COMPLETE ».**
```
Resume-CFNUpdateRollback -StackName "myStack"
```
+ Pour plus de détails sur l'API, reportez-vous [ContinueUpdateRollback](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-CFNUpdateStack`
L'exemple de code suivant montre comment utiliser`Stop-CFNUpdateStack`.
**Outils pour PowerShell V4**
**Exemple 1 : annule une mise à jour sur la pile spécifiée.**
```
Stop-CFNUpdateStack -StackName "myStack"
```
+ Pour plus de détails sur l'API, reportez-vous [CancelUpdateStack](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Test-CFNStack`
L'exemple de code suivant montre comment utiliser`Test-CFNStack`.
**Outils pour PowerShell V4**
**Exemple 1 : teste si la pile a atteint l’un des états UPDATE\$1ROLLBACK\$1COMPLETE, CREATE\$1COMPLETE, ROLLBACK\$1COMPLETE ou UPDATE\$1COMPLETE.**
```
Test-CFNStack -StackName MyStack
```
**Sortie** :
```
False
```
**Exemple 2 : teste si la pile a atteint le statut UPDATE\$1COMPLETE ou UPDATE\$1ROLLBACK\$1COMPLETE.**
```
Test-CFNStack -StackName MyStack -Status UPDATE_COMPLETE,UPDATE_ROLLBACK_COMPLETE
```
**Sortie** :
```
True
```
+ Pour plus de détails sur l'API, voir [Test- CFNStack](https://docs.aws.amazon.com/powershell/v4/reference) in *Outils AWS pour PowerShell Cmdlet Reference (V4)*.
### `Test-CFNTemplate`
L'exemple de code suivant montre comment utiliser`Test-CFNTemplate`.
**Outils pour PowerShell V4**
**Exemple 1 : valide le contenu du modèle spécifié. La sortie détaille les fonctionnalités, la description et les paramètres du modèle.**
```
Test-CFNTemplate -TemplateBody "{TEMPLATE CONTENT HERE}"
```
**Exemple 2 : valide le modèle spécifié accessible via une URL Amazon S3. La sortie détaille les fonctionnalités, la description et les paramètres du modèle.**
```
Test-CFNTemplate -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template
```
+ Pour plus de détails sur l'API, reportez-vous [ValidateTemplate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-CFNStack`
L'exemple de code suivant montre comment utiliser`Update-CFNStack`.
**Outils pour PowerShell V4**
**Exemple 1 : met à jour la pile « MyStack » avec le modèle et les paramètres de personnalisation spécifiés. « PK1 » représente le nom d'un paramètre déclaré dans le modèle et « PV1 » représente sa valeur. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de ParameterKey « » et « ParameterValue ».**
```
Update-CFNStack -StackName "myStack" `
-TemplateBody "{Template Content Here}" `
-Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }
```
**Exemple 2 : met à jour la pile « MyStack » avec le modèle et les paramètres de personnalisation spécifiés. « PK1 » et « PK2 » représentent les noms des paramètres déclarés dans le modèle, « PV1 » et « PV2 » représentent les valeurs demandées. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de ParameterKey « » et « ParameterValue ».**
```
Update-CFNStack -StackName "myStack" `
-TemplateBody "{Template Content Here}" `
-Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )
```
**Exemple 3 : met à jour la pile « MyStack » avec le modèle et les paramètres de personnalisation spécifiés. « PK1 » représente le nom d'un paramètre déclaré dans le modèle et « PV2 » représente sa valeur. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de ParameterKey « » et « ParameterValue ».**
```
Update-CFNStack -StackName "myStack" -TemplateBody "{Template Content Here}" -Parameters @{ ParameterKey="PK1"; ParameterValue="PV1" }
```
**Exemple 4 : met à jour la pile « MyStack » avec le modèle spécifié, obtenu auprès d'Amazon S3, et les paramètres de personnalisation. « PK1 » et « PK2 » représentent les noms des paramètres déclarés dans le modèle, « PV1 » et « PV2 » représentent les valeurs demandées. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de ParameterKey « » et « ParameterValue ».**
```
Update-CFNStack -StackName "myStack" `
-TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
-Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )
```
**Exemple 5 : met à jour la pile « MyStack », qui est supposée dans cet exemple contenir des ressources IAM, avec le modèle spécifié, obtenu auprès d'Amazon S3, et les paramètres de personnalisation. « PK1 » et « PK2 » représentent les noms des paramètres déclarés dans le modèle, « PV1 » et « PV2 » représentent les valeurs demandées. Les paramètres de personnalisation peuvent également être spécifiés en utilisant « Key » et « Value » au lieu de ParameterKey « » et « ParameterValue ». Les piles contenant des ressources IAM nécessitent que vous spécifiiez le paramètre -Capabilities « CAPABILITY\$1IAM », sinon la mise à jour échouera avec une erreur « ». InsufficientCapabilities**
```
Update-CFNStack -StackName "myStack" `
-TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
-Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } ) `
-Capabilities "CAPABILITY_IAM"
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateStack](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Wait-CFNStack`
L'exemple de code suivant montre comment utiliser`Wait-CFNStack`.
**Outils pour PowerShell V4**
**Exemple 1 : teste si la pile a atteint l’un des états UPDATE\$1ROLLBACK\$1COMPLETE, CREATE\$1COMPLETE, ROLLBACK\$1COMPLETE ou UPDATE\$1COMPLETE. Si la pile n’est pas dans l’un des états, la commande est mise en veille pendant deux secondes avant de tester à nouveau l’état. Ceci est répété jusqu’à ce que la pile atteigne l’un des états demandés ou que le délai d’expiration par défaut de soixante secondes s’écoule. Si le délai d’expiration est dépassé, une exception est levée. Si la pile atteint l’un des états demandés dans le délai d’expiration imparti, elle est renvoyée dans le pipeline.**
```
$stack = Wait-CFNStack -StackName MyStack
```
**Exemple 2 : cet exemple attend au total cinq minutes (300 secondes) pour que la pile atteigne l’un des états spécifiés. Dans cet exemple, l’état est atteint avant le délai d’expiration et l’objet de la pile est donc renvoyé dans le pipeline.**
```
Wait-CFNStack -StackName MyStack -Timeout 300 -Status CREATE_COMPLETE,ROLLBACK_COMPLETE
```
**Sortie** :
```
Capabilities : {CAPABILITY_IAM}
ChangeSetId :
CreationTime : 6/1/2017 9:29:33 AM
Description : AWS CloudFormation Sample Template ec2_instance_with_instance_profile: Create an EC2 instance with an associated instance profile. **WARNING** This template creates one or more Amazon EC2
instances and an Amazon SQS queue. You will be billed for the AWS resources used if you create a stack from this template.
DisableRollback : False
LastUpdatedTime : 1/1/0001 12:00:00 AM
NotificationARNs : {}
Outputs : {}
Parameters : {}
RoleARN :
StackId : arn:aws:cloudformation:us-west-2:123456789012:stack/MyStack/7ea87b50-46e7-11e7-9c9b-503a90a9c4d1
StackName : MyStack
StackStatus : CREATE_COMPLETE
StackStatusReason :
Tags : {}
TimeoutInMinutes : 0
```
**Exemple 3 : cet exemple montre le résultat d’erreur lorsqu’une pile n’atteint pas l’un des états demandés dans le délai d’expiration imparti (dans ce cas, le délai par défaut de soixante secondes).**
```
Wait-CFNStack -StackName MyStack -Status CREATE_COMPLETE,ROLLBACK_COMPLETE
```
**Sortie** :
```
Wait-CFNStack : Timed out after 60 seconds waiting for CloudFormation stack MyStack in region us-west-2 to reach one of state(s): UPDATE_ROLLBACK_COMPLETE,CREATE_COMPLETE,ROLLBACK_COMPLETE,UPDATE_COMPLETE
At line:1 char:1
+ Wait-CFNStack -StackName MyStack -State CREATE_COMPLETE,ROLLBACK_COMPLETE
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidOperation: (Amazon.PowerShe...tCFNStackCmdlet:WaitCFNStackCmdlet) [Wait-CFNStack], InvalidOperationException
+ FullyQualifiedErrorId : InvalidOperationException,Amazon.PowerShell.Cmdlets.CFN.WaitCFNStackCmdlet
```
+ Pour plus de détails sur l'API, consultez la *référence des CFNStack Outils AWS pour PowerShell applets de commande [Wait-](https://docs.aws.amazon.com/powershell/v4/reference) in (V4)*.
# CloudFront exemples utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec CloudFront.
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
### `Get-CFCloudFrontOriginAccessIdentity`
L'exemple de code suivant montre comment utiliser`Get-CFCloudFrontOriginAccessIdentity`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple renvoie une identité d'accès Amazon CloudFront Origin spécifique, spécifiée par le paramètre -Id. Bien que le paramètre -Id ne soit pas obligatoire, aucun résultat n’est renvoyé si vous ne le spécifiez pas.**
```
Get-CFCloudFrontOriginAccessIdentity -Id E3XXXXXXXXXXRT
```
**Sortie** :
```
CloudFrontOriginAccessIdentityConfig Id S3CanonicalUserId
------------------------------------ -- -----------------
Amazon.CloudFront.Model.CloudFrontOr... E3XXXXXXXXXXRT 4b6e...
```
+ Pour plus de détails sur l'API, reportez-vous [GetCloudFrontOriginAccessIdentity](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFCloudFrontOriginAccessIdentityConfig`
L'exemple de code suivant montre comment utiliser`Get-CFCloudFrontOriginAccessIdentityConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple renvoie des informations de configuration concernant une seule identité CloudFront d'accès à Amazon Origin, spécifiée par le paramètre -Id. Des erreurs se produisent si aucun paramètre -Id n’est spécifié.**
```
Get-CFCloudFrontOriginAccessIdentityConfig -Id E3XXXXXXXXXXRT
```
**Sortie** :
```
CallerReference Comment
--------------- -------
mycallerreference: 2/1/2011 1:16:32 PM Caller reference: 2/1/2011 1:16:32 PM
```
+ Pour plus de détails sur l'API, reportez-vous [GetCloudFrontOriginAccessIdentityConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFCloudFrontOriginAccessIdentityList`
L'exemple de code suivant montre comment utiliser`Get-CFCloudFrontOriginAccessIdentityList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple renvoie une liste des identités CloudFront d'accès d'origine Amazon. Comme le MaxItem paramètre - spécifie une valeur de 2, les résultats incluent deux identités.**
```
Get-CFCloudFrontOriginAccessIdentityList -MaxItem 2
```
**Sortie** :
```
IsTruncated : True
Items : {E326XXXXXXXXXT, E1YWXXXXXXX9B}
Marker :
MaxItems : 2
NextMarker : E1YXXXXXXXXX9B
Quantity : 2
```
+ Pour plus de détails sur l'API, reportez-vous [ListCloudFrontOriginAccessIdentities](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFDistribution`
L'exemple de code suivant montre comment utiliser`Get-CFDistribution`.
**Outils pour PowerShell V4**
**Exemple 1 : extrait les informations d’une distribution spécifique.**
```
Get-CFDistribution -Id EXAMPLE0000ID
```
+ Pour plus de détails sur l'API, reportez-vous [GetDistribution](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFDistributionConfig`
L'exemple de code suivant montre comment utiliser`Get-CFDistributionConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : extrait la configuration d’une distribution spécifique.**
```
Get-CFDistributionConfig -Id EXAMPLE0000ID
```
+ Pour plus de détails sur l'API, reportez-vous [GetDistributionConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFDistributionList`
L'exemple de code suivant montre comment utiliser`Get-CFDistributionList`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les distributions.**
```
Get-CFDistributionList
```
+ Pour plus de détails sur l'API, reportez-vous [ListDistributions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CFDistribution`
L'exemple de code suivant montre comment utiliser`New-CFDistribution`.
**Outils pour PowerShell V4**
**Exemple 1 : crée une CloudFront distribution de base, configurée avec la journalisation et la mise en cache.**
```
$origin = New-Object Amazon.CloudFront.Model.Origin
$origin.DomainName = "amzn-s3-demo-bucket.s3.amazonaws.com"
$origin.Id = "UniqueOrigin1"
$origin.S3OriginConfig = New-Object Amazon.CloudFront.Model.S3OriginConfig
$origin.S3OriginConfig.OriginAccessIdentity = ""
New-CFDistribution `
-DistributionConfig_Enabled $true `
-DistributionConfig_Comment "Test distribution" `
-Origins_Item $origin `
-Origins_Quantity 1 `
-Logging_Enabled $true `
-Logging_IncludeCookie $true `
-Logging_Bucket amzn-s3-demo-logging-bucket.s3.amazonaws.com `
-Logging_Prefix "help/" `
-DistributionConfig_CallerReference Client1 `
-DistributionConfig_DefaultRootObject index.html `
-DefaultCacheBehavior_TargetOriginId $origin.Id `
-ForwardedValues_QueryString $true `
-Cookies_Forward all `
-WhitelistedNames_Quantity 0 `
-TrustedSigners_Enabled $false `
-TrustedSigners_Quantity 0 `
-DefaultCacheBehavior_ViewerProtocolPolicy allow-all `
-DefaultCacheBehavior_MinTTL 1000 `
-DistributionConfig_PriceClass "PriceClass_All" `
-CacheBehaviors_Quantity 0 `
-Aliases_Quantity 0
```
+ Pour plus de détails sur l'API, reportez-vous [CreateDistribution](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CFInvalidation`
L'exemple de code suivant montre comment utiliser`New-CFInvalidation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une invalidation sur une distribution dont l’ID est EXAMPLENSTXAXE. CallerReference Il s'agit d'un identifiant unique choisi par l'utilisateur ; dans ce cas, un horodatage représentant le 15 mai 2019 à 9 h 00 est utilisé. La variable \$1Paths stocke trois chemins vers des fichiers image et média que l’utilisateur ne souhaite pas inclure dans le cache de la distribution. La valeur du paramètre -Paths\$1Quantity correspond au nombre total de chemins indiqués dans le paramètre -Paths\$1Item.**
```
$Paths = "/images/*.gif", "/images/image1.jpg", "/videos/*.mp4"
New-CFInvalidation -DistributionId "EXAMPLENSTXAXE" -InvalidationBatch_CallerReference 20190515090000 -Paths_Item $Paths -Paths_Quantity 3
```
**Sortie** :
```
Invalidation Location
------------ --------
Amazon.CloudFront.Model.Invalidation https://cloudfront.amazonaws.com/2018-11-05/distribution/EXAMPLENSTXAXE/invalidation/EXAMPLE8NOK9H
```
+ Pour plus de détails sur l'API, reportez-vous [CreateInvalidation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CFSignedCookie`
L'exemple de code suivant montre comment utiliser`New-CFSignedCookie`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un cookie signé sur la ressource spécifiée à l’aide d’une politique prédéfinie. Le cookie sera valide pendant un an.**
```
$params = @{
"ResourceUri"="http://xyz.cloudfront.net/image1.jpeg"
"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
"ExpiresOn"=(Get-Date).AddYears(1)
}
New-CFSignedCookie @params
```
**Sortie** :
```
Expires
-------
[CloudFront-Expires, 1472227284]
```
**Exemple 2 : crée un cookie signé sur les ressources spécifiées à l’aide d’une politique personnalisée. Le cookie sera valide dans les 24 heures et expirera une semaine plus tard.**
```
$start = (Get-Date).AddHours(24)
$params = @{
"ResourceUri"="http://xyz.cloudfront.net/content/*.jpeg"
"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
"ExpiresOn"=$start.AddDays(7)
"ActiveFrom"=$start
}
New-CFSignedCookie @params
```
**Sortie** :
```
Policy
------
[CloudFront-Policy, eyJTd...wIjo...
```
**Exemple 3 : crée un cookie signé sur les ressources spécifiées à l’aide d’une politique personnalisée. Le cookie sera valide dans les 24 heures et expirera une semaine plus tard. L’accès aux ressources est limité à la plage d’adresses IP spécifiée.**
```
$start = (Get-Date).AddHours(24)
$params = @{
"ResourceUri"="http://xyz.cloudfront.net/content/*.jpeg"
"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
"ExpiresOn"=$start.AddDays(7)
"ActiveFrom"=$start
"IpRange"="192.0.2.0/24"
}
New-CFSignedCookie @params
```
**Sortie** :
```
Policy ------ [CloudFront-Policy, eyJTd...wIjo...
```
+ Pour plus de détails sur l'API, voir [New- CFSigned Cookie](https://docs.aws.amazon.com/powershell/v4/reference) in *Outils AWS pour PowerShell Cmdlet Reference (V4)*.
### `New-CFSignedUrl`
L'exemple de code suivant montre comment utiliser`New-CFSignedUrl`.
**Outils pour PowerShell V4**
**Exemple 1 : crée une URL signée sur la ressource spécifiée à l’aide d’une politique prédéfinie. L’URL sera valide pendant une heure. Un objet System.Uri contenant l’URL signée est émis dans le pipeline.**
```
$params = @{
"ResourceUri"="https://cdn.example.com/index.html"
"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
"ExpiresOn"=(Get-Date).AddHours(1)
}
New-CFSignedUrl @params
```
**Exemple 2 : crée une URL signée sur la ressource spécifiée à l’aide d’une politique personnalisée. L’URL sera valide dans 24 heures et expirera une semaine plus tard.**
```
$start = (Get-Date).AddHours(24)
$params = @{
"ResourceUri"="https://cdn.example.com/index.html"
"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
"ExpiresOn"=(Get-Date).AddDays(7)
"ActiveFrom"=$start
}
New-CFSignedUrl @params
```
**Exemple 3 : crée une URL signée sur la ressource spécifiée à l’aide d’une politique personnalisée. L’URL sera valide dans 24 heures et expirera une semaine plus tard. L’accès à la ressource est limité à la plage d’adresses IP spécifiée.**
```
$start = (Get-Date).AddHours(24)
$params = @{
"ResourceUri"="https://cdn.example.com/index.html"
"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
"ExpiresOn"=(Get-Date).AddDays(7)
"ActiveFrom"=$start
"IpRange"="192.0.2.0/24"
}
New-CFSignedUrl @params
```
+ Pour plus de détails sur l'API, voir [New- CFSigned Url](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
# CloudTrail exemples utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec CloudTrail.
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
### `Find-CTEvent`
L'exemple de code suivant montre comment utiliser`Find-CTEvent`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie tous les événements qui se sont produits au cours des sept derniers jours. Par défaut, l’applet de commande effectue automatiquement plusieurs appels pour transmettre tous les événements, puis s’arrête lorsque le service indique qu’aucune autre donnée n’est disponible.**
```
Find-CTEvent
```
**Exemple 2 : renvoie tous les événements survenus au cours des sept derniers jours en spécifiant une région qui n’est pas la valeur par défaut du shell actuel.**
```
Find-CTEvent -Region eu-central-1
```
**Exemple 3 : renvoie tous les événements associés à l'appel RunInstances d'API.**
```
Find-CTEvent -LookupAttribute @{ AttributeKey="EventName"; AttributeValue="RunInstances" }
```
**Exemple 4 : renvoie les cinq premiers événements disponibles.**
```
Find-CTEvent -MaxResult 5
```
+ Pour plus de détails sur l'API, reportez-vous [LookupEvents](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CTTrail`
L'exemple de code suivant montre comment utiliser`Get-CTTrail`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les paramètres de tous les journaux de suivi associés à la région actuelle pour votre compte.**
```
Get-CTTrail
```
**Exemple 2 : renvoie les paramètres pour les journaux de suivi spécifiés.**
```
Get-CTTrail -TrailNameList trail1,trail2
```
**Exemple 3 : renvoie les paramètres pour les journaux de suivi spécifiés qui ont été créés dans une région autre que la région par défaut du shell actuel (dans ce cas, la région de Francfort (eu-central-1)).**
```
Get-CTTrail -TrailNameList trailABC,trailDEF -Region eu-central-1
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTrails](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CTTrailStatus`
L'exemple de code suivant montre comment utiliser`Get-CTTrailStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les informations d'état du parcours portant le nom « myExampleTrail ». Les données renvoyées incluent des informations sur les erreurs de livraison, les erreurs Amazon SNS et Amazon S3, ainsi que les heures de début et de fin de journalisation du journal de suivi. Cet exemple suppose que le journal de suivi a été créé dans la même région que le shell par défaut actuel.**
```
Get-CTTrailStatus -Name myExampleTrail
```
**Exemple 2 : renvoie les informations de statut pour un journal de suivi créé dans une région autre que la région par défaut du shell actuel (dans ce cas, la région de Francfort (eu-central-1)).**
```
Get-CTTrailStatus -Name myExampleTrail -Region eu-central-1
```
+ Pour plus de détails sur l'API, reportez-vous [GetTrailStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CTTrail`
L'exemple de code suivant montre comment utiliser`New-CTTrail`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un journal de suivi qui utilisera le compartiment « amzn-s3-demo-bucket » pour le stockage des fichiers journaux.**
```
New-CTTrail -Name "awscloudtrail-example" -S3BucketName "amzn-s3-demo-bucket"
```
**Exemple 2 : crée un journal de suivi qui utilisera le compartiment « amzn-s3-demo-bucket » pour le stockage des fichiers journaux. Les objets S3 représentant les journaux auront le préfixe de clé commun « mylogs ». Lorsque de nouveaux journaux sont envoyés au compartiment, une notification est envoyée à la rubrique SNS « mlog-deliverytopic ». Cet exemple utilise le splatting pour fournir les valeurs des paramètres à l’applet de commande.**
```
$params = @{
Name="awscloudtrail-example"
S3BucketName="amzn-s3-demo-bucket"
S3KeyPrefix="mylogs"
SnsTopicName="mlog-deliverytopic"
}
New-CTTrail @params
```
+ Pour plus de détails sur l'API, reportez-vous [CreateTrail](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CTTrail`
L'exemple de code suivant montre comment utiliser`Remove-CTTrail`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime le journal de suivi spécifié. Vous devrez confirmer avant que la commande ne soit exécutée. Pour supprimer la confirmation, ajoutez le paramètre de commutateur -Force.**
```
Remove-CTTrail -Name "awscloudtrail-example"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteTrail](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Start-CTLogging`
L'exemple de code suivant montre comment utiliser`Start-CTLogging`.
**Outils pour PowerShell V4**
**Exemple 1 : Démarre l'enregistrement des appels d' AWS API et la livraison du fichier journal pour le journal nommé « myExampleTrail ». Cet exemple suppose que le journal de suivi a été créé dans la même région que le shell par défaut actuel.**
```
Start-CTLogging -Name myExampleTrail
```
**Exemple 2 : Démarre l'enregistrement des appels d' AWS API et la livraison du fichier journal pour un journal créé dans une région autre que la région par défaut du shell actuel (dans ce cas, la région de Francfort (eu-central-1)).**
```
Start-CTLogging -Name myExampleTrail -Region eu-central-1
```
+ Pour plus de détails sur l'API, reportez-vous [StartLogging](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-CTLogging`
L'exemple de code suivant montre comment utiliser`Stop-CTLogging`.
**Outils pour PowerShell V4**
**Exemple 1 : Suspend l'enregistrement des appels d' AWS API et la livraison du fichier journal pour le journal nommé « myExampleTrail ». Cet exemple suppose que le journal de suivi a été créé dans la même région que le shell par défaut actuel.**
```
Stop-CTLogging -Name myExampleTrail
```
**Exemple 2 : Suspend l'enregistrement des appels d' AWS API et la livraison du fichier journal pour un journal créé dans une région autre que la région par défaut du shell actuel (dans ce cas, la région de Francfort (eu-central-1)).**
```
Stop-CTLogging -Name myExampleTrail -Region eu-central-1
```
+ Pour plus de détails sur l'API, reportez-vous [StopLogging](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-CTTrail`
L'exemple de code suivant montre comment utiliser`Update-CTTrail`.
**Outils pour PowerShell V4**
**Exemple 1 : met à jour le journal de suivi spécifié afin que les événements de service globaux (tels que ceux provenant d’IAM) soient enregistrés et change le préfixe de clé commun des fichiers journaux à venir pour « globallogs ».**
```
Update-CTTrail -Name "awscloudtrail-example" -IncludeGlobalServiceEvents $true -S3KeyPrefix "globallogs"
```
**Exemple 2 : met à jour le journal de suivi spécifié afin que les notifications concernant les nouvelles livraisons de journaux soient envoyées à la rubrique SNS spécifiée.**
```
Update-CTTrail -Name "awscloudtrail-example" -SnsTopicName "mlog-deliverytopic2"
```
**Exemple 3 : met à jour le journal de suivi spécifié afin que les journaux soient envoyés dans un autre compartiment.**
```
Update-CTTrail -Name "awscloudtrail-example" -S3BucketName "otherlogs"
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateTrail](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# CloudWatch exemples utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec CloudWatch.
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
### `Get-CWAlarm`
L'exemple de code suivant montre comment utiliser`Get-CWAlarm`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie toutes les alarmes, y compris les alarmes composites et métriques de CloudWatch.**
```
Get-CWAlarm -MaxRecords 1
```
**Sortie** :
```
CompositeAlarms MetricAlarms NextToken
--------------- ------------ ---------
{MetricAlarms-01} NextToken-01
{MetricAlarms-02} NextToken-02
{MetricAlarms-03} NextToken-03
```
**Exemple 2 : renvoie uniquement les données d'alarmes composites CloudWatch après avoir défini le AlarmType paramètre - sur CompositeAlarms.**
```
Get-CWAlarm -AlarmType 'CompositeAlarms'
```
**Sortie** :
```
CompositeAlarms MetricAlarms NextToken
--------------- ------------ ---------
{CompositeAlarms-01}
{CompositeAlarms-02}
{CompositeAlarms-03}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAlarms](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CWDashboard`
L'exemple de code suivant montre comment utiliser`Get-CWDashboard`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie l’ARN dans le corps du tableau de bord spécifié.**
```
Get-CWDashboard -DashboardName Dashboard1
```
**Sortie** :
```
DashboardArn DashboardBody
------------ -------------
arn:aws:cloudwatch::123456789012:dashboard/Dashboard1 {...
```
+ Pour plus de détails sur l'API, reportez-vous [GetDashboard](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CWDashboardList`
L'exemple de code suivant montre comment utiliser`Get-CWDashboardList`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie la collection de tableaux de bord pour votre compte.**
```
Get-CWDashboardList
```
**Sortie** :
```
DashboardArn DashboardName LastModified Size
------------ ------------- ------------ ----
arn:... Dashboard1 7/6/2017 8:14:15 PM 252
```
**Exemple 2 : renvoie la collection de tableaux de bord de votre compte dont le nom commence par le préfixe « dev’.**
```
Get-CWDashboardList -DashboardNamePrefix dev
```
+ Pour plus de détails sur l'API, reportez-vous [ListDashboards](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CWDashboard`
L'exemple de code suivant montre comment utiliser`Remove-CWDashboard`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime le tableau de bord spécifié, en le promouvant pour confirmation avant de continuer. Pour contourner la confirmation, ajoutez le commutateur -Force à la commande.**
```
Remove-CWDashboard -DashboardName Dashboard1
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteDashboards](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-CWDashboard`
L'exemple de code suivant montre comment utiliser`Write-CWDashboard`.
**Outils pour PowerShell V4**
**Exemple 1 : crée ou met à jour le tableau de bord nommé « Dashboard1 » pour y inclure deux widgets de métriques placés côte à côte.**
```
$dashBody = @"
{
"widgets":[
{
"type":"metric",
"x":0,
"y":0,
"width":12,
"height":6,
"properties":{
"metrics":[
[
"AWS/EC2",
"CPUUtilization",
"InstanceId",
"i-012345"
]
],
"period":300,
"stat":"Average",
"region":"us-east-1",
"title":"EC2 Instance CPU"
}
},
{
"type":"metric",
"x":12,
"y":0,
"width":12,
"height":6,
"properties":{
"metrics":[
[
"AWS/S3",
"BucketSizeBytes",
"BucketName",
"amzn-s3-demo-bucket"
]
],
"period":86400,
"stat":"Maximum",
"region":"us-east-1",
"title":"amzn-s3-demo-bucket bytes"
}
}
]
}
"@
Write-CWDashboard -DashboardName Dashboard1 -DashboardBody $dashBody
```
**Exemple 2 : crée ou met à jour le tableau de bord en transmettant son contenu descriptif à l’applet de commande.**
```
$dashBody = @"
{
...
}
"@
$dashBody | Write-CWDashboard -DashboardName Dashboard1
```
+ Pour plus de détails sur l'API, reportez-vous [PutDashboard](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-CWMetricData`
L'exemple de code suivant montre comment utiliser`Write-CWMetricData`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un nouvel MetricDatum objet et l'écrit dans Amazon Web Services CloudWatch Metrics.**
```
### Create a MetricDatum .NET object
$Metric = New-Object -TypeName Amazon.CloudWatch.Model.MetricDatum
$Metric.Timestamp = [DateTime]::UtcNow
$Metric.MetricName = 'CPU'
$Metric.Value = 50
### Write the metric data to the CloudWatch service
Write-CWMetricData -Namespace instance1 -MetricData $Metric
```
+ Pour plus de détails sur l'API, reportez-vous [PutMetricData](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# CodeCommit exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec CodeCommit.
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
### `Get-CCBranch`
L'exemple de code suivant montre comment utiliser`Get-CCBranch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur la branche spécifiée pour le référentiel spécifié.**
```
Get-CCBranch -RepositoryName MyDemoRepo -BranchName MyNewBranch
```
**Sortie** :
```
BranchName CommitId
---------- --------
MyNewBranch 7763222d...561fc9c9
```
+ Pour plus de détails sur l'API, reportez-vous [GetBranch](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CCBranchList`
L'exemple de code suivant montre comment utiliser`Get-CCBranchList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient une liste de noms de branches pour le référentiel spécifié.**
```
Get-CCBranchList -RepositoryName MyDemoRepo
```
**Sortie** :
```
master
MyNewBranch
```
+ Pour plus de détails sur l'API, reportez-vous [ListBranches](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CCRepository`
L'exemple de code suivant montre comment utiliser`Get-CCRepository`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations pour le référentiel spécifié.**
```
Get-CCRepository -RepositoryName MyDemoRepo
```
**Sortie** :
```
AccountId : 80398EXAMPLE
Arn : arn:aws:codecommit:us-east-1:80398EXAMPLE:MyDemoRepo
CloneUrlHttp : https://git-codecommit.us-east-1.amazonaws.com/v1/repos/MyDemoRepo
CloneUrlSsh : ssh://git-codecommit.us-east-1.amazonaws.com/v1/repos/MyDemoRepo
CreationDate : 9/8/2015 3:21:33 PM
DefaultBranch :
LastModifiedDate : 9/8/2015 3:21:33 PM
RepositoryDescription : This is a repository for demonstration purposes.
RepositoryId : c7d0d2b0-ce40-4303-b4c3-38529EXAMPLE
RepositoryName : MyDemoRepo
```
+ Pour plus de détails sur l'API, reportez-vous [GetRepository](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CCRepositoryBatch`
L'exemple de code suivant montre comment utiliser`Get-CCRepositoryBatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple confirme quels référentiels sont trouvés ou non, parmi ceux spécifiés.**
```
Get-CCRepositoryBatch -RepositoryName MyDemoRepo, MyNewRepo, AMissingRepo
```
**Sortie** :
```
Repositories RepositoriesNotFound
------------ --------------------
{MyDemoRepo, MyNewRepo} {AMissingRepo}
```
+ Pour plus de détails sur l'API, reportez-vous [BatchGetRepositories](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CCRepositoryList`
L'exemple de code suivant montre comment utiliser`Get-CCRepositoryList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie tous les référentiels par ordre croissant de nom de référentiel.**
```
Get-CCRepositoryList -Order Ascending -SortBy RepositoryName
```
**Sortie** :
```
RepositoryId RepositoryName
------------ --------------
c7d0d2b0-ce40-4303-b4c3-38529EXAMPLE MyDemoRepo
05f30c66-e3e3-4f91-a0cd-1c84aEXAMPLE MyNewRepo
```
+ Pour plus de détails sur l'API, reportez-vous [ListRepositories](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CCBranch`
L'exemple de code suivant montre comment utiliser`New-CCBranch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une nouvelle branche avec le nom spécifié pour le référentiel spécifié et l’ID de validation spécifié.**
```
New-CCBranch -RepositoryName MyDemoRepo -BranchName MyNewBranch -CommitId 7763222d...561fc9c9
```
+ Pour plus de détails sur l'API, reportez-vous [CreateBranch](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CCRepository`
L'exemple de code suivant montre comment utiliser`New-CCRepository`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un nouveau référentiel avec le nom spécifié et la description spécifiée.**
```
New-CCRepository -RepositoryName MyDemoRepo -RepositoryDescription "This is a repository for demonstration purposes."
```
**Sortie** :
```
AccountId : 80398EXAMPLE
Arn : arn:aws:codecommit:us-east-1:80398EXAMPLE:MyDemoRepo
CloneUrlHttp : https://git-codecommit.us-east-1.amazonaws.com/v1/repos/MyDemoRepo
CloneUrlSsh : ssh://git-codecommit.us-east-1.amazonaws.com/v1/repos/MyDemoRepo
CreationDate : 9/18/2015 4:13:25 PM
DefaultBranch :
LastModifiedDate : 9/18/2015 4:13:25 PM
RepositoryDescription : This is a repository for demonstration purposes.
RepositoryId : 43ef2443-3372-4b12-9e78-65c27EXAMPLE
RepositoryName : MyDemoRepo
```
+ Pour plus de détails sur l'API, reportez-vous [CreateRepository](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CCRepository`
L'exemple de code suivant montre comment utiliser`Remove-CCRepository`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple force la suppression du référentiel spécifié. La commande vous invite à confirmer avant de poursuivre. Ajoutez le paramètre -Force pour supprimer le référentiel sans invite.**
```
Remove-CCRepository -RepositoryName MyDemoRepo
```
**Sortie** :
```
43ef2443-3372-4b12-9e78-65c27EXAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteRepository](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-CCDefaultBranch`
L'exemple de code suivant montre comment utiliser`Update-CCDefaultBranch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple remplace la branche par défaut du référentiel spécifié par la branche spécifiée.**
```
Update-CCDefaultBranch -RepositoryName MyDemoRepo -DefaultBranchName MyNewBranch
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateDefaultBranch](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-CCRepositoryDescription`
L'exemple de code suivant montre comment utiliser`Update-CCRepositoryDescription`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie la description du référentiel spécifié.**
```
Update-CCRepositoryDescription -RepositoryName MyDemoRepo -RepositoryDescription "This is an updated description."
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateRepositoryDescription](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-CCRepositoryName`
L'exemple de code suivant montre comment utiliser`Update-CCRepositoryName`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie le nom du référentiel spécifié.**
```
Update-CCRepositoryName -NewName MyDemoRepo2 -OldName MyDemoRepo
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateRepositoryName](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# CodeDeploy exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec CodeDeploy.
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-CDOnPremiseInstanceTag`
L'exemple de code suivant montre comment utiliser`Add-CDOnPremiseInstanceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute une balise d’instance sur site avec la clé et la valeur spécifiées pour l’instance sur site spécifiée.**
```
Add-CDOnPremiseInstanceTag -InstanceName AssetTag12010298EX -Tag @{"Key" = "Name"; "Value" = "CodeDeployDemo-OnPrem"}
```
+ Pour plus de détails sur l'API, reportez-vous [AddTagsToOnPremisesInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDApplication`
L'exemple de code suivant montre comment utiliser`Get-CDApplication`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur l’application spécifiée.**
```
Get-CDApplication -ApplicationName CodeDeployDemoApplication
```
**Sortie** :
```
ApplicationId ApplicationName CreateTime LinkedToGitHub
------------- --------------- ---------- --------------
e07fb938-091e-4f2f-8963-4d3e8EXAMPLE CodeDeployDemoApplication 7/20/2015 9:49:48 PM False
```
+ Pour plus de détails sur l'API, reportez-vous [GetApplication](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDApplicationBatch`
L'exemple de code suivant montre comment utiliser`Get-CDApplicationBatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur les applications spécifiées.**
```
Get-CDApplicationBatch -ApplicationName CodeDeployDemoApplication, CodePipelineDemoApplication
```
**Sortie** :
```
ApplicationId ApplicationName CreateTime LinkedToGitHub
------------- --------------- ---------- --------------
e07fb938-091e-4f2f-8963-4d3e8EXAMPLE CodeDeployDemoApplication 7/20/2015 9:49:48 PM False
1ecfd602-62f1-4038-8f0d-06688EXAMPLE CodePipelineDemoApplication 8/13/2015 5:53:26 PM False
```
+ Pour plus de détails sur l'API, reportez-vous [BatchGetApplications](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDApplicationList`
L'exemple de code suivant montre comment utiliser`Get-CDApplicationList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient une liste des applications disponibles.**
```
Get-CDApplicationList
```
**Sortie** :
```
CodeDeployDemoApplication
CodePipelineDemoApplication
```
+ Pour plus de détails sur l'API, reportez-vous [ListApplications](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDApplicationRevision`
L'exemple de code suivant montre comment utiliser`Get-CDApplicationRevision`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur la révision de l’application spécifiée.**
```
$revision = Get-CDApplicationRevision -ApplicationName CodeDeployDemoApplication -S3Location_Bucket amzn-s3-demo-bucket -Revision_RevisionType S3 -S3Location_Key 5xd27EX.zip -S3Location_BundleType zip -S3Location_ETag 4565c1ac97187f190c1a90265EXAMPLE
Write-Output ("Description = " + $revision.RevisionInfo.Description + ", RegisterTime = " + $revision.RevisionInfo.RegisterTime)
```
**Sortie** :
```
Description = Application revision registered by Deployment ID: d-CX9CHN3EX, RegisterTime = 07/20/2015 23:46:42
```
+ Pour plus de détails sur l'API, reportez-vous [GetApplicationRevision](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDApplicationRevisionList`
L'exemple de code suivant montre comment utiliser`Get-CDApplicationRevisionList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur les révisions disponibles de l’application spécifiée.**
```
ForEach ($revision in (Get-CDApplicationRevisionList -ApplicationName CodeDeployDemoApplication -Deployed Ignore)) {
>> If ($revision.RevisionType -Eq "S3") {
>> Write-Output ("Type = S3, Bucket = " + $revision.S3Location.Bucket + ", BundleType = " + $revision.S3Location.BundleType + ", ETag = " + $revision.S3Location.ETag + ", Key = " + $revision.S3Location.Key)
>> }
>> If ($revision.RevisionType -Eq "GitHub") {
>> Write-Output ("Type = GitHub, CommitId = " + $revision.GitHubLocation.CommitId + ", Repository = " + $revision.GitHubLocation.Repository)
>> }
>> }
>>
```
**Sortie** :
```
Type = S3, Bucket = amzn-s3-demo-bucket, BundleType = zip, ETag = 4565c1ac97187f190c1a90265EXAMPLE, Key = 5xd27EX.zip
Type = GitHub, CommitId = f48933c3...76405362, Repository = MyGitHubUser/CodeDeployDemoRepo
```
+ Pour plus de détails sur l'API, reportez-vous [ListApplicationRevisions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDDeployment`
L'exemple de code suivant montre comment utiliser`Get-CDDeployment`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations récapitulatives sur le déploiement spécifié.**
```
Get-CDDeployment -DeploymentId d-QZMRGSTEX
```
**Sortie** :
```
ApplicationName : CodeDeployDemoApplication
CompleteTime : 7/23/2015 11:26:04 PM
CreateTime : 7/23/2015 11:24:43 PM
Creator : user
DeploymentConfigName : CodeDeployDefault.OneAtATime
DeploymentGroupName : CodeDeployDemoFleet
DeploymentId : d-QZMRGSTEX
DeploymentOverview : Amazon.CodeDeploy.Model.DeploymentOverview
Description :
ErrorInformation :
IgnoreApplicationStopFailures : False
Revision : Amazon.CodeDeploy.Model.RevisionLocation
StartTime : 1/1/0001 12:00:00 AM
Status : Succeeded
```
**Exemple 2 : cet exemple obtient des informations sur le statut des instances participant au déploiement spécifié.**
```
(Get-CDDeployment -DeploymentId d-QZMRGSTEX).DeploymentOverview
```
**Sortie** :
```
Failed : 0
InProgress : 0
Pending : 0
Skipped : 0
Succeeded : 3
```
**Exemple 3 : cet exemple obtient des informations sur la révision de l’application pour le déploiement spécifié.**
```
(Get-CDDeployment -DeploymentId d-QZMRGSTEX).Revision.S3Location
```
**Sortie** :
```
Bucket : amzn-s3-demo-bucket
BundleType : zip
ETag : cfbb81b304ee5e27efc21adaed3EXAMPLE
Key : clzfqEX
Version :
```
+ Pour plus de détails sur l'API, reportez-vous [GetDeployment](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDDeploymentBatch`
L'exemple de code suivant montre comment utiliser`Get-CDDeploymentBatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur les déploiements spécifiés.**
```
Get-CDDeploymentBatch -DeploymentId d-QZMRGSTEX, d-RR0T5KTEX
```
**Sortie** :
```
ApplicationName : CodeDeployDemoApplication
CompleteTime : 7/23/2015 11:26:04 PM
CreateTime : 7/23/2015 11:24:43 PM
Creator : user
DeploymentConfigName : CodeDeployDefault.OneAtATime
DeploymentGroupName : CodeDeployDemoFleet
DeploymentId : d-QZMRGSTEX
DeploymentOverview : Amazon.CodeDeploy.Model.DeploymentOverview
Description :
ErrorInformation :
IgnoreApplicationStopFailures : False
Revision : Amazon.CodeDeploy.Model.RevisionLocation
StartTime : 1/1/0001 12:00:00 AM
Status : Succeeded
ApplicationName : CodePipelineDemoApplication
CompleteTime : 7/23/2015 6:07:30 PM
CreateTime : 7/23/2015 6:06:29 PM
Creator : user
DeploymentConfigName : CodeDeployDefault.OneAtATime
DeploymentGroupName : CodePipelineDemoFleet
DeploymentId : d-RR0T5KTEX
DeploymentOverview : Amazon.CodeDeploy.Model.DeploymentOverview
Description :
ErrorInformation :
IgnoreApplicationStopFailures : False
Revision : Amazon.CodeDeploy.Model.RevisionLocation
StartTime : 1/1/0001 12:00:00 AM
Status : Succeeded
```
+ Pour plus de détails sur l'API, reportez-vous [BatchGetDeployments](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDDeploymentConfig`
L'exemple de code suivant montre comment utiliser`Get-CDDeploymentConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations récapitulatives sur la configuration du déploiement spécifiée.**
```
Get-CDDeploymentConfig -DeploymentConfigName ThreeQuartersHealthy
```
**Sortie** :
```
CreateTime DeploymentConfigId DeploymentConfigName MinimumHealthyHosts
---------- ------------------ -------------------- -------------------
10/3/2014 4:32:30 PM 518a3950-d034-46a1-9d2c-3c949EXAMPLE ThreeQuartersHealthy Amazon.CodeDeploy.Model.MinimumHealthyHosts
```
**Exemple 2 : cet exemple obtient des informations sur la définition de la configuration du déploiement spécifiée.**
```
Write-Output ((Get-CDDeploymentConfig -DeploymentConfigName ThreeQuartersHealthy).MinimumHealthyHosts)
```
**Sortie** :
```
Type Value
---- -----
FLEET_PERCENT 75
```
+ Pour plus de détails sur l'API, reportez-vous [GetDeploymentConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDDeploymentConfigList`
L'exemple de code suivant montre comment utiliser`Get-CDDeploymentConfigList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient une liste des configurations de déploiement disponibles.**
```
Get-CDDeploymentConfigList
```
**Sortie** :
```
ThreeQuartersHealthy
CodeDeployDefault.OneAtATime
CodeDeployDefault.AllAtOnce
CodeDeployDefault.HalfAtATime
```
+ Pour plus de détails sur l'API, reportez-vous [ListDeploymentConfigs](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDDeploymentGroup`
L'exemple de code suivant montre comment utiliser`Get-CDDeploymentGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur le groupe de déploiement spécifié.**
```
Get-CDDeploymentGroup -ApplicationName CodeDeployDemoApplication -DeploymentGroupName CodeDeployDemoFleet
```
**Sortie** :
```
ApplicationName : CodeDeployDemoApplication
AutoScalingGroups : {}
DeploymentConfigName : CodeDeployDefault.OneAtATime
DeploymentGroupId : 7d7c098a-b444-4b27-96ef-22791EXAMPLE
DeploymentGroupName : CodeDeployDemoFleet
Ec2TagFilters : {Name}
OnPremisesInstanceTagFilters : {}
ServiceRoleArn : arn:aws:iam::80398EXAMPLE:role/CodeDeploySampleStack-4ph6EX-CodeDeployTrustRole-O9MWP7XTL8EX
TargetRevision : Amazon.CodeDeploy.Model.RevisionLocation
```
+ Pour plus de détails sur l'API, reportez-vous [GetDeploymentGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDDeploymentGroupList`
L'exemple de code suivant montre comment utiliser`Get-CDDeploymentGroupList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient une liste de groupes de déploiement pour l’application spécifiée.**
```
Get-CDDeploymentGroupList -ApplicationName CodeDeployDemoApplication
```
**Sortie** :
```
ApplicationName DeploymentGroups NextToken
--------------- ---------------- ---------
CodeDeployDemoApplication {CodeDeployDemoFleet, CodeDeployProductionFleet}
```
+ Pour plus de détails sur l'API, reportez-vous [ListDeploymentGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDDeploymentInstance`
L'exemple de code suivant montre comment utiliser`Get-CDDeploymentInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur l’instance spécifiée pour le déploiement spécifié.**
```
Get-CDDeploymentInstance -DeploymentId d-QZMRGSTEX -InstanceId i-254e22EX
```
**Sortie** :
```
DeploymentId : d-QZMRGSTEX
InstanceId : arn:aws:ec2:us-east-1:80398EXAMPLE:instance/i-254e22EX
LastUpdatedAt : 7/23/2015 11:25:24 PM
LifecycleEvents : {ApplicationStop, DownloadBundle, BeforeInstall, Install...}
Status : Succeeded
```
+ Pour plus de détails sur l'API, reportez-vous [GetDeploymentInstance](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDDeploymentInstanceList`
L'exemple de code suivant montre comment utiliser`Get-CDDeploymentInstanceList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple obtient une liste d'instances IDs pour le déploiement spécifié.**
```
Get-CDDeploymentInstanceList -DeploymentId d-QZMRGSTEX
```
**Sortie** :
```
i-254e22EX
i-274e22EX
i-3b4e22EX
```
+ Pour plus de détails sur l'API, reportez-vous [ListDeploymentInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDDeploymentList`
L'exemple de code suivant montre comment utiliser`Get-CDDeploymentList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple permet d'obtenir une liste des déploiements IDs pour l'application et le groupe de déploiement spécifiés.**
```
Get-CDDeploymentList -ApplicationName CodeDeployDemoApplication -DeploymentGroupName CodeDeployDemoFleet
```
**Sortie** :
```
d-QZMRGSTEX
d-RR0T5KTEX
```
+ Pour plus de détails sur l'API, reportez-vous [ListDeployments](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDOnPremiseInstance`
L'exemple de code suivant montre comment utiliser`Get-CDOnPremiseInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur l’instance sur site spécifiée.**
```
Get-CDOnPremiseInstance -InstanceName AssetTag12010298EX
```
**Sortie** :
```
DeregisterTime : 1/1/0001 12:00:00 AM
IamUserArn : arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser
InstanceArn : arn:aws:codedeploy:us-east-1:80398EXAMPLE:instance/AssetTag12010298EX_rDH556dxEX
InstanceName : AssetTag12010298EX
RegisterTime : 4/3/2015 6:36:24 PM
Tags : {Name}
```
+ Pour plus de détails sur l'API, reportez-vous [GetOnPremisesInstance](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDOnPremiseInstanceBatch`
L'exemple de code suivant montre comment utiliser`Get-CDOnPremiseInstanceBatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur les instances sur site spécifiées.**
```
Get-CDOnPremiseInstanceBatch -InstanceName AssetTag12010298EX, AssetTag12010298EX-2
```
**Sortie** :
```
DeregisterTime : 1/1/0001 12:00:00 AM
IamUserArn : arn:aws:iam::80398EXAMPLE:user/CodeDeployFRWUser
InstanceArn : arn:aws:codedeploy:us-east-1:80398EXAMPLE:instance/AssetTag12010298EX-2_XmeSz18rEX
InstanceName : AssetTag12010298EX-2
RegisterTime : 4/3/2015 6:38:52 PM
Tags : {Name}
DeregisterTime : 1/1/0001 12:00:00 AM
IamUserArn : arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser
InstanceArn : arn:aws:codedeploy:us-east-1:80398EXAMPLE:instance/AssetTag12010298EX_rDH556dxEX
InstanceName : AssetTag12010298EX
RegisterTime : 4/3/2015 6:36:24 PM
Tags : {Name}
```
+ Pour plus de détails sur l'API, reportez-vous [BatchGetOnPremisesInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CDOnPremiseInstanceList`
L'exemple de code suivant montre comment utiliser`Get-CDOnPremiseInstanceList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient une liste de noms d’instance sur site disponibles.**
```
Get-CDOnPremiseInstanceList
```
**Sortie** :
```
AssetTag12010298EX
AssetTag12010298EX-2
```
+ Pour plus de détails sur l'API, reportez-vous [ListOnPremisesInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CDApplication`
L'exemple de code suivant montre comment utiliser`New-CDApplication`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une nouvelle application avec le nom spécifié.**
```
New-CDApplication -ApplicationName MyNewApplication
```
**Sortie** :
```
f19e4b61-2231-4328-b0fd-e57f5EXAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [CreateApplication](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CDDeployment`
L'exemple de code suivant montre comment utiliser`New-CDDeployment`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un nouveau déploiement pour l’application et le groupe de déploiement spécifiés avec la configuration de déploiement et la révision de l’application spécifiées.**
```
New-CDDeployment -ApplicationName MyNewApplication -S3Location_Bucket amzn-s3-demo-bucket -S3Location_BundleType zip -DeploymentConfigName CodeDeployDefault.OneAtATime -DeploymentGroupName MyNewDeploymentGroup -IgnoreApplicationStopFailures $True -S3Location_Key aws-codedeploy_linux-master.zip -RevisionType S3
```
**Sortie** :
```
d-ZHROG7UEX
```
**Exemple 2 : Cet exemple montre comment spécifier des groupes de balises d'instance EC2 par lesquels une instance doit être identifiée afin qu'elle soit incluse dans l'environnement de remplacement pour un blue/green déploiement.**
```
New-CDDeployment -ApplicationName MyNewApplication -S3Location_Bucket amzn-s3-demo-bucket -S3Location_BundleType zip -DeploymentConfigName CodeDeployDefault.OneAtATime -DeploymentGroupName MyNewDeploymentGroup -IgnoreApplicationStopFailures $True -S3Location_Key aws-codedeploy_linux-master.zip -RevisionType S3 -Ec2TagSetList @(@{Key="key1";Type="KEY_ONLY"},@{Key="Key2";Type="KEY_AND_VALUE";Value="Value2"}),@(@{Key="Key3";Type="VALUE_ONLY";Value="Value3"})
```
**Sortie** :
```
d-ZHROG7UEX
```
+ Pour plus de détails sur l'API, reportez-vous [CreateDeployment](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CDDeploymentConfig`
L'exemple de code suivant montre comment utiliser`New-CDDeploymentConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une configuration de déploiement avec le nom et le comportement spécifiés.**
```
New-CDDeploymentConfig -DeploymentConfigName AtLeastTwoHealthyHosts -MinimumHealthyHosts_Type HOST_COUNT -MinimumHealthyHosts_Value 2
```
**Sortie** :
```
0f3e8187-44ef-42da-aeed-b6823EXAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [CreateDeploymentConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CDDeploymentGroup`
L'exemple de code suivant montre comment utiliser`New-CDDeploymentGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un groupe de déploiement avec le nom spécifié, le groupe Auto Scaling, la configuration de déploiement, la balise et le rôle de service, pour l’application spécifiée.**
```
New-CDDeploymentGroup -ApplicationName MyNewApplication -AutoScalingGroup CodeDeployDemo-ASG -DeploymentConfigName CodeDeployDefault.OneAtATime -DeploymentGroupName MyNewDeploymentGroup -Ec2TagFilter @{Key="Name"; Type="KEY_AND_VALUE"; Value="CodeDeployDemo"} -ServiceRoleArn arn:aws:iam::80398EXAMPLE:role/CodeDeployDemo
```
**Sortie** :
```
16bbf199-95fd-40fc-a909-0bbcfEXAMPLE
```
**Exemple 2 : Cet exemple montre comment spécifier des groupes de balises d'instance EC2 par lesquels une instance doit être identifiée afin qu'elle soit incluse dans l'environnement de remplacement pour un blue/green déploiement.**
```
New-CDDeploymentGroup -ApplicationName MyNewApplication -AutoScalingGroup CodeDeployDemo-ASG -DeploymentConfigName CodeDeployDefault.OneAtATime -DeploymentGroupName MyNewDeploymentGroup -Ec2TagFilter @{Key="Name"; Type="KEY_AND_VALUE"; Value="CodeDeployDemo"} -ServiceRoleArn arn:aws:iam::80398EXAMPLE:role/CodeDeployDemo -Ec2TagSetList @(@{Key="key1";Type="KEY_ONLY"},@{Key="Key2";Type="KEY_AND_VALUE";Value="Value2"}),@(@{Key="Key3";Type="VALUE_ONLY";Value="Value3"})
```
**Sortie** :
```
16bbf199-95fd-40fc-a909-0bbcfEXAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [CreateDeploymentGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-CDApplicationRevision`
L'exemple de code suivant montre comment utiliser`Register-CDApplicationRevision`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre une révision d’application à l’emplacement Amazon S3 spécifié, pour l’application spécifiée.**
```
Register-CDApplicationRevision -ApplicationName MyNewApplication -S3Location_Bucket amzn-s3-demo-bucket -S3Location_BundleType zip -S3Location_Key aws-codedeploy_linux-master.zip -Revision_RevisionType S3
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterApplicationRevision](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-CDOnPremiseInstance`
L'exemple de code suivant montre comment utiliser`Register-CDOnPremiseInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre une instance sur site avec le nom et l’utilisateur IAM spécifiés.**
```
Register-CDOnPremiseInstance -IamUserArn arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser -InstanceName AssetTag12010298EX
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterOnPremisesInstance](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CDApplication`
L'exemple de code suivant montre comment utiliser`Remove-CDApplication`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’application portant le nom spécifié. La commande vous invite à confirmer avant de poursuivre. Ajoutez le paramètre -Force pour supprimer l’application sans invite.**
```
Remove-CDApplication -ApplicationName MyNewApplication
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteApplication](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CDDeploymentConfig`
L'exemple de code suivant montre comment utiliser`Remove-CDDeploymentConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la configuration de déploiement avec le nom spécifié. La commande vous invite à confirmer avant de poursuivre. Ajoutez le paramètre -Force pour supprimer la configuration de déploiement sans invite.**
```
Remove-CDDeploymentConfig -DeploymentConfigName AtLeastTwoHealthyHosts
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteDeploymentConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CDDeploymentGroup`
L'exemple de code suivant montre comment utiliser`Remove-CDDeploymentGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le groupe de déploiement avec le nom spécifié pour l’application spécifiée. La commande vous invite à confirmer avant de poursuivre. Ajoutez le paramètre -Force pour supprimer le groupe de déploiement sans invite.**
```
Remove-CDDeploymentGroup -ApplicationName MyNewApplication -DeploymentGroupName MyNewDeploymentGroup
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteDeploymentGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CDOnPremiseInstanceTag`
L'exemple de code suivant montre comment utiliser`Remove-CDOnPremiseInstanceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la balise spécifiée pour l’instance sur site avec le nom spécifié. La commande vous invite à confirmer avant de poursuivre. Ajoutez le paramètre -Force pour supprimer la balise sans invite.**
```
Remove-CDOnPremiseInstanceTag -InstanceName AssetTag12010298EX -Tag @{"Key" = "Name"; "Value" = "CodeDeployDemo-OnPrem"}
```
+ Pour plus de détails sur l'API, reportez-vous [RemoveTagsFromOnPremisesInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-CDDeployment`
L'exemple de code suivant montre comment utiliser`Stop-CDDeployment`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple tente d’arrêter le déploiement avec l’ID de déploiement spécifié.**
```
Stop-CDDeployment -DeploymentId d-LJQNREYEX
```
**Sortie** :
```
Status StatusMessage
------ -------------
Pending Stopping Pending. Stopping to schedule commands in the deployment instances
```
+ Pour plus de détails sur l'API, reportez-vous [StopDeployment](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-CDOnPremiseInstance`
L'exemple de code suivant montre comment utiliser`Unregister-CDOnPremiseInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple annule l’enregistrement de l’instance sur site avec le nom spécifié.**
```
Unregister-CDOnPremiseInstance -InstanceName AssetTag12010298EX
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterOnPremisesInstance](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-CDApplication`
L'exemple de code suivant montre comment utiliser`Update-CDApplication`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie le nom de l’application spécifiée.**
```
Update-CDApplication -ApplicationName MyNewApplication -NewApplicationName MyNewApplication-2
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateApplication](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-CDDeploymentGroup`
L'exemple de code suivant montre comment utiliser`Update-CDDeploymentGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie le nom du groupe de déploiement spécifié pour l’application spécifiée.**
```
Update-CDDeploymentGroup -ApplicationName MyNewApplication -CurrentDeploymentGroupName MyNewDeploymentGroup -NewDeploymentGroupName MyNewDeploymentGroup-2
```
**Exemple 2 : Cet exemple montre comment spécifier des groupes de balises d'instance EC2 par lesquels une instance doit être identifiée afin qu'elle soit incluse dans l'environnement de remplacement pour un blue/green déploiement.**
```
Update-CDDeploymentGroup -ApplicationName MyNewApplication -CurrentDeploymentGroupName MyNewDeploymentGroup -NewDeploymentGroupName MyNewDeploymentGroup-2 -Ec2TagSetList @(@{Key="key1";Type="KEY_ONLY"},@{Key="Key2";Type="KEY_AND_VALUE";Value="Value2"}),@(@{Key="Key3";Type="VALUE_ONLY";Value="Value3"})
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateDeploymentGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# CodePipeline exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec CodePipeline.
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
### `Confirm-CPJob`
L'exemple de code suivant montre comment utiliser`Confirm-CPJob`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient le statut d’une tâche spécifique.**
```
Confirm-CPJob -JobId f570dc12-5ef3-44bc-945a-6e133EXAMPLE -Nonce 3
```
**Sortie** :
```
Value
-----
InProgress
```
+ Pour plus de détails sur l'API, reportez-vous [AcknowledgeJob](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Disable-CPStageTransition`
L'exemple de code suivant montre comment utiliser`Disable-CPStageTransition`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple désactive la transition entrante pour l’étape spécifiée dans le pipeline spécifié.**
```
Disable-CPStageTransition -PipelineName CodePipelineDemo -Reason "Disabling temporarily." -StageName Beta -TransitionType Inbound
```
+ Pour plus de détails sur l'API, reportez-vous [DisableStageTransition](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-CPStageTransition`
L'exemple de code suivant montre comment utiliser`Enable-CPStageTransition`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active la transition entrante pour l’étape spécifiée dans le pipeline spécifié.**
```
Enable-CPStageTransition -PipelineName CodePipelineDemo -StageName Beta -TransitionType Inbound
```
+ Pour plus de détails sur l'API, reportez-vous [EnableStageTransition](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CPActionType`
L'exemple de code suivant montre comment utiliser`Get-CPActionType`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur toutes les actions disponibles pour le propriétaire spécifié.**
```
ForEach ($actionType in (Get-CPActionType -ActionOwnerFilter AWS)) {
Write-Output ("For Category = " + $actionType.Id.Category + ", Owner = " + $actionType.Id.Owner + ", Provider = " + $actionType.Id.Provider + ", Version = " + $actionType.Id.Version + ":")
Write-Output (" ActionConfigurationProperties:")
ForEach ($acp in $actionType.ActionConfigurationProperties) {
Write-Output (" For " + $acp.Name + ":")
Write-Output (" Description = " + $acp.Description)
Write-Output (" Key = " + $acp.Key)
Write-Output (" Queryable = " + $acp.Queryable)
Write-Output (" Required = " + $acp.Required)
Write-Output (" Secret = " + $acp.Secret)
}
Write-Output (" InputArtifactDetails:")
Write-Output (" MaximumCount = " + $actionType.InputArtifactDetails.MaximumCount)
Write-Output (" MinimumCount = " + $actionType.InputArtifactDetails.MinimumCount)
Write-Output (" OutputArtifactDetails:")
Write-Output (" MaximumCount = " + $actionType.OutputArtifactDetails.MaximumCount)
Write-Output (" MinimumCount = " + $actionType.OutputArtifactDetails.MinimumCount)
Write-Output (" Settings:")
Write-Output (" EntityUrlTemplate = " + $actionType.Settings.EntityUrlTemplate)
Write-Output (" ExecutionUrlTemplate = " + $actionType.Settings.ExecutionUrlTemplate)
}
```
**Sortie** :
```
For Category = Deploy, Owner = AWS, Provider = ElasticBeanstalk, Version = 1:
ActionConfigurationProperties:
For ApplicationName:
Description = The AWS Elastic Beanstalk Application name
Key = True
Queryable = False
Required = True
Secret = False
For EnvironmentName:
Description = The AWS Elastic Beanstalk Environment name
Key = True
Queryable = False
Required = True
Secret = False
InputArtifactDetails:
MaximumCount = 1
MinimumCount = 1
OutputArtifactDetails:
MaximumCount = 0
MinimumCount = 0
Settings:
EntityUrlTemplate = https://console.aws.amazon.com/elasticbeanstalk/r/application/{Config:ApplicationName}
ExecutionUrlTemplate = https://console.aws.amazon.com/elasticbeanstalk/r/application/{Config:ApplicationName}
For Category = Deploy, Owner = AWS, Provider = CodeDeploy, Version = 1:
ActionConfigurationProperties:
For ApplicationName:
Description = The AWS CodeDeploy Application name
Key = True
Queryable = False
Required = True
Secret = False
For DeploymentGroupName:
Description = The AWS CodeDeploy Deployment Group name
Key = True
Queryable = False
Required = True
Secret = False
InputArtifactDetails:
MaximumCount = 1
MinimumCount = 1
OutputArtifactDetails:
MaximumCount = 0
MinimumCount = 0
Settings:
EntityUrlTemplate = https://console.aws.amazon.com/codedeploy/home?#/applications/{Config:ApplicationName}/deployment-groups/{Config:DeploymentGroupName}
ExecutionUrlTemplate = https://console.aws.amazon.com/codedeploy/home?#/deployments/{ExternalExecutionId}
```
+ Pour plus de détails sur l'API, reportez-vous [ListActionTypes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CPActionableJobList`
L'exemple de code suivant montre comment utiliser`Get-CPActionableJobList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations sur toutes les tâches exploitables pour la catégorie d’action, le propriétaire, le fournisseur, la version et les paramètres de requête spécifiés.**
```
Get-CPActionableJobList -ActionTypeId_Category Build -ActionTypeId_Owner Custom -ActionTypeId_Provider MyCustomProviderName -ActionTypeId_Version 1 -QueryParam @{"ProjectName" = "MyProjectName"}
```
**Sortie** :
```
AccountId Data Id Nonce
--------- ---- -- -----
80398EXAMPLE Amazon.CodePipeline.Model.JobData 0de392f5-712d-4f41-ace3-f57a0EXAMPLE 3
```
+ Pour plus de détails sur l'API, reportez-vous [PollForJobs](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CPJobDetail`
L'exemple de code suivant montre comment utiliser`Get-CPJobDetail`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations générales sur la tâche spécifiée.**
```
Get-CPJobDetail -JobId f570dc12-5ef3-44bc-945a-6e133EXAMPLE
```
**Sortie** :
```
AccountId Data Id
--------- ---- --
80398EXAMPLE Amazon.CodePipeline.Model.JobData f570dc12-5ef3-44bc-945a-6e133EXAMPLE
```
**Exemple 2 : cet exemple obtient des informations détaillées sur la tâche spécifiée.**
```
$jobDetails = Get-CPJobDetail -JobId f570dc12-5ef3-44bc-945a-6e133EXAMPLE
Write-Output ("For Job " + $jobDetails.Id + ":")
Write-Output (" AccountId = " + $jobDetails.AccountId)
$jobData = $jobDetails.Data
Write-Output (" Configuration:")
ForEach ($key in $jobData.ActionConfiguration.Keys) {
$value = $jobData.ActionConfiguration.$key
Write-Output (" " + $key + " = " + $value)
}
Write-Output (" ActionTypeId:")
Write-Output (" Category = " + $jobData.ActionTypeId.Category)
Write-Output (" Owner = " + $jobData.ActionTypeId.Owner)
Write-Output (" Provider = " + $jobData.ActionTypeId.Provider)
Write-Output (" Version = " + $jobData.ActionTypeId.Version)
Write-Output (" ArtifactCredentials:")
Write-Output (" AccessKeyId = " + $jobData.ArtifactCredentials.AccessKeyId)
Write-Output (" SecretAccessKey = " + $jobData.ArtifactCredentials.SecretAccessKey)
Write-Output (" SessionToken = " + $jobData.ArtifactCredentials.SessionToken)
Write-Output (" InputArtifacts:")
ForEach ($ia in $jobData.InputArtifacts) {
Write-Output (" " + $ia.Name)
}
Write-Output (" OutputArtifacts:")
ForEach ($oa in $jobData.OutputArtifacts) {
Write-Output (" " + $oa.Name)
}
Write-Output (" PipelineContext:")
$context = $jobData.PipelineContext
Write-Output (" Name = " + $context.Action.Name)
Write-Output (" PipelineName = " + $context.PipelineName)
Write-Output (" Stage = " + $context.Stage.Name)
```
**Sortie** :
```
For Job f570dc12-5ef3-44bc-945a-6e133EXAMPLE:
AccountId = 80398EXAMPLE
Configuration:
ActionTypeId:
Category = Build
Owner = Custom
Provider = MyCustomProviderName
Version = 1
ArtifactCredentials:
AccessKeyId = ASIAIEI3...IXI6YREX
SecretAccessKey = cqAFDhEi...RdQyfa2u
SessionToken = AQoDYXdz...5u+lsAU=
InputArtifacts:
MyApp
OutputArtifacts:
MyAppBuild
PipelineContext:
Name = Build
PipelineName = CodePipelineDemo
Stage = Build
```
+ Pour plus de détails sur l'API, reportez-vous [GetJobDetails](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CPPipeline`
L'exemple de code suivant montre comment utiliser`Get-CPPipeline`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations générales sur le pipeline spécifié.**
```
Get-CPPipeline -Name CodePipelineDemo -Version 1
```
**Sortie** :
```
ArtifactStore : Amazon.CodePipeline.Model.ArtifactStore
Name : CodePipelineDemo
RoleArn : arn:aws:iam::80398EXAMPLE:role/CodePipelineServiceRole
Stages : {Source, Build, Beta, TestStage}
Version : 1
```
**Exemple 2 : cet exemple obtient des informations détaillées sur le pipeline spécifié.**
```
$pipeline = Get-CPPipeline -Name CodePipelineDemo
Write-Output ("Name = " + $pipeline.Name)
Write-Output ("RoleArn = " + $pipeline.RoleArn)
Write-Output ("Version = " + $pipeline.Version)
Write-Output ("ArtifactStore:")
Write-Output (" Location = " + $pipeline.ArtifactStore.Location)
Write-Output (" Type = " + $pipeline.ArtifactStore.Type.Value)
Write-Output ("Stages:")
ForEach ($stage in $pipeline.Stages) {
Write-Output (" Name = " + $stage.Name)
Write-Output (" Actions:")
ForEach ($action in $stage.Actions) {
Write-Output (" Name = " + $action.Name)
Write-Output (" Category = " + $action.ActionTypeId.Category)
Write-Output (" Owner = " + $action.ActionTypeId.Owner)
Write-Output (" Provider = " + $action.ActionTypeId.Provider)
Write-Output (" Version = " + $action.ActionTypeId.Version)
Write-Output (" Configuration:")
ForEach ($key in $action.Configuration.Keys) {
$value = $action.Configuration.$key
Write-Output (" " + $key + " = " + $value)
}
Write-Output (" InputArtifacts:")
ForEach ($ia in $action.InputArtifacts) {
Write-Output (" " + $ia.Name)
}
ForEach ($oa in $action.OutputArtifacts) {
Write-Output (" " + $oa.Name)
}
Write-Output (" RunOrder = " + $action.RunOrder)
}
}
```
**Sortie** :
```
Name = CodePipelineDemo
RoleArn = arn:aws:iam::80398EXAMPLE:role/CodePipelineServiceRole
Version = 3
ArtifactStore:
Location = amzn-s3-demo-bucket
Type = S3
Stages:
Name = Source
Actions:
Name = Source
Category = Source
Owner = ThirdParty
Provider = GitHub
Version = 1
Configuration:
Branch = master
OAuthToken = ****
Owner = my-user-name
Repo = MyRepoName
InputArtifacts:
MyApp
RunOrder = 1
Name = Build
Actions:
Name = Build
Category = Build
Owner = Custom
Provider = MyCustomProviderName
Version = 1
Configuration:
ProjectName = MyProjectName
InputArtifacts:
MyApp
MyAppBuild
RunOrder = 1
Name = Beta
Actions:
Name = CodePipelineDemoFleet
Category = Deploy
Owner = AWS
Provider = CodeDeploy
Version = 1
Configuration:
ApplicationName = CodePipelineDemoApplication
DeploymentGroupName = CodePipelineDemoFleet
InputArtifacts:
MyAppBuild
RunOrder = 1
Name = TestStage
Actions:
Name = MyJenkinsTestAction
Category = Test
Owner = Custom
Provider = MyCustomTestProvider
Version = 1
Configuration:
ProjectName = MyJenkinsProjectName
InputArtifacts:
MyAppBuild
RunOrder = 1
```
+ Pour plus de détails sur l'API, reportez-vous [GetPipeline](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CPPipelineList`
L'exemple de code suivant montre comment utiliser`Get-CPPipelineList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient une liste des pipelines disponibles.**
```
Get-CPPipelineList
```
**Sortie** :
```
Created Name Updated Version
------- ---- ------- -------
8/13/2015 10:17:54 PM CodePipelineDemo 8/13/2015 10:17:54 PM 3
7/8/2015 2:41:53 AM MyFirstPipeline 7/22/2015 9:06:37 PM 7
```
+ Pour plus de détails sur l'API, reportez-vous [ListPipelines](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CPPipelineState`
L'exemple de code suivant montre comment utiliser`Get-CPPipelineState`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient des informations générales sur les étapes pour le pipeline spécifié.**
```
Get-CPPipelineState -Name CodePipelineDemo
```
**Sortie** :
```
Created : 8/13/2015 10:17:54 PM
PipelineName : CodePipelineDemo
PipelineVersion : 1
StageStates : {Source, Build, Beta, TestStage}
Updated : 8/13/2015 10:17:54 PM
```
**Exemple 2 : cet exemple obtient des informations détaillées sur l’état du pipeline spécifié.**
```
ForEach ($stageState in (Get-CPPipelineState -Name $arg).StageStates) {
Write-Output ("For " + $stageState.StageName + ":")
Write-Output (" InboundTransitionState:")
Write-Output (" DisabledReason = " + $stageState.InboundTransitionState.DisabledReason)
Write-Output (" Enabled = " + $stageState.InboundTransitionState.Enabled)
Write-Output (" LastChangedAt = " + $stageState.InboundTransitionState.LastChangedAt)
Write-Output (" LastChangedBy = " + $stageState.InboundTransitionState.LastChangedBy)
Write-Output (" ActionStates:")
ForEach ($actionState in $stageState.ActionStates) {
Write-Output (" For " + $actionState.ActionName + ":")
Write-Output (" CurrentRevision:")
Write-Output (" Created = " + $actionState.CurrentRevision.Created)
Write-Output (" RevisionChangeId = " + $actionState.CurrentRevision.RevisionChangeId)
Write-Output (" RevisionId = " + $actionState.CurrentRevision.RevisionId)
Write-Output (" EntityUrl = " + $actionState.EntityUrl)
Write-Output (" LatestExecution:")
Write-Output (" ErrorDetails:")
Write-Output (" Code = " + $actionState.LatestExecution.ErrorDetails.Code)
Write-Output (" Message = " + $actionState.LatestExecution.ErrorDetails.Message)
Write-Output (" ExternalExecutionId = " + $actionState.LatestExecution.ExternalExecutionId)
Write-Output (" ExternalExecutionUrl = " + $actionState.LatestExecution.ExternalExecutionUrl)
Write-Output (" LastStatusChange = " + $actionState.LatestExecution.LastStatusChange)
Write-Output (" PercentComplete = " + $actionState.LatestExecution.PercentComplete)
Write-Output (" Status = " + $actionState.LatestExecution.Status)
Write-Output (" Summary = " + $actionState.LatestExecution.Summary)
Write-Output (" RevisionUrl = " + $actionState.RevisionUrl)
}
}
```
**Sortie** :
```
For Source:
InboundTransitionState:
DisabledReason =
Enabled =
LastChangedAt =
LastChangedBy =
ActionStates:
For Source:
CurrentRevision:
Created =
RevisionChangeId =
RevisionId =
EntityUrl = https://github.com/my-user-name/MyRepoName/tree/master
LatestExecution:
ErrorDetails:
Code =
Message =
ExternalExecutionId =
ExternalExecutionUrl =
LastStatusChange = 07/20/2015 23:28:45
PercentComplete = 0
Status = Succeeded
Summary =
RevisionUrl =
For Build:
InboundTransitionState:
DisabledReason =
Enabled = True
LastChangedAt = 01/01/0001 00:00:00
LastChangedBy =
ActionStates:
For Build:
CurrentRevision:
Created =
RevisionChangeId =
RevisionId =
EntityUrl = http://54.174.131.1EX/job/MyJenkinsDemo
LatestExecution:
ErrorDetails:
Code = TimeoutError
Message = The action failed because a job worker exceeded its time limit. If this is a custom action, make sure that the job worker is configured correctly.
ExternalExecutionId =
ExternalExecutionUrl =
LastStatusChange = 07/21/2015 00:29:29
PercentComplete = 0
Status = Failed
Summary =
RevisionUrl =
For Beta:
InboundTransitionState:
DisabledReason =
Enabled = True
LastChangedAt = 01/01/0001 00:00:00
LastChangedBy =
ActionStates:
For CodePipelineDemoFleet:
CurrentRevision:
Created =
RevisionChangeId =
RevisionId =
EntityUrl = https://console.aws.amazon.com/codedeploy/home?#/applications/CodePipelineDemoApplication/deployment-groups/CodePipelineDemoFleet
LatestExecution:
ErrorDetails:
Code =
Message =
ExternalExecutionId = d-D5LTCZXEX
ExternalExecutionUrl = https://console.aws.amazon.com/codedeploy/home?#/deployments/d-D5LTCZXEX
LastStatusChange = 07/08/2015 22:07:42
PercentComplete = 0
Status = Succeeded
Summary = Deployment Succeeded
RevisionUrl =
For TestStage:
InboundTransitionState:
DisabledReason =
Enabled = True
LastChangedAt = 01/01/0001 00:00:00
LastChangedBy =
ActionStates:
For MyJenkinsTestAction25:
CurrentRevision:
Created =
RevisionChangeId =
RevisionId =
EntityUrl = http://54.174.131.1EX/job/MyJenkinsDemo
LatestExecution:
ErrorDetails:
Code =
Message =
ExternalExecutionId = 5
ExternalExecutionUrl = http://54.174.131.1EX/job/MyJenkinsDemo/5
LastStatusChange = 07/08/2015 22:09:03
PercentComplete = 0
Status = Succeeded
Summary = Finished
RevisionUrl =
```
+ Pour plus de détails sur l'API, reportez-vous [GetPipelineState](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CPCustomActionType`
L'exemple de code suivant montre comment utiliser`New-CPCustomActionType`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une action personnalisée avec les propriétés spécifiées.**
```
New-CPCustomActionType -Category Build -ConfigurationProperty @{"Description" = "The name of the build project must be provided when this action is added to the pipeline."; "Key" = $True; "Name" = "ProjectName"; "Queryable" = $False; "Required" = $True; "Secret" = $False; "Type" = "String"} -Settings_EntityUrlTemplate "https://my-build-instance/job/{Config:ProjectName}/" -Settings_ExecutionUrlTemplate "https://my-build-instance/job/mybuildjob/lastSuccessfulBuild{ExternalExecutionId}/" -InputArtifactDetails_MaximumCount 1 -OutputArtifactDetails_MaximumCount 1 -InputArtifactDetails_MinimumCount 0 -OutputArtifactDetails_MinimumCount 0 -Provider "MyBuildProviderName" -Version 1
```
**Sortie** :
```
ActionConfigurationProperties : {ProjectName}
Id : Amazon.CodePipeline.Model.ActionTypeId
InputArtifactDetails : Amazon.CodePipeline.Model.ArtifactDetails
OutputArtifactDetails : Amazon.CodePipeline.Model.ArtifactDetails
Settings : Amazon.CodePipeline.Model.ActionTypeSettings
```
+ Pour plus de détails sur l'API, reportez-vous [CreateCustomActionType](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CPPipeline`
L'exemple de code suivant montre comment utiliser`New-CPPipeline`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un pipeline avec les paramètres spécifiés.**
```
$pipeline = New-Object Amazon.CodePipeline.Model.PipelineDeclaration
$sourceStageAction = New-Object Amazon.CodePipeline.Model.ActionDeclaration
$deployStageAction = New-Object Amazon.CodePipeline.Model.ActionDeclaration
$sourceStageActionOutputArtifact = New-Object Amazon.CodePipeline.Model.OutputArtifact
$sourceStageActionOutputArtifact.Name = "MyApp"
$sourceStageAction.ActionTypeId = @{"Category" = "Source"; "Owner" = "AWS"; "Provider" = "S3"; "Version" = 1}
$sourceStageAction.Configuration.Add("S3Bucket", "amzn-s3-demo-bucket")
$sourceStageAction.Configuration.Add("S3ObjectKey", "my-object-key-name.zip")
$sourceStageAction.OutputArtifacts.Add($sourceStageActionOutputArtifact)
$sourceStageAction.Name = "Source"
$deployStageActionInputArtifact = New-Object Amazon.CodePipeline.Model.InputArtifact
$deployStageActionInputArtifact.Name = "MyApp"
$deployStageAction.ActionTypeId = @{"Category" = "Deploy"; "Owner" = "AWS"; "Provider" = "CodeDeploy"; "Version" = 1}
$deployStageAction.Configuration.Add("ApplicationName", "CodePipelineDemoApplication")
$deployStageAction.Configuration.Add("DeploymentGroupName", "CodePipelineDemoFleet")
$deployStageAction.InputArtifacts.Add($deployStageActionInputArtifact)
$deployStageAction.Name = "CodePipelineDemoFleet"
$sourceStage = New-Object Amazon.CodePipeline.Model.StageDeclaration
$deployStage = New-Object Amazon.CodePipeline.Model.StageDeclaration
$sourceStage.Name = "Source"
$deployStage.Name = "Beta"
$sourceStage.Actions.Add($sourceStageAction)
$deployStage.Actions.Add($deployStageAction)
$pipeline.ArtifactStore = @{"Location" = "amzn-s3-demo-bucket"; "Type" = "S3"}
$pipeline.Name = "CodePipelineDemo"
$pipeline.RoleArn = "arn:aws:iam::80398EXAMPLE:role/CodePipelineServiceRole"
$pipeline.Stages.Add($sourceStage)
$pipeline.Stages.Add($deployStage)
$pipeline.Version = 1
New-CPPipeline -Pipeline $pipeline
```
**Sortie** :
```
ArtifactStore : Amazon.CodePipeline.Model.ArtifactStore
Name : CodePipelineDemo
RoleArn : arn:aws:iam::80398EXAMPLE:role/CodePipelineServiceRole
Stages : {Source, Beta}
Version : 1
```
+ Pour plus de détails sur l'API, reportez-vous [CreatePipeline](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CPCustomActionType`
L'exemple de code suivant montre comment utiliser`Remove-CPCustomActionType`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’action personnalisée spécifiée. La commande vous invite à confirmer avant de poursuivre. Ajoutez le paramètre -Force pour supprimer l’action personnalisée sans invite.**
```
Remove-CPCustomActionType -Category Build -Provider MyBuildProviderName -Version 1
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteCustomActionType](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CPPipeline`
L'exemple de code suivant montre comment utiliser`Remove-CPPipeline`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le pipeline spécifié. La commande vous invite à confirmer avant de poursuivre. Ajoutez le paramètre -Force pour supprimer le pipeline sans invite.**
```
Remove-CPPipeline -Name CodePipelineDemo
```
+ Pour plus de détails sur l'API, reportez-vous [DeletePipeline](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Start-CPPipelineExecution`
L'exemple de code suivant montre comment utiliser`Start-CPPipelineExecution`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple commence à exécuter le pipeline spécifié.**
```
Start-CPPipelineExecution -Name CodePipelineDemo
```
+ Pour plus de détails sur l'API, reportez-vous [StartPipelineExecution](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-CPPipeline`
L'exemple de code suivant montre comment utiliser`Update-CPPipeline`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour le pipeline existant spécifié avec les paramètres spécifiés.**
```
$pipeline = New-Object Amazon.CodePipeline.Model.PipelineDeclaration
$sourceStageAction = New-Object Amazon.CodePipeline.Model.ActionDeclaration
$deployStageAction = New-Object Amazon.CodePipeline.Model.ActionDeclaration
$sourceStageActionOutputArtifact = New-Object Amazon.CodePipeline.Model.OutputArtifact
$sourceStageActionOutputArtifact.Name = "MyApp"
$sourceStageAction.ActionTypeId = @{"Category" = "Source"; "Owner" = "AWS"; "Provider" = "S3"; "Version" = 1}
$sourceStageAction.Configuration.Add("S3Bucket", "amzn-s3-demo-bucket")
$sourceStageAction.Configuration.Add("S3ObjectKey", "my-object-key-name.zip")
$sourceStageAction.OutputArtifacts.Add($sourceStageActionOutputArtifact)
$sourceStageAction.Name = "Source"
$deployStageActionInputArtifact = New-Object Amazon.CodePipeline.Model.InputArtifact
$deployStageActionInputArtifact.Name = "MyApp"
$deployStageAction.ActionTypeId = @{"Category" = "Deploy"; "Owner" = "AWS"; "Provider" = "CodeDeploy"; "Version" = 1}
$deployStageAction.Configuration.Add("ApplicationName", "CodePipelineDemoApplication")
$deployStageAction.Configuration.Add("DeploymentGroupName", "CodePipelineDemoFleet")
$deployStageAction.InputArtifacts.Add($deployStageActionInputArtifact)
$deployStageAction.Name = "CodePipelineDemoFleet"
$sourceStage = New-Object Amazon.CodePipeline.Model.StageDeclaration
$deployStage = New-Object Amazon.CodePipeline.Model.StageDeclaration
$sourceStage.Name = "MyInputFiles"
$deployStage.Name = "MyTestDeployment"
$sourceStage.Actions.Add($sourceStageAction)
$deployStage.Actions.Add($deployStageAction)
$pipeline.ArtifactStore = @{"Location" = "amzn-s3-demo-bucket"; "Type" = "S3"}
$pipeline.Name = "CodePipelineDemo"
$pipeline.RoleArn = "arn:aws:iam::80398EXAMPLE:role/CodePipelineServiceRole"
$pipeline.Stages.Add($sourceStage)
$pipeline.Stages.Add($deployStage)
$pipeline.Version = 1
Update-CPPipeline -Pipeline $pipeline
```
**Sortie** :
```
ArtifactStore : Amazon.CodePipeline.Model.ArtifactStore
Name : CodePipelineDemo
RoleArn : arn:aws:iam::80398EXAMPLE:role/CodePipelineServiceRole
Stages : {InputFiles, TestDeployment}
Version : 2
```
+ Pour plus de détails sur l'API, reportez-vous [UpdatePipeline](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Amazon Cognito Identity utilisant les outils pour la version 4 PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Amazon Cognito Identity.
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
### `Get-CGIIdentityPool`
L'exemple de code suivant montre comment utiliser`Get-CGIIdentityPool`.
**Outils pour PowerShell V4**
**Exemple 1 : extrait les informations relatives à un groupe d’identités spécifique par son ID.**
```
Get-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
**Sortie** :
```
LoggedAt : 8/12/2015 4:29:40 PM
AllowUnauthenticatedIdentities : True
DeveloperProviderName :
IdentityPoolId : us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
IdentityPoolName : CommonTests1
OpenIdConnectProviderARNs : {}
SupportedLoginProviders : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 142
HttpStatusCode : OK
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeIdentityPool](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CGIIdentityPoolList`
L'exemple de code suivant montre comment utiliser`Get-CGIIdentityPoolList`.
**Outils pour PowerShell V4**
**Exemple 1 : extrait une liste de groupes d’identités existants.**
```
Get-CGIIdentityPoolList
```
**Sortie** :
```
IdentityPoolId IdentityPoolName
-------------- ----------------
us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1 CommonTests1
us-east-1:118d242d-204e-4b88-b803-EXAMPLEGUID2 Tests2
us-east-1:15d49393-ab16-431a-b26e-EXAMPLEGUID3 CommonTests13
```
+ Pour plus de détails sur l'API, reportez-vous [ListIdentityPools](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CGIIdentityPoolRole`
L'exemple de code suivant montre comment utiliser`Get-CGIIdentityPoolRole`.
**Outils pour PowerShell V4**
**Exemple 1 : obtient les informations sur les rôles pour un groupe d’identités spécifique.**
```
Get-CGIIdentityPoolRole -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
**Sortie** :
```
LoggedAt : 8/12/2015 4:33:51 PM
IdentityPoolId : us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
Roles : {[unauthenticated, arn:aws:iam::123456789012:role/CommonTests1Role]}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 165
HttpStatusCode : OK
```
+ Pour plus de détails sur l'API, reportez-vous [GetIdentityPoolRoles](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-CGIIdentityPool`
L'exemple de code suivant montre comment utiliser`New-CGIIdentityPool`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un nouveau groupe d’identités qui autorise les identités non authentifiées.**
```
New-CGIIdentityPool -AllowUnauthenticatedIdentities $true -IdentityPoolName CommonTests13
```
**Sortie** :
```
LoggedAt : 8/12/2015 4:56:07 PM
AllowUnauthenticatedIdentities : True
DeveloperProviderName :
IdentityPoolId : us-east-1:15d49393-ab16-431a-b26e-EXAMPLEGUID3
IdentityPoolName : CommonTests13
OpenIdConnectProviderARNs : {}
SupportedLoginProviders : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 136
HttpStatusCode : OK
```
+ Pour plus de détails sur l'API, reportez-vous [CreateIdentityPool](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CGIIdentityPool`
L'exemple de code suivant montre comment utiliser`Remove-CGIIdentityPool`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime un groupe d’identités spécifique.**
```
Remove-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteIdentityPool](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-CGIIdentityPoolRole`
L'exemple de code suivant montre comment utiliser`Set-CGIIdentityPoolRole`.
**Outils pour PowerShell V4**
**Exemple 1 : configure le groupe d’identités spécifique pour qu’il ait un rôle IAM non authentifié.**
```
Set-CGIIdentityPoolRole -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1 -Role @{ "unauthenticated" = "arn:aws:iam::123456789012:role/CommonTests1Role" }
```
+ Pour plus de détails sur l'API, reportez-vous [SetIdentityPoolRoles](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-CGIIdentityPool`
L'exemple de code suivant montre comment utiliser`Update-CGIIdentityPool`.
**Outils pour PowerShell V4**
**Exemple 1 : met à jour certaines propriétés du groupe d’identités, en l’occurrence le nom du groupe d’identités.**
```
Update-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1 -IdentityPoolName NewPoolName
```
**Sortie** :
```
LoggedAt : 8/12/2015 4:53:33 PM
AllowUnauthenticatedIdentities : False
DeveloperProviderName :
IdentityPoolId : us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
IdentityPoolName : NewPoolName
OpenIdConnectProviderARNs : {}
SupportedLoginProviders : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 135
HttpStatusCode : OK
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateIdentityPool](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# AWS Config exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec AWS Config.
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-CFGResourceTag`
L'exemple de code suivant montre comment utiliser`Add-CFGResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple associe la balise spécifiée à l’ARN de la ressource, qui est config-rule/config-rule-16iyn0 dans ce cas.**
```
Add-CFGResourceTag -ResourceArn arn:aws:config:eu-west-1:123456789012:config-rule/config-rule-16iyn0 -Tag @{Key="Release";Value="Beta"}
```
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGAggregateComplianceByConfigRuleList`
L'exemple de code suivant montre comment utiliser`Get-CFGAggregateComplianceByConfigRuleList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple extrait les détails du filtrage ConfigurationAggregator « kaju » pour la règle de configuration donnée et expands/returns la « conformité » de la règle.**
```
Get-CFGAggregateComplianceByConfigRuleList -ConfigurationAggregatorName kaju -Filters_ConfigRuleName ALB_HTTP_TO_HTTPS_REDIRECTION_CHECK | Select-Object -ExpandProperty Compliance
```
**Sortie** :
```
ComplianceContributorCount ComplianceType
-------------------------- --------------
Amazon.ConfigService.Model.ComplianceContributorCount NON_COMPLIANT
```
**Exemple 2 : Cet exemple extrait les détails du compte donné ConfigurationAggregator, les filtre pour le compte donné pour toutes les régions couvertes par l'agrégateur et indique ensuite la conformité de toutes les règles.**
```
Get-CFGAggregateComplianceByConfigRuleList -ConfigurationAggregatorName kaju -Filters_AccountId 123456789012 | Select-Object ConfigRuleName, @{N="Compliance";E={$_.Compliance.ComplianceType}}
```
**Sortie** :
```
ConfigRuleName Compliance
-------------- ----------
ALB_HTTP_TO_HTTPS_REDIRECTION_CHECK NON_COMPLIANT
ec2-instance-no-public-ip NON_COMPLIANT
desired-instance-type NON_COMPLIANT
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAggregateComplianceByConfigRules](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGAggregateComplianceDetailsByConfigRule`
L'exemple de code suivant montre comment utiliser`Get-CFGAggregateComplianceDetailsByConfigRule`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple renvoie les résultats de l'évaluation en sélectionnant la sortie avec l'identifiant de ressource et le type de ressource pour la règle de AWS configuration « » qui sont à l'état desired-instance-type « CONFORME » pour le compte, l'agrégateur, la région et la règle de configuration donnés**
```
Get-CFGAggregateComplianceDetailsByConfigRule -AccountId 123456789012 -AwsRegion eu-west-1 -ComplianceType COMPLIANT -ConfigRuleName desired-instance-type -ConfigurationAggregatorName raju | Select-Object -ExpandProperty EvaluationResultIdentifier | Select-Object -ExpandProperty EvaluationResultQualifier
```
**Sortie** :
```
ConfigRuleName ResourceId ResourceType
-------------- ---------- ------------
desired-instance-type i-0f1bf2f34c5678d12 AWS::EC2::Instance
desired-instance-type i-0fd12dd3456789123 AWS::EC2::Instance
```
+ Pour plus de détails sur l'API, reportez-vous [GetAggregateComplianceDetailsByConfigRule](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGAggregateConfigRuleComplianceSummary`
L'exemple de code suivant montre comment utiliser`Get-CFGAggregateConfigRuleComplianceSummary`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie le nombre de règles non conformes pour un agrégateur donné.**
```
(Get-CFGAggregateConfigRuleComplianceSummary -ConfigurationAggregatorName raju).AggregateComplianceCounts.ComplianceSummary.NonCompliantResourceCount
```
**Sortie** :
```
CapExceeded CappedCount
----------- -----------
False 5
```
+ Pour plus de détails sur l'API, reportez-vous [GetAggregateConfigRuleComplianceSummary](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGAggregateDiscoveredResourceCount`
L'exemple de code suivant montre comment utiliser`Get-CFGAggregateDiscoveredResourceCount`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie le nombre de ressources pour l’agrégateur donné filtré pour la région us-east-1.**
```
Get-CFGAggregateDiscoveredResourceCount -ConfigurationAggregatorName Master -Filters_Region us-east-1
```
**Sortie** :
```
GroupByKey GroupedResourceCounts NextToken TotalDiscoveredResources
---------- --------------------- --------- ------------------------
{} 455
```
**Exemple 2 : cet exemple renvoie le nombre de ressources regroupé par RESOURCE\$1TYPE pour la région filtrée pour l’agrégateur donné.**
```
Get-CFGAggregateDiscoveredResourceCount -ConfigurationAggregatorName Master -Filters_Region us-east-1 -GroupByKey RESOURCE_TYPE |
Select-Object -ExpandProperty GroupedResourceCounts
```
**Sortie** :
```
GroupName ResourceCount
--------- -------------
AWS::CloudFormation::Stack 12
AWS::CloudFront::Distribution 1
AWS::CloudTrail::Trail 1
AWS::DynamoDB::Table 1
AWS::EC2::EIP 2
AWS::EC2::FlowLog 2
AWS::EC2::InternetGateway 4
AWS::EC2::NatGateway 2
AWS::EC2::NetworkAcl 4
AWS::EC2::NetworkInterface 12
AWS::EC2::RouteTable 13
AWS::EC2::SecurityGroup 18
AWS::EC2::Subnet 16
AWS::EC2::VPC 4
AWS::EC2::VPCEndpoint 2
AWS::EC2::VPCPeeringConnection 1
AWS::IAM::Group 2
AWS::IAM::Policy 51
AWS::IAM::Role 78
AWS::IAM::User 7
AWS::Lambda::Function 3
AWS::RDS::DBSecurityGroup 1
AWS::S3::Bucket 3
AWS::SSM::AssociationCompliance 107
AWS::SSM::ManagedInstanceInventory 108
```
+ Pour plus de détails sur l'API, reportez-vous [GetAggregateDiscoveredResourceCounts](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGAggregateDiscoveredResourceList`
L'exemple de code suivant montre comment utiliser`Get-CFGAggregateDiscoveredResourceList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie les identifiants de ressources pour le type de ressource donné agrégés dans l’agrégateur « Irlande ». Pour la liste des types de ressources, veuillez consulter https://docs.aws.amazon.com/sdkfornet/ v3/ apidocs/index.html?page=ConfigService/TConfigServiceResourceType ConfigService .html&tocid=Amazon\$1 \$1. ResourceType**
```
Get-CFGAggregateDiscoveredResourceList -ConfigurationAggregatorName Ireland -ResourceType ([Amazon.ConfigService.ResourceType]::AWSAutoScalingAutoScalingGroup)
```
**Sortie** :
```
ResourceId : arn:aws:autoscaling:eu-west-1:123456789012:autoScalingGroup:12e3b4fc-1234-1234-a123-1d2ba3c45678:autoScalingGroupName/asg-1
ResourceName : asg-1
ResourceType : AWS::AutoScaling::AutoScalingGroup
SourceAccountId : 123456789012
SourceRegion : eu-west-1
```
**Exemple 2 : cet exemple renvoie le type de ressources `AwsEC2SecurityGroup` nommé « default » pour l’agrégateur donné filtré pour la région us-east-1.**
```
Get-CFGAggregateDiscoveredResourceList -ConfigurationAggregatorName raju -ResourceType ([Amazon.ConfigService.ResourceType]::AWSEC2SecurityGroup) -Filters_Region us-east-1 -Filters_ResourceName default
```
**Sortie** :
```
ResourceId : sg-01234bd5dbfa67c89
ResourceName : default
ResourceType : AWS::EC2::SecurityGroup
SourceAccountId : 123456789102
SourceRegion : us-east-1
ResourceId : sg-0123a4ebbf56789be
ResourceName : default
ResourceType : AWS::EC2::SecurityGroup
SourceAccountId : 123456789102
SourceRegion : us-east-1
ResourceId : sg-4fc1d234
ResourceName : default
ResourceType : AWS::EC2::SecurityGroup
SourceAccountId : 123456789102
SourceRegion : us-east-1
```
+ Pour plus de détails sur l'API, reportez-vous [ListAggregateDiscoveredResources](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGAggregateResourceConfig`
L'exemple de code suivant montre comment utiliser`Get-CFGAggregateResourceConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie l’élément de configuration pour la ressource agrégée donnée et développe Configuration.**
```
(Get-CFGAggregateResourceConfig -ResourceIdentifier_SourceRegion us-east-1 -ResourceIdentifier_SourceAccountId 123456789012 -ResourceIdentifier_ResourceId sg-4fc1d234 -ResourceIdentifier_ResourceType ([Amazon.ConfigService.ResourceType]::AWSEC2SecurityGroup) -ConfigurationAggregatorName raju).Configuration | ConvertFrom-Json
```
**Sortie** :
```
{"description":"default VPC security group","groupName":"default","ipPermissions":[{"ipProtocol":"-1","ipv6Ranges":[],"prefixListIds":[],"userIdGroupPairs":[{"groupId":"sg-4fc1d234","userId":"123456789012"}],"ipv4Ranges":[],"ipRanges":[]},{"fromPort":3389,"ipProtocol":"tcp","ipv6Ranges":[],"prefixListIds":[],"toPort":3389,"userIdGroupPairs":[],"ipv4Ranges":[{"cidrIp":"54.240.197.224/29","description":"office subnet"},{"cidrIp":"72.21.198.65/32","description":"home pc"}],"ipRanges":["54.240.197.224/29","72.21.198.65/32"]}],"ownerId":"123456789012","groupId":"sg-4fc1d234","ipPermissionsEgress":[{"ipProtocol":"-1","ipv6Ranges":[],"prefixListIds":[],"userIdGroupPairs":[],"ipv4Ranges":[{"cidrIp":"0.0.0.0/0"}],"ipRanges":["0.0.0.0/0"]}],"tags":[],"vpcId":"vpc-2d1c2e34"}
```
+ Pour plus de détails sur l'API, consultez [GetAggregateResourceconfig-service](https://docs.aws.amazon.com/powershell/v4/reference) dans le manuel *Outils AWS pour PowerShell Cmdlet Reference (*V4).
### `Get-CFGAggregateResourceConfigBatch`
L'exemple de code suivant montre comment utiliser`Get-CFGAggregateResourceConfigBatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple récupère l’élément de configuration actuel pour la ressource (identifiée) présente dans l’agrégateur donné.**
```
$resIdentifier=[Amazon.ConfigService.Model.AggregateResourceIdentifier]@{
ResourceId= "i-012e3cb4df567e8aa"
ResourceName = "arn:aws:ec2:eu-west-1:123456789012:instance/i-012e3cb4df567e8aa"
ResourceType = [Amazon.ConfigService.ResourceType]::AWSEC2Instance
SourceAccountId = "123456789012"
SourceRegion = "eu-west-1"
}
Get-CFGAggregateResourceConfigBatch -ResourceIdentifier $resIdentifier -ConfigurationAggregatorName raju
```
**Sortie** :
```
BaseConfigurationItems UnprocessedResourceIdentifiers
---------------------- ------------------------------
{} {arn:aws:ec2:eu-west-1:123456789012:instance/i-012e3cb4df567e8aa}
```
+ Pour plus de détails sur l'API, consultez [BatchGetAggregateResourceconfig-service](https://docs.aws.amazon.com/powershell/v4/reference) dans le manuel *Outils AWS pour PowerShell Cmdlet Reference (*V4).
### `Get-CFGAggregationAuthorizationList`
L'exemple de code suivant montre comment utiliser`Get-CFGAggregationAuthorizationList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait les autorisations accordées aux agrégateurs.**
```
Get-CFGAggregationAuthorizationList
```
**Sortie** :
```
AggregationAuthorizationArn AuthorizedAccountId AuthorizedAwsRegion CreationTime
--------------------------- ------------------- ------------------- ------------
arn:aws:config-service:eu-west-1:123456789012:aggregation-authorization/123456789012/eu-west-1 123456789012 eu-west-1 8/26/2019 12:55:27 AM
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAggregationAuthorizations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGComplianceByConfigRule`
L'exemple de code suivant montre comment utiliser`Get-CFGComplianceByConfigRule`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple récupère les détails de conformité de la règle ebs-optimized-instance, pour laquelle il n'existe aucun résultat d'évaluation actuel pour la règle, il renvoie donc INSUFFIENT\$1DATA**
```
(Get-CFGComplianceByConfigRule -ConfigRuleName ebs-optimized-instance).Compliance
```
**Sortie** :
```
ComplianceContributorCount ComplianceType
-------------------------- --------------
INSUFFICIENT_DATA
```
**Exemple 2 : cet exemple renvoie le nombre de ressources non conformes pour la règle ALB\$1HTTP\$1TO\$1HTTPS\$1REDIRECTION\$1CHECK.**
```
(Get-CFGComplianceByConfigRule -ConfigRuleName ALB_HTTP_TO_HTTPS_REDIRECTION_CHECK -ComplianceType NON_COMPLIANT).Compliance.ComplianceContributorCount
```
**Sortie** :
```
CapExceeded CappedCount
----------- -----------
False 2
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeComplianceByConfigRule](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGComplianceByResource`
L'exemple de code suivant montre comment utiliser`Get-CFGComplianceByResource`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple vérifie le type de ressource `AWS::SSM::ManagedInstanceInventory` pour le type de conformité « CONFORME ».**
```
Get-CFGComplianceByResource -ComplianceType COMPLIANT -ResourceType AWS::SSM::ManagedInstanceInventory
```
**Sortie** :
```
Compliance ResourceId ResourceType
---------- ---------- ------------
Amazon.ConfigService.Model.Compliance i-0123bcf4b567890e3 AWS::SSM::ManagedInstanceInventory
Amazon.ConfigService.Model.Compliance i-0a1234f6f5d6b78f7 AWS::SSM::ManagedInstanceInventory
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeComplianceByResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGComplianceDetailsByConfigRule`
L'exemple de code suivant montre comment utiliser`Get-CFGComplianceDetailsByConfigRule`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple obtient les résultats de l'évaluation de la règle access-keys-rotated et renvoie la sortie groupée par type de conformité**
```
Get-CFGComplianceDetailsByConfigRule -ConfigRuleName access-keys-rotated | Group-Object ComplianceType
```
**Sortie** :
```
Count Name Group
----- ---- -----
2 COMPLIANT {Amazon.ConfigService.Model.EvaluationResult, Amazon.ConfigService.Model.EvaluationResult}
5 NON_COMPLIANT {Amazon.ConfigService.Model.EvaluationResult, Amazon.ConfigService.Model.EvaluationResult, Amazon.ConfigService.Model.EvaluationRes...
```
**Exemple 2 : Cet exemple interroge les détails de conformité de la règle relative access-keys-rotated aux ressources COMPLIANT.**
```
Get-CFGComplianceDetailsByConfigRule -ConfigRuleName access-keys-rotated -ComplianceType COMPLIANT | ForEach-Object {$_.EvaluationResultIdentifier.EvaluationResultQualifier}
```
**Sortie** :
```
ConfigRuleName ResourceId ResourceType
-------------- ---------- ------------
access-keys-rotated BCAB1CDJ2LITAPVEW3JAH AWS::IAM::User
access-keys-rotated BCAB1CDJ2LITL3EHREM4Q AWS::IAM::User
```
+ Pour plus de détails sur l'API, reportez-vous [GetComplianceDetailsByConfigRule](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGComplianceDetailsByResource`
L'exemple de code suivant montre comment utiliser`Get-CFGComplianceDetailsByResource`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple d’évaluation donne des résultats pour la ressource donnée.**
```
Get-CFGComplianceDetailsByResource -ResourceId ABCD5STJ4EFGHIVEW6JAH -ResourceType 'AWS::IAM::User'
```
**Sortie** :
```
Annotation :
ComplianceType : COMPLIANT
ConfigRuleInvokedTime : 8/25/2019 11:34:56 PM
EvaluationResultIdentifier : Amazon.ConfigService.Model.EvaluationResultIdentifier
ResultRecordedTime : 8/25/2019 11:34:56 PM
ResultToken :
```
+ Pour plus de détails sur l'API, reportez-vous [GetComplianceDetailsByResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGComplianceSummaryByConfigRule`
L'exemple de code suivant montre comment utiliser`Get-CFGComplianceSummaryByConfigRule`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie le nombre de règles Config non conformes.**
```
Get-CFGComplianceSummaryByConfigRule -Select ComplianceSummary.NonCompliantResourceCount
```
**Sortie** :
```
CapExceeded CappedCount
----------- -----------
False 9
```
+ Pour plus de détails sur l'API, reportez-vous [GetComplianceSummaryByConfigRule](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGComplianceSummaryByResourceType`
L'exemple de code suivant montre comment utiliser`Get-CFGComplianceSummaryByResourceType`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie le nombre de ressources conformes ou non conformes et convertit la sortie en json.**
```
Get-CFGComplianceSummaryByResourceType -Select ComplianceSummariesByResourceType.ComplianceSummary | ConvertTo-Json
{
"ComplianceSummaryTimestamp": "2019-12-14T06:14:49.778Z",
"CompliantResourceCount": {
"CapExceeded": false,
"CappedCount": 2
},
"NonCompliantResourceCount": {
"CapExceeded": true,
"CappedCount": 100
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetComplianceSummaryByResourceType](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGConfigRule`
L'exemple de code suivant montre comment utiliser`Get-CFGConfigRule`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les règles de configuration du compte, avec les propriétés sélectionnées.**
```
Get-CFGConfigRule | Select-Object ConfigRuleName, ConfigRuleId, ConfigRuleArn, ConfigRuleState
```
**Sortie** :
```
ConfigRuleName ConfigRuleId ConfigRuleArn ConfigRuleState
-------------- ------------ ------------- ---------------
ALB_REDIRECTION_CHECK config-rule-12iyn3 arn:aws:config-service:eu-west-1:123456789012:config-rule/config-rule-12iyn3 ACTIVE
access-keys-rotated config-rule-aospfr arn:aws:config-service:eu-west-1:123456789012:config-rule/config-rule-aospfr ACTIVE
autoscaling-group-elb-healthcheck-required config-rule-cn1f2x arn:aws:config-service:eu-west-1:123456789012:config-rule/config-rule-cn1f2x ACTIVE
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeConfigRules](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGConfigRuleEvaluationStatus`
L'exemple de code suivant montre comment utiliser`Get-CFGConfigRuleEvaluationStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie les informations de statut pour les règles de configuration données.**
```
Get-CFGConfigRuleEvaluationStatus -ConfigRuleName root-account-mfa-enabled, vpc-flow-logs-enabled
```
**Sortie** :
```
ConfigRuleArn : arn:aws:config:eu-west-1:123456789012:config-rule/config-rule-kvq1wk
ConfigRuleId : config-rule-kvq1wk
ConfigRuleName : root-account-mfa-enabled
FirstActivatedTime : 8/27/2019 8:05:17 AM
FirstEvaluationStarted : True
LastErrorCode :
LastErrorMessage :
LastFailedEvaluationTime : 1/1/0001 12:00:00 AM
LastFailedInvocationTime : 1/1/0001 12:00:00 AM
LastSuccessfulEvaluationTime : 12/13/2019 8:12:03 AM
LastSuccessfulInvocationTime : 12/13/2019 8:12:03 AM
ConfigRuleArn : arn:aws:config:eu-west-1:123456789012:config-rule/config-rule-z1s23b
ConfigRuleId : config-rule-z1s23b
ConfigRuleName : vpc-flow-logs-enabled
FirstActivatedTime : 8/14/2019 6:23:44 AM
FirstEvaluationStarted : True
LastErrorCode :
LastErrorMessage :
LastFailedEvaluationTime : 1/1/0001 12:00:00 AM
LastFailedInvocationTime : 1/1/0001 12:00:00 AM
LastSuccessfulEvaluationTime : 12/13/2019 7:12:01 AM
LastSuccessfulInvocationTime : 12/13/2019 7:12:01 AM
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeConfigRuleEvaluationStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGConfigurationAggregatorList`
L'exemple de code suivant montre comment utiliser`Get-CFGConfigurationAggregatorList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie tous les agrégateurs de la région/du compte.**
```
Get-CFGConfigurationAggregatorList
```
**Sortie** :
```
AccountAggregationSources : {Amazon.ConfigService.Model.AccountAggregationSource}
ConfigurationAggregatorArn : arn:aws:config-service:eu-west-1:123456789012:config-aggregator/config-aggregator-xabca1me
ConfigurationAggregatorName : IrelandMaster
CreationTime : 8/25/2019 11:42:39 PM
LastUpdatedTime : 8/25/2019 11:42:39 PM
OrganizationAggregationSource :
AccountAggregationSources : {}
ConfigurationAggregatorArn : arn:aws:config-service:eu-west-1:123456789012:config-aggregator/config-aggregator-qubqabcd
ConfigurationAggregatorName : raju
CreationTime : 8/11/2019 8:39:25 AM
LastUpdatedTime : 8/11/2019 8:39:25 AM
OrganizationAggregationSource : Amazon.ConfigService.Model.OrganizationAggregationSource
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeConfigurationAggregators](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGConfigurationAggregatorSourcesStatus`
L'exemple de code suivant montre comment utiliser`Get-CFGConfigurationAggregatorSourcesStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche les champs demandés pour les sources dans l’agrégateur donné.**
```
Get-CFGConfigurationAggregatorSourcesStatus -ConfigurationAggregatorName raju | select SourceType, LastUpdateStatus, LastUpdateTime, SourceId
```
**Sortie** :
```
SourceType LastUpdateStatus LastUpdateTime SourceId
---------- ---------------- -------------- --------
ORGANIZATION SUCCEEDED 12/31/2019 7:45:06 AM Organization
ACCOUNT SUCCEEDED 12/31/2019 7:09:38 AM 612641234567
ACCOUNT SUCCEEDED 12/31/2019 7:12:53 AM 933301234567
ACCOUNT SUCCEEDED 12/31/2019 7:18:10 AM 933301234567
ACCOUNT SUCCEEDED 12/31/2019 7:25:17 AM 933301234567
ACCOUNT SUCCEEDED 12/31/2019 7:25:49 AM 612641234567
ACCOUNT SUCCEEDED 12/31/2019 7:26:11 AM 612641234567
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeConfigurationAggregatorSourcesStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGConfigurationRecorder`
L'exemple de code suivant montre comment utiliser`Get-CFGConfigurationRecorder`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie les détails des enregistreurs de configuration.**
```
Get-CFGConfigurationRecorder | Format-List
```
**Sortie** :
```
Name : default
RecordingGroup : Amazon.ConfigService.Model.RecordingGroup
RoleARN : arn:aws:iam::123456789012:role/aws-service-role/config.amazonaws.com/AWSServiceRoleForConfig
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeConfigurationRecorders](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGConfigurationRecorderStatus`
L'exemple de code suivant montre comment utiliser`Get-CFGConfigurationRecorderStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie le statut des enregistreurs de configuration.**
```
Get-CFGConfigurationRecorderStatus
```
**Sortie** :
```
LastErrorCode :
LastErrorMessage :
LastStartTime : 10/11/2019 10:13:51 AM
LastStatus : Success
LastStatusChangeTime : 12/31/2019 6:14:12 AM
LastStopTime : 10/11/2019 10:13:46 AM
Name : default
Recording : True
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeConfigurationRecorderStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGConformancePack`
L'exemple de code suivant montre comment utiliser`Get-CFGConformancePack`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie tous les packs de conformité.**
```
Get-CFGConformancePack
```
**Sortie** :
```
ConformancePackArn : arn:aws:config:eu-west-1:123456789012:conformance-pack/dono/conformance-pack-p0acq8bpz
ConformancePackId : conformance-pack-p0acabcde
ConformancePackInputParameters : {}
ConformancePackName : dono
CreatedBy :
DeliveryS3Bucket : kt-ps-examples
DeliveryS3KeyPrefix :
LastUpdateRequestedTime : 12/31/2019 8:45:31 AM
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeConformancePacks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGDeliveryChannel`
L'exemple de code suivant montre comment utiliser`Get-CFGDeliveryChannel`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait le canal de distribution de la région et affiche les détails.**
```
Get-CFGDeliveryChannel -Region eu-west-1 | Select-Object Name, S3BucketName, S3KeyPrefix, @{N="DeliveryFrequency";E={$_.ConfigSnapshotDeliveryProperties.DeliveryFrequency}}
```
**Sortie** :
```
Name S3BucketName S3KeyPrefix DeliveryFrequency
---- ------------ ----------- -----------------
default config-bucket-NA my TwentyFour_Hours
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeDeliveryChannels](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-CFGResourceTag`
L'exemple de code suivant montre comment utiliser`Get-CFGResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les balises associées à la ressource donnée**
```
Get-CFGResourceTag -ResourceArn $rules[0].ConfigRuleArn
```
**Sortie** :
```
Key Value
--- -----
Version 1.3
```
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-CFGConformancePack`
L'exemple de code suivant montre comment utiliser`Remove-CFGConformancePack`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le pack de conformité donné, ainsi que toutes les règles, actions correctives et résultats d’évaluation du pack.**
```
Remove-CFGConformancePack -ConformancePackName dono
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-CFGConformancePack (DeleteConformancePack)" on target "dono".
[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 [DeleteConformancePack](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-CFGConformancePack`
L'exemple de code suivant montre comment utiliser`Write-CFGConformancePack`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un pack de conformité en récupérant le modèle à partir du fichier yaml donné.**
```
Write-CFGConformancePack -ConformancePackName dono -DeliveryS3Bucket amzn-s3-demo-bucket -TemplateBody (Get-Content C:\windows\temp\template.yaml -Raw)
```
+ Pour plus de détails sur l'API, reportez-vous [PutConformancePack](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-CFGDeliveryChannel`
L'exemple de code suivant montre comment utiliser`Write-CFGDeliveryChannel`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie la propriété deliveryFrequency d’un canal de livraison existant.**
```
Write-CFGDeliveryChannel -ConfigSnapshotDeliveryProperties_DeliveryFrequency TwentyFour_Hours -DeliveryChannelName default -DeliveryChannel_S3BucketName amzn-s3-demo-bucket -DeliveryChannel_S3KeyPrefix my
```
+ Pour plus de détails sur l'API, reportez-vous [PutDeliveryChannel](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples de Device Farm utilisant Tools for PowerShell V4
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 V4 avec Device Farm.
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
### `New-DFUpload`
L'exemple de code suivant montre comment utiliser`New-DFUpload`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un téléchargement de AWS Device Farm pour une application Android. Vous pouvez obtenir l'ARN du projet à partir de la sortie de New- DFProject ou Get- DFProject List. Utilisez l'URL signée dans la DFUpload sortie New- pour télécharger un fichier sur Device Farm.**
```
New-DFUpload -ContentType "application/octet-stream" -ProjectArn "arn:aws:devicefarm:us-west-2:123456789012:project:EXAMPLEa-7ec1-4741-9c1f-d3e04EXAMPLE" -Name "app.apk" -Type ANDROID_APP
```
+ Pour plus de détails sur l'API, reportez-vous [CreateUpload](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Directory Service exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Directory Service.
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-DSIpRoute`
L'exemple de code suivant montre comment utiliser`Add-DSIpRoute`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande supprime la balise de ressource attribuée au Directory-id spécifié**
```
Add-DSIpRoute -DirectoryId d-123456ijkl -IpRoute @{CidrIp ="203.0.113.5/32"} -UpdateSecurityGroupForDirectoryController $true
```
+ Pour plus de détails sur l'API, reportez-vous [AddIpRoutes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-DSResourceTag`
L'exemple de code suivant montre comment utiliser`Add-DSResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande ajoute la balise de ressource au Directory-id spécifié**
```
Add-DSResourceTag -ResourceId d-123456ijkl -Tag @{Key="myTag"; Value="mytgValue"}
```
+ Pour plus de détails sur l'API, reportez-vous [AddTagsToResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Approve-DSTrust`
L'exemple de code suivant montre comment utiliser`Approve-DSTrust`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple appelle l'opération d' VerifyTrust API AWS Directory Service pour le Trustid spécifié.**
```
Approve-DSTrust -TrustId t-9067157123
```
+ Pour plus de détails sur l'API, reportez-vous [VerifyTrust](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Confirm-DSSharedDirectory`
L'exemple de code suivant montre comment utiliser`Confirm-DSSharedDirectory`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple accepte une demande de partage de répertoire envoyée par le propriétaire du répertoire Compte AWS.**
```
Confirm-DSSharedDirectory -SharedDirectoryId d-9067012345
```
**Sortie** :
```
CreatedDateTime : 12/30/2019 4:20:27 AM
LastUpdatedDateTime : 12/30/2019 4:21:40 AM
OwnerAccountId : 123456781234
OwnerDirectoryId : d-123456ijkl
SharedAccountId : 123456784321
SharedDirectoryId : d-9067012345
ShareMethod :
ShareNotes : This is test sharing
ShareStatus : Sharing
```
+ Pour plus de détails sur l'API, reportez-vous [AcceptSharedDirectory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Connect-DSDirectory`
L'exemple de code suivant montre comment utiliser`Connect-DSDirectory`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un AD Connector pour se connecter à un répertoire sur site.**
```
Connect-DSDirectory -Name contoso.com -ConnectSettings_CustomerUserName Administrator -Password $Password -ConnectSettings_CustomerDnsIp 172.31.36.96 -ShortName CONTOSO -Size Small -ConnectSettings_VpcId vpc-123459da -ConnectSettings_SubnetId subnet-1234ccaa, subnet-5678ffbb
```
+ Pour plus de détails sur l'API, reportez-vous [ConnectDirectory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Deny-DSSharedDirectory`
L'exemple de code suivant montre comment utiliser`Deny-DSSharedDirectory`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple rejette une demande de partage de répertoire envoyée par le compte propriétaire du répertoire.**
```
Deny-DSSharedDirectory -SharedDirectoryId d-9067012345
```
**Sortie** :
```
d-9067012345
```
+ Pour plus de détails sur l'API, reportez-vous [RejectSharedDirectory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Disable-DSDirectoryShare`
L'exemple de code suivant montre comment utiliser`Disable-DSDirectoryShare`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple arrête le partage de répertoire entre le propriétaire du répertoire et le compte consommateur.**
```
Disable-DSDirectoryShare -DirectoryId d-123456ijkl -UnshareTarget_Id 123456784321 -UnshareTarget_Type ACCOUNT
```
**Sortie** :
```
d-9067012345
```
+ Pour plus de détails sur l'API, reportez-vous [UnshareDirectory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Disable-DSLDAPS`
L'exemple de code suivant montre comment utiliser`Disable-DSLDAPS`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple désactive les appels sécurisés LDAP pour le répertoire spécifié.**
```
Disable-DSLDAPS -DirectoryId d-123456ijkl -Type Client
```
+ Pour plus de détails sur l’API, consultez [DisableLDAPS](https://docs.aws.amazon.com/powershell/v4/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V4)*.
### `Disable-DSRadius`
L'exemple de code suivant montre comment utiliser`Disable-DSRadius`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple désactive le serveur RADIUS configuré pour un répertoire AD Connector ou Microsoft AD.**
```
Disable-DSRadius -DirectoryId d-123456ijkl
```
+ Pour plus de détails sur l'API, reportez-vous [DisableRadius](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Disable-DSSso`
L'exemple de code suivant montre comment utiliser`Disable-DSSso`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple désactive l’authentification unique pour un répertoire.**
```
Disable-DSSso -DirectoryId d-123456ijkl
```
+ Pour plus de détails sur l'API, reportez-vous [DisableSso](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-DSDirectoryShare`
L'exemple de code suivant montre comment utiliser`Enable-DSDirectoryShare`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple partage un répertoire spécifique de votre AWS compte avec un autre AWS compte en utilisant la méthode Handshake.**
```
Enable-DSDirectoryShare -DirectoryId d-123456ijkl -ShareTarget_Id 123456784321 -ShareMethod HANDSHAKE -ShareTarget_Type ACCOUNT
```
**Sortie** :
```
d-9067012345
```
+ Pour plus de détails sur l'API, reportez-vous [ShareDirectory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-DSLDAPS`
L'exemple de code suivant montre comment utiliser`Enable-DSLDAPS`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active le commutateur pour le répertoire spécifique afin de toujours utiliser les appels sécurisés LDAP.**
```
Enable-DSLDAPS -DirectoryId d-123456ijkl -Type Client
```
+ Pour plus de détails sur l’API, consultez [EnableLDAPS](https://docs.aws.amazon.com/powershell/v4/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V4)*.
### `Enable-DSRadius`
L'exemple de code suivant montre comment utiliser`Enable-DSRadius`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active l’authentification multifactorielle (MFA) avec la configuration de serveur RADIUS fournie pour un répertoire AD Connector ou Microsoft AD.**
```
Enable-DSRadius -DirectoryId d-123456ijkl
-RadiusSettings_AuthenticationProtocol PAP
-RadiusSettings_DisplayLabel Radius
-RadiusSettings_RadiusPort 1812
-RadiusSettings_RadiusRetry 4
-RadiusSettings_RadiusServer 10.4.185.113
-RadiusSettings_RadiusTimeout 50
-RadiusSettings_SharedSecret wJalrXUtnFEMI
```
+ Pour plus de détails sur l'API, reportez-vous [EnableRadius](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-DSSso`
L'exemple de code suivant montre comment utiliser`Enable-DSSso`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active l’authentification unique pour un répertoire.**
```
Enable-DSSso -DirectoryId d-123456ijkl
```
+ Pour plus de détails sur l'API, reportez-vous [EnableSso](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSCertificate`
L'exemple de code suivant montre comment utiliser`Get-DSCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche des informations sur le certificat enregistré pour une connexion LDAP sécurisée.**
```
Get-DSCertificate -DirectoryId d-123456ijkl -CertificateId c-906731e34f
```
**Sortie** :
```
CertificateId : c-906731e34f
CommonName : contoso-EC2AMAZ-CTGG2NM-CA
ExpiryDateTime : 4/15/2025 6:34:15 PM
RegisteredDateTime : 4/15/2020 6:38:56 PM
State : Registered
StateReason : Certificate registered successfully.
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSCertificateList`
L'exemple de code suivant montre comment utiliser`Get-DSCertificateList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie tous les certificats enregistrés pour une connexion LDAP sécurisée pour le répertoire spécifié.**
```
Get-DSCertificateList -DirectoryId d-123456ijkl
```
**Sortie** :
```
CertificateId CommonName ExpiryDateTime State
------------- ---------- -------------- -----
c-906731e34f contoso-EC2AMAZ-CTGG2NM-CA 4/15/2025 6:34:15 PM Registered
```
+ Pour plus de détails sur l'API, reportez-vous [ListCertificates](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSConditionalForwarder`
L'exemple de code suivant montre comment utiliser`Get-DSConditionalForwarder`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande obtient tous les redirecteurs conditionnels configurés ayant un Directory-id donné.**
```
Get-DSConditionalForwarder -DirectoryId d-123456ijkl
```
**Sortie** :
```
DnsIpAddrs RemoteDomainName ReplicationScope
---------- ---------------- ----------------
{172.31.77.239} contoso.com Domain
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeConditionalForwarders](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSDirectory`
L'exemple de code suivant montre comment utiliser`Get-DSDirectory`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande obtient des informations sur les répertoires qui appartiennent à ce compte.**
```
Get-DSDirectory | Select-Object DirectoryId, Name, DnsIpAddrs, Type
```
**Sortie** :
```
DirectoryId Name DnsIpAddrs Type
----------- ---- ---------- ----
d-123456abcd abcd.example.com {172.31.74.189, 172.31.13.145} SimpleAD
d-123456efgh wifi.example.com {172.31.16.108, 172.31.10.56} ADConnector
d-123456ijkl lan2.example.com {172.31.10.56, 172.31.16.108} MicrosoftAD
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeDirectories](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSDirectoryLimit`
L'exemple de code suivant montre comment utiliser`Get-DSDirectoryLimit`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche les informations de limite de répertoire pour la région us-east-1.**
```
Get-DSDirectoryLimit -Region us-east-1
```
**Sortie** :
```
CloudOnlyDirectoriesCurrentCount : 1
CloudOnlyDirectoriesLimit : 10
CloudOnlyDirectoriesLimitReached : False
CloudOnlyMicrosoftADCurrentCount : 1
CloudOnlyMicrosoftADLimit : 20
CloudOnlyMicrosoftADLimitReached : False
ConnectedDirectoriesCurrentCount : 1
ConnectedDirectoriesLimit : 10
```
+ Pour plus de détails sur l'API, reportez-vous [GetDirectoryLimits](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSDomainControllerList`
L'exemple de code suivant montre comment utiliser`Get-DSDomainControllerList`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande obtient la liste détaillée des contrôleurs de domaine lancés pour le directory-id mentionné**
```
Get-DSDomainControllerList -DirectoryId d-123456ijkl
```
**Sortie** :
```
AvailabilityZone : us-east-1b
DirectoryId : d-123456ijkl
DnsIpAddr : 172.31.16.108
DomainControllerId : dc-1234567aa6
LaunchTime : 4/4/2019 4:53:43 AM
Status : Active
StatusLastUpdatedDateTime : 4/24/2019 1:37:54 PM
StatusReason :
SubnetId : subnet-1234kkaa
VpcId : vpc-123459d
AvailabilityZone : us-east-1d
DirectoryId : d-123456ijkl
DnsIpAddr : 172.31.10.56
DomainControllerId : dc-1234567aa7
LaunchTime : 4/4/2019 4:53:43 AM
Status : Active
StatusLastUpdatedDateTime : 4/4/2019 5:14:31 AM
StatusReason :
SubnetId : subnet-5678ffbb
VpcId : vpc-123459d
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeDomainControllers](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSEventTopic`
L'exemple de code suivant montre comment utiliser`Get-DSEventTopic`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande affiche les informations de la rubrique SNS configurée pour les notifications lorsque le statut du répertoire change.**
```
Get-DSEventTopic -DirectoryId d-123456ijkl
```
**Sortie** :
```
CreatedDateTime : 12/13/2019 11:15:32 AM
DirectoryId : d-123456ijkl
Status : Registered
TopicArn : arn:aws:sns:us-east-1:123456781234:snstopicname
TopicName : snstopicname
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEventTopics](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSIpRouteList`
L'exemple de code suivant montre comment utiliser`Get-DSIpRouteList`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande obtient les blocs d’adresses IP publiques configurés dans Directory IP Routing**
```
Get-DSIpRouteList -DirectoryId d-123456ijkl
```
**Sortie** :
```
AddedDateTime : 12/13/2019 12:27:22 PM
CidrIp : 203.0.113.5/32
Description : Public IP of On-Prem DNS Server
DirectoryId : d-123456ijkl
IpRouteStatusMsg : Added
IpRouteStatusReason :
```
+ Pour plus de détails sur l'API, reportez-vous [ListIpRoutes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSLDAPSSetting`
L'exemple de code suivant montre comment utiliser`Get-DSLDAPSSetting`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le statut de la sécurité LDAP pour le répertoire spécifié.**
```
Get-DSLDAPSSetting -DirectoryId d-123456ijkl
```
**Sortie** :
```
LastUpdatedDateTime LDAPSStatus LDAPSStatusReason
------------------- ----------- -----------------
4/15/2020 6:51:03 PM Enabled LDAPS is enabled successfully.
```
+ Pour plus de détails sur l'API, consultez la section [Description LDAPSSettings](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSLogSubscriptionList`
L'exemple de code suivant montre comment utiliser`Get-DSLogSubscriptionList`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande obtient les informations d’abonnement au journal correspondant au directory-id spécifié**
```
Get-DSLogSubscriptionList -DirectoryId d-123456ijkl
```
**Sortie** :
```
DirectoryId LogGroupName SubscriptionCreatedDateTime
----------- ------------ ---------------------------
d-123456ijkl /aws/directoryservice/d-123456ijkl-lan2.example.com 12/14/2019 9:05:23 AM
```
+ Pour plus de détails sur l'API, reportez-vous [ListLogSubscriptions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSResourceTag`
L'exemple de code suivant montre comment utiliser`Get-DSResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande obtient toutes les balises du répertoire spécifié.**
```
Get-DSResourceTag -ResourceId d-123456ijkl
```
**Sortie** :
```
Key Value
--- -----
myTag myTagValue
```
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSSchemaExtension`
L'exemple de code suivant montre comment utiliser`Get-DSSchemaExtension`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les extensions de schéma appliquées à un Microsoft AD Directory.**
```
Get-DSSchemaExtension -DirectoryId d-123456ijkl
```
**Sortie** :
```
Description : ManagedADSchemaExtension
DirectoryId : d-123456ijkl
EndDateTime : 4/12/2020 10:30:49 AM
SchemaExtensionId : e-9067306643
SchemaExtensionStatus : Completed
SchemaExtensionStatusReason : Schema updates are complete.
StartDateTime : 4/12/2020 10:28:42 AM
```
+ Pour plus de détails sur l'API, reportez-vous [ListSchemaExtensions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSSharedDirectory`
L'exemple de code suivant montre comment utiliser`Get-DSSharedDirectory`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple permet d'obtenir les répertoires partagés de votre AWS compte**
```
Get-DSSharedDirectory -OwnerDirectoryId d-123456ijkl -SharedDirectoryId d-9067012345
```
**Sortie** :
```
CreatedDateTime : 12/30/2019 4:34:37 AM
LastUpdatedDateTime : 12/30/2019 4:35:22 AM
OwnerAccountId : 123456781234
OwnerDirectoryId : d-123456ijkl
SharedAccountId : 123456784321
SharedDirectoryId : d-9067012345
ShareMethod : HANDSHAKE
ShareNotes : This is a test Sharing
ShareStatus : Shared
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSharedDirectories](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSSnapshot`
L'exemple de code suivant montre comment utiliser`Get-DSSnapshot`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande obtient des informations sur les instantanés de répertoires spécifiés qui appartiennent à ce compte.**
```
Get-DSSnapshot -DirectoryId d-123456ijkl
```
**Sortie** :
```
DirectoryId : d-123456ijkl
Name :
SnapshotId : s-9064bd1234
StartTime : 12/13/2019 6:33:01 PM
Status : Completed
Type : Auto
DirectoryId : d-123456ijkl
Name :
SnapshotId : s-9064bb4321
StartTime : 12/9/2019 9:48:11 PM
Status : Completed
Type : Auto
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSnapshots](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSSnapshotLimit`
L'exemple de code suivant montre comment utiliser`Get-DSSnapshotLimit`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande obtient les limites d’instantanés manuels pour un répertoire spécifié.**
```
Get-DSSnapshotLimit -DirectoryId d-123456ijkl
```
**Sortie** :
```
ManualSnapshotsCurrentCount ManualSnapshotsLimit ManualSnapshotsLimitReached
--------------------------- -------------------- ---------------------------
0 5 False
```
+ Pour plus de détails sur l'API, reportez-vous [GetSnapshotLimits](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DSTrust`
L'exemple de code suivant montre comment utiliser`Get-DSTrust`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande obtient les informations des relations de confiance créées pour le directory-id spécifié.**
```
Get-DSTrust -DirectoryId d-123456abcd
```
**Sortie** :
```
CreatedDateTime : 7/5/2019 4:55:42 AM
DirectoryId : d-123456abcd
LastUpdatedDateTime : 7/5/2019 4:56:04 AM
RemoteDomainName : contoso.com
SelectiveAuth : Disabled
StateLastUpdatedDateTime : 7/5/2019 4:56:04 AM
TrustDirection : One-Way: Incoming
TrustId : t-9067157123
TrustState : Created
TrustStateReason :
TrustType : Forest
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTrusts](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-DSAlias`
L'exemple de code suivant montre comment utiliser`New-DSAlias`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande crée un alias pour un répertoire et attribue l’alias au directory-id spécifié.**
```
New-DSAlias -DirectoryId d-123456ijkl -Alias MyOrgName
```
**Sortie** :
```
Alias DirectoryId
----- -----------
myorgname d-123456ijkl
```
+ Pour plus de détails sur l'API, reportez-vous [CreateAlias](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-DSComputer`
L'exemple de code suivant montre comment utiliser`New-DSComputer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un objet informatique Active Directory.**
```
New-DSComputer -DirectoryId d-123456ijkl -ComputerName ADMemberServer -Password $Password
```
**Sortie** :
```
ComputerAttributes ComputerId ComputerName
------------------ ---------- ------------
{WindowsSamName, DistinguishedName} S-1-5-21-1191241402-978882507-2717148213-1662 ADMemberServer
```
+ Pour plus de détails sur l'API, reportez-vous [CreateComputer](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-DSConditionalForwarder`
L'exemple de code suivant montre comment utiliser`New-DSConditionalForwarder`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un redirecteur conditionnel dans l'ID de AWS répertoire spécifié.**
```
New-DSConditionalForwarder -DirectoryId d-123456ijkl -DnsIpAddr 172.31.36.96,172.31.10.56 -RemoteDomainName contoso.com
```
+ Pour plus de détails sur l'API, reportez-vous [CreateConditionalForwarder](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-DSDirectory`
L'exemple de code suivant montre comment utiliser`New-DSDirectory`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un répertoire Simple AD.**
```
New-DSDirectory -Name corp.example.com -Password $Password -Size Small -VpcSettings_VpcId vpc-123459d -VpcSettings_SubnetIds subnet-1234kkaa,subnet-5678ffbb
```
+ Pour plus de détails sur l'API, reportez-vous [CreateDirectory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-DSLogSubscription`
L'exemple de code suivant montre comment utiliser`New-DSLogSubscription`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un abonnement pour transférer les journaux de sécurité du contrôleur de domaine Directory Service en temps réel vers le groupe de CloudWatch journaux Amazon spécifié dans votre Compte AWS.**
```
New-DSLogSubscription -DirectoryId d-123456ijkl -LogGroupName /aws/directoryservice/d-123456ijkl-lan2.example.com
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLogSubscription](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-DSMicrosoftAD`
L'exemple de code suivant montre comment utiliser`New-DSMicrosoftAD`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un nouveau répertoire Microsoft AD dans AWS Cloud.**
```
New-DSMicrosoftAD -Name corp.example.com -Password $Password -edition Standard -VpcSettings_VpcId vpc-123459d -VpcSettings_SubnetIds subnet-1234kkaa,subnet-5678ffbb
```
+ Pour plus de détails sur l'API, consultez [CreateMicrosoftAD](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-DSSnapshot`
L'exemple de code suivant montre comment utiliser`New-DSSnapshot`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un instantané de répertoire**
```
New-DSSnapshot -DirectoryId d-123456ijkl
```
+ Pour plus de détails sur l'API, reportez-vous [CreateSnapshot](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-DSTrust`
L'exemple de code suivant montre comment utiliser`New-DSTrust`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée une confiance bidirectionnelle à l'échelle de Forestwide entre votre annuaire AWS Microsoft AD géré et Microsoft Active Directory existant sur site.**
```
New-DSTrust -DirectoryId d-123456ijkl -RemoteDomainName contoso.com -TrustDirection Two-Way -TrustType Forest -TrustPassword $Password -ConditionalForwarderIpAddr 172.31.36.96
```
**Sortie** :
```
t-9067157123
```
+ Pour plus de détails sur l'API, reportez-vous [CreateTrust](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-DSCertificate`
L'exemple de code suivant montre comment utiliser`Register-DSCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre un certificat pour une connexion LDAP sécurisée.**
```
$Certificate = Get-Content contoso.cer -Raw
Register-DSCertificate -DirectoryId d-123456ijkl -CertificateData $Certificate
```
**Sortie** :
```
c-906731e350
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-DSEventTopic`
L'exemple de code suivant montre comment utiliser`Register-DSEventTopic`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple associe un répertoire en tant que diffuseur de publication à une rubrique SNS.**
```
Register-DSEventTopic -DirectoryId d-123456ijkl -TopicName snstopicname
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterEventTopic](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-DSConditionalForwarder`
L'exemple de code suivant montre comment utiliser`Remove-DSConditionalForwarder`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime le redirecteur conditionnel qui a été configuré pour votre AWS répertoire.**
```
Remove-DSConditionalForwarder -DirectoryId d-123456ijkl -RemoteDomainName contoso.com
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteConditionalForwarder](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-DSDirectory`
L'exemple de code suivant montre comment utiliser`Remove-DSDirectory`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime un AWS annuaire du service d'annuaire (connecteur AD/Microsoft AD/AD simple)**
```
Remove-DSDirectory -DirectoryId d-123456ijkl
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteDirectory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-DSIpRoute`
L'exemple de code suivant montre comment utiliser`Remove-DSIpRoute`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande supprime l’adresse IP spécifiée des routes IP configurées du Directory-id.**
```
Remove-DSIpRoute -DirectoryId d-123456ijkl -CidrIp 203.0.113.5/32
```
+ Pour plus de détails sur l'API, reportez-vous [RemoveIpRoutes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-DSLogSubscription`
L'exemple de code suivant montre comment utiliser`Remove-DSLogSubscription`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande supprime l’abonnement au journal du Directory-id spécifié**
```
Remove-DSLogSubscription -DirectoryId d-123456ijkl
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLogSubscription](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-DSResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-DSResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande supprime la balise de ressource attribuée au Directory-id spécifié**
```
Remove-DSResourceTag -ResourceId d-123456ijkl -TagKey myTag
```
+ Pour plus de détails sur l'API, reportez-vous [RemoveTagsFromResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-DSSnapshot`
L'exemple de code suivant montre comment utiliser`Remove-DSSnapshot`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’instantané créé manuellement.**
```
Remove-DSSnapshot -SnapshotId s-9068b488kc
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteSnapshot](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-DSTrust`
L'exemple de code suivant montre comment utiliser`Remove-DSTrust`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime la relation de confiance existante entre votre annuaire AD AWS géré et un domaine externe.**
```
Get-DSTrust -DirectoryId d-123456ijkl -Select Trusts.TrustId | Remove-DSTrust
```
**Sortie** :
```
t-9067157123
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteTrust](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Reset-DSUserPassword`
L'exemple de code suivant montre comment utiliser`Reset-DSUserPassword`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple réinitialise le mot de passe de l'utilisateur Active Directory nommé ADUser dans AWS Managed Microsoft AD ou Simple AD Directory**
```
Reset-DSUserPassword -UserName ADuser -DirectoryId d-123456ijkl -NewPassword $Password
```
+ Pour plus de détails sur l'API, reportez-vous [ResetUserPassword](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Restore-DSFromSnapshot`
L'exemple de code suivant montre comment utiliser`Restore-DSFromSnapshot`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple restaure un répertoire à l’aide d’un instantané de répertoire existant.**
```
Restore-DSFromSnapshot -SnapshotId s-9068b488kc
```
+ Pour plus de détails sur l'API, reportez-vous [RestoreFromSnapshot](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-DSDomainControllerCount`
L'exemple de code suivant montre comment utiliser`Set-DSDomainControllerCount`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple définit le nombre de contrôleurs de domaine à 3 pour le directory-id spécifié.**
```
Set-DSDomainControllerCount -DirectoryId d-123456ijkl -DesiredNumber 3
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateNumberOfDomainControllers](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Start-DSSchemaExtension`
L'exemple de code suivant montre comment utiliser`Start-DSSchemaExtension`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple applique une extension de schéma à un répertoire Microsoft AD.**
```
$ldif = Get-Content D:\Users\Username\Downloads\ExtendedSchema.ldf -Raw
Start-DSSchemaExtension -DirectoryId d-123456ijkl -CreateSnapshotBeforeSchemaExtension $true -Description ManagedADSchemaExtension -LdifContent $ldif
```
**Sortie** :
```
e-9067306643
```
+ Pour plus de détails sur l'API, reportez-vous [StartSchemaExtension](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-DSSchemaExtension`
L'exemple de code suivant montre comment utiliser`Stop-DSSchemaExtension`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple annule une extension de schéma en cours vers un répertoire Microsoft AD.**
```
Stop-DSSchemaExtension -DirectoryId d-123456ijkl -SchemaExtensionId e-9067306643
```
+ Pour plus de détails sur l'API, reportez-vous [CancelSchemaExtension](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-DSCertificate`
L'exemple de code suivant montre comment utiliser`Unregister-DSCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime du système le certificat enregistré pour une connexion LDAP sécurisée.**
```
Unregister-DSCertificate -DirectoryId d-123456ijkl -CertificateId c-906731e34f
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-DSEventTopic`
L'exemple de code suivant montre comment utiliser`Unregister-DSEventTopic`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le répertoire spécifié en tant que diffuseur de publication pour la rubrique SNS spécifiée.**
```
Unregister-DSEventTopic -DirectoryId d-123456ijkl -TopicName snstopicname
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterEventTopic](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-DSConditionalForwarder`
L'exemple de code suivant montre comment utiliser`Update-DSConditionalForwarder`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple met à jour un redirecteur conditionnel qui a été configuré pour votre AWS annuaire.**
```
Update-DSConditionalForwarder -DirectoryId d-123456ijkl -DnsIpAddr 172.31.36.96,172.31.16.108 -RemoteDomainName contoso.com
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateConditionalForwarder](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-DSRadius`
L'exemple de code suivant montre comment utiliser`Update-DSRadius`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour les informations du serveur RADIUS pour un répertoire AD Connector ou Microsoft AD.**
```
Update-DSRadius -DirectoryId d-123456ijkl -RadiusSettings_RadiusRetry 3
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateRadius](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-DSTrust`
L'exemple de code suivant montre comment utiliser`Update-DSTrust`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple met à jour le SelectiveAuth paramètre de l'identifiant de confiance spécifié de Disabled à Enabled.**
```
Update-DSTrust -TrustId t-9067157123 -SelectiveAuth Enabled
```
**Sortie** :
```
RequestId TrustId
--------- -------
138864a7-c9a8-4ad1-a828-eae479e85b45 t-9067157123
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateTrust](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# AWS DMS exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec AWS DMS.
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
### `New-DMSReplicationTask`
L'exemple de code suivant montre comment utiliser`New-DMSReplicationTask`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée une nouvelle tâche de réplication du Service AWS de migration de base de données qui utilise CdcStartTime au lieu de CdcStartPosition. Le MigrationType est défini sur full-load-and-cdc « », ce qui signifie que la table cible doit être vide. La nouvelle tâche est balisée avec une balise dont la clé est Stage et la valeur clé est Test. Pour plus d'informations sur les valeurs utilisées par cette applet de commande, consultez la section Création d'une tâche (https://docs.aws.amazon.com/dms/latest/userguide/CHAP\$1Tasks.Creating.html) dans le Guide de l'utilisateur du Service de migration de base de données. AWS **
```
New-DMSReplicationTask -ReplicationInstanceArn "arn:aws:dms:us-east-1:123456789012:rep:EXAMPLE66XFJUWATDJGBEXAMPLE"`
-CdcStartTime "2019-08-08T12:12:12"`
-CdcStopPosition "server_time:2019-08-09T12:12:12"`
-MigrationType "full-load-and-cdc"`
-ReplicationTaskIdentifier "task1"`
-ReplicationTaskSetting ""`
-SourceEndpointArn "arn:aws:dms:us-east-1:123456789012:endpoint:EXAMPLEW5UANC7Y3P4EEXAMPLE"`
-TableMapping "file:////home/testuser/table-mappings.json"`
-Tag @{"Key"="Stage";"Value"="Test"}`
-TargetEndpointArn "arn:aws:dms:us-east-1:123456789012:endpoint:EXAMPLEJZASXWHTWCLNEXAMPLE"
```
+ Pour plus de détails sur l'API, reportez-vous [CreateReplicationTask](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples DynamoDB utilisant Tools for V4 PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la version Outils AWS pour PowerShell V4 avec DynamoDB.
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-DDBIndexSchema`
L'exemple de code suivant montre comment utiliser`Add-DDBIndexSchema`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un TableSchema objet vide et y ajoute une nouvelle définition d'index secondaire local avant d'écrire l' TableSchema objet dans le pipeline.**
```
$schema | Add-DDBIndexSchema -IndexName "LastPostIndex" -RangeKeyName "LastPostDateTime" -RangeKeyDataType "S" -ProjectionType "keys_only"
$schema = New-DDBTableSchema
```
**Sortie** :
```
AttributeSchema KeySchema LocalSecondaryIndexSchema
--------------- --------- -------------------------
{LastPostDateTime} {} {LastPostIndex}
```
**Exemple 2 : ajoute une nouvelle définition d'index secondaire local à l' TableSchema objet fourni avant de réécrire l' TableSchema objet dans le pipeline. L' TableSchema objet peut également être fourni à l'aide du paramètre -Schema.**
```
New-DDBTableSchema | Add-DDBIndexSchema -IndexName "LastPostIndex" -RangeKeyName "LastPostDateTime" -RangeKeyDataType "S" -ProjectionType "keys_only"
```
**Sortie** :
```
AttributeSchema KeySchema LocalSecondaryIndexSchema
--------------- --------- -------------------------
{LastPostDateTime} {} {LastPostIndex}
```
+ Pour plus de détails sur l'API, consultez [DDBIndexAdd-Schema](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-DDBKeySchema`
L'exemple de code suivant montre comment utiliser`Add-DDBKeySchema`.
**Outils pour PowerShell V4**
**Exemple 1 : Crée un TableSchema objet vide et y ajoute des entrées de définition de clé et d'attribut à l'aide des données clés spécifiées avant d'écrire l' TableSchema objet dans le pipeline. Le type de clé est déclaré « HASH » par défaut ; utilisez le KeyType paramètre - avec la valeur « RANGE » pour déclarer une clé de plage.**
```
$schema = New-DDBTableSchema
$schema | Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S"
```
**Sortie** :
```
AttributeSchema KeySchema LocalSecondaryIndexSchema
--------------- --------- -------------------------
{ForumName} {ForumName} {}
```
**Exemple 2 : ajoute de nouvelles entrées de définition de clé et d'attribut à l' TableSchema objet fourni avant d'écrire l' TableSchema objet dans le pipeline. Le type de clé est déclaré « HASH » par défaut ; utilisez le KeyType paramètre - avec la valeur « RANGE » pour déclarer une clé de plage. L' TableSchema objet peut également être fourni à l'aide du paramètre -Schema.**
```
New-DDBTableSchema | Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S"
```
**Sortie** :
```
AttributeSchema KeySchema LocalSecondaryIndexSchema
--------------- --------- -------------------------
{ForumName} {ForumName} {}
```
+ Pour plus de détails sur l'API, consultez [DDBKeyAdd-Schema](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `ConvertFrom-DDBItem`
L'exemple de code suivant montre comment utiliser`ConvertFrom-DDBItem`.
**Outils pour PowerShell V4**
**Exemple 1 : ConvertFrom - DDBItem est utilisé pour convertir le résultat d'une table de hachage Get-DDBItem de AttributeValues DynamoDB en une table de hachage de types courants tels que string et double.**
```
@{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
} | ConvertTo-DDBItem
Get-DDBItem -TableName 'Music' -Key $key | ConvertFrom-DDBItem
```
**Sortie** :
```
Name Value
---- -----
Genre Country
Artist No One You Know
Price 1.94
CriticRating 9
SongTitle Somewhere Down The Road
AlbumTitle Somewhat Famous
```
+ Pour plus de détails sur l'API, voir [ConvertFrom- DDBItem](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `ConvertTo-DDBItem`
L'exemple de code suivant montre comment utiliser`ConvertTo-DDBItem`.
**Outils pour PowerShell V4**
**Exemple 1 : exemple de conversion d’une table de hachage en dictionnaire de valeurs d’attributs DynamoDB.**
```
@{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
} | ConvertTo-DDBItem
Key Value
--- -----
SongTitle Amazon.DynamoDBv2.Model.AttributeValue
Artist Amazon.DynamoDBv2.Model.AttributeValue
```
**Exemple 2 : exemple de conversion d’une table de hachage en dictionnaire de valeurs d’attributs DynamoDB.**
```
@{
MyMap = @{
MyString = 'my string'
}
MyStringSet = [System.Collections.Generic.HashSet[String]]@('my', 'string')
MyNumericSet = [System.Collections.Generic.HashSet[Int]]@(1, 2, 3)
MyBinarySet = [System.Collections.Generic.HashSet[System.IO.MemoryStream]]@(
([IO.MemoryStream]::new([Text.Encoding]::UTF8.GetBytes('my'))),
([IO.MemoryStream]::new([Text.Encoding]::UTF8.GetBytes('string')))
)
MyList1 = @('my', 'string')
MyList2 = [System.Collections.Generic.List[Int]]@(1, 2)
MyList3 = [System.Collections.ArrayList]@('one', 2, $true)
} | ConvertTo-DDBItem
```
**Sortie** :
```
Key Value
--- -----
MyStringSet Amazon.DynamoDBv2.Model.AttributeValue
MyList1 Amazon.DynamoDBv2.Model.AttributeValue
MyNumericSet Amazon.DynamoDBv2.Model.AttributeValue
MyList2 Amazon.DynamoDBv2.Model.AttributeValue
MyBinarySet Amazon.DynamoDBv2.Model.AttributeValue
MyMap Amazon.DynamoDBv2.Model.AttributeValue
MyList3 Amazon.DynamoDBv2.Model.AttributeValue
```
+ Pour plus de détails sur l'API, voir [ConvertTo- DDBItem](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DDBBatchItem`
L'exemple de code suivant montre comment utiliser`Get-DDBBatchItem`.
**Outils pour PowerShell V4**
**Exemple 1 : extrait l'élément SongTitle « Somewhere Down The Road » des tables DynamoDB « Music » et « Songs ».**
```
$key = @{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
} | ConvertTo-DDBItem
$keysAndAttributes = New-Object Amazon.DynamoDBv2.Model.KeysAndAttributes
$list = New-Object 'System.Collections.Generic.List[System.Collections.Generic.Dictionary[String, Amazon.DynamoDBv2.Model.AttributeValue]]'
$list.Add($key)
$keysAndAttributes.Keys = $list
$requestItem = @{
'Music' = [Amazon.DynamoDBv2.Model.KeysAndAttributes]$keysAndAttributes
'Songs' = [Amazon.DynamoDBv2.Model.KeysAndAttributes]$keysAndAttributes
}
$batchItems = Get-DDBBatchItem -RequestItem $requestItem
$batchItems.GetEnumerator() | ForEach-Object {$PSItem.Value} | ConvertFrom-DDBItem
```
**Sortie** :
```
Name Value
---- -----
Artist No One You Know
SongTitle Somewhere Down The Road
AlbumTitle Somewhat Famous
CriticRating 10
Genre Country
Price 1.94
Artist No One You Know
SongTitle Somewhere Down The Road
AlbumTitle Somewhat Famous
CriticRating 10
Genre Country
Price 1.94
```
+ Pour plus de détails sur l'API, reportez-vous [BatchGetItem](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DDBItem`
L'exemple de code suivant montre comment utiliser`Get-DDBItem`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie l'élément DynamoDB avec la clé de partition et la SongTitle clé de tri Artist.**
```
$key = @{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
} | ConvertTo-DDBItem
Get-DDBItem -TableName 'Music' -Key $key | ConvertFrom-DDBItem
```
**Sortie** :
```
Name Value
---- -----
Genre Country
SongTitle Somewhere Down The Road
Price 1.94
Artist No One You Know
CriticRating 9
AlbumTitle Somewhat Famous
```
+ Pour plus de détails sur l'API, reportez-vous [GetItem](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DDBTable`
L'exemple de code suivant montre comment utiliser`Get-DDBTable`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les détails de la table spécifiée.**
```
Get-DDBTable -TableName "myTable"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTable](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-DDBTableList`
L'exemple de code suivant montre comment utiliser`Get-DDBTableList`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoi des détails de toutes les tables, en itérant automatiquement jusqu’à ce que le service indique qu’il n’existe plus de tables.**
```
Get-DDBTableList
```
+ Pour plus de détails sur l'API, reportez-vous [ListTables](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Invoke-DDBQuery`
L'exemple de code suivant montre comment utiliser`Invoke-DDBQuery`.
**Outils pour PowerShell V4**
**Exemple 1 : invoque une requête qui renvoie des éléments DynamoDB avec les valeurs spécifiées et Artist. SongTitle **
```
$invokeDDBQuery = @{
TableName = 'Music'
KeyConditionExpression = ' SongTitle = :SongTitle and Artist = :Artist'
ExpressionAttributeValues = @{
':SongTitle' = 'Somewhere Down The Road'
':Artist' = 'No One You Know'
} | ConvertTo-DDBItem
}
Invoke-DDBQuery @invokeDDBQuery | ConvertFrom-DDBItem
```
**Sortie** :
```
Name Value
---- -----
Genre Country
Artist No One You Know
Price 1.94
CriticRating 9
SongTitle Somewhere Down The Road
AlbumTitle Somewhat Famous
```
+ Pour plus de détails sur l’API, consultez [Query](https://docs.aws.amazon.com/powershell/v4/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V4)*.
### `Invoke-DDBScan`
L'exemple de code suivant montre comment utiliser`Invoke-DDBScan`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoi de tous les éléments de la table Music.**
```
Invoke-DDBScan -TableName 'Music' | ConvertFrom-DDBItem
```
**Sortie** :
```
Name Value
---- -----
Genre Country
Artist No One You Know
Price 1.94
CriticRating 9
SongTitle Somewhere Down The Road
AlbumTitle Somewhat Famous
Genre Country
Artist No One You Know
Price 1.98
CriticRating 8.4
SongTitle My Dog Spot
AlbumTitle Hey Now
```
**Exemple 2 : renvoie les éléments du tableau Musique dont le score est CriticRating supérieur ou égal à neuf.**
```
$scanFilter = @{
CriticRating = [Amazon.DynamoDBv2.Model.Condition]@{
AttributeValueList = @(@{N = '9'})
ComparisonOperator = 'GE'
}
}
Invoke-DDBScan -TableName 'Music' -ScanFilter $scanFilter | ConvertFrom-DDBItem
```
**Sortie** :
```
Name Value
---- -----
Genre Country
Artist No One You Know
Price 1.94
CriticRating 9
SongTitle Somewhere Down The Road
AlbumTitle Somewhat Famous
```
+ Pour plus de détails sur l’API, consultez [Scan](https://docs.aws.amazon.com/powershell/v4/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V4)*.
### `New-DDBTable`
L'exemple de code suivant montre comment utiliser`New-DDBTable`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée une table nommée Thread dont la clé primaire est composée de « ForumName » (hachage de type de clé) et de « Subject » (plage de types de clés). Le schéma utilisé pour construire la table peut être redirigé vers chaque applet de commande comme indiqué ou spécifié à l’aide du paramètre -Schema.**
```
$schema = New-DDBTableSchema
$schema | Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S"
$schema | Add-DDBKeySchema -KeyName "Subject" -KeyType RANGE -KeyDataType "S"
$schema | New-DDBTable -TableName "Thread" -ReadCapacity 10 -WriteCapacity 5
```
**Sortie** :
```
AttributeDefinitions : {ForumName, Subject}
TableName : Thread
KeySchema : {ForumName, Subject}
TableStatus : CREATING
CreationDateTime : 10/28/2013 4:39:49 PM
ProvisionedThroughput : Amazon.DynamoDBv2.Model.ProvisionedThroughputDescription
TableSizeBytes : 0
ItemCount : 0
LocalSecondaryIndexes : {}
```
**Exemple 2 : Cet exemple crée une table nommée Thread dont la clé primaire est composée de « ForumName » (hachage de type de clé) et de « Subject » (plage de types de clés). Un index secondaire local est également défini. La clé de l'index secondaire local sera définie automatiquement à partir de la clé de hachage principale de la table (ForumName). Le schéma utilisé pour construire la table peut être redirigé vers chaque applet de commande comme indiqué ou spécifié à l’aide du paramètre -Schema.**
```
$schema = New-DDBTableSchema
$schema | Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S"
$schema | Add-DDBKeySchema -KeyName "Subject" -KeyDataType "S"
$schema | Add-DDBIndexSchema -IndexName "LastPostIndex" -RangeKeyName "LastPostDateTime" -RangeKeyDataType "S" -ProjectionType "keys_only"
$schema | New-DDBTable -TableName "Thread" -ReadCapacity 10 -WriteCapacity 5
```
**Sortie** :
```
AttributeDefinitions : {ForumName, LastPostDateTime, Subject}
TableName : Thread
KeySchema : {ForumName, Subject}
TableStatus : CREATING
CreationDateTime : 10/28/2013 4:39:49 PM
ProvisionedThroughput : Amazon.DynamoDBv2.Model.ProvisionedThroughputDescription
TableSizeBytes : 0
ItemCount : 0
LocalSecondaryIndexes : {LastPostIndex}
```
**Exemple 3 : Cet exemple montre comment utiliser un pipeline unique pour créer une table nommée Thread qui possède une clé primaire composée de « ForumName » (hachage de type de clé) et de « Subject » (plage de types de clés) et un index secondaire local. Les options Add- DDBKey Schema et Add- DDBIndex Schema créent un nouvel TableSchema objet pour vous si aucun objet n'est fourni par le pipeline ou le paramètre -Schema.**
```
New-DDBTableSchema |
Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S" |
Add-DDBKeySchema -KeyName "Subject" -KeyDataType "S" |
Add-DDBIndexSchema -IndexName "LastPostIndex" `
-RangeKeyName "LastPostDateTime" `
-RangeKeyDataType "S" `
-ProjectionType "keys_only" |
New-DDBTable -TableName "Thread" -ReadCapacity 10 -WriteCapacity 5
```
**Sortie** :
```
AttributeDefinitions : {ForumName, LastPostDateTime, Subject}
TableName : Thread
KeySchema : {ForumName, Subject}
TableStatus : CREATING
CreationDateTime : 10/28/2013 4:39:49 PM
ProvisionedThroughput : Amazon.DynamoDBv2.Model.ProvisionedThroughputDescription
TableSizeBytes : 0
ItemCount : 0
LocalSecondaryIndexes : {LastPostIndex}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateTable](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-DDBTableSchema`
L'exemple de code suivant montre comment utiliser`New-DDBTableSchema`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un TableSchema objet vide prêt à accepter les définitions de clé et d'index à utiliser lors de la création d'une nouvelle table Amazon DynamoDB. L'objet renvoyé peut être redirigé vers les DDBTable applets de commande Add- DDBKey Schema, Add- DDBIndex Schema et New- ou leur être transmis à l'aide du paramètre -Schema de chaque applet de commande.**
```
New-DDBTableSchema
```
**Sortie** :
```
AttributeSchema KeySchema LocalSecondaryIndexSchema
--------------- --------- -------------------------
{} {} {}
```
+ Pour plus de détails sur l'API, consultez [New- DDBTable Schema](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-DDBItem`
L'exemple de code suivant montre comment utiliser`Remove-DDBItem`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime l’élément DynamoDB correspondant à la clé fournie.**
```
$key = @{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
} | ConvertTo-DDBItem
Remove-DDBItem -TableName 'Music' -Key $key -Confirm:$false
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteItem](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-DDBTable`
L'exemple de code suivant montre comment utiliser`Remove-DDBTable`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime la table spécifiée. Vous êtes invité à confirmer avant que l’opération ne se poursuive.**
```
Remove-DDBTable -TableName "myTable"
```
**Exemple 2 : supprime la table spécifiée. Aucune confirmation ne vous est demandée avant le début de l’opération.**
```
Remove-DDBTable -TableName "myTable" -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteTable](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-DDBBatchItem`
L'exemple de code suivant montre comment utiliser`Set-DDBBatchItem`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un nouvel élément ou remplace un élément existant par un nouveau dans les tables DynamoDB Music et Songs.**
```
$item = @{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
AlbumTitle = 'Somewhat Famous'
Price = 1.94
Genre = 'Country'
CriticRating = 10.0
} | ConvertTo-DDBItem
$writeRequest = New-Object Amazon.DynamoDBv2.Model.WriteRequest
$writeRequest.PutRequest = [Amazon.DynamoDBv2.Model.PutRequest]$item
$requestItem = @{
'Music' = [Amazon.DynamoDBv2.Model.WriteRequest]($writeRequest)
'Songs' = [Amazon.DynamoDBv2.Model.WriteRequest]($writeRequest)
}
Set-DDBBatchItem -RequestItem $requestItem
```
+ Pour plus de détails sur l'API, reportez-vous [BatchWriteItem](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-DDBItem`
L'exemple de code suivant montre comment utiliser`Set-DDBItem`.
**Outils pour PowerShell V4**
**Exemple 1 : création d’un nouvel élément ou remplacement d’un élément existant par un nouvel élément.**
```
$item = @{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
AlbumTitle = 'Somewhat Famous'
Price = 1.94
Genre = 'Country'
CriticRating = 9.0
} | ConvertTo-DDBItem
Set-DDBItem -TableName 'Music' -Item $item
```
+ Pour plus de détails sur l'API, reportez-vous [PutItem](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-DDBItem`
L'exemple de code suivant montre comment utiliser`Update-DDBItem`.
**Outils pour PowerShell V4**
**Exemple 1 : définit l'attribut genre sur « Rap » sur l'élément DynamoDB avec la clé de partition et la SongTitle clé de tri Artist.**
```
$key = @{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
} | ConvertTo-DDBItem
$updateDdbItem = @{
TableName = 'Music'
Key = $key
UpdateExpression = 'set Genre = :val1'
ExpressionAttributeValue = (@{
':val1' = ([Amazon.DynamoDBv2.Model.AttributeValue]'Rap')
})
}
Update-DDBItem @updateDdbItem
```
**Sortie** :
```
Name Value
---- -----
Genre Rap
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateItem](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-DDBTable`
L'exemple de code suivant montre comment utiliser`Update-DDBTable`.
**Outils pour PowerShell V4**
**Exemple 1 : mise à jour du débit provisionné pour la table donnée.**
```
Update-DDBTable -TableName "myTable" -ReadCapacity 10 -WriteCapacity 5
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateTable](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Amazon EC2 utilisant Tools for V4 PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Amazon EC2.
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-EC2CapacityReservation`
L'exemple de code suivant montre comment utiliser`Add-EC2CapacityReservation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une réserve de capacité avec les attributs spécifiés**
```
Add-EC2CapacityReservation -InstanceType m4.xlarge -InstanceCount 2 -AvailabilityZone eu-west-1b -EbsOptimized True -InstancePlatform Windows
```
**Sortie** :
```
AvailabilityZone : eu-west-1b
AvailableInstanceCount : 2
CapacityReservationId : cr-0c1f2345db6f7cdba
CreateDate : 3/28/2019 9:29:41 AM
EbsOptimized : True
EndDate : 1/1/0001 12:00:00 AM
EndDateType : unlimited
EphemeralStorage : False
InstanceMatchCriteria : open
InstancePlatform : Windows
InstanceType : m4.xlarge
State : active
Tags : {}
Tenancy : default
TotalInstanceCount : 2
```
+ Pour plus de détails sur l'API, reportez-vous [CreateCapacityReservation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-EC2InternetGateway`
L'exemple de code suivant montre comment utiliser`Add-EC2InternetGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple attache la passerelle Internet spécifiée au VPC spécifié.**
```
Add-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d -VpcId vpc-12345678
```
**Exemple 2 : cet exemple crée un VPC et une passerelle Internet, puis attache la passerelle Internet au VPC.**
```
$vpc = New-EC2Vpc -CidrBlock 10.0.0.0/16
New-EC2InternetGateway | Add-EC2InternetGateway -VpcId $vpc.VpcId
```
+ Pour plus de détails sur l'API, reportez-vous [AttachInternetGateway](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-EC2NetworkInterface`
L'exemple de code suivant montre comment utiliser`Add-EC2NetworkInterface`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple attache l’interface réseau spécifiée à l’instance spécifiée.**
```
Add-EC2NetworkInterface -NetworkInterfaceId eni-12345678 -InstanceId i-1a2b3c4d -DeviceIndex 1
```
**Sortie** :
```
eni-attach-1a2b3c4d
```
+ Pour plus de détails sur l'API, reportez-vous [AttachNetworkInterface](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-EC2Volume`
L'exemple de code suivant montre comment utiliser`Add-EC2Volume`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple attache le volume spécifié à l’instance spécifiée et l’expose avec le nom de l’appareil spécifié.**
```
Add-EC2Volume -VolumeId vol-12345678 -InstanceId i-1a2b3c4d -Device /dev/sdh
```
**Sortie** :
```
AttachTime : 12/22/2015 1:53:58 AM
DeleteOnTermination : False
Device : /dev/sdh
InstanceId : i-1a2b3c4d
State : attaching
VolumeId : vol-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [AttachVolume](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-EC2VpnGateway`
L'exemple de code suivant montre comment utiliser`Add-EC2VpnGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple attache la passerelle privée virtuelle spécifiée au VPC spécifié.**
```
Add-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d -VpcId vpc-12345678
```
**Sortie** :
```
State VpcId
----- -----
attaching vpc-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [AttachVpnGateway](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Approve-EC2VpcPeeringConnection`
L'exemple de code suivant montre comment utiliser`Approve-EC2VpcPeeringConnection`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple approuve le fichier VpcPeeringConnectionId pcx-1dfad234b56ff78be demandé**
```
Approve-EC2VpcPeeringConnection -VpcPeeringConnectionId pcx-1dfad234b56ff78be
```
**Sortie** :
```
AccepterVpcInfo : Amazon.EC2.Model.VpcPeeringConnectionVpcInfo
ExpirationTime : 1/1/0001 12:00:00 AM
RequesterVpcInfo : Amazon.EC2.Model.VpcPeeringConnectionVpcInfo
Status : Amazon.EC2.Model.VpcPeeringConnectionStateReason
Tags : {}
VpcPeeringConnectionId : pcx-1dfad234b56ff78be
```
+ Pour plus de détails sur l'API, reportez-vous [AcceptVpcPeeringConnection](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Confirm-EC2ProductInstance`
L'exemple de code suivant montre comment utiliser`Confirm-EC2ProductInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple détermine si le code produit spécifié est associé à l’instance spécifiée.**
```
Confirm-EC2ProductInstance -ProductCode 774F4FF8 -InstanceId i-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [ConfirmProductInstance](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Copy-EC2Image`
L'exemple de code suivant montre comment utiliser`Copy-EC2Image`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple copie l’AMI spécifiée dans la région « UE (Irlande) » vers la région « USA Ouest (Oregon) ». Si -Region n’est pas spécifiée, la région par défaut actuelle est utilisée comme région de destination.**
```
Copy-EC2Image -SourceRegion eu-west-1 -SourceImageId ami-12345678 -Region us-west-2 -Name "Copy of ami-12345678"
```
**Sortie** :
```
ami-87654321
```
+ Pour plus de détails sur l'API, reportez-vous [CopyImage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Copy-EC2Snapshot`
L'exemple de code suivant montre comment utiliser`Copy-EC2Snapshot`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple copie l’instantané spécifié dans la région « UE (Irlande) » vers la région « USA Ouest (Oregon) ».**
```
Copy-EC2Snapshot -SourceRegion eu-west-1 -SourceSnapshotId snap-12345678 -Region us-west-2
```
**Exemple 2 : si vous définissez une région par défaut et que vous omettez le paramètre Région, la région de destination par défaut est la région par défaut.**
```
Set-DefaultAWSRegion us-west-2
Copy-EC2Snapshot -SourceRegion eu-west-1 -SourceSnapshotId snap-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [CopySnapshot](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Deny-EC2VpcPeeringConnection`
L'exemple de code suivant montre comment utiliser`Deny-EC2VpcPeeringConnection`.
**Outils pour PowerShell V4**
**Exemple 1 : L'exemple ci-dessus refuse la demande d'identifiant de demande VpcPeering pcx-01a2b3ce45fe67eb8**
```
Deny-EC2VpcPeeringConnection -VpcPeeringConnectionId pcx-01a2b3ce45fe67eb8
```
+ Pour plus de détails sur l'API, reportez-vous [RejectVpcPeeringConnection](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Disable-EC2VgwRoutePropagation`
L'exemple de code suivant montre comment utiliser`Disable-EC2VgwRoutePropagation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple empêche la passerelle virtuelle de propager automatiquement les itinéraires vers la table de routage spécifiée.**
```
Disable-EC2VgwRoutePropagation -RouteTableId rtb-12345678 -GatewayId vgw-1a2b3c4d
```
+ Pour plus de détails sur l'API, reportez-vous [DisableVgwRoutePropagation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Disable-EC2VpcClassicLink`
L'exemple de code suivant montre comment utiliser`Disable-EC2VpcClassicLink`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple désactive le EC2 VpcClassicLink vpc-01e23c4a5d6db78e9. Elle renvoie Vrai ou Faux.**
```
Disable-EC2VpcClassicLink -VpcId vpc-01e23c4a5d6db78e9
```
+ Pour plus de détails sur l'API, reportez-vous [DisableVpcClassicLink](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Disable-EC2VpcClassicLinkDnsSupport`
L'exemple de code suivant montre comment utiliser`Disable-EC2VpcClassicLinkDnsSupport`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple désactive le support ClassicLink DNS pour le vpc-0b12d3456a7e8910d**
```
Disable-EC2VpcClassicLinkDnsSupport -VpcId vpc-0b12d3456a7e8910d
```
+ Pour plus de détails sur l'API, reportez-vous [DisableVpcClassicLinkDnsSupport](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Dismount-EC2InternetGateway`
L'exemple de code suivant montre comment utiliser`Dismount-EC2InternetGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple détache la passerelle Internet spécifiée au VPC spécifié.**
```
Dismount-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d -VpcId vpc-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [DetachInternetGateway](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Dismount-EC2NetworkInterface`
L'exemple de code suivant montre comment utiliser`Dismount-EC2NetworkInterface`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’attachement spécifié entre une interface réseau et une instance.**
```
Dismount-EC2NetworkInterface -AttachmentId eni-attach-1a2b3c4d -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DetachNetworkInterface](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Dismount-EC2Volume`
L'exemple de code suivant montre comment utiliser`Dismount-EC2Volume`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple détache le volume spécifié.**
```
Dismount-EC2Volume -VolumeId vol-12345678
```
**Sortie** :
```
AttachTime : 12/22/2015 1:53:58 AM
DeleteOnTermination : False
Device : /dev/sdh
InstanceId : i-1a2b3c4d
State : detaching
VolumeId : vol-12345678
```
**Exemple 2 : vous pouvez également spécifier l’ID de l’instance et le nom de l’appareil pour vous assurer que vous détachez le volume approprié.**
```
Dismount-EC2Volume -VolumeId vol-12345678 -InstanceId i-1a2b3c4d -Device /dev/sdh
```
+ Pour plus de détails sur l'API, reportez-vous [DetachVolume](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Dismount-EC2VpnGateway`
L'exemple de code suivant montre comment utiliser`Dismount-EC2VpnGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple détache la passerelle privée virtuelle spécifiée du VPC spécifié.**
```
Dismount-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d -VpcId vpc-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [DetachVpnGateway](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2CapacityReservation`
L'exemple de code suivant montre comment utiliser`Edit-EC2CapacityReservation`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple modifie le CapacityReservationId cr-0c1f2345db6f7cdba en remplaçant le nombre d'instances par 1**
```
Edit-EC2CapacityReservation -CapacityReservationId cr-0c1f2345db6f7cdba -InstanceCount 1
```
**Sortie** :
```
True
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyCapacityReservation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2Host`
L'exemple de code suivant montre comment utiliser`Edit-EC2Host`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie les AutoPlacement paramètres sur off pour l'hôte dédié h-01e23f4cd567890f3**
```
Edit-EC2Host -HostId h-03e09f8cd681609f3 -AutoPlacement off
```
**Sortie** :
```
Successful Unsuccessful
---------- ------------
{h-01e23f4cd567890f3} {}
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyHosts](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2IdFormat`
L'exemple de code suivant montre comment utiliser`Edit-EC2IdFormat`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active le format d’ID plus long pour le type de ressource spécifié.**
```
Edit-EC2IdFormat -Resource instance -UseLongId $true
```
**Exemple 2 : cet exemple désactive le format d’ID plus long pour le type de ressource spécifié.**
```
Edit-EC2IdFormat -Resource instance -UseLongId $false
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyIdFormat](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2ImageAttribute`
L'exemple de code suivant montre comment utiliser`Edit-EC2ImageAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la description de l’AMI spécifiée.**
```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Description "New description"
```
**Exemple 2 : Cet exemple rend l'AMI publique (par exemple, afin que tout le Compte AWS monde puisse l'utiliser).**
```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup all
```
**Exemple 3 : cet exemple rend l’AMI privée (par exemple, afin que vous soyez le seul à pouvoir l’utiliser en tant que propriétaire).**
```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserGroup all
```
**Exemple 4 : Cet exemple accorde l'autorisation de lancement à la personne spécifiée Compte AWS.**
```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333
```
**Exemple 5 : Cet exemple supprime l'autorisation de lancement spécifiée Compte AWS.**
```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyImageAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2InstanceAttribute`
L'exemple de code suivant montre comment utiliser`Edit-EC2InstanceAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie le type d’instance de l’instance spécifiée.**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.medium
```
**Exemple 2 : Cet exemple permet d'améliorer la mise en réseau pour l'instance spécifiée, en spécifiant « simple » comme valeur du paramètre de support réseau de I/O virtualisation à racine unique (SR-IOV), -. SriovNetSupport**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SriovNetSupport "simple"
```
**Exemple 3 : cet exemple modifie les groupes de sécurité pour l’instance spécifiée. L’instance doit être dans un VPC. Vous devez spécifier l’ID de chaque groupe de sécurité, et non le nom.**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -Group @( "sg-12345678", "sg-45678901" )
```
**Exemple 4 : Cet exemple active l' I/O optimisation EBS pour l'instance spécifiée. Cette caractéristique n’est pas disponible avec tous les types d’instance. Des frais d’utilisation supplémentaires s’appliquent lorsque vous utilisez une instance optimisée EBS.**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $true
```
**Exemple 5 : Cet exemple permet de source/destination vérifier l'instance spécifiée. Pour qu’une instance NAT effectue la traduction d’adresses réseau, cette valeur doit être « false ».**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $true
```
**Exemple 6 : cet exemple désactive la résiliation de l’instance spécifiée.**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $true
```
**Exemple 7 : cet exemple modifie l’instance spécifiée afin qu’elle se résilie lorsque l’arrêt est lancé à partir de l’instance.**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyInstanceAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2InstanceCreditSpecification`
L'exemple de code suivant montre comment utiliser`Edit-EC2InstanceCreditSpecification`.
**Outils pour PowerShell V4**
**Exemple 1 : cela active les crédits T2 illimités pour l’instance i-01234567890abcdef.**
```
$Credit = New-Object -TypeName Amazon.EC2.Model.InstanceCreditSpecificationRequest
$Credit.InstanceId = "i-01234567890abcdef"
$Credit.CpuCredits = "unlimited"
Edit-EC2InstanceCreditSpecification -InstanceCreditSpecification $Credit
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyInstanceCreditSpecification](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2NetworkInterfaceAttribute`
L'exemple de code suivant montre comment utiliser`Edit-EC2NetworkInterfaceAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie l’interface réseau spécifiée afin que l’attachement spécifié soit supprimé lors de la résiliation.**
```
Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -Attachment_AttachmentId eni-attach-1a2b3c4d -Attachment_DeleteOnTermination $true
```
**Exemple 2 : cet exemple modifie la description de l’interface réseau spécifiée.**
```
Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -Description "my description"
```
**Exemple 3 : cet exemple modifie le groupe de sécurité pour l’instance réseau spécifiée.**
```
Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -Groups sg-1a2b3c4d
```
**Exemple 4 : Cet exemple désactive la source/destination vérification de l'interface réseau spécifiée.**
```
Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -SourceDestCheck $false
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyNetworkInterfaceAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2ReservedInstance`
L'exemple de code suivant montre comment utiliser`Edit-EC2ReservedInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie la zone de disponibilité, le nombre d’instances et la plateforme pour les instances réservées spécifiées.**
```
$config = New-Object Amazon.EC2.Model.ReservedInstancesConfiguration
$config.AvailabilityZone = "us-west-2a"
$config.InstanceCount = 1
$config.Platform = "EC2-VPC"
Edit-EC2ReservedInstance `
-ReservedInstancesId @("FE32132D-70D5-4795-B400-AE435EXAMPLE", "0CC556F3-7AB8-4C00-B0E5-98666EXAMPLE") `
-TargetConfiguration $config
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyReservedInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2SnapshotAttribute`
L'exemple de code suivant montre comment utiliser`Edit-EC2SnapshotAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple rend public le cliché spécifié en définissant son CreateVolumePermission attribut.**
```
Edit-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission -OperationType Add -GroupName all
```
+ Pour plus de détails sur l'API, reportez-vous [ModifySnapshotAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2SpotFleetRequest`
L'exemple de code suivant montre comment utiliser`Edit-EC2SpotFleetRequest`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la capacité cible de la demande de parc d’instances Spot spécifiée.**
```
Edit-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -TargetCapacity 10
```
**Sortie** :
```
True
```
+ Pour plus de détails sur l'API, reportez-vous [ModifySpotFleetRequest](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2SubnetAttribute`
L'exemple de code suivant montre comment utiliser`Edit-EC2SubnetAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active l’adressage IP public pour le sous-réseau spécifié.**
```
Edit-EC2SubnetAttribute -SubnetId subnet-1a2b3c4d -MapPublicIpOnLaunch $true
```
**Exemple 2 : cet exemple désactive l’adressage IP public pour le sous-réseau spécifié.**
```
Edit-EC2SubnetAttribute -SubnetId subnet-1a2b3c4d -MapPublicIpOnLaunch $false
```
+ Pour plus de détails sur l'API, reportez-vous [ModifySubnetAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2VolumeAttribute`
L'exemple de code suivant montre comment utiliser`Edit-EC2VolumeAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple modifie l'attribut spécifié du volume spécifié. I/O les opérations relatives au volume reprennent automatiquement après avoir été suspendues en raison de données potentiellement incohérentes.**
```
Edit-EC2VolumeAttribute -VolumeId vol-12345678 -AutoEnableIO $true
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyVolumeAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-EC2VpcAttribute`
L'exemple de code suivant montre comment utiliser`Edit-EC2VpcAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active la prise en charge des noms d’hôte DNS pour le VPC spécifié.**
```
Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsHostnames $true
```
**Exemple 2 : cet exemple désactive la prise en charge des noms d’hôte DNS pour le VPC spécifié.**
```
Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsHostnames $false
```
**Exemple 3 : cet exemple active la prise en charge de la résolution DNS pour le VPC spécifié.**
```
Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsSupport $true
```
**Exemple 4 : cet exemple désactive la prise en charge de la résolution DNS pour le VPC spécifié.**
```
Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsSupport $false
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyVpcAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-EC2VgwRoutePropagation`
L'exemple de code suivant montre comment utiliser`Enable-EC2VgwRoutePropagation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet à la passerelle virtuelle spécifiée de propager automatiquement les itinéraires vers la table de routage spécifiée.**
```
Enable-EC2VgwRoutePropagation -RouteTableId rtb-12345678 -GatewayId vgw-1a2b3c4d
```
+ Pour plus de détails sur l'API, reportez-vous [EnableVgwRoutePropagation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-EC2VolumeIO`
L'exemple de code suivant montre comment utiliser`Enable-EC2VolumeIO`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple active les I/O opérations pour le volume spécifié, si les I/O opérations ont été désactivées.**
```
Enable-EC2VolumeIO -VolumeId vol-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [EnableVolumeIo](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-EC2VpcClassicLink`
L'exemple de code suivant montre comment utiliser`Enable-EC2VpcClassicLink`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple active le VPC vpc-0123456b789b0d12f pour ClassicLink**
```
Enable-EC2VpcClassicLink -VpcId vpc-0123456b789b0d12f
```
**Sortie** :
```
True
```
+ Pour plus de détails sur l'API, reportez-vous [EnableVpcClassicLink](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-EC2VpcClassicLinkDnsSupport`
L'exemple de code suivant montre comment utiliser`Enable-EC2VpcClassicLinkDnsSupport`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple permet à vpc-0b12d3456a7e8910d de prendre en charge la résolution du nom d'hôte DNS pour ClassicLink**
```
Enable-EC2VpcClassicLinkDnsSupport -VpcId vpc-0b12d3456a7e8910d -Region eu-west-1
```
+ Pour plus de détails sur l'API, reportez-vous [EnableVpcClassicLinkDnsSupport](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2AccountAttribute`
L'exemple de code suivant montre comment utiliser`Get-EC2AccountAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple indique si vous pouvez lancer des instances dans EC2-Classic et EC2-VPC dans la région, ou uniquement dans EC2-VPC.**
```
(Get-EC2AccountAttribute -AttributeName supported-platforms).AttributeValues
```
**Sortie** :
```
AttributeValue
--------------
EC2
VPC
```
**Exemple 2 : cet exemple décrit votre VPC par défaut, ou indique « aucun » si vous n’avez pas de VPC par défaut dans la région.**
```
(Get-EC2AccountAttribute -AttributeName default-vpc).AttributeValues
```
**Sortie** :
```
AttributeValue
--------------
vpc-12345678
```
**Exemple 3 : cet exemple décrit le nombre maximal d’instances à la demande que vous pouvez exécuter.**
```
(Get-EC2AccountAttribute -AttributeName max-instances).AttributeValues
```
**Sortie** :
```
AttributeValue
--------------
20
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAccountAttributes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2Address`
L'exemple de code suivant montre comment utiliser`Get-EC2Address`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’adresse IP Elastic spécifiée pour les instances dans EC2-Classic.**
```
Get-EC2Address -AllocationId eipalloc-12345678
```
**Sortie** :
```
AllocationId : eipalloc-12345678
AssociationId : eipassoc-12345678
Domain : vpc
InstanceId : i-87654321
NetworkInterfaceId : eni-12345678
NetworkInterfaceOwnerId : 12345678
PrivateIpAddress : 10.0.2.172
PublicIp : 198.51.100.2
```
**Exemple 2 : cet exemple décrit vos adresses IP Elastic spécifiées pour les instances dans un VPC. Cette syntaxe nécessite PowerShell la version 3 ou ultérieure.**
```
Get-EC2Address -Filter @{ Name="domain";Values="vpc" }
```
**Exemple 3 : cet exemple décrit l’adresse IP Elastic spécifiée pour les instances dans EC2-Classic.**
```
Get-EC2Address -PublicIp 203.0.113.17
```
**Sortie** :
```
AllocationId :
AssociationId :
Domain : standard
InstanceId : i-12345678
NetworkInterfaceId :
NetworkInterfaceOwnerId :
PrivateIpAddress :
PublicIp : 203.0.113.17
```
**Exemple 4 : cet exemple décrit vos adresses IP Elastic spécifiées pour les instances dans EC2-Classic. Cette syntaxe nécessite PowerShell la version 3 ou ultérieure.**
```
Get-EC2Address -Filter @{ Name="domain";Values="standard" }
```
**Exemple 5 : cet exemple décrit toutes vos adresses IP Elastic.**
```
Get-EC2Address
```
**Exemple 6 : cet exemple renvoie les adresses IP publiques et privées pour l’ID d’instance fourni dans le filtre**
```
Get-EC2Address -Region eu-west-1 -Filter @{Name="instance-id";Values="i-0c12d3f4f567ffb89"} | Select-Object PrivateIpAddress, PublicIp
```
**Sortie** :
```
PrivateIpAddress PublicIp
---------------- --------
10.0.0.99 63.36.5.227
```
**Exemple 7 : Cet exemple récupère tous les Elastic IPs avec son identifiant d'allocation, son identifiant d'association et ses identifiants d'instance**
```
Get-EC2Address -Region eu-west-1 | Select-Object InstanceId, AssociationId, AllocationId, PublicIp
```
**Sortie** :
```
InstanceId AssociationId AllocationId PublicIp
---------- ------------- ------------ --------
eipalloc-012e3b456789e1fad 17.212.120.178
i-0c123dfd3415bac67 eipassoc-0e123456bb7890bdb eipalloc-01cd23ebf45f7890c 17.212.124.77
eipalloc-012345678eeabcfad 17.212.225.7
i-0123d405c67e89a0c eipassoc-0c123b456783966ba eipalloc-0123cdd456a8f7892 37.216.52.173
i-0f1bf2f34c5678d09 eipassoc-0e12934568a952d96 eipalloc-0e1c23e4d5e6789e4 37.218.222.278
i-012e3cb4df567e8aa eipassoc-0d1b2fa4d67d03810 eipalloc-0123f456f78a01b58 37.210.82.27
i-0123bcf4b567890e1 eipassoc-01d2345f678903fb1 eipalloc-0e1db23cfef5c45c7 37.215.222.270
```
**Exemple 8 : cet exemple extrait la liste des adresses IP EC2 correspondant à la clé de balise « Catégorie » à la valeur « Prod »**
```
Get-EC2Address -Filter @{Name="tag:Category";Values="Prod"}
```
**Sortie** :
```
AllocationId : eipalloc-0123f456f81a01b58
AssociationId : eipassoc-0d1b23a456d103810
CustomerOwnedIp :
CustomerOwnedIpv4Pool :
Domain : vpc
InstanceId : i-012e3cb4df567e1aa
NetworkBorderGroup : eu-west-1
NetworkInterfaceId : eni-0123f41d5a60d5f40
NetworkInterfaceOwnerId : 123456789012
PrivateIpAddress : 192.168.1.84
PublicIp : 34.250.81.29
PublicIpv4Pool : amazon
Tags : {Category, Name}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAddresses](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2AvailabilityZone`
L'exemple de code suivant montre comment utiliser`Get-EC2AvailabilityZone`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les zones de disponibilité disponibles pour la région actuelle.**
```
Get-EC2AvailabilityZone
```
**Sortie** :
```
Messages RegionName State ZoneName
-------- ---------- ----- --------
{} us-west-2 available us-west-2a
{} us-west-2 available us-west-2b
{} us-west-2 available us-west-2c
```
**Exemple 2 : cet exemple décrit toutes les zones de disponibilité dont l’état est altéré. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou supérieure.**
```
Get-EC2AvailabilityZone -Filter @{ Name="state";Values="impaired" }
```
**Exemple 3 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer le filtre.**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "state"
$filter.Values = "impaired"
Get-EC2AvailabilityZone -Filter $filter
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAvailabilityZones](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2BundleTask`
L'exemple de code suivant montre comment utiliser`Get-EC2BundleTask`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit la tâche groupée spécifiée.**
```
Get-EC2BundleTask -BundleId bun-12345678
```
**Exemple 2 : cet exemple décrit les tâches groupées dont l’état est « terminé » ou « échec ».**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "state"
$filter.Values = @( "complete", "failed" )
Get-EC2BundleTask -Filter $filter
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeBundleTasks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2CapacityReservation`
L'exemple de code suivant montre comment utiliser`Get-EC2CapacityReservation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit une ou plusieurs de vos réserves de capacité pour la région**
```
Get-EC2CapacityReservation -Region eu-west-1
```
**Sortie** :
```
AvailabilityZone : eu-west-1b
AvailableInstanceCount : 2
CapacityReservationId : cr-0c1f2345db6f7cdba
CreateDate : 3/28/2019 9:29:41 AM
EbsOptimized : True
EndDate : 1/1/0001 12:00:00 AM
EndDateType : unlimited
EphemeralStorage : False
InstanceMatchCriteria : open
InstancePlatform : Windows
InstanceType : m4.xlarge
State : active
Tags : {}
Tenancy : default
TotalInstanceCount : 2
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeCapacityReservations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2ConsoleOutput`
L'exemple de code suivant montre comment utiliser`Get-EC2ConsoleOutput`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient la sortie de console pour l’instance Linux spécifiée. La sortie de la console est codée.**
```
Get-EC2ConsoleOutput -InstanceId i-0e19abcd47c123456
```
**Sortie** :
```
InstanceId Output
---------- ------
i-0e194d3c47c123637 WyAgICAwLjAwMDAwMF0gQ29tbW...bGU9dHR5UzAgc2Vs
```
**Exemple 2 : cet exemple stocke la sortie codée de la console dans une variable, puis la décode.**
```
$Output_encoded = (Get-EC2ConsoleOutput -InstanceId i-0e19abcd47c123456).Output
[System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String($Output_encoded))
```
+ Pour plus de détails sur l'API, reportez-vous [GetConsoleOutput](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2CustomerGateway`
L'exemple de code suivant montre comment utiliser`Get-EC2CustomerGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit la passerelle client spécifiée.**
```
Get-EC2CustomerGateway -CustomerGatewayId cgw-1a2b3c4d
```
**Sortie** :
```
BgpAsn : 65534
CustomerGatewayId : cgw-1a2b3c4d
IpAddress : 203.0.113.12
State : available
Tags : {}
Type : ipsec.1
```
**Exemple 2 : cet exemple décrit toute passerelle client dont l’état est en attente ou disponible.**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "state"
$filter.Values = @( "pending", "available" )
Get-EC2CustomerGateway -Filter $filter
```
**Exemple 3 : cet exemple décrit toutes vos passerelles client.**
```
Get-EC2CustomerGateway
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeCustomerGateways](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2DhcpOption`
L'exemple de code suivant montre comment utiliser`Get-EC2DhcpOption`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie vos ensembles d’options DHCP.**
```
Get-EC2DhcpOption
```
**Sortie** :
```
DhcpConfigurations DhcpOptionsId Tag
------------------ ------------- ---
{domain-name, domain-name-servers} dopt-1a2b3c4d {}
{domain-name, domain-name-servers} dopt-2a3b4c5d {}
{domain-name-servers} dopt-3a4b5c6d {}
```
**Exemple 2 : cet exemple obtient les détails de configuration du jeu d’options DHCP spécifié.**
```
(Get-EC2DhcpOption -DhcpOptionsId dopt-1a2b3c4d).DhcpConfigurations
```
**Sortie** :
```
Key Values
--- ------
domain-name {abc.local}
domain-name-servers {10.0.0.101, 10.0.0.102}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeDhcpOptions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2FlowLog`
L'exemple de code suivant montre comment utiliser`Get-EC2FlowLog`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit un ou plusieurs journaux de flux avec le type de destination de journal « s3 »**
```
Get-EC2FlowLog -Filter @{Name="log-destination-type";Values="s3"}
```
**Sortie** :
```
CreationTime : 2/25/2019 9:07:36 PM
DeliverLogsErrorMessage :
DeliverLogsPermissionArn :
DeliverLogsStatus : SUCCESS
FlowLogId : fl-01b2e3d45f67f8901
FlowLogStatus : ACTIVE
LogDestination : arn:aws:s3:::amzn-s3-demo-bucket-dd-tata
LogDestinationType : s3
LogGroupName :
ResourceId : eni-01d2dda3456b7e890
TrafficType : ALL
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeFlowLogs](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2Host`
L'exemple de code suivant montre comment utiliser`Get-EC2Host`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie les détails de l’hôte EC2.**
```
Get-EC2Host
```
**Sortie** :
```
AllocationTime : 3/23/2019 4:55:22 PM
AutoPlacement : off
AvailabilityZone : eu-west-1b
AvailableCapacity : Amazon.EC2.Model.AvailableCapacity
ClientToken :
HostId : h-01e23f4cd567890f1
HostProperties : Amazon.EC2.Model.HostProperties
HostReservationId :
Instances : {}
ReleaseTime : 1/1/0001 12:00:00 AM
State : available
Tags : {}
```
**Exemple 2 : Cet exemple interroge le AvailableInstanceCapacity pour l'hôte h-01e23f4cd567899f1**
```
Get-EC2Host -HostId h-01e23f4cd567899f1 | Select-Object -ExpandProperty AvailableCapacity | Select-Object -expand AvailableInstanceCapacity
```
**Sortie** :
```
AvailableCapacity InstanceType TotalCapacity
----------------- ------------ -------------
11 m4.xlarge 11
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeHosts](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2HostReservationOffering`
L'exemple de code suivant montre comment utiliser`Get-EC2HostReservationOffering`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple décrit les réservations d'hôtes dédiés disponibles à l'achat pour le filtre « instance-family » donné où se PaymentOption trouve « » NoUpfront**
```
Get-EC2HostReservationOffering -Filter @{Name="instance-family";Values="m4"} | Where-Object PaymentOption -eq NoUpfront
```
**Sortie** :
```
CurrencyCode :
Duration : 94608000
HourlyPrice : 1.307
InstanceFamily : m4
OfferingId : hro-0c1f234567890d9ab
PaymentOption : NoUpfront
UpfrontPrice : 0.000
CurrencyCode :
Duration : 31536000
HourlyPrice : 1.830
InstanceFamily : m4
OfferingId : hro-04ad12aaaf34b5a67
PaymentOption : NoUpfront
UpfrontPrice : 0.000
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeHostReservationOfferings](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2HostReservationPurchasePreview`
L'exemple de code suivant montre comment utiliser`Get-EC2HostReservationPurchasePreview`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple offre un aperçu d’un achat de réserve avec des configurations qui correspondent à celles de votre hôte dédié h-01e23f4cd567890f1**
```
Get-EC2HostReservationPurchasePreview -OfferingId hro-0c1f23456789d0ab -HostIdSet h-01e23f4cd567890f1
```
**Sortie** :
```
CurrencyCode Purchase TotalHourlyPrice TotalUpfrontPrice
------------ -------- ---------------- -----------------
{} 1.307 0.000
```
+ Pour plus de détails sur l'API, reportez-vous [GetHostReservationPurchasePreview](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2IdFormat`
L'exemple de code suivant montre comment utiliser`Get-EC2IdFormat`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active le format d’ID pour le type de ressource spécifié.**
```
Get-EC2IdFormat -Resource instance
```
**Sortie** :
```
Resource UseLongIds
-------- ----------
instance False
```
**Exemple 2 : Cet exemple décrit les formats d'identification pour tous les types de ressources qui prennent en charge les extensions IDs.**
```
Get-EC2IdFormat
```
**Sortie** :
```
Resource UseLongIds
-------- ----------
reservation False
instance False
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeIdFormat](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2IdentityIdFormat`
L'exemple de code suivant montre comment utiliser`Get-EC2IdentityIdFormat`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie le format d’ID pour la ressource « image » pour le rôle donné**
```
Get-EC2IdentityIdFormat -PrincipalArn arn:aws:iam::123456789511:role/JDBC -Resource image
```
**Sortie** :
```
Deadline Resource UseLongIds
-------- -------- ----------
8/2/2018 11:30:00 PM image True
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeIdentityIdFormat](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2Image`
L'exemple de code suivant montre comment utiliser`Get-EC2Image`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’AMI spécifiée.**
```
Get-EC2Image -ImageId ami-12345678
```
**Sortie** :
```
Architecture : x86_64
BlockDeviceMappings : {/dev/xvda}
CreationDate : 2014-10-20T00:56:28.000Z
Description : My image
Hypervisor : xen
ImageId : ami-12345678
ImageLocation : 123456789012/my-image
ImageOwnerAlias :
ImageType : machine
KernelId :
Name : my-image
OwnerId : 123456789012
Platform :
ProductCodes : {}
Public : False
RamdiskId :
RootDeviceName : /dev/xvda
RootDeviceType : ebs
SriovNetSupport : simple
State : available
StateReason :
Tags : {Name}
VirtualizationType : hvm
```
**Exemple 2 : Cet exemple décrit le produit AMIs que vous possédez.**
```
Get-EC2Image -owner self
```
**Exemple 3 : Cet exemple décrit le public AMIs qui exécute Microsoft Windows Server.**
```
Get-EC2Image -Filter @{ Name="platform"; Values="windows" }
```
**Exemple 4 : Cet exemple décrit tous les publics de la AMIs région « us-west-2 ».**
```
Get-EC2Image -Region us-west-2
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeImages](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2ImageAttribute`
L'exemple de code suivant montre comment utiliser`Get-EC2ImageAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient la description de l’AMI spécifiée.**
```
Get-EC2ImageAttribute -ImageId ami-12345678 -Attribute description
```
**Sortie** :
```
BlockDeviceMappings : {}
Description : My image description
ImageId : ami-12345678
KernelId :
LaunchPermissions : {}
ProductCodes : {}
RamdiskId :
SriovNetSupport :
```
**Exemple 2 : cet exemple décrit les autorisations de lancement pour l’AMI spécifiée.**
```
Get-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission
```
**Sortie** :
```
BlockDeviceMappings : {}
Description :
ImageId : ami-12345678
KernelId :
LaunchPermissions : {all}
ProductCodes : {}
RamdiskId :
SriovNetSupport :
```
**Exemple 3 : cet exemple teste si la mise en réseau améliorée est activée.**
```
Get-EC2ImageAttribute -ImageId ami-12345678 -Attribute sriovNetSupport
```
**Sortie** :
```
BlockDeviceMappings : {}
Description :
ImageId : ami-12345678
KernelId :
LaunchPermissions : {}
ProductCodes : {}
RamdiskId :
SriovNetSupport : simple
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeImageAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2ImageByName`
L'exemple de code suivant montre comment utiliser`Get-EC2ImageByName`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’ensemble complet des noms de filtres actuellement pris en charge.**
```
Get-EC2ImageByName
```
**Sortie** :
```
WINDOWS_2016_BASE
WINDOWS_2016_NANO
WINDOWS_2016_CORE
WINDOWS_2016_CONTAINER
WINDOWS_2016_SQL_SERVER_ENTERPRISE_2016
WINDOWS_2016_SQL_SERVER_STANDARD_2016
WINDOWS_2016_SQL_SERVER_WEB_2016
WINDOWS_2016_SQL_SERVER_EXPRESS_2016
WINDOWS_2012R2_BASE
WINDOWS_2012R2_CORE
WINDOWS_2012R2_SQL_SERVER_EXPRESS_2016
WINDOWS_2012R2_SQL_SERVER_STANDARD_2016
WINDOWS_2012R2_SQL_SERVER_WEB_2016
WINDOWS_2012R2_SQL_SERVER_EXPRESS_2014
WINDOWS_2012R2_SQL_SERVER_STANDARD_2014
WINDOWS_2012R2_SQL_SERVER_WEB_2014
WINDOWS_2012_BASE
WINDOWS_2012_SQL_SERVER_EXPRESS_2014
WINDOWS_2012_SQL_SERVER_STANDARD_2014
WINDOWS_2012_SQL_SERVER_WEB_2014
WINDOWS_2012_SQL_SERVER_EXPRESS_2012
WINDOWS_2012_SQL_SERVER_STANDARD_2012
WINDOWS_2012_SQL_SERVER_WEB_2012
WINDOWS_2012_SQL_SERVER_EXPRESS_2008
WINDOWS_2012_SQL_SERVER_STANDARD_2008
WINDOWS_2012_SQL_SERVER_WEB_2008
WINDOWS_2008R2_BASE
WINDOWS_2008R2_SQL_SERVER_EXPRESS_2012
WINDOWS_2008R2_SQL_SERVER_STANDARD_2012
WINDOWS_2008R2_SQL_SERVER_WEB_2012
WINDOWS_2008R2_SQL_SERVER_EXPRESS_2008
WINDOWS_2008R2_SQL_SERVER_STANDARD_2008
WINDOWS_2008R2_SQL_SERVER_WEB_2008
WINDOWS_2008RTM_BASE
WINDOWS_2008RTM_SQL_SERVER_EXPRESS_2008
WINDOWS_2008RTM_SQL_SERVER_STANDARD_2008
WINDOWS_2008_BEANSTALK_IIS75
WINDOWS_2012_BEANSTALK_IIS8
VPC_NAT
```
**Exemple 2 : cet exemple décrit l’AMI spécifiée. L'utilisation de cette commande pour localiser une AMI est utile car AWS chaque mois, une nouvelle version de Windows est publiée AMIs avec les dernières mises à jour. Vous pouvez spécifier le « ImageId » pour lancer une instance New-EC2Instance à l'aide de l'AMI actuelle pour le filtre spécifié.**
```
Get-EC2ImageByName -Names WINDOWS_2016_BASE
```
**Sortie** :
```
Architecture : x86_64
BlockDeviceMappings : {/dev/sda1, xvdca, xvdcb, xvdcc...}
CreationDate : yyyy.mm.ddThh:mm:ss.000Z
Description : Microsoft Windows Server 2016 with Desktop Experience Locale English AMI provided by Amazon
Hypervisor : xen
ImageId : ami-xxxxxxxx
ImageLocation : amazon/Windows_Server-2016-English-Full-Base-yyyy.mm.dd
ImageOwnerAlias : amazon
ImageType : machine
KernelId :
Name : Windows_Server-2016-English-Full-Base-yyyy.mm.dd
OwnerId : 801119661308
Platform : Windows
ProductCodes : {}
Public : True
RamdiskId :
RootDeviceName : /dev/sda1
RootDeviceType : ebs
SriovNetSupport : simple
State : available
StateReason :
Tags : {}
VirtualizationType : hvm
```
+ Pour plus de détails sur l'API, reportez-vous [Get-EC2ImageByName](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2ImportImageTask`
L'exemple de code suivant montre comment utiliser`Get-EC2ImportImageTask`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit la tâche d’importation d’image spécifiée.**
```
Get-EC2ImportImageTask -ImportTaskId import-ami-hgfedcba
```
**Sortie** :
```
Architecture : x86_64
Description : Windows Image 2
Hypervisor :
ImageId : ami-1a2b3c4d
ImportTaskId : import-ami-hgfedcba
LicenseType : AWS
Platform : Windows
Progress :
SnapshotDetails : {/dev/sda1}
Status : completed
StatusMessage :
```
**Exemple 2 : cet exemple décrit toutes vos tâches d’importation d’image.**
```
Get-EC2ImportImageTask
```
**Sortie** :
```
Architecture :
Description : Windows Image 1
Hypervisor :
ImageId :
ImportTaskId : import-ami-abcdefgh
LicenseType : AWS
Platform : Windows
Progress :
SnapshotDetails : {}
Status : deleted
StatusMessage : User initiated task cancelation
Architecture : x86_64
Description : Windows Image 2
Hypervisor :
ImageId : ami-1a2b3c4d
ImportTaskId : import-ami-hgfedcba
LicenseType : AWS
Platform : Windows
Progress :
SnapshotDetails : {/dev/sda1}
Status : completed
StatusMessage :
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeImportImageTasks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2ImportSnapshotTask`
L'exemple de code suivant montre comment utiliser`Get-EC2ImportSnapshotTask`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit la tâche d’importation de l’instantané spécifié.**
```
Get-EC2ImportSnapshotTask -ImportTaskId import-snap-abcdefgh
```
**Sortie** :
```
Description ImportTaskId SnapshotTaskDetail
----------------- -------------------- ------------------
Disk Image Import 1 import-snap-abcdefgh Amazon.EC2.Model.SnapshotTaskDetail
```
**Exemple 2 : cet exemple décrit toutes vos tâches d’importation d’instantanés.**
```
Get-EC2ImportSnapshotTask
```
**Sortie** :
```
Description ImportTaskId SnapshotTaskDetail
----------------- -------------------- ------------------
Disk Image Import 1 import-snap-abcdefgh Amazon.EC2.Model.SnapshotTaskDetail
Disk Image Import 2 import-snap-hgfedcba Amazon.EC2.Model.SnapshotTaskDetail
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeImportSnapshotTasks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2Instance`
L'exemple de code suivant montre comment utiliser`Get-EC2Instance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’instance spécifiée.**
```
(Get-EC2Instance -InstanceId i-12345678).Instances
```
**Sortie** :
```
AmiLaunchIndex : 0
Architecture : x86_64
BlockDeviceMappings : {/dev/sda1}
ClientToken : TleEy1448154045270
EbsOptimized : False
Hypervisor : xen
IamInstanceProfile : Amazon.EC2.Model.IamInstanceProfile
ImageId : ami-12345678
InstanceId : i-12345678
InstanceLifecycle :
InstanceType : t2.micro
KernelId :
KeyName : my-key-pair
LaunchTime : 12/4/2015 4:44:40 PM
Monitoring : Amazon.EC2.Model.Monitoring
NetworkInterfaces : {ip-10-0-2-172.us-west-2.compute.internal}
Placement : Amazon.EC2.Model.Placement
Platform : Windows
PrivateDnsName : ip-10-0-2-172.us-west-2.compute.internal
PrivateIpAddress : 10.0.2.172
ProductCodes : {}
PublicDnsName :
PublicIpAddress :
RamdiskId :
RootDeviceName : /dev/sda1
RootDeviceType : ebs
SecurityGroups : {default}
SourceDestCheck : True
SpotInstanceRequestId :
SriovNetSupport :
State : Amazon.EC2.Model.InstanceState
StateReason :
StateTransitionReason :
SubnetId : subnet-12345678
Tags : {Name}
VirtualizationType : hvm
VpcId : vpc-12345678
```
**Exemple 2 : cet exemple décrit toutes vos instances dans la région actuelle, regroupées par réserve. Pour voir les détails des instances, développez la collection Instances au sein de chaque objet de réserve.**
```
Get-EC2Instance
```
**Sortie** :
```
GroupNames : {}
Groups : {}
Instances : {}
OwnerId : 123456789012
RequesterId : 226008221399
ReservationId : r-c5df370c
GroupNames : {}
Groups : {}
Instances : {}
OwnerId : 123456789012
RequesterId : 854251627541
ReservationId : r-63e65bab
...
```
**Exemple 3 : cet exemple illustre l’utilisation d’un filtre pour interroger des instances EC2 dans un sous-réseau spécifique d’un VPC.**
```
(Get-EC2Instance -Filter @{Name="vpc-id";Values="vpc-1a2bc34d"},@{Name="subnet-id";Values="subnet-1a2b3c4d"}).Instances
```
**Sortie** :
```
InstanceId InstanceType Platform PrivateIpAddress PublicIpAddress SecurityGroups SubnetId VpcId
---------- ------------ -------- ---------------- --------------- -------------- -------- -----
i-01af...82cf180e19 t2.medium Windows 10.0.0.98 ... subnet-1a2b3c4d vpc-1a2b3c4d
i-0374...7e9d5b0c45 t2.xlarge Windows 10.0.0.53 ... subnet-1a2b3c4d vpc-1a2b3c4d
```
**Exemple 4 : cet exemple illustre l’utilisation d’un filtre à valeurs multiples pour interroger des instances EC2 à la fois en cours d’exécution et arrêtées**
```
$InstanceParams = @{
Filter = @(
@{'Name' = 'instance-state-name';'Values' = @("running","stopped")}
)
}
(Get-EC2Instance @InstanceParams).Instances
```
**Sortie** :
```
InstanceId InstanceType Platform PrivateIpAddress PublicIpAddress SecurityGroups SubnetId VpcId
---------- ------------ -------- ---------------- --------------- -------------- -------- -----
i-05a9...f6c5f46e18 t3.medium 10.0.1.7 ... subnet-1a2b3c4d vpc-1a2b3c4d
i-02cf...945c4fdd07 t3.medium Windows 10.0.1.8 ... subnet-1a2b3c4d vpc-1a2b3c4d
i-0ac0...c037f9f3a1 t3.xlarge Windows 10.0.1.10 ... subnet-1a2b3c4d vpc-1a2b3c4d
i-066b...57b7b08888 t3.medium Windows 10.0.1.11 ... subnet-1a2b3c4d vpc-1a2b3c4d
i-0fee...82e83ccd72 t3.medium Windows 10.0.1.5 ... subnet-1a2b3c4d vpc-1a2b3c4d
i-0a68...274cc5043b t3.medium Windows 10.0.1.6 ... subnet-1a2b3c4d vpc-1a2b3c4d
```
**Exemple 5 : cet exemple illustre l’utilisation d’un filtre à valeurs multiples pour interroger des instances EC2 à la fois en cours d’exécution et arrêtées, et l’utilisation de l’applet de commande Select-Object afin de choisir des valeurs spécifiques de sortie.**
```
$InstanceParams = @{
Filter = @(
@{'Name' = 'instance-state-name';'Values' = @("running","stopped")}
)
}
$SelectParams = @{
Property = @(
"InstanceID", "InstanceType", "Platform", "PrivateIpAddress",
@{Name="Name";Expression={$_.Tags[$_.Tags.Key.IndexOf("Name")].Value}},
@{Name="State";Expression={$_.State.Name}}
)
}
$result = Get-EC2Instance @InstanceParams
$result.Instances | Select-Object @SelectParams | Format-Table -AutoSize
```
**Sortie** :
```
InstanceId InstanceType Platform PrivateIpAddress Name State
---------- ------------ -------- ---------------- ---- -----
i-05a9...f6c5f46e18 t3.medium 10.0.1.7 ec2-name-01 running
i-02cf...945c4fdd07 t3.medium Windows 10.0.1.8 ec2-name-02 stopped
i-0ac0...c037f9f3a1 t3.xlarge Windows 10.0.1.10 ec2-name-03 running
i-066b...57b7b08888 t3.medium Windows 10.0.1.11 ec2-name-04 stopped
i-0fee...82e83ccd72 t3.medium Windows 10.0.1.5 ec2-name-05 running
i-0a68...274cc5043b t3.medium Windows 10.0.1.6 ec2-name-06 stopped
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2InstanceAttribute`
L'exemple de code suivant montre comment utiliser`Get-EC2InstanceAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le type de l’instance spécifiée.**
```
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceType
```
**Sortie** :
```
InstanceType : t2.micro
```
**Exemple 2 : cet exemple indique si la mise en réseau améliorée est activée pour l’instance spécifiée.**
```
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute sriovNetSupport
```
**Sortie** :
```
SriovNetSupport : simple
```
**Exemple 3 : cet exemple décrit les groupes de sécurité pour l’instance spécifiée.**
```
(Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute groupSet).Groups
```
**Sortie** :
```
GroupId
-------
sg-12345678
sg-45678901
```
**Exemple 4 : cet exemple indique si l’optimisation EBS est activée pour l’instance spécifiée.**
```
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute ebsOptimized
```
**Sortie** :
```
EbsOptimized : False
```
**Exemple 5 : Cet exemple décrit l'attribut disableApiTermination « » de l'instance spécifiée.**
```
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute disableApiTermination
```
**Sortie** :
```
DisableApiTermination : False
```
**Exemple 6 : Cet exemple décrit l'attribut « instanceInitiatedShutdown Comportement » de l'instance spécifiée.**
```
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceInitiatedShutdownBehavior
```
**Sortie** :
```
InstanceInitiatedShutdownBehavior : stop
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstanceAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2InstanceMetadata`
L'exemple de code suivant montre comment utiliser`Get-EC2InstanceMetadata`.
**Outils pour PowerShell V4**
**Exemple 1 : répertorie les catégories de métadonnées d’instance disponibles qui peuvent être interrogées.**
```
Get-EC2InstanceMetadata -ListCategory
```
**Sortie** :
```
AmiId
LaunchIndex
ManifestPath
AncestorAmiId
BlockDeviceMapping
InstanceId
InstanceType
LocalHostname
LocalIpv4
KernelId
AvailabilityZone
ProductCode
PublicHostname
PublicIpv4
PublicKey
RamdiskId
Region
ReservationId
SecurityGroup
UserData
InstanceMonitoring
IdentityDocument
IdentitySignature
IdentityPkcs7
```
**Exemple 2 : renvoie l’ID d’Amazon Machine Image (AMI) utilisée pour lancer l’instance.**
```
Get-EC2InstanceMetadata -Category AmiId
```
**Sortie** :
```
ami-b2e756ca
```
**Exemple 3 : cet exemple interroge le document d’identité au format JSON pour l’instance.**
```
Get-EC2InstanceMetadata -Category IdentityDocument
{
"availabilityZone" : "us-west-2a",
"devpayProductCodes" : null,
"marketplaceProductCodes" : null,
"version" : "2017-09-30",
"instanceId" : "i-01ed50f7e2607f09e",
"billingProducts" : [ "bp-6ba54002" ],
"instanceType" : "t2.small",
"pendingTime" : "2018-03-07T16:26:04Z",
"imageId" : "ami-b2e756ca",
"privateIp" : "10.0.0.171",
"accountId" : "111122223333",
"architecture" : "x86_64",
"kernelId" : null,
"ramdiskId" : null,
"region" : "us-west-2"
}
```
**Exemple 4 : cet exemple utilise une requête de chemin pour obtenir les macs de l’interface réseau pour l’instance.**
```
Get-EC2InstanceMetadata -Path "/network/interfaces/macs"
```
**Sortie** :
```
02:80:7f:ef:4c:e0/
```
**Exemple 5 : Si un rôle IAM est associé à l'instance, renvoie des informations sur la dernière mise à jour du profil de l'instance, y compris la LastUpdated date de l'instance InstanceProfileArn, et InstanceProfileId.**
```
Get-EC2InstanceMetadata -Path "/iam/info"
```
**Sortie** :
```
{
"Code" : "Success",
"LastUpdated" : "2018-03-08T03:38:40Z",
"InstanceProfileArn" : "arn:aws:iam::111122223333:instance-profile/MyLaunchRole_Profile",
"InstanceProfileId" : "AIPAI4...WVK2RW"
}
```
+ Pour plus de détails sur l'API, reportez-vous [Get-EC2InstanceMetadata](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2InstanceStatus`
L'exemple de code suivant montre comment utiliser`Get-EC2InstanceStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le statut de l’instance spécifiée.**
```
Get-EC2InstanceStatus -InstanceId i-12345678
```
**Sortie** :
```
AvailabilityZone : us-west-2a
Events : {}
InstanceId : i-12345678
InstanceState : Amazon.EC2.Model.InstanceState
Status : Amazon.EC2.Model.InstanceStatusSummary
SystemStatus : Amazon.EC2.Model.InstanceStatusSummary
```
```
$status = Get-EC2InstanceStatus -InstanceId i-12345678
$status.InstanceState
```
**Sortie** :
```
Code Name
---- ----
16 running
```
```
$status.Status
```
**Sortie** :
```
Details Status
------- ------
{reachability} ok
```
```
$status.SystemStatus
```
**Sortie** :
```
Details Status
------- ------
{reachability} ok
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstanceStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2InternetGateway`
L'exemple de code suivant montre comment utiliser`Get-EC2InternetGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit la passerelle Internet spécifiée.**
```
Get-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d
```
**Sortie** :
```
Attachments InternetGatewayId Tags
----------- ----------------- ----
{vpc-1a2b3c4d} igw-1a2b3c4d {}
```
**Exemple 2 : cet exemple décrit toutes vos passerelles Internet.**
```
Get-EC2InternetGateway
```
**Sortie** :
```
Attachments InternetGatewayId Tags
----------- ----------------- ----
{vpc-1a2b3c4d} igw-1a2b3c4d {}
{} igw-2a3b4c5d {}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInternetGateways](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2KeyPair`
L'exemple de code suivant montre comment utiliser`Get-EC2KeyPair`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit la paire de clés spécifiée.**
```
Get-EC2KeyPair -KeyName my-key-pair
```
**Sortie** :
```
KeyFingerprint KeyName
-------------- -------
1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f my-key-pair
```
**Exemple 2 : cet exemple décrit toutes vos paires de clés.**
```
Get-EC2KeyPair
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeKeyPairs](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2NetworkAcl`
L'exemple de code suivant montre comment utiliser`Get-EC2NetworkAcl`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit la liste ACL réseau spécifiée.**
```
Get-EC2NetworkAcl -NetworkAclId acl-12345678
```
**Sortie** :
```
Associations : {aclassoc-1a2b3c4d}
Entries : {Amazon.EC2.Model.NetworkAclEntry, Amazon.EC2.Model.NetworkAclEntry}
IsDefault : False
NetworkAclId : acl-12345678
Tags : {Name}
VpcId : vpc-12345678
```
**Exemple 2 : cet exemple décrit les règles pour la liste ACL réseau spécifiée.**
```
(Get-EC2NetworkAcl -NetworkAclId acl-12345678).Entries
```
**Sortie** :
```
CidrBlock : 0.0.0.0/0
Egress : True
IcmpTypeCode :
PortRange :
Protocol : -1
RuleAction : deny
RuleNumber : 32767
CidrBlock : 0.0.0.0/0
Egress : False
IcmpTypeCode :
PortRange :
Protocol : -1
RuleAction : deny
RuleNumber : 32767
```
**Exemple 3 : Cet exemple décrit l'ensemble de votre réseau ACLs.**
```
Get-EC2NetworkAcl
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeNetworkAcls](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2NetworkInterface`
L'exemple de code suivant montre comment utiliser`Get-EC2NetworkInterface`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’interface réseau spécifiée.**
```
Get-EC2NetworkInterface -NetworkInterfaceId eni-12345678
```
**Sortie** :
```
Association :
Attachment : Amazon.EC2.Model.NetworkInterfaceAttachment
AvailabilityZone : us-west-2c
Description :
Groups : {my-security-group}
MacAddress : 0a:e9:a6:19:4c:7f
NetworkInterfaceId : eni-12345678
OwnerId : 123456789012
PrivateDnsName : ip-10-0-0-107.us-west-2.compute.internal
PrivateIpAddress : 10.0.0.107
PrivateIpAddresses : {ip-10-0-0-107.us-west-2.compute.internal}
RequesterId :
RequesterManaged : False
SourceDestCheck : True
Status : in-use
SubnetId : subnet-1a2b3c4d
TagSet : {}
VpcId : vpc-12345678
```
**Exemple 2 : cet exemple décrit toutes vos interfaces réseau.**
```
Get-EC2NetworkInterface
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeNetworkInterfaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2NetworkInterfaceAttribute`
L'exemple de code suivant montre comment utiliser`Get-EC2NetworkInterfaceAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’interface réseau spécifiée.**
```
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute Attachment
```
**Sortie** :
```
Attachment : Amazon.EC2.Model.NetworkInterfaceAttachment
```
**Exemple 2 : cet exemple décrit l’interface réseau spécifiée.**
```
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute Description
```
**Sortie** :
```
Description : My description
```
**Exemple 3 : cet exemple décrit l’interface réseau spécifiée.**
```
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute GroupSet
```
**Sortie** :
```
Groups : {my-security-group}
```
**Exemple 4 : cet exemple décrit l’interface réseau spécifiée.**
```
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute SourceDestCheck
```
**Sortie** :
```
SourceDestCheck : True
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeNetworkInterfaceAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2PasswordData`
L'exemple de code suivant montre comment utiliser`Get-EC2PasswordData`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple déchiffre le mot de passe attribué par Amazon EC2 au compte administrateur pour l’instance Windows spécifiée. Lorsqu’un fichier pem a été spécifié, le paramètre du commutateur -Decrypt est automatiquement supposé.**
```
Get-EC2PasswordData -InstanceId i-12345678 -PemFile C:\path\my-key-pair.pem
```
**Sortie** :
```
mYZ(PA9?C)Q
```
**Exemple 2 : (Windows PowerShell uniquement) Inspecte l'instance pour déterminer le nom de la paire de clés utilisée pour lancer l'instance, puis tente de trouver les données de paire de clés correspondantes dans le magasin de configuration du Toolkit for Visual Studio AWS . Si les données de la paire de clés sont trouvées, le mot de passe est déchiffré.**
```
Get-EC2PasswordData -InstanceId i-12345678 -Decrypt
```
**Sortie** :
```
mYZ(PA9?C)Q
```
**Exemple 3 : renvoie les données de mot de passe chiffrées pour l’instance.**
```
Get-EC2PasswordData -InstanceId i-12345678
```
**Sortie** :
```
iVz3BAK/WAXV.....dqt8WeMA==
```
+ Pour plus de détails sur l'API, reportez-vous [GetPasswordData](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2PlacementGroup`
L'exemple de code suivant montre comment utiliser`Get-EC2PlacementGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le groupe de placement spécifié.**
```
Get-EC2PlacementGroup -GroupName my-placement-group
```
**Sortie** :
```
GroupName State Strategy
--------- ----- --------
my-placement-group available cluster
```
+ Pour plus de détails sur l'API, reportez-vous [DescribePlacementGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2PrefixList`
L'exemple de code suivant montre comment utiliser`Get-EC2PrefixList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple extrait le fichier disponible Services AWS sous forme de liste de préfixes pour la région**
```
Get-EC2PrefixList
```
**Sortie** :
```
Cidrs PrefixListId PrefixListName
----- ------------ --------------
{52.94.5.0/24, 52.119.240.0/21, 52.94.24.0/23} pl-6fa54006 com.amazonaws.eu-west-1.dynamodb
{52.218.0.0/17, 54.231.128.0/19} pl-6da54004 com.amazonaws.eu-west-1.s3
```
+ Pour plus de détails sur l'API, reportez-vous [DescribePrefixLists](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2Region`
L'exemple de code suivant montre comment utiliser`Get-EC2Region`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les régions qui sont à votre disposition.**
```
Get-EC2Region
```
**Sortie** :
```
Endpoint RegionName
-------- ----------
ec2.eu-west-1.amazonaws.com eu-west-1
ec2.ap-southeast-1.amazonaws.com ap-southeast-1
ec2.ap-southeast-2.amazonaws.com ap-southeast-2
ec2.eu-central-1.amazonaws.com eu-central-1
ec2.ap-northeast-1.amazonaws.com ap-northeast-1
ec2.us-east-1.amazonaws.com us-east-1
ec2.sa-east-1.amazonaws.com sa-east-1
ec2.us-west-1.amazonaws.com us-west-1
ec2.us-west-2.amazonaws.com us-west-2
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeRegions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2RouteTable`
L'exemple de code suivant montre comment utiliser`Get-EC2RouteTable`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit toutes vos tables de routage.**
```
Get-EC2RouteTable
```
**Sortie** :
```
DestinationCidrBlock : 10.0.0.0/16
DestinationPrefixListId :
GatewayId : local
InstanceId :
InstanceOwnerId :
NetworkInterfaceId :
Origin : CreateRouteTable
State : active
VpcPeeringConnectionId :
DestinationCidrBlock : 0.0.0.0/0
DestinationPrefixListId :
GatewayId : igw-1a2b3c4d
InstanceId :
InstanceOwnerId :
NetworkInterfaceId :
Origin : CreateRoute
State : active
VpcPeeringConnectionId :
```
**Exemple 2 : cet exemple renvoie les détails de la table de routage spécifiée.**
```
Get-EC2RouteTable -RouteTableId rtb-1a2b3c4d
```
**Exemple 3 : cet exemple décrit les tables de routage pour le VPC spécifié.**
```
Get-EC2RouteTable -Filter @{ Name="vpc-id"; Values="vpc-1a2b3c4d" }
```
**Sortie** :
```
Associations : {rtbassoc-12345678}
PropagatingVgws : {}
Routes : {, }
RouteTableId : rtb-1a2b3c4d
Tags : {}
VpcId : vpc-1a2b3c4d
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeRouteTables](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2ScheduledInstance`
L'exemple de code suivant montre comment utiliser`Get-EC2ScheduledInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’Instance planifiée spécifiée.**
```
Get-EC2ScheduledInstance -ScheduledInstanceId sci-1234-1234-1234-1234-123456789012
```
**Sortie** :
```
AvailabilityZone : us-west-2b
CreateDate : 1/25/2016 1:43:38 PM
HourlyPrice : 0.095
InstanceCount : 1
InstanceType : c4.large
NetworkPlatform : EC2-VPC
NextSlotStartTime : 1/31/2016 1:00:00 AM
Platform : Linux/UNIX
PreviousSlotEndTime :
Recurrence : Amazon.EC2.Model.ScheduledInstanceRecurrence
ScheduledInstanceId : sci-1234-1234-1234-1234-123456789012
SlotDurationInHours : 32
TermEndDate : 1/31/2017 1:00:00 AM
TermStartDate : 1/31/2016 1:00:00 AM
TotalScheduledInstanceHours : 1696
```
**Exemple 2 : cet exemple décrit toutes vos instances planifiées.**
```
Get-EC2ScheduledInstance
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScheduledInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2ScheduledInstanceAvailability`
L'exemple de code suivant montre comment utiliser`Get-EC2ScheduledInstanceAvailability`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit un calendrier qui a lieu chaque semaine le dimanche, à compter de la date spécifiée.**
```
Get-EC2ScheduledInstanceAvailability -Recurrence_Frequency Weekly -Recurrence_Interval 1 -Recurrence_OccurrenceDay 1 -FirstSlotStartTimeRange_EarliestTime 2016-01-31T00:00:00Z -FirstSlotStartTimeRange_LatestTime 2016-01-31T04:00:00Z
```
**Sortie** :
```
AvailabilityZone : us-west-2b
AvailableInstanceCount : 20
FirstSlotStartTime : 1/31/2016 8:00:00 AM
HourlyPrice : 0.095
InstanceType : c4.large
MaxTermDurationInDays : 366
MinTermDurationInDays : 366
NetworkPlatform : EC2-VPC
Platform : Linux/UNIX
PurchaseToken : eyJ2IjoiMSIsInMiOjEsImMiOi...
Recurrence : Amazon.EC2.Model.ScheduledInstanceRecurrence
SlotDurationInHours : 23
TotalScheduledInstanceHours : 1219
...
```
**Exemple 2 : pour affiner les résultats, vous pouvez ajouter des filtres pour des critères tels que le système d’exploitation, le réseau et le type d’instance.**
```
-Filter @{ Name="platform";Values="Linux/UNIX" },@{ Name="network-platform";Values="EC2-VPC" },@{ Name="instance-type";Values="c4.large" }
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeScheduledInstanceAvailability](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2SecurityGroup`
L'exemple de code suivant montre comment utiliser`Get-EC2SecurityGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le groupe de sécurité spécifié pour un VPC. Lorsque vous travaillez avec des groupes de sécurité appartenant à un VPC, vous devez utiliser l'ID du groupe de sécurité (GroupId paramètre -), et non le nom (- GroupName paramètre), pour référencer le groupe.**
```
Get-EC2SecurityGroup -GroupId sg-12345678
```
**Sortie** :
```
Description : default VPC security group
GroupId : sg-12345678
GroupName : default
IpPermissions : {Amazon.EC2.Model.IpPermission}
IpPermissionsEgress : {Amazon.EC2.Model.IpPermission}
OwnerId : 123456789012
Tags : {}
VpcId : vpc-12345678
```
**Exemple 2 : cet exemple décrit le groupe de sécurité spécifié pour EC2-Classic. Lorsque vous travaillez avec des groupes de sécurité pour EC2-Classic, vous pouvez utiliser le nom du groupe (- GroupName paramètre) ou l'ID du groupe (- GroupId paramètre) pour référencer le groupe de sécurité.**
```
Get-EC2SecurityGroup -GroupName my-security-group
```
**Sortie** :
```
Description : my security group
GroupId : sg-45678901
GroupName : my-security-group
IpPermissions : {Amazon.EC2.Model.IpPermission, Amazon.EC2.Model.IpPermission}
IpPermissionsEgress : {}
OwnerId : 123456789012
Tags : {}
VpcId :
```
**Exemple 3 : cet exemple extrait tous les groupes de sécurité pour le fichier vpc-0fc1ff23456b789eb**
```
Get-EC2SecurityGroup -Filter @{Name="vpc-id";Values="vpc-0fc1ff23456b789eb"}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSecurityGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2Snapshot`
L'exemple de code suivant montre comment utiliser`Get-EC2Snapshot`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’instantané spécifié.**
```
Get-EC2Snapshot -SnapshotId snap-12345678
```
**Sortie** :
```
DataEncryptionKeyId :
Description : Created by CreateImage(i-1a2b3c4d) for ami-12345678 from vol-12345678
Encrypted : False
KmsKeyId :
OwnerAlias :
OwnerId : 123456789012
Progress : 100%
SnapshotId : snap-12345678
StartTime : 10/23/2014 6:01:28 AM
State : completed
StateMessage :
Tags : {}
VolumeId : vol-12345678
VolumeSize : 8
```
**Exemple 2 : cet exemple décrit les instantanés dotés d’une balise « Nom ».**
```
Get-EC2Snapshot | ? { $_.Tags.Count -gt 0 -and $_.Tags.Key -eq "Name" }
```
**Exemple 3 : Cet exemple décrit les instantanés dotés d'une balise « Name » avec la valeur « TestValue ».**
```
Get-EC2Snapshot | ? { $_.Tags.Count -gt 0 -and $_.Tags.Key -eq "Name" -and $_.Tags.Value -eq "TestValue" }
```
**Exemple 4 : cet exemple décrit tous vos instantanés.**
```
Get-EC2Snapshot -Owner self
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSnapshots](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2SnapshotAttribute`
L'exemple de code suivant montre comment utiliser`Get-EC2SnapshotAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’attribut spécifié de l’instantané spécifié.**
```
Get-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute ProductCodes
```
**Sortie** :
```
CreateVolumePermissions ProductCodes SnapshotId
----------------------- ------------ ----------
{} {} snap-12345678
```
**Exemple 2 : cet exemple décrit l’attribut spécifié de l’instantané spécifié.**
```
(Get-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission).CreateVolumePermissions
```
**Sortie** :
```
Group UserId
----- ------
all
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSnapshotAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2SpotDatafeedSubscription`
L'exemple de code suivant montre comment utiliser`Get-EC2SpotDatafeedSubscription`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit votre flux de données d’instance Spot.**
```
Get-EC2SpotDatafeedSubscription
```
**Sortie** :
```
Bucket : amzn-s3-demo-bucket
Fault :
OwnerId : 123456789012
Prefix : spotdata
State : Active
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSpotDatafeedSubscription](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2SpotFleetInstance`
L'exemple de code suivant montre comment utiliser`Get-EC2SpotFleetInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les instances associées à la demande de parc d’instances Spot spécifiée.**
```
Get-EC2SpotFleetInstance -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE
```
**Sortie** :
```
InstanceId InstanceType SpotInstanceRequestId
---------- ------------ ---------------------
i-f089262a c3.large sir-12345678
i-7e8b24a4 c3.large sir-87654321
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSpotFleetInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2SpotFleetRequest`
L'exemple de code suivant montre comment utiliser`Get-EC2SpotFleetRequest`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit la demande relative au parc d’instances Spot spécifiée.**
```
Get-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE | format-list
```
**Sortie** :
```
ConfigData : Amazon.EC2.Model.SpotFleetRequestConfigData
CreateTime : 12/26/2015 8:23:33 AM
SpotFleetRequestId : sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE
SpotFleetRequestState : active
```
**Exemple 2 : cet exemple décrit toutes vos demandes de parc d’instances Spot.**
```
Get-EC2SpotFleetRequest
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSpotFleetRequests](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2SpotFleetRequestHistory`
L'exemple de code suivant montre comment utiliser`Get-EC2SpotFleetRequestHistory`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’historique de la demande relative au parc d’instances Spot spécifié.**
```
Get-EC2SpotFleetRequestHistory -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -StartTime 2015-12-26T00:00:00Z
```
**Sortie** :
```
HistoryRecords : {Amazon.EC2.Model.HistoryRecord, Amazon.EC2.Model.HistoryRecord...}
LastEvaluatedTime : 12/26/2015 8:29:11 AM
NextToken :
SpotFleetRequestId : sfr-088bc5f1-7e7b-451a-bd13-757f10672b93
StartTime : 12/25/2015 8:00:00 AM
```
```
(Get-EC2SpotFleetRequestHistory -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -StartTime 2015-12-26T00:00:00Z).HistoryRecords
```
**Sortie** :
```
EventInformation EventType Timestamp
---------------- --------- ---------
Amazon.EC2.Model.EventInformation fleetRequestChange 12/26/2015 8:23:33 AM
Amazon.EC2.Model.EventInformation fleetRequestChange 12/26/2015 8:23:33 AM
Amazon.EC2.Model.EventInformation fleetRequestChange 12/26/2015 8:23:33 AM
Amazon.EC2.Model.EventInformation launched 12/26/2015 8:25:34 AM
Amazon.EC2.Model.EventInformation launched 12/26/2015 8:25:05 AM
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSpotFleetRequestHistory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2SpotInstanceRequest`
L'exemple de code suivant montre comment utiliser`Get-EC2SpotInstanceRequest`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit la demande d’instance Spot spécifiée.**
```
Get-EC2SpotInstanceRequest -SpotInstanceRequestId sir-12345678
```
**Sortie** :
```
ActualBlockHourlyPrice :
AvailabilityZoneGroup :
BlockDurationMinutes : 0
CreateTime : 4/8/2015 2:51:33 PM
Fault :
InstanceId : i-12345678
LaunchedAvailabilityZone : us-west-2b
LaunchGroup :
LaunchSpecification : Amazon.EC2.Model.LaunchSpecification
ProductDescription : Linux/UNIX
SpotInstanceRequestId : sir-12345678
SpotPrice : 0.020000
State : active
Status : Amazon.EC2.Model.SpotInstanceStatus
Tags : {Name}
Type : one-time
```
**Exemple 2 : cet exemple décrit toutes vos demandes d’instance Spot.**
```
Get-EC2SpotInstanceRequest
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSpotInstanceRequests](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2SpotPriceHistory`
L'exemple de code suivant montre comment utiliser`Get-EC2SpotPriceHistory`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient les 10 dernières entrées de l’historique des prix Spot pour le type d’instance et la zone de disponibilité spécifiés. Notez que la valeur spécifiée pour le AvailabilityZone paramètre - doit être valide pour la valeur de région fournie au paramètre -Region de l'applet de commande (non illustré dans l'exemple) ou définie par défaut dans le shell. Cet exemple de commande suppose qu’une région par défaut « us-west-2 » a été définie dans l’environnement.**
```
Get-EC2SpotPriceHistory -InstanceType c3.large -AvailabilityZone us-west-2a -MaxResult 10
```
**Sortie** :
```
AvailabilityZone : us-west-2a
InstanceType : c3.large
Price : 0.017300
ProductDescription : Linux/UNIX (Amazon VPC)
Timestamp : 12/25/2015 7:39:49 AM
AvailabilityZone : us-west-2a
InstanceType : c3.large
Price : 0.017200
ProductDescription : Linux/UNIX (Amazon VPC)
Timestamp : 12/25/2015 7:38:29 AM
AvailabilityZone : us-west-2a
InstanceType : c3.large
Price : 0.017300
ProductDescription : Linux/UNIX (Amazon VPC)
Timestamp : 12/25/2015 6:57:13 AM
...
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSpotPriceHistory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2Subnet`
L'exemple de code suivant montre comment utiliser`Get-EC2Subnet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le sous-réseau spécifié.**
```
Get-EC2Subnet -SubnetId subnet-1a2b3c4d
```
**Sortie** :
```
AvailabilityZone : us-west-2c
AvailableIpAddressCount : 251
CidrBlock : 10.0.0.0/24
DefaultForAz : False
MapPublicIpOnLaunch : False
State : available
SubnetId : subnet-1a2b3c4d
Tags : {}
VpcId : vpc-12345678
```
**Exemple 2 : cet exemple décrit tous vos sous-réseaux.**
```
Get-EC2Subnet
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSubnets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2Tag`
L'exemple de code suivant montre comment utiliser`Get-EC2Tag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple récupère les balises pour le type de ressource « image »**
```
Get-EC2Tag -Filter @{Name="resource-type";Values="image"}
```
**Sortie** :
```
Key ResourceId ResourceType Value
--- ---------- ------------ -----
Name ami-0a123b4ccb567a8ea image Win7-Imported
auto-delete ami-0a123b4ccb567a8ea image never
```
**Exemple 2 : cet exemple récupère toutes les balises de toutes les ressources et les regroupe par type de ressource**
```
Get-EC2Tag | Group-Object resourcetype
```
**Sortie** :
```
Count Name Group
----- ---- -----
9 subnet {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...}
53 instance {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...}
3 route-table {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription}
5 security-group {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...}
30 volume {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription...}
1 internet-gateway {Amazon.EC2.Model.TagDescription}
3 network-interface {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription}
4 elastic-ip {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription}
1 dhcp-options {Amazon.EC2.Model.TagDescription}
2 image {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription}
3 vpc {Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription, Amazon.EC2.Model.TagDescription}
```
**Exemple 3 : cet exemple affiche toutes les ressources avec la balise « auto-delete » avec la valeur « no » pour la région donnée**
```
Get-EC2Tag -Region eu-west-1 -Filter @{Name="tag:auto-delete";Values="no"}
```
**Sortie** :
```
Key ResourceId ResourceType Value
--- ---------- ------------ -----
auto-delete i-0f1bce234d5dd678b instance no
auto-delete vol-01d234aa5678901a2 volume no
auto-delete vol-01234bfb5def6f7b8 volume no
auto-delete vol-01ccb23f4c5e67890 volume no
```
**Exemple 4 : Cet exemple obtient toutes les ressources avec la balise « auto-delete » avec une valeur « aucune » et des filtres supplémentaires dans le canal suivant pour analyser uniquement les types de ressources « instance » et crée finalement la balise « ThisInstance » pour chaque ressource d'instance, la valeur étant l'identifiant de l'instance lui-même**
```
Get-EC2Tag -Region eu-west-1 -Filter @{Name="tag:auto-delete";Values="no"} | Where-Object ResourceType -eq "instance" | ForEach-Object {New-EC2Tag -ResourceId $_.ResourceId -Tag @{Key="ThisInstance";Value=$_.ResourceId}}
```
**Exemple 5 : cet exemple récupère les balises pour toutes les ressources de l’instance ainsi que les clés « Nom » et les affiche sous forme de table**
```
Get-EC2Tag -Filter @{Name="resource-type";Values="instance"},@{Name="key";Values="Name"} | Select-Object ResourceId, @{Name="Name-Tag";Expression={$PSItem.Value}} | Format-Table -AutoSize
```
**Sortie** :
```
ResourceId Name-Tag
---------- --------
i-012e3cb4df567e1aa jump1
i-01c23a45d6fc7a89f repro-3
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2Volume`
L'exemple de code suivant montre comment utiliser`Get-EC2Volume`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le volume EBS spécifié.**
```
Get-EC2Volume -VolumeId vol-12345678
```
**Sortie** :
```
Attachments : {}
AvailabilityZone : us-west-2c
CreateTime : 7/17/2015 4:35:19 PM
Encrypted : False
Iops : 90
KmsKeyId :
Size : 30
SnapshotId : snap-12345678
State : in-use
Tags : {}
VolumeId : vol-12345678
VolumeType : standard
```
**Exemple 2 : cet exemple décrit vos volumes EBS dont le statut est « disponible ».**
```
Get-EC2Volume -Filter @{ Name="status"; Values="available" }
```
**Sortie** :
```
Attachments : {}
AvailabilityZone : us-west-2c
CreateTime : 12/21/2015 2:31:29 PM
Encrypted : False
Iops : 60
KmsKeyId :
Size : 20
SnapshotId : snap-12345678
State : available
Tags : {}
VolumeId : vol-12345678
VolumeType : gp2
...
```
**Exemple 3 : cet exemple décrit tous vos volumes EBS.**
```
Get-EC2Volume
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeVolumes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2VolumeAttribute`
L'exemple de code suivant montre comment utiliser`Get-EC2VolumeAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’attribut spécifié du volume spécifié.**
```
Get-EC2VolumeAttribute -VolumeId vol-12345678 -Attribute AutoEnableIO
```
**Sortie** :
```
AutoEnableIO ProductCodes VolumeId
------------ ------------ --------
False {} vol-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeVolumeAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2VolumeStatus`
L'exemple de code suivant montre comment utiliser`Get-EC2VolumeStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le statut du volume spécifié.**
```
Get-EC2VolumeStatus -VolumeId vol-12345678
```
**Sortie** :
```
Actions : {}
AvailabilityZone : us-west-2a
Events : {}
VolumeId : vol-12345678
VolumeStatus : Amazon.EC2.Model.VolumeStatusInfo
```
```
(Get-EC2VolumeStatus -VolumeId vol-12345678).VolumeStatus
```
**Sortie** :
```
Details Status
------- ------
{io-enabled, io-performance} ok
```
```
(Get-EC2VolumeStatus -VolumeId vol-12345678).VolumeStatus.Details
```
**Sortie** :
```
Name Status
---- ------
io-enabled passed
io-performance not-applicable
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeVolumeStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2Vpc`
L'exemple de code suivant montre comment utiliser`Get-EC2Vpc`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le VPC spécifié.**
```
Get-EC2Vpc -VpcId vpc-12345678
```
**Sortie** :
```
CidrBlock : 10.0.0.0/16
DhcpOptionsId : dopt-1a2b3c4d
InstanceTenancy : default
IsDefault : False
State : available
Tags : {Name}
VpcId : vpc-12345678
```
**Exemple 2 : cet exemple décrit le VPC par défaut (il ne peut y en avoir qu’un par région). Si votre compte prend en charge EC2-Classic dans cette région, il n’existe pas de VPC par défaut.**
```
Get-EC2Vpc -Filter @{Name="isDefault"; Values="true"}
```
**Sortie** :
```
CidrBlock : 172.31.0.0/16
DhcpOptionsId : dopt-12345678
InstanceTenancy : default
IsDefault : True
State : available
Tags : {}
VpcId : vpc-45678901
```
**Exemple 3 : Cet exemple décrit ceux VPCs qui correspondent au filtre spécifié (c'est-à-dire qui ont un CIDR correspondant à la valeur « 10.0.0.0/16 » et dont l'état est « disponible »).**
```
Get-EC2Vpc -Filter @{Name="cidr"; Values="10.0.0.0/16"},@{Name="state";Values="available"}
```
**Exemple 4 : Cet exemple décrit tous vos VPCs.**
```
Get-EC2Vpc
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeVpcs](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2VpcAttribute`
L'exemple de code suivant montre comment utiliser`Get-EC2VpcAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple décrit l'attribut enableDnsSupport « ».**
```
Get-EC2VpcAttribute -VpcId vpc-12345678 -Attribute enableDnsSupport
```
**Sortie** :
```
EnableDnsSupport
----------------
True
```
**Exemple 2 : Cet exemple décrit l'attribut enableDnsHostnames « ».**
```
Get-EC2VpcAttribute -VpcId vpc-12345678 -Attribute enableDnsHostnames
```
**Sortie** :
```
EnableDnsHostnames
------------------
True
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeVpcAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2VpcClassicLink`
L'exemple de code suivant montre comment utiliser`Get-EC2VpcClassicLink`.
**Outils pour PowerShell V4**
**Exemple 1 : L'exemple ci-dessus renvoie tous les VPCs avec leur ClassicLinkEnabled état pour la région**
```
Get-EC2VpcClassicLink -Region eu-west-1
```
**Sortie** :
```
ClassicLinkEnabled Tags VpcId
------------------ ---- -----
False {Name} vpc-0fc1ff23f45b678eb
False {} vpc-01e23c4a5d6db78e9
False {Name} vpc-0123456b078b9d01f
False {} vpc-12cf3b4f
False {Name} vpc-0b12d3456a7e8901d
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeVpcClassicLink](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2VpcClassicLinkDnsSupport`
L'exemple de code suivant montre comment utiliser`Get-EC2VpcClassicLinkDnsSupport`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple décrit l'état du support ClassicLink DNS VPCs pour la région eu-west-1**
```
Get-EC2VpcClassicLinkDnsSupport -VpcId vpc-0b12d3456a7e8910d -Region eu-west-1
```
**Sortie** :
```
ClassicLinkDnsSupported VpcId
----------------------- -----
False vpc-0b12d3456a7e8910d
False vpc-12cf3b4f
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeVpcClassicLinkDnsSupport](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2VpcEndpoint`
L'exemple de code suivant montre comment utiliser`Get-EC2VpcEndpoint`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit un ou plusieurs de vos points de terminaison d’un VPC pour la région eu-west-1. Il dirige ensuite la sortie vers la commande suivante, qui sélectionne la VpcEndpointId propriété et renvoie l'ID VPC du tableau sous forme de tableau de chaînes**
```
Get-EC2VpcEndpoint -Region eu-west-1 | Select-Object -ExpandProperty VpcEndpointId
```
**Sortie** :
```
vpce-01a2ab3f4f5cc6f7d
vpce-01d2b345a6787890b
vpce-0012e34d567890e12
vpce-0c123db4567890123
```
**Exemple 2 : Cet exemple décrit tous les points de terminaison VPC pour la région eu-west-1 et sélectionne VpcEndpointId, VpcId ainsi que les propriétés pour les présenter sous forme de ServiceName tableau PrivateDnsEnabled **
```
Get-EC2VpcEndpoint -Region eu-west-1 | Select-Object VpcEndpointId, VpcId, ServiceName, PrivateDnsEnabled | Format-Table -AutoSize
```
**Sortie** :
```
VpcEndpointId VpcId ServiceName PrivateDnsEnabled
------------- ----- ----------- -----------------
vpce-02a2ab2f2f2cc2f2d vpc-0fc6ff46f65b039eb com.amazonaws.eu-west-1.ssm True
vpce-01d1b111a1114561b vpc-0fc6ff46f65b039eb com.amazonaws.eu-west-1.ec2 True
vpce-0011e23d45167e838 vpc-0fc6ff46f65b039eb com.amazonaws.eu-west-1.ec2messages True
vpce-0c123db4567890123 vpc-0fc6ff46f65b039eb com.amazonaws.eu-west-1.ssmmessages True
```
**Exemple 3 : cet exemple exporte le document de politique pour le point de terminaison d’un VPC vpce-01a2ab3f4f5cc6f7d dans un fichier json**
```
Get-EC2VpcEndpoint -Region eu-west-1 -VpcEndpointId vpce-01a2ab3f4f5cc6f7d | Select-Object -expand PolicyDocument | Out-File vpce_policyDocument.json
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeVpcEndpoints](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2VpcEndpointService`
L'exemple de code suivant montre comment utiliser`Get-EC2VpcEndpointService`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le service de point de terminaison d’un VPC EC2 avec le filtre donné, dans ce cas com.amazonaws.eu-west-1.ecs. En outre, il agrandit également la ServiceDetails propriété et affiche les détails**
```
Get-EC2VpcEndpointService -Region eu-west-1 -MaxResult 5 -Filter @{Name="service-name";Values="com.amazonaws.eu-west-1.ecs"} | Select-Object -ExpandProperty ServiceDetails
```
**Sortie** :
```
AcceptanceRequired : False
AvailabilityZones : {eu-west-1a, eu-west-1b, eu-west-1c}
BaseEndpointDnsNames : {ecs.eu-west-1.vpce.amazonaws.com}
Owner : amazon
PrivateDnsName : ecs.eu-west-1.amazonaws.com
ServiceName : com.amazonaws.eu-west-1.ecs
ServiceType : {Amazon.EC2.Model.ServiceTypeDetail}
VpcEndpointPolicySupported : False
```
**Exemple 2 : Cet exemple récupère tous les services de point de terminaison VPC EC2 et renvoie le ServiceNames « ssm » correspondant**
```
Get-EC2VpcEndpointService -Region eu-west-1 | Select-Object -ExpandProperty Servicenames | Where-Object { -match "ssm"}
```
**Sortie** :
```
com.amazonaws.eu-west-1.ssm
com.amazonaws.eu-west-1.ssmmessages
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeVpcEndpointServices](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2VpnConnection`
L'exemple de code suivant montre comment utiliser`Get-EC2VpnConnection`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit la connexion VPN spécifiée.**
```
Get-EC2VpnConnection -VpnConnectionId vpn-12345678
```
**Sortie** :
```
CustomerGatewayConfiguration : [XML document]
CustomerGatewayId : cgw-1a2b3c4d
Options : Amazon.EC2.Model.VpnConnectionOptions
Routes : {Amazon.EC2.Model.VpnStaticRoute}
State : available
Tags : {}
Type : ipsec.1
VgwTelemetry : {Amazon.EC2.Model.VgwTelemetry, Amazon.EC2.Model.VgwTelemetry}
VpnConnectionId : vpn-12345678
VpnGatewayId : vgw-1a2b3c4d
```
**Exemple 2 : cet exemple décrit toute connexion VPN dont l’état est en attente ou disponible.**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "state"
$filter.Values = @( "pending", "available" )
Get-EC2VpnConnection -Filter $filter
```
**Exemple 3 : cet exemple décrit toutes vos connexions VPN.**
```
Get-EC2VpnConnection
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeVpnConnections](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EC2VpnGateway`
L'exemple de code suivant montre comment utiliser`Get-EC2VpnGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit la passerelle privée virtuelle spécifiée.**
```
Get-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d
```
**Sortie** :
```
AvailabilityZone :
State : available
Tags : {}
Type : ipsec.1
VpcAttachments : {vpc-12345678}
VpnGatewayId : vgw-1a2b3c4d
```
**Exemple 2 : cet exemple décrit toute passerelle privée virtuelle dont l’état est en attente ou disponible.**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "state"
$filter.Values = @( "pending", "available" )
Get-EC2VpnGateway -Filter $filter
```
**Exemple 3 : cet exemple décrit toutes vos passerelles privées virtuelles.**
```
Get-EC2VpnGateway
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeVpnGateways](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Grant-EC2SecurityGroupEgress`
L'exemple de code suivant montre comment utiliser`Grant-EC2SecurityGroupEgress`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple définit une règle de sortie pour le groupe de sécurité spécifié pour EC2-VPC. La règle accorde l’accès à la plage d’adresses IP spécifiée sur le port TCP 80. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou supérieure.**
```
$ip = @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; IpRanges="203.0.113.0/24" }
Grant-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ip
```
**Exemple 2 : avec PowerShell la version 2, vous devez utiliser New-Object pour créer l' IpPermission objet.**
```
$ip = New-Object Amazon.EC2.Model.IpPermission
$ip.IpProtocol = "tcp"
$ip.FromPort = 80
$ip.ToPort = 80
$ip.IpRanges.Add("203.0.113.0/24")
Grant-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ip
```
**Exemple 3 : cet exemple accorde l’accès au groupe de sécurité source spécifié sur le port TCP 80.**
```
$ug = New-Object Amazon.EC2.Model.UserIdGroupPair
$ug.GroupId = "sg-1a2b3c4d"
$ug.UserId = "123456789012"
Grant-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission @( @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; UserIdGroupPairs=$ug } )
```
+ Pour plus de détails sur l'API, reportez-vous [AuthorizeSecurityGroupEgress](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Grant-EC2SecurityGroupIngress`
L'exemple de code suivant montre comment utiliser`Grant-EC2SecurityGroupIngress`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple définit les règles d’entrée pour un groupe de sécurité pour EC2-VPC. Ces règles accordent l’accès à une adresse IP spécifique pour le SSH (port 22) et le RDC (port 3389). En outre, vous devez identifier des groupes de sécurité pour EC2-VPC à l’aide de l’ID du groupe de sécurité et non le nom du groupe de sécurité. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou supérieure.**
```
$ip1 = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.25/32" }
$ip2 = @{ IpProtocol="tcp"; FromPort="3389"; ToPort="3389"; IpRanges="203.0.113.25/32" }
Grant-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission @( $ip1, $ip2 )
```
**Exemple 2 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer les IpPermission objets.**
```
$ip1 = New-Object Amazon.EC2.Model.IpPermission
$ip1.IpProtocol = "tcp"
$ip1.FromPort = 22
$ip1.ToPort = 22
$ip1.IpRanges.Add("203.0.113.25/32")
$ip2 = new-object Amazon.EC2.Model.IpPermission
$ip2.IpProtocol = "tcp"
$ip2.FromPort = 3389
$ip2.ToPort = 3389
$ip2.IpRanges.Add("203.0.113.25/32")
Grant-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission @( $ip1, $ip2 )
```
**Exemple 3 : cet exemple définit les règles d’entrée pour un groupe de sécurité pour EC2-Classic. Ces règles accordent l’accès à une adresse IP spécifique pour le SSH (port 22) et le RDC (port 3389). La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou supérieure.**
```
$ip1 = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.25/32" }
$ip2 = @{ IpProtocol="tcp"; FromPort="3389"; ToPort="3389"; IpRanges="203.0.113.25/32" }
Grant-EC2SecurityGroupIngress -GroupName "my-security-group" -IpPermission @( $ip1, $ip2 )
```
**Exemple 4 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer les IpPermission objets.**
```
$ip1 = New-Object Amazon.EC2.Model.IpPermission
$ip1.IpProtocol = "tcp"
$ip1.FromPort = 22
$ip1.ToPort = 22
$ip1.IpRanges.Add("203.0.113.25/32")
$ip2 = new-object Amazon.EC2.Model.IpPermission
$ip2.IpProtocol = "tcp"
$ip2.FromPort = 3389
$ip2.ToPort = 3389
$ip2.IpRanges.Add("203.0.113.25/32")
Grant-EC2SecurityGroupIngress -GroupName "my-security-group" -IpPermission @( $ip1, $ip2 )
```
**Exemple 5 : cet exemple accorde l’accès au port TCP 8081 depuis le groupe de sécurité source spécifié (sg-1a2b3c4d) au groupe de sécurité spécifié (sg-12345678).**
```
$ug = New-Object Amazon.EC2.Model.UserIdGroupPair
$ug.GroupId = "sg-1a2b3c4d"
$ug.UserId = "123456789012"
Grant-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission @( @{ IpProtocol="tcp"; FromPort="8081"; ToPort="8081"; UserIdGroupPairs=$ug } )
```
**Exemple 6 : cet exemple ajoute le CIDR 5.5.5.5/32 aux règles d’entrée du groupe de sécurité sg-1234abcd pour le trafic du port TCP 22 avec une description.**
```
$IpRange = New-Object -TypeName Amazon.EC2.Model.IpRange
$IpRange.CidrIp = "5.5.5.5/32"
$IpRange.Description = "SSH from Office"
$IpPermission = New-Object Amazon.EC2.Model.IpPermission
$IpPermission.IpProtocol = "tcp"
$IpPermission.ToPort = 22
$IpPermission.FromPort = 22
$IpPermission.Ipv4Ranges = $IpRange
Grant-EC2SecurityGroupIngress -GroupId sg-1234abcd -IpPermission $IpPermission
```
+ Pour plus de détails sur l'API, reportez-vous [AuthorizeSecurityGroupIngress](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Import-EC2Image`
L'exemple de code suivant montre comment utiliser`Import-EC2Image`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple importe une image de machine virtuelle à disque unique depuis le compartiment Amazon S3 spécifié vers Amazon EC2 avec un jeton d’idempotence. L’exemple nécessite qu’un rôle de service d’importation de machine virtuelle portant le nom par défaut « vmimport » existe, avec une politique autorisant Amazon EC2 à accéder au compartiment spécifié, comme expliqué dans la rubrique Prérequis pour l’importation d’une machine virtuelle. Pour utiliser un rôle personnalisé, spécifiez le nom du rôle à l’aide du paramètre `-RoleName`.**
```
$container = New-Object Amazon.EC2.Model.ImageDiskContainer
$container.Format="VMDK"
$container.UserBucket = New-Object Amazon.EC2.Model.UserBucket
$container.UserBucket.S3Bucket = "amzn-s3-demo-bucket"
$container.UserBucket.S3Key = "Win_2008_Server_Standard_SP2_64-bit-disk1.vmdk"
$parms = @{
"ClientToken"="idempotencyToken"
"Description"="Windows 2008 Standard Image Import"
"Platform"="Windows"
"LicenseType"="AWS"
}
Import-EC2Image -DiskContainer $container @parms
```
**Sortie** :
```
Architecture :
Description : Windows 2008 Standard Image
Hypervisor :
ImageId :
ImportTaskId : import-ami-abcdefgh
LicenseType : AWS
Platform : Windows
Progress : 2
SnapshotDetails : {}
Status : active
StatusMessage : pending
```
+ Pour plus de détails sur l'API, reportez-vous [ImportImage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Import-EC2KeyPair`
L'exemple de code suivant montre comment utiliser`Import-EC2KeyPair`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple importe une clé publique dans EC2. La première ligne stocke le contenu du fichier de clé publique (\$1.pub) dans la variable `$publickey`. Ensuite, l'exemple convertit le UTF8 format du fichier de clé publique en une chaîne codée en Base64 et stocke la chaîne convertie dans la variable. `$pkbase64` Dans la dernière ligne, la clé publique convertie est importée dans EC2. L’applet de commande renvoie l’empreinte digitale et le nom de la clé en tant que résultats.**
```
$publickey=[Io.File]::ReadAllText("C:\Users\TestUser\.ssh\id_rsa.pub")
$pkbase64 = [System.Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($publickey))
Import-EC2KeyPair -KeyName Example-user-key -PublicKey $pkbase64
```
**Sortie** :
```
KeyFingerprint KeyName
-------------- -------
do:d0:15:8f:79:97:12:be:00:fd:df:31:z3:b1:42:z1 Example-user-key
```
+ Pour plus de détails sur l'API, reportez-vous [ImportKeyPair](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Import-EC2Snapshot`
L'exemple de code suivant montre comment utiliser`Import-EC2Snapshot`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple importe une image de disque de machine virtuelle au format « VMDK » dans un instantané Amazon EBS. L'exemple nécessite un rôle de service d'importation de machine virtuelle portant le nom par défaut « vmimport », avec une politique autorisant Amazon EC2 à accéder au bucket spécifié, comme expliqué dans `VM Import Prequisites` la rubrique http://docs.aws.amazon. com/AWSEC2/latest/WindowsGuide/VMImportPrerequisites.html. Pour utiliser un rôle personnalisé, spécifiez le nom du rôle à l’aide du paramètre `-RoleName`.**
```
$parms = @{
"ClientToken"="idempotencyToken"
"Description"="Disk Image Import"
"DiskContainer_Description" = "Data disk"
"DiskContainer_Format" = "VMDK"
"DiskContainer_S3Bucket" = "amzn-s3-demo-bucket"
"DiskContainer_S3Key" = "datadiskimage.vmdk"
}
Import-EC2Snapshot @parms
```
**Sortie** :
```
Description ImportTaskId SnapshotTaskDetail
----------------- -------------------- ------------------
Disk Image Import import-snap-abcdefgh Amazon.EC2.Model.SnapshotTaskDetail
```
+ Pour plus de détails sur l'API, reportez-vous [ImportSnapshot](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Move-EC2AddressToVpc`
L'exemple de code suivant montre comment utiliser`Move-EC2AddressToVpc`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple déplace une instance EC2 dont l’adresse IP publique est 12.345.67.89 vers la plateforme EC2-VPC dans la région USA Est (Virginie du Nord).**
```
Move-EC2AddressToVpc -PublicIp 12.345.67.89 -Region us-east-1
```
**Exemple 2 : Cet exemple dirige les résultats d'une Get-EC2Instance commande vers l'Move-EC2AddressToVpcapplet de commande. La Get-EC2Instance commande obtient une instance spécifiée par son ID d'instance, puis renvoie la propriété d'adresse IP publique de l'instance.**
```
(Get-EC2Instance -Instance i-12345678).Instances.PublicIpAddress | Move-EC2AddressToVpc
```
+ Pour plus de détails sur l'API, reportez-vous [MoveAddressToVpc](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2Address`
L'exemple de code suivant montre comment utiliser`New-EC2Address`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple alloue une adresse IP Elastic pour pouvoir l’utiliser avec une instance dans un VPC.**
```
New-EC2Address -Domain Vpc
```
**Sortie** :
```
AllocationId Domain PublicIp
------------ ------ --------
eipalloc-12345678 vpc 198.51.100.2
```
**Exemple 2 : cet exemple alloue une adresse IP Elastic pour pouvoir l’utiliser avec une instance dans EC2-Classic.**
```
New-EC2Address
```
**Sortie** :
```
AllocationId Domain PublicIp
------------ ------ --------
standard 203.0.113.17
```
+ Pour plus de détails sur l'API, reportez-vous [AllocateAddress](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2CustomerGateway`
L'exemple de code suivant montre comment utiliser`New-EC2CustomerGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée la passerelle client spécifiée.**
```
New-EC2CustomerGateway -Type ipsec.1 -PublicIp 203.0.113.12 -BgpAsn 65534
```
**Sortie** :
```
BgpAsn : 65534
CustomerGatewayId : cgw-1a2b3c4d
IpAddress : 203.0.113.12
State : available
Tags : {}
Type : ipsec.1
```
+ Pour plus de détails sur l'API, reportez-vous [CreateCustomerGateway](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2DhcpOption`
L'exemple de code suivant montre comment utiliser`New-EC2DhcpOption`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée le jeu d’options DHCP spécifié. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$options = @( @{Key="domain-name";Values=@("abc.local")}, @{Key="domain-name-servers";Values=@("10.0.0.101","10.0.0.102")})
New-EC2DhcpOption -DhcpConfiguration $options
```
**Sortie** :
```
DhcpConfigurations DhcpOptionsId Tags
------------------ ------------- ----
{domain-name, domain-name-servers} dopt-1a2b3c4d {}
```
**Exemple 2 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer chaque option DHCP.**
```
$option1 = New-Object Amazon.EC2.Model.DhcpConfiguration
$option1.Key = "domain-name"
$option1.Values = "abc.local"
$option2 = New-Object Amazon.EC2.Model.DhcpConfiguration
$option2.Key = "domain-name-servers"
$option2.Values = @("10.0.0.101","10.0.0.102")
New-EC2DhcpOption -DhcpConfiguration @($option1, $option2)
```
**Sortie** :
```
DhcpConfigurations DhcpOptionsId Tags
------------------ ------------- ----
{domain-name, domain-name-servers} dopt-2a3b4c5d {}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateDhcpOptions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2FlowLog`
L'exemple de code suivant montre comment utiliser`New-EC2FlowLog`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un journal de flux EC2 pour le sous-réseau subnet-1d234567 vers le cloud-watch-log nom « subnet1-log » pour tout le trafic « REJECT » en utilisant les autorisations du rôle « Admin »**
```
New-EC2FlowLog -ResourceId "subnet-1d234567" -LogDestinationType cloud-watch-logs -LogGroupName subnet1-log -TrafficType "REJECT" -ResourceType Subnet -DeliverLogsPermissionArn "arn:aws:iam::98765432109:role/Admin"
```
**Sortie** :
```
ClientToken FlowLogIds Unsuccessful
----------- ---------- ------------
m1VN2cxP3iB4qo//VUKl5EU6cF7gQLOxcqNefvjeTGw= {fl-012fc34eed5678c9d} {}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateFlowLogs](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2Host`
L'exemple de code suivant montre comment utiliser`New-EC2Host`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple alloue un hôte dédié à votre compte pour le type d’instance et la zone de disponibilité donnés**
```
New-EC2Host -AutoPlacement on -AvailabilityZone eu-west-1b -InstanceType m4.xlarge -Quantity 1
```
**Sortie** :
```
h-01e23f4cd567890f3
```
+ Pour plus de détails sur l'API, reportez-vous [AllocateHosts](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2HostReservation`
L'exemple de code suivant montre comment utiliser`New-EC2HostReservation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple achète l’offre de réservation hro-0c1f23456789d0ab avec des configurations qui correspondent à celles de votre hôte dédié h-01e23f4cd567890f1**
```
New-EC2HostReservation -OfferingId hro-0c1f23456789d0ab HostIdSet h-01e23f4cd567890f1
```
**Sortie** :
```
ClientToken :
CurrencyCode :
Purchase : {hr-0123f4b5d67bedc89}
TotalHourlyPrice : 1.307
TotalUpfrontPrice : 0.000
```
+ Pour plus de détails sur l'API, reportez-vous [PurchaseHostReservation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2Image`
L'exemple de code suivant montre comment utiliser`New-EC2Image`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une AMI avec le nom et la description spécifiés, à partir de l’instance spécifiée. Amazon EC2 tente d’arrêter correctement l’instance avant de créer l’image, puis redémarre l’instance une fois l’opération terminée.**
```
New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI"
```
**Exemple 2 : cet exemple crée une AMI avec le nom et la description spécifiés, à partir de l’instance spécifiée. Amazon EC2 crée l’image sans arrêter ni redémarrer l’instance ; par conséquent, l’intégrité du système de fichiers sur l’image créée ne peut être garantie.**
```
New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI" -NoReboot $true
```
**Exemple 3 : cet exemple crée une AMI avec trois volumes. Le premier volume est basé sur un instantané Amazon EBS. Le deuxième volume est un volume Amazon EBS vide de 100 GiO. Le troisième volume est un volume de stockage d’instances. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou supérieure.**
```
$ebsBlock1 = @{SnapshotId="snap-1a2b3c4d"}
$ebsBlock2 = @{VolumeSize=100}
New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI" -BlockDeviceMapping @( @{DeviceName="/dev/sdf";Ebs=$ebsBlock1}, @{DeviceName="/dev/sdg";Ebs=$ebsBlock2}, @{DeviceName="/dev/sdc";VirtualName="ephemeral0"})
```
+ Pour plus de détails sur l'API, reportez-vous [CreateImage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2Instance`
L'exemple de code suivant montre comment utiliser`New-EC2Instance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple lance une instance unique de l’AMI spécifiée dans EC2-Classic ou dans un VPC par défaut.**
```
New-EC2Instance -ImageId ami-12345678 -MinCount 1 -MaxCount 1 -InstanceType m3.medium -KeyName my-key-pair -SecurityGroup my-security-group
```
**Exemple 2 : cet exemple lance une instance unique de l’AMI spécifiée dans un VPC.**
```
New-EC2Instance -ImageId ami-12345678 -MinCount 1 -MaxCount 1 -SubnetId subnet-12345678 -InstanceType t2.micro -KeyName my-key-pair -SecurityGroupId sg-12345678
```
**Exemple 3 : pour ajouter un volume EBS ou un volume de stockage d’instance, définissez un mappage de périphérique de stockage en mode bloc et ajoutez-le à la commande. Cet exemple ajoute un volume de stockage d’instances.**
```
$bdm = New-Object Amazon.EC2.Model.BlockDeviceMapping
$bdm.VirtualName = "ephemeral0"
$bdm.DeviceName = "/dev/sdf"
New-EC2Instance -ImageId ami-12345678 -BlockDeviceMapping $bdm ...
```
**Exemple 4 : Pour spécifier l'un des systèmes Windows actuels AMIs, obtenez son ID AMI à l'aide deGet-EC2ImageByName. Cet exemple lance une instance à partir de l’AMI de base actuelle pour Windows Server 2016.**
```
$ami = Get-EC2ImageByName WINDOWS_2016_BASE
New-EC2Instance -ImageId $ami.ImageId ...
```
**Exemple 5 : lance une instance dans l’environnement hôte dédié spécifié.**
```
New-EC2Instance -ImageId ami-1a2b3c4d -InstanceType m4.large -KeyName my-key-pair -SecurityGroupId sg-1a2b3c4d -AvailabilityZone us-west-1a -Tenancy host -HostID h-1a2b3c4d5e6f1a2b3
```
**Exemple 6 : cette demande lance deux instances et applique une balise avec une clé de serveur Web et une valeur de production aux instances. La demande applique également une balise avec une clé de centre de coûts et une valeur cc123 aux volumes créés (dans ce cas, le volume racine de chaque instance).**
```
$tag1 = @{ Key="webserver"; Value="production" }
$tag2 = @{ Key="cost-center"; Value="cc123" }
$tagspec1 = new-object Amazon.EC2.Model.TagSpecification
$tagspec1.ResourceType = "instance"
$tagspec1.Tags.Add($tag1)
$tagspec2 = new-object Amazon.EC2.Model.TagSpecification
$tagspec2.ResourceType = "volume"
$tagspec2.Tags.Add($tag2)
New-EC2Instance -ImageId "ami-1a2b3c4d" -KeyName "my-key-pair" -MaxCount 2 -InstanceType "t2.large" -SubnetId "subnet-1a2b3c4d" -TagSpecification $tagspec1,$tagspec2
```
+ Pour plus de détails sur l'API, reportez-vous [RunInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2InstanceExportTask`
L'exemple de code suivant montre comment utiliser`New-EC2InstanceExportTask`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple exporte une instance arrêtée, `i-0800b00a00EXAMPLE`, sous forme de disque dur virtuel (VHD) vers le compartiment S3 `testbucket-export-instances-2019`. L'environnement cible est`Microsoft`, et le paramètre de région est ajouté parce que l'instance se trouve dans la `us-east-1` région, alors que la AWS région par défaut de l'utilisateur n'est pas us-east-1. Pour obtenir le statut de la tâche d’exportation, copiez la valeur `ExportTaskId` à partir des résultats de cette commande, puis exécutez `Get-EC2ExportTask -ExportTaskId export_task_ID_from_results.`**
```
New-EC2InstanceExportTask -InstanceId i-0800b00a00EXAMPLE -ExportToS3Task_DiskImageFormat VHD -ExportToS3Task_S3Bucket "amzn-s3-demo-bucket" -TargetEnvironment Microsoft -Region us-east-1
```
**Sortie** :
```
Description :
ExportTaskId : export-i-077c73108aEXAMPLE
ExportToS3Task : Amazon.EC2.Model.ExportToS3Task
InstanceExportDetails : Amazon.EC2.Model.InstanceExportDetails
State : active
StatusMessage :
```
+ Pour plus de détails sur l'API, reportez-vous [CreateInstanceExportTask](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2InternetGateway`
L'exemple de code suivant montre comment utiliser`New-EC2InternetGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une passerelle Internet.**
```
New-EC2InternetGateway
```
**Sortie** :
```
Attachments InternetGatewayId Tags
----------- ----------------- ----
{} igw-1a2b3c4d {}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateInternetGateway](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2KeyPair`
L'exemple de code suivant montre comment utiliser`New-EC2KeyPair`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une paire de clés et capture la clé privée RSA codée PEM dans un fichier portant le nom spécifié. Lorsque vous l'utilisez PowerShell, le codage doit être défini sur ASCII pour générer une clé valide. Pour plus d'informations, consultez la section Créer, afficher et supprimer des paires de clés Amazon EC2 (https://docs.aws.amazon.com/cli/latest/userguide/cli-services-ec2-keypairs.html) dans le guide de l'utilisateur de l'interface de ligne de AWS commande.**
```
(New-EC2KeyPair -KeyName "my-key-pair").KeyMaterial | Out-File -Encoding ascii -FilePath C:\path\my-key-pair.pem
```
+ Pour plus de détails sur l'API, reportez-vous [CreateKeyPair](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2NetworkAcl`
L'exemple de code suivant montre comment utiliser`New-EC2NetworkAcl`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une liste ACL réseau pour le VPC spécifié.**
```
New-EC2NetworkAcl -VpcId vpc-12345678
```
**Sortie** :
```
Associations : {}
Entries : {Amazon.EC2.Model.NetworkAclEntry, Amazon.EC2.Model.NetworkAclEntry}
IsDefault : False
NetworkAclId : acl-12345678
Tags : {}
VpcId : vpc-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [CreateNetworkAcl](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2NetworkAclEntry`
L'exemple de code suivant montre comment utiliser`New-EC2NetworkAclEntry`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée une entrée pour la liste ACL réseau spécifiée. La règle autorise le trafic entrant depuis n’importe où (0.0.0.0/0) sur le port UDP 53 (DNS) vers n’importe quel sous-réseau associé.**
```
New-EC2NetworkAclEntry -NetworkAclId acl-12345678 -Egress $false -RuleNumber 100 -Protocol 17 -PortRange_From 53 -PortRange_To 53 -CidrBlock 0.0.0.0/0 -RuleAction allow
```
+ Pour plus de détails sur l'API, reportez-vous [CreateNetworkAclEntry](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2NetworkInterface`
L'exemple de code suivant montre comment utiliser`New-EC2NetworkInterface`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée l’interface réseau spécifiée.**
```
New-EC2NetworkInterface -SubnetId subnet-1a2b3c4d -Description "my network interface" -Group sg-12345678 -PrivateIpAddress 10.0.0.17
```
**Sortie** :
```
Association :
Attachment :
AvailabilityZone : us-west-2c
Description : my network interface
Groups : {my-security-group}
MacAddress : 0a:72:bc:1a:cd:7f
NetworkInterfaceId : eni-12345678
OwnerId : 123456789012
PrivateDnsName : ip-10-0-0-17.us-west-2.compute.internal
PrivateIpAddress : 10.0.0.17
PrivateIpAddresses : {}
RequesterId :
RequesterManaged : False
SourceDestCheck : True
Status : pending
SubnetId : subnet-1a2b3c4d
TagSet : {}
VpcId : vpc-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [CreateNetworkInterface](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2PlacementGroup`
L'exemple de code suivant montre comment utiliser`New-EC2PlacementGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un groupe de placement avec le nom spécifié.**
```
New-EC2PlacementGroup -GroupName my-placement-group -Strategy cluster
```
+ Pour plus de détails sur l'API, reportez-vous [CreatePlacementGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2Route`
L'exemple de code suivant montre comment utiliser`New-EC2Route`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée la route spécifiée pour la table de routage spécifiée. La route correspond à l’ensemble du trafic et l’achemine vers la passerelle Internet spécifiée.**
```
New-EC2Route -RouteTableId rtb-1a2b3c4d -DestinationCidrBlock 0.0.0.0/0 -GatewayId igw-1a2b3c4d
```
**Sortie** :
```
True
```
+ Pour plus de détails sur l'API, reportez-vous [CreateRoute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2RouteTable`
L'exemple de code suivant montre comment utiliser`New-EC2RouteTable`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple une table de routage pour le VPC spécifié.**
```
New-EC2RouteTable -VpcId vpc-12345678
```
**Sortie** :
```
Associations : {}
PropagatingVgws : {}
Routes : {}
RouteTableId : rtb-1a2b3c4d
Tags : {}
VpcId : vpc-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [CreateRouteTable](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2ScheduledInstance`
L'exemple de code suivant montre comment utiliser`New-EC2ScheduledInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple lance l’instance planifiée spécifiée.**
```
New-EC2ScheduledInstance -ScheduledInstanceId sci-1234-1234-1234-1234-123456789012 -InstanceCount 1 `
-IamInstanceProfile_Name my-iam-role `
-LaunchSpecification_ImageId ami-12345678 `
-LaunchSpecification_InstanceType c4.large `
-LaunchSpecification_SubnetId subnet-12345678`
-LaunchSpecification_SecurityGroupId sg-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [RunScheduledInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2ScheduledInstancePurchase`
L'exemple de code suivant montre comment utiliser`New-EC2ScheduledInstancePurchase`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple achète une instance planifiée.**
```
$request = New-Object Amazon.EC2.Model.PurchaseRequest
$request.InstanceCount = 1
$request.PurchaseToken = "eyJ2IjoiMSIsInMiOjEsImMiOi..."
New-EC2ScheduledInstancePurchase -PurchaseRequest $request
```
**Sortie** :
```
AvailabilityZone : us-west-2b
CreateDate : 1/25/2016 1:43:38 PM
HourlyPrice : 0.095
InstanceCount : 1
InstanceType : c4.large
NetworkPlatform : EC2-VPC
NextSlotStartTime : 1/31/2016 1:00:00 AM
Platform : Linux/UNIX
PreviousSlotEndTime :
Recurrence : Amazon.EC2.Model.ScheduledInstanceRecurrence
ScheduledInstanceId : sci-1234-1234-1234-1234-123456789012
SlotDurationInHours : 32
TermEndDate : 1/31/2017 1:00:00 AM
TermStartDate : 1/31/2016 1:00:00 AM
TotalScheduledInstanceHours : 1696
```
+ Pour plus de détails sur l'API, reportez-vous [PurchaseScheduledInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2SecurityGroup`
L'exemple de code suivant montre comment utiliser`New-EC2SecurityGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un groupe de sécurité pour le VPC spécifié.**
```
New-EC2SecurityGroup -GroupName my-security-group -Description "my security group" -VpcId vpc-12345678
```
**Sortie** :
```
sg-12345678
```
**Exemple 2 : cet exemple décrit un groupe de sécurité pour EC2-Classic.**
```
New-EC2SecurityGroup -GroupName my-security-group -Description "my security group"
```
**Sortie** :
```
sg-45678901
```
+ Pour plus de détails sur l'API, reportez-vous [CreateSecurityGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2Snapshot`
L'exemple de code suivant montre comment utiliser`New-EC2Snapshot`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un instantané du volume spécifié.**
```
New-EC2Snapshot -VolumeId vol-12345678 -Description "This is a test"
```
**Sortie** :
```
DataEncryptionKeyId :
Description : This is a test
Encrypted : False
KmsKeyId :
OwnerAlias :
OwnerId : 123456789012
Progress :
SnapshotId : snap-12345678
StartTime : 12/22/2015 1:28:42 AM
State : pending
StateMessage :
Tags : {}
VolumeId : vol-12345678
VolumeSize : 20
```
+ Pour plus de détails sur l'API, reportez-vous [CreateSnapshot](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2SpotDatafeedSubscription`
L'exemple de code suivant montre comment utiliser`New-EC2SpotDatafeedSubscription`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un flux de données d’instance Spot.**
```
New-EC2SpotDatafeedSubscription -Bucket amzn-s3-demo-bucket -Prefix spotdata
```
**Sortie** :
```
Bucket : amzn-s3-demo-bucket
Fault :
OwnerId : 123456789012
Prefix : spotdata
State : Active
```
+ Pour plus de détails sur l'API, reportez-vous [CreateSpotDatafeedSubscription](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2Subnet`
L'exemple de code suivant montre comment utiliser`New-EC2Subnet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un sous-réseau pour le CIDR spécifié.**
```
New-EC2Subnet -VpcId vpc-12345678 -CidrBlock 10.0.0.0/24
```
**Sortie** :
```
AvailabilityZone : us-west-2c
AvailableIpAddressCount : 251
CidrBlock : 10.0.0.0/24
DefaultForAz : False
MapPublicIpOnLaunch : False
State : pending
SubnetId : subnet-1a2b3c4d
Tag : {}
VpcId : vpc-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [CreateSubnet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2Tag`
L'exemple de code suivant montre comment utiliser`New-EC2Tag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute une balise unique à la ressource spécifiée. La clé de balise est « MyTag » et la valeur de la balise est « myTagValue ». La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou supérieure.**
```
New-EC2Tag -Resource i-12345678 -Tag @{ Key="myTag"; Value="myTagValue" }
```
**Exemple 2 : cet exemple met à jour ou ajoute les balises spécifiées à la ressource spécifiée. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou supérieure.**
```
New-EC2Tag -Resource i-12345678 -Tag @( @{ Key="myTag"; Value="newTagValue" }, @{ Key="test"; Value="anotherTagValue" } )
```
**Exemple 3 : avec PowerShell la version 2, vous devez utiliser New-Object pour créer la balise pour le paramètre Tag.**
```
$tag = New-Object Amazon.EC2.Model.Tag
$tag.Key = "myTag"
$tag.Value = "myTagValue"
New-EC2Tag -Resource i-12345678 -Tag $tag
```
+ Pour plus de détails sur l'API, reportez-vous [CreateTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2Volume`
L'exemple de code suivant montre comment utiliser`New-EC2Volume`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée le volume spécifié.**
```
New-EC2Volume -Size 50 -AvailabilityZone us-west-2a -VolumeType gp2
```
**Sortie** :
```
Attachments : {}
AvailabilityZone : us-west-2a
CreateTime : 12/22/2015 1:42:07 AM
Encrypted : False
Iops : 150
KmsKeyId :
Size : 50
SnapshotId :
State : creating
Tags : {}
VolumeId : vol-12345678
VolumeType : gp2
```
**Exemple 2 : cet exemple de demande crée un volume et applique une balise avec une clé de pile et une valeur de production.**
```
$tag = @{ Key="stack"; Value="production" }
$tagspec = new-object Amazon.EC2.Model.TagSpecification
$tagspec.ResourceType = "volume"
$tagspec.Tags.Add($tag)
New-EC2Volume -Size 80 -AvailabilityZone "us-west-2a" -TagSpecification $tagspec
```
+ Pour plus de détails sur l'API, reportez-vous [CreateVolume](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2Vpc`
L'exemple de code suivant montre comment utiliser`New-EC2Vpc`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un VPC pour le CIDR spécifié. Amazon VPC crée également les éléments suivants pour le VPC : un ensemble d’options DHCP par défaut, une table de routage principale et une liste ACL réseau par défaut.**
```
New-EC2VPC -CidrBlock 10.0.0.0/16
```
**Sortie** :
```
CidrBlock : 10.0.0.0/16
DhcpOptionsId : dopt-1a2b3c4d
InstanceTenancy : default
IsDefault : False
State : pending
Tags : {}
VpcId : vpc-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [CreateVpc](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2VpcEndpoint`
L'exemple de code suivant montre comment utiliser`New-EC2VpcEndpoint`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un nouveau point de terminaison d’un VPC pour le service com.amazonaws.eu-west-1.s3 dans le VPC vpc-0fc1ff23f45b678eb**
```
New-EC2VpcEndpoint -ServiceName com.amazonaws.eu-west-1.s3 -VpcId vpc-0fc1ff23f45b678eb
```
**Sortie** :
```
ClientToken VpcEndpoint
----------- -----------
Amazon.EC2.Model.VpcEndpoint
```
+ Pour plus de détails sur l'API, reportez-vous [CreateVpcEndpoint](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2VpnConnection`
L'exemple de code suivant montre comment utiliser`New-EC2VpnConnection`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une connexion VPN entre la passerelle privée virtuelle spécifiée et la passerelle client spécifiée. La sortie inclut les informations de configuration dont votre administrateur réseau a besoin, au format XML.**
```
New-EC2VpnConnection -Type ipsec.1 -CustomerGatewayId cgw-1a2b3c4d -VpnGatewayId vgw-1a2b3c4d
```
**Sortie** :
```
CustomerGatewayConfiguration : [XML document]
CustomerGatewayId : cgw-1a2b3c4d
Options :
Routes : {}
State : pending
Tags : {}
Type :
VgwTelemetry : {}
VpnConnectionId : vpn-12345678
VpnGatewayId : vgw-1a2b3c4d
```
**Exemple 2 : cet exemple crée la connexion VPN et capture la configuration dans un fichier portant le nom spécifié.**
```
(New-EC2VpnConnection -CustomerGatewayId cgw-1a2b3c4d -VpnGatewayId vgw-1a2b3c4d).CustomerGatewayConfiguration | Out-File C:\path\vpn-configuration.xml
```
**Exemple 3 : cet exemple crée une connexion VPN avec un routage statique entre la passerelle privée virtuelle spécifiée et la passerelle client spécifiée.**
```
New-EC2VpnConnection -Type ipsec.1 -CustomerGatewayId cgw-1a2b3c4d -VpnGatewayId vgw-1a2b3c4d -Options_StaticRoutesOnly $true
```
+ Pour plus de détails sur l'API, reportez-vous [CreateVpnConnection](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2VpnConnectionRoute`
L'exemple de code suivant montre comment utiliser`New-EC2VpnConnectionRoute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la route statique spécifiée pour la connexion VPN spécifiée.**
```
New-EC2VpnConnectionRoute -VpnConnectionId vpn-12345678 -DestinationCidrBlock 11.12.0.0/16
```
+ Pour plus de détails sur l'API, reportez-vous [CreateVpnConnectionRoute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EC2VpnGateway`
L'exemple de code suivant montre comment utiliser`New-EC2VpnGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée la passerelle privée virtuelle spécifiée.**
```
New-EC2VpnGateway -Type ipsec.1
```
**Sortie** :
```
AvailabilityZone :
State : available
Tags : {}
Type : ipsec.1
VpcAttachments : {}
VpnGatewayId : vgw-1a2b3c4d
```
+ Pour plus de détails sur l'API, reportez-vous [CreateVpnGateway](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-EC2Address`
L'exemple de code suivant montre comment utiliser`Register-EC2Address`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple associe l’adresse IP Elastic spécifiée à l’instance spécifiée dans un VPC.**
```
C:\> Register-EC2Address -InstanceId i-12345678 -AllocationId eipalloc-12345678
```
**Sortie** :
```
eipassoc-12345678
```
**Exemple 2 : cet exemple associe l’adresse IP Elastic spécifiée à l’instance spécifiée dans EC2-Classic.**
```
C:\> Register-EC2Address -InstanceId i-12345678 -PublicIp 203.0.113.17
```
+ Pour plus de détails sur l'API, reportez-vous [AssociateAddress](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-EC2DhcpOption`
L'exemple de code suivant montre comment utiliser`Register-EC2DhcpOption`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple associe le jeu d’options DHCP spécifié au VPC spécifié.**
```
Register-EC2DhcpOption -DhcpOptionsId dopt-1a2b3c4d -VpcId vpc-12345678
```
**Exemple 2 : cet exemple associe les options DHCP définies par défaut au VPC spécifié.**
```
Register-EC2DhcpOption -DhcpOptionsId default -VpcId vpc-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [AssociateDhcpOptions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-EC2Image`
L'exemple de code suivant montre comment utiliser`Register-EC2Image`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre une AMI à l’aide du fichier manifeste spécifié dans Amazon S3.**
```
Register-EC2Image -ImageLocation amzn-s3-demo-bucket/my-web-server-ami/image.manifest.xml -Name my-web-server-ami
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterImage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-EC2PrivateIpAddress`
L'exemple de code suivant montre comment utiliser`Register-EC2PrivateIpAddress`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple attribue l’adresse IP privée secondaire spécifiée à l’interface réseau spécifiée.**
```
Register-EC2PrivateIpAddress -NetworkInterfaceId eni-1a2b3c4d -PrivateIpAddress 10.0.0.82
```
**Exemple 2 : cet exemple crée deux adresses IP privées secondaires et les attribue à l’interface réseau spécifiée.**
```
Register-EC2PrivateIpAddress -NetworkInterfaceId eni-1a2b3c4d -SecondaryPrivateIpAddressCount 2
```
+ Pour plus de détails sur l'API, reportez-vous [AssignPrivateIpAddresses](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-EC2RouteTable`
L'exemple de code suivant montre comment utiliser`Register-EC2RouteTable`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple associe la table de routage spécifiée au sous-réseau spécifié.**
```
Register-EC2RouteTable -RouteTableId rtb-1a2b3c4d -SubnetId subnet-1a2b3c4d
```
**Sortie** :
```
rtbassoc-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [AssociateRouteTable](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2Address`
L'exemple de code suivant montre comment utiliser`Remove-EC2Address`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple publie l’adresse IP Elastic spécifiée pour les instances dans un VPC.**
```
Remove-EC2Address -AllocationId eipalloc-12345678 -Force
```
**Exemple 2 : cet exemple publie l’adresse IP Elastic spécifiée pour les instances dans EC2-Classic.**
```
Remove-EC2Address -PublicIp 198.51.100.2 -Force
```
+ Pour plus de détails sur l'API, reportez-vous [ReleaseAddress](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2CapacityReservation`
L'exemple de code suivant montre comment utiliser`Remove-EC2CapacityReservation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple annule la réserve de capacité cr-0c1f2345db6f7cdba**
```
Remove-EC2CapacityReservation -CapacityReservationId cr-0c1f2345db6f7cdba
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EC2CapacityReservation (CancelCapacityReservation)" on target "cr-0c1f2345db6f7cdba".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y
True
```
+ Pour plus de détails sur l'API, reportez-vous [CancelCapacityReservation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2CustomerGateway`
L'exemple de code suivant montre comment utiliser`Remove-EC2CustomerGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la passerelle client spécifiée. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2CustomerGateway -CustomerGatewayId cgw-1a2b3c4d
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2CustomerGateway (DeleteCustomerGateway)" on Target "cgw-1a2b3c4d".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteCustomerGateway](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2DhcpOption`
L'exemple de code suivant montre comment utiliser`Remove-EC2DhcpOption`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le jeu d’options DHCP spécifié. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2DhcpOption -DhcpOptionsId dopt-1a2b3c4d
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2DhcpOption (DeleteDhcpOptions)" on Target "dopt-1a2b3c4d".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteDhcpOptions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2FlowLog`
L'exemple de code suivant montre comment utiliser`Remove-EC2FlowLog`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime le fichier FlowLogId fl-01a2b3456a789c01 donné**
```
Remove-EC2FlowLog -FlowLogId fl-01a2b3456a789c01
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EC2FlowLog (DeleteFlowLogs)" on target "fl-01a2b3456a789c01".
[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 [DeleteFlowLogs](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2Host`
L'exemple de code suivant montre comment utiliser`Remove-EC2Host`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple publie l’ID d’hôte h-0badafd1dcb2f3456 donné**
```
Remove-EC2Host -HostId h-0badafd1dcb2f3456
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EC2Host (ReleaseHosts)" on target "h-0badafd1dcb2f3456".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Successful Unsuccessful
---------- ------------
{h-0badafd1dcb2f3456} {}
```
+ Pour plus de détails sur l'API, reportez-vous [ReleaseHosts](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2Instance`
L'exemple de code suivant montre comment utiliser`Remove-EC2Instance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple résilie l’instance spécifiée (l’instance peut être en cours d’exécution ou à l’état « arrêté »). L’applet de commande vous invite à confirmer avant de poursuivre ; utilisez le commutateur -Force pour supprimer l’invite.**
```
Remove-EC2Instance -InstanceId i-12345678
```
**Sortie** :
```
CurrentState InstanceId PreviousState
------------ ---------- -------------
Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceState
```
+ Pour plus de détails sur l'API, reportez-vous [TerminateInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2InternetGateway`
L'exemple de code suivant montre comment utiliser`Remove-EC2InternetGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la passerelle Internet spécifiée. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2InternetGateway (DeleteInternetGateway)" on Target "igw-1a2b3c4d".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteInternetGateway](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2KeyPair`
L'exemple de code suivant montre comment utiliser`Remove-EC2KeyPair`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la paire de clés spécifiée. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2KeyPair -KeyName my-key-pair
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2KeyPair (DeleteKeyPair)" on Target "my-key-pair".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteKeyPair](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2NetworkAcl`
L'exemple de code suivant montre comment utiliser`Remove-EC2NetworkAcl`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la liste ACL réseau spécifiée. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2NetworkAcl -NetworkAclId acl-12345678
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2NetworkAcl (DeleteNetworkAcl)" on Target "acl-12345678".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteNetworkAcl](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2NetworkAclEntry`
L'exemple de code suivant montre comment utiliser`Remove-EC2NetworkAclEntry`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la règle spécifiée de la liste ACL réseau spécifiée. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2NetworkAclEntry -NetworkAclId acl-12345678 -Egress $false -RuleNumber 100
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2NetworkAclEntry (DeleteNetworkAclEntry)" on Target "acl-12345678".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteNetworkAclEntry](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2NetworkInterface`
L'exemple de code suivant montre comment utiliser`Remove-EC2NetworkInterface`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’interface réseau spécifiée. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2NetworkInterface -NetworkInterfaceId eni-12345678
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2NetworkInterface (DeleteNetworkInterface)" on Target "eni-12345678".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteNetworkInterface](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2PlacementGroup`
L'exemple de code suivant montre comment utiliser`Remove-EC2PlacementGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le groupe de placement spécifié. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2PlacementGroup -GroupName my-placement-group
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2PlacementGroup (DeletePlacementGroup)" on Target "my-placement-group".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeletePlacementGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2Route`
L'exemple de code suivant montre comment utiliser`Remove-EC2Route`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la route spécifiée de la table de routage spécifiée. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2Route -RouteTableId rtb-1a2b3c4d -DestinationCidrBlock 0.0.0.0/0
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2Route (DeleteRoute)" on Target "rtb-1a2b3c4d".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteRoute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2RouteTable`
L'exemple de code suivant montre comment utiliser`Remove-EC2RouteTable`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la table de routage spécifiée. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2RouteTable -RouteTableId rtb-1a2b3c4d
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2RouteTable (DeleteRouteTable)" on Target "rtb-1a2b3c4d".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteRouteTable](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2SecurityGroup`
L'exemple de code suivant montre comment utiliser`Remove-EC2SecurityGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le groupe de sécurité spécifié pour EC2-VPC. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2SecurityGroup -GroupId sg-12345678
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2SecurityGroup (DeleteSecurityGroup)" on Target "sg-12345678".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : cet exemple supprime le groupe de sécurité spécifié pour EC2-Classic.**
```
Remove-EC2SecurityGroup -GroupName my-security-group -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteSecurityGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2Snapshot`
L'exemple de code suivant montre comment utiliser`Remove-EC2Snapshot`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’instantané spécifié. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2Snapshot -SnapshotId snap-12345678
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EC2Snapshot (DeleteSnapshot)" on target "snap-12345678".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteSnapshot](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2SpotDatafeedSubscription`
L'exemple de code suivant montre comment utiliser`Remove-EC2SpotDatafeedSubscription`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le flux de données de votre instance Spot. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2SpotDatafeedSubscription
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2SpotDatafeedSubscription (DeleteSpotDatafeedSubscription)" on Target "".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteSpotDatafeedSubscription](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2Subnet`
L'exemple de code suivant montre comment utiliser`Remove-EC2Subnet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le sous-réseau spécifié. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2Subnet -SubnetId subnet-1a2b3c4d
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2Subnet (DeleteSubnet)" on Target "subnet-1a2b3c4d".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteSubnet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2Tag`
L'exemple de code suivant montre comment utiliser`Remove-EC2Tag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la balise spécifiée de la ressource spécifiée, quelle que soit la valeur de la balise. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
Remove-EC2Tag -Resource i-12345678 -Tag @{ Key="myTag" } -Force
```
**Exemple 2 : cet exemple supprime la balise spécifiée de la ressource spécifiée, uniquement si la valeur de la balise correspond. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
Remove-EC2Tag -Resource i-12345678 -Tag @{ Key="myTag";Value="myTagValue" } -Force
```
**Exemple 3 : cet exemple supprime la balise spécifiée de la ressource spécifiée, quelle que soit la valeur de la balise.**
```
$tag = New-Object Amazon.EC2.Model.Tag
$tag.Key = "myTag"
Remove-EC2Tag -Resource i-12345678 -Tag $tag -Force
```
**Exemple 4 : cet exemple supprime la balise spécifiée de la ressource spécifiée, uniquement si la valeur de la balise correspond.**
```
$tag = New-Object Amazon.EC2.Model.Tag
$tag.Key = "myTag"
$tag.Value = "myTagValue"
Remove-EC2Tag -Resource i-12345678 -Tag $tag -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2Volume`
L'exemple de code suivant montre comment utiliser`Remove-EC2Volume`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple détache le volume spécifié. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2Volume -VolumeId vol-12345678
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-EC2Volume (DeleteVolume)" on target "vol-12345678".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteVolume](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2Vpc`
L'exemple de code suivant montre comment utiliser`Remove-EC2Vpc`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le VPC spécifié. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2Vpc -VpcId vpc-12345678
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2Vpc (DeleteVpc)" on Target "vpc-12345678".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteVpc](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2VpnConnection`
L'exemple de code suivant montre comment utiliser`Remove-EC2VpnConnection`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la connexion de VPN spécifiée. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2VpnConnection -VpnConnectionId vpn-12345678
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2VpnConnection (DeleteVpnConnection)" on Target "vpn-12345678".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteVpnConnection](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2VpnConnectionRoute`
L'exemple de code suivant montre comment utiliser`Remove-EC2VpnConnectionRoute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la route statique spécifiée de la connexion VPN spécifiée. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2VpnConnectionRoute -VpnConnectionId vpn-12345678 -DestinationCidrBlock 11.12.0.0/16
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2VpnConnectionRoute (DeleteVpnConnectionRoute)" on Target "vpn-12345678".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteVpnConnectionRoute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EC2VpnGateway`
L'exemple de code suivant montre comment utiliser`Remove-EC2VpnGateway`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la passerelle privée virtuelle spécifiée. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-EC2VpnGateway (DeleteVpnGateway)" on Target "vgw-1a2b3c4d".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteVpnGateway](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Request-EC2SpotFleet`
L'exemple de code suivant montre comment utiliser`Request-EC2SpotFleet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une demande de parc d’instances Spot dans la zone de disponibilité avec le prix le plus bas pour le type d’instance spécifié. Si votre compte prend uniquement en charge EC2-VPC, le parc d’instances Spot lance les instances dans la zone de disponibilité ayant le prix le moins élevé qui a un sous-réseau par défaut. Si votre compte prend en charge EC2-Classic, le parc d’instances Spot lance les instances dans EC2-Classic dans la zone de disponibilité ayant le prix le moins élevé. Notez que le prix que vous payez ne dépassera pas le prix Spot spécifié pour la demande.**
```
$sg = New-Object Amazon.EC2.Model.GroupIdentifier
$sg.GroupId = "sg-12345678"
$lc = New-Object Amazon.EC2.Model.SpotFleetLaunchSpecification
$lc.ImageId = "ami-12345678"
$lc.InstanceType = "m3.medium"
$lc.SecurityGroups.Add($sg)
Request-EC2SpotFleet -SpotFleetRequestConfig_SpotPrice 0.04 `
-SpotFleetRequestConfig_TargetCapacity 2 `
-SpotFleetRequestConfig_IamFleetRole arn:aws:iam::123456789012:role/my-spot-fleet-role `
-SpotFleetRequestConfig_LaunchSpecification $lc
```
+ Pour plus de détails sur l'API, reportez-vous [RequestSpotFleet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Request-EC2SpotInstance`
L'exemple de code suivant montre comment utiliser`Request-EC2SpotInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple demande une instance Spot unique dans le sous-réseau spécifié. Notez que le groupe de sécurité doit être créé pour le VPC qui contient le sous-réseau spécifié et qu’il doit être spécifié par ID à l’aide de l’interface réseau. Lorsque vous spécifiez une interface réseau, vous devez inclure l’ID de sous-réseau à l’aide de l’interface réseau.**
```
$n = New-Object Amazon.EC2.Model.InstanceNetworkInterfaceSpecification
$n.DeviceIndex = 0
$n.SubnetId = "subnet-12345678"
$n.Groups.Add("sg-12345678")
Request-EC2SpotInstance -InstanceCount 1 -SpotPrice 0.050 -Type one-time `
-IamInstanceProfile_Arn arn:aws:iam::123456789012:instance-profile/my-iam-role `
-LaunchSpecification_ImageId ami-12345678 `
-LaunchSpecification_InstanceType m3.medium `
-LaunchSpecification_NetworkInterface $n
```
**Sortie** :
```
ActualBlockHourlyPrice :
AvailabilityZoneGroup :
BlockDurationMinutes : 0
CreateTime : 12/26/2015 7:44:10 AM
Fault :
InstanceId :
LaunchedAvailabilityZone :
LaunchGroup :
LaunchSpecification : Amazon.EC2.Model.LaunchSpecification
ProductDescription : Linux/UNIX
SpotInstanceRequestId : sir-12345678
SpotPrice : 0.050000
State : open
Status : Amazon.EC2.Model.SpotInstanceStatus
Tags : {}
Type : one-time
```
+ Pour plus de détails sur l'API, reportez-vous [RequestSpotInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Reset-EC2ImageAttribute`
L'exemple de code suivant montre comment utiliser`Reset-EC2ImageAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple rétablit la valeur par défaut de l’attribut « launchPermission ». Par défaut, AMIs sont privés.**
```
Reset-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission
```
+ Pour plus de détails sur l'API, reportez-vous [ResetImageAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Reset-EC2InstanceAttribute`
L'exemple de code suivant montre comment utiliser`Reset-EC2InstanceAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple réinitialise l'attribut « sriovNetSupport » pour l'instance spécifiée.**
```
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute sriovNetSupport
```
**Exemple 2 : cet exemple réinitialise l’attribut « ebsOptimized » pour l’instance spécifiée.**
```
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute ebsOptimized
```
**Exemple 3 : Cet exemple réinitialise l'attribut « sourceDestCheck » pour l'instance spécifiée.**
```
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute sourceDestCheck
```
**Exemple 4 : Cet exemple réinitialise l'attribut « disableApiTermination » pour l'instance spécifiée.**
```
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute disableApiTermination
```
**Exemple 5 : Cet exemple réinitialise l'attribut « instanceInitiatedShutdown Comportement » pour l'instance spécifiée.**
```
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceInitiatedShutdownBehavior
```
+ Pour plus de détails sur l'API, reportez-vous [ResetInstanceAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Reset-EC2NetworkInterfaceAttribute`
L'exemple de code suivant montre comment utiliser`Reset-EC2NetworkInterfaceAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple réinitialise la source/destination vérification de l'interface réseau spécifiée.**
```
Reset-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -SourceDestCheck
```
+ Pour plus de détails sur l'API, reportez-vous [ResetNetworkInterfaceAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Reset-EC2SnapshotAttribute`
L'exemple de code suivant montre comment utiliser`Reset-EC2SnapshotAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple réinitialise l’attribut spécifié pour l’instantané spécifié.**
```
Reset-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission
```
+ Pour plus de détails sur l'API, reportez-vous [ResetSnapshotAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Restart-EC2Instance`
L'exemple de code suivant montre comment utiliser`Restart-EC2Instance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple redémarre l’instance spécifiée.**
```
Restart-EC2Instance -InstanceId i-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [RebootInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Revoke-EC2SecurityGroupEgress`
L'exemple de code suivant montre comment utiliser`Revoke-EC2SecurityGroupEgress`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la règle pour le groupe de sécurité spécifié pour EC2-VPC. Ceci révoque l’accès à la plage d’adresses IP spécifiée sur le port TCP 80. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou supérieure.**
```
$ip = @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; IpRanges="203.0.113.0/24" }
Revoke-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ip
```
**Exemple 2 : avec PowerShell la version 2, vous devez utiliser New-Object pour créer l' IpPermission objet.**
```
$ip = New-Object Amazon.EC2.Model.IpPermission
$ip.IpProtocol = "tcp"
$ip.FromPort = 80
$ip.ToPort = 80
$ip.IpRanges.Add("203.0.113.0/24")
Revoke-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ip
```
**Exemple 3 : cet exemple révoque l’accès au groupe de sécurité source spécifié sur le port TCP 80.**
```
$ug = New-Object Amazon.EC2.Model.UserIdGroupPair
$ug.GroupId = "sg-1a2b3c4d"
$ug.UserId = "123456789012"
Revoke-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission @( @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; UserIdGroupPairs=$ug } )
```
+ Pour plus de détails sur l'API, reportez-vous [RevokeSecurityGroupEgress](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Revoke-EC2SecurityGroupIngress`
L'exemple de code suivant montre comment utiliser`Revoke-EC2SecurityGroupIngress`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple révoque l’accès au port TCP 22 à partir de la plage d’adresses spécifiée pour le groupe de sécurité spécifié pour EC2-VPC. En outre, vous devez identifier des groupes de sécurité pour EC2-VPC à l’aide de l’ID du groupe de sécurité et non le nom du groupe de sécurité. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou supérieure.**
```
$ip = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.0/24" }
Revoke-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission $ip
```
**Exemple 2 : avec PowerShell la version 2, vous devez utiliser New-Object pour créer l' IpPermission objet.**
```
$ip = New-Object Amazon.EC2.Model.IpPermission
$ip.IpProtocol = "tcp"
$ip.FromPort = 22
$ip.ToPort = 22
$ip.IpRanges.Add("203.0.113.0/24")
Revoke-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission $ip
```
**Exemple 3 : cet exemple révoque l’accès au port TCP 22 à partir de la plage d’adresses spécifiée pour le groupe de sécurité spécifié pour EC2-Classic. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou supérieure.**
```
$ip = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.0/24" }
Revoke-EC2SecurityGroupIngress -GroupName "my-security-group" -IpPermission $ip
```
**Exemple 4 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer l' IpPermission objet.**
```
$ip = New-Object Amazon.EC2.Model.IpPermission
$ip.IpProtocol = "tcp"
$ip.FromPort = 22
$ip.ToPort = 22
$ip.IpRanges.Add("203.0.113.0/24")
Revoke-EC2SecurityGroupIngress -GroupName "my-security-group" -IpPermission $ip
```
+ Pour plus de détails sur l'API, reportez-vous [RevokeSecurityGroupIngress](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Send-EC2InstanceStatus`
L'exemple de code suivant montre comment utiliser`Send-EC2InstanceStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple signale des commentaires de statut pour l’instance spécifiée.**
```
Send-EC2InstanceStatus -Instance i-12345678 -Status impaired -ReasonCode unresponsive
```
+ Pour plus de détails sur l'API, reportez-vous [ReportInstanceStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-EC2NetworkAclAssociation`
L'exemple de code suivant montre comment utiliser`Set-EC2NetworkAclAssociation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple associe la liste ACL réseau spécifiée au sous-réseau pour l’association de liste ACL réseau spécifiée.**
```
Set-EC2NetworkAclAssociation -NetworkAclId acl-12345678 -AssociationId aclassoc-1a2b3c4d
```
**Sortie** :
```
aclassoc-87654321
```
+ Pour plus de détails sur l'API, reportez-vous [ReplaceNetworkAclAssociation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-EC2NetworkAclEntry`
L'exemple de code suivant montre comment utiliser`Set-EC2NetworkAclEntry`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple remplace l’entrée spécifiée pour la liste ACL réseau spécifiée. La nouvelle règle autorise le trafic entrant depuis l’adresse spécifiée vers n’importe quel sous-réseau associé.**
```
Set-EC2NetworkAclEntry -NetworkAclId acl-12345678 -Egress $false -RuleNumber 100 -Protocol 17 -PortRange_From 53 -PortRange_To 53 -CidrBlock 203.0.113.12/24 -RuleAction allow
```
+ Pour plus de détails sur l'API, reportez-vous [ReplaceNetworkAclEntry](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-EC2Route`
L'exemple de code suivant montre comment utiliser`Set-EC2Route`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple remplace la route spécifiée par la table de routage spécifiée. La nouvelle route envoie le trafic spécifié à la passerelle privée virtuelle spécifiée.**
```
Set-EC2Route -RouteTableId rtb-1a2b3c4d -DestinationCidrBlock 10.0.0.0/24 -GatewayId vgw-1a2b3c4d
```
+ Pour plus de détails sur l'API, reportez-vous [ReplaceRoute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-EC2RouteTableAssociation`
L'exemple de code suivant montre comment utiliser`Set-EC2RouteTableAssociation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple associe la table de routage spécifiée au sous-réseau pour l’association de table de routage spécifiée.**
```
Set-EC2RouteTableAssociation -RouteTableId rtb-1a2b3c4d -AssociationId rtbassoc-12345678
```
**Sortie** :
```
rtbassoc-87654321
```
+ Pour plus de détails sur l'API, reportez-vous [ReplaceRouteTableAssociation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Start-EC2Instance`
L'exemple de code suivant montre comment utiliser`Start-EC2Instance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple démarre l’instance spécifiée.**
```
Start-EC2Instance -InstanceId i-12345678
```
**Sortie** :
```
CurrentState InstanceId PreviousState
------------ ---------- -------------
Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceState
```
**Exemple 2 : cet exemple démarre les instances spécifiées.**
```
@("i-12345678", "i-76543210") | Start-EC2Instance
```
**Exemple 3 : cet exemple démarre l’ensemble des instances actuellement arrêtées. Les objets d'instance renvoyés par Get-EC2Instance sont redirigés versStart-EC2Instance. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou supérieure.**
```
(Get-EC2Instance -Filter @{ Name="instance-state-name"; Values="stopped"}).Instances | Start-EC2Instance
```
**Exemple 4 : avec PowerShell la version 2, vous devez utiliser New-Object pour créer le filtre pour le paramètre Filter.**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "instance-state-name"
$filter.Values = "stopped"
(Get-EC2Instance -Filter $filter).Instances | Start-EC2Instance
```
+ Pour plus de détails sur l'API, reportez-vous [StartInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Start-EC2InstanceMonitoring`
L'exemple de code suivant montre comment utiliser`Start-EC2InstanceMonitoring`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple de commande active la surveillance détaillée de l’instance spécifiée.**
```
Start-EC2InstanceMonitoring -InstanceId i-12345678
```
**Sortie** :
```
InstanceId Monitoring
---------- ----------
i-12345678 Amazon.EC2.Model.Monitoring
```
+ Pour plus de détails sur l'API, reportez-vous [MonitorInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-EC2ImportTask`
L'exemple de code suivant montre comment utiliser`Stop-EC2ImportTask`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple annule la tâche d’importation spécifiée (importation d’instantanés ou d’images). Si nécessaire, une raison peut être fournie à l’aide du paramètre `-CancelReason`.**
```
Stop-EC2ImportTask -ImportTaskId import-ami-abcdefgh
```
+ Pour plus de détails sur l'API, reportez-vous [CancelImportTask](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-EC2Instance`
L'exemple de code suivant montre comment utiliser`Stop-EC2Instance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple arrête l’instance spécifiée.**
```
Stop-EC2Instance -InstanceId i-12345678
```
**Sortie** :
```
CurrentState InstanceId PreviousState
------------ ---------- -------------
Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceState
```
+ Pour plus de détails sur l'API, reportez-vous [StopInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-EC2InstanceMonitoring`
L'exemple de code suivant montre comment utiliser`Stop-EC2InstanceMonitoring`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple désactive la surveillance détaillée de l’instance spécifiée.**
```
Stop-EC2InstanceMonitoring -InstanceId i-12345678
```
**Sortie** :
```
InstanceId Monitoring
---------- ----------
i-12345678 Amazon.EC2.Model.Monitoring
```
+ Pour plus de détails sur l'API, reportez-vous [UnmonitorInstances](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-EC2SpotFleetRequest`
L'exemple de code suivant montre comment utiliser`Stop-EC2SpotFleetRequest`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple annule la demande de parc d’instances Spot spécifiée et résilie les instances Spot associées.**
```
Stop-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -TerminateInstance $true
```
**Exemple 2 : cet exemple annule la demande de parc d’instances Spot spécifiée sans résilier les instances Spot associées.**
```
Stop-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -TerminateInstance $false
```
+ Pour plus de détails sur l'API, reportez-vous [CancelSpotFleetRequests](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-EC2SpotInstanceRequest`
L'exemple de code suivant montre comment utiliser`Stop-EC2SpotInstanceRequest`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple annule la demande d’instance Spot spécifiée.**
```
Stop-EC2SpotInstanceRequest -SpotInstanceRequestId sir-12345678
```
**Sortie** :
```
SpotInstanceRequestId State
--------------------- -----
sir-12345678 cancelled
```
+ Pour plus de détails sur l'API, reportez-vous [CancelSpotInstanceRequests](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-EC2Address`
L'exemple de code suivant montre comment utiliser`Unregister-EC2Address`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple dissocie l’adresse IP Elastic spécifiée de l’instance spécifiée dans un VPC.**
```
Unregister-EC2Address -AssociationId eipassoc-12345678
```
**Exemple 2 : cet exemple dissocie l’adresse IP Elastic spécifiée de l’instance spécifiée dans EC2-Classic.**
```
Unregister-EC2Address -PublicIp 203.0.113.17
```
+ Pour plus de détails sur l'API, reportez-vous [DisassociateAddress](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-EC2Image`
L'exemple de code suivant montre comment utiliser`Unregister-EC2Image`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple annule l’enregistrement de l’AMI spécifiée.**
```
Unregister-EC2Image -ImageId ami-12345678
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterImage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-EC2PrivateIpAddress`
L'exemple de code suivant montre comment utiliser`Unregister-EC2PrivateIpAddress`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple annule l’attribution de l’adresse IP privée spécifiée à l’interface réseau spécifiée.**
```
Unregister-EC2PrivateIpAddress -NetworkInterfaceId eni-1a2b3c4d -PrivateIpAddress 10.0.0.82
```
+ Pour plus de détails sur l'API, reportez-vous [UnassignPrivateIpAddresses](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-EC2RouteTable`
L'exemple de code suivant montre comment utiliser`Unregister-EC2RouteTable`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’association spécifiée entre une table de routage et un sous-réseau.**
```
Unregister-EC2RouteTable -AssociationId rtbassoc-1a2b3c4d
```
+ Pour plus de détails sur l'API, reportez-vous [DisassociateRouteTable](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-EC2SecurityGroupRuleIngressDescription`
L'exemple de code suivant montre comment utiliser`Update-EC2SecurityGroupRuleIngressDescription`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la description d’une règle de trafic entrant pour le groupe de sécurité.**
```
$existingInboundRule = Get-EC2SecurityGroupRule -SecurityGroupRuleId "sgr-1234567890"
$ruleWithUpdatedDescription = [Amazon.EC2.Model.SecurityGroupRuleDescription]@{
"SecurityGroupRuleId" = $existingInboundRule.SecurityGroupRuleId
"Description" = "Updated rule description"
}
Update-EC2SecurityGroupRuleIngressDescription -GroupId $existingInboundRule.GroupId -SecurityGroupRuleDescription $ruleWithUpdatedDescription
```
**Exemple 2 : supprime la description d’une règle de groupe de sécurité d’entrée (entrante) existante (en omettant le paramètre dans la demande).**
```
$existingInboundRule = Get-EC2SecurityGroupRule -SecurityGroupRuleId "sgr-1234567890"
$ruleWithoutDescription = [Amazon.EC2.Model.SecurityGroupRuleDescription]@{
"SecurityGroupRuleId" = $existingInboundRule.SecurityGroupRuleId
}
Update-EC2SecurityGroupRuleIngressDescription -GroupId $existingInboundRule.GroupId -SecurityGroupRuleDescription $ruleWithoutDescription
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateSecurityGroupRuleDescriptionsIngress](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Amazon ECR utilisant Tools for V4 PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Amazon ECR.
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
### `Get-ECRLoginCommand`
L'exemple de code suivant montre comment utiliser`Get-ECRLoginCommand`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie un fichier PSObject contenant des informations de connexion qui peuvent être utilisées pour s'authentifier auprès de n'importe quel registre Amazon ECR auquel votre principal IAM a accès. Les informations d’identification et le point de terminaison régional requis pour l’appel afin d’obtenir le jeton d’autorisation sont obtenus à partir des paramètres par défaut du shell (définis par les applets de commande `Set-AWSCredential/Set-DefaultAWSRegion` ou `Initialize-AWSDefaultConfiguration`). Vous pouvez utiliser la propriété Command avec Invoke-Expression pour vous connecter au registre spécifié ou utiliser les informations d’identification renvoyées dans d’autres outils nécessitant une connexion.**
```
Get-ECRLoginCommand
```
**Sortie** :
```
Username : AWS
Password : eyJwYXlsb2Fk...kRBVEFfS0VZIn0=
ProxyEndpoint : https://123456789012.dkr.ecr.us-west-2.amazonaws.com
Endpoint : https://123456789012.dkr.ecr.us-west-2.amazonaws.com
ExpiresAt : 9/26/2017 6:08:23 AM
Command : docker login --username AWS --password eyJwYXlsb2Fk...kRBVEFfS0VZIn0= https://123456789012.dkr.ecr.us-west-2.amazonaws.com
```
**Exemple 2 : récupère un PSObject conteneur d'informations de connexion que vous utilisez comme entrée pour une commande de connexion docker. Vous pouvez spécifier n’importe quel URI de registre Amazon ECR auquel vous authentifier tant que votre principal IAM a accès à ce registre.**
```
(Get-ECRLoginCommand).Password | docker login --username AWS --password-stdin 012345678910.dkr.ecr.us-east-1.amazonaws.com
```
+ Pour plus de détails sur l'API, consultez la section [Get- ECRLogin Command](https://docs.aws.amazon.com/powershell/v4/reference) in *Outils AWS pour PowerShell Cmdlet Reference (V4)*.
# Exemples d'Amazon ECS utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Amazon ECS.
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
### `Get-ECSClusterDetail`
L'exemple de code suivant montre comment utiliser`Get-ECSClusterDetail`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande décrit un ou plusieurs de vos clusters ECS.**
```
Get-ECSClusterDetail -Cluster "LAB-ECS-CL" -Include SETTINGS | Select-Object *
```
**Sortie** :
```
LoggedAt : 12/27/2019 9:27:41 PM
Clusters : {LAB-ECS-CL}
Failures : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 396
HttpStatusCode : OK
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeClusters](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ECSClusterList`
L'exemple de code suivant montre comment utiliser`Get-ECSClusterList`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande renvoie une liste des clusters ECS existants.**
```
Get-ECSClusterList
```
**Sortie** :
```
arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS-CL
arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS
```
+ Pour plus de détails sur l'API, reportez-vous [ListClusters](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ECSClusterService`
L'exemple de code suivant montre comment utiliser`Get-ECSClusterService`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie tous les services en cours d’exécution dans votre cluster par défaut.**
```
Get-ECSClusterService
```
**Exemple 2 : cet exemple répertorie tous les services exécutés dans le cluster spécifié.**
```
Get-ECSClusterService -Cluster myCluster
```
+ Pour plus de détails sur l'API, reportez-vous [ListServices](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ECSService`
L'exemple de code suivant montre comment utiliser`Get-ECSService`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre comment extraire les détails d’un service spécifique à partir de votre cluster par défaut.**
```
Get-ECSService -Service my-hhtp-service
```
**Exemple 2 : cet exemple montre comment extraire les détails d’un service spécifique qui s’exécute dans le cluster nommé.**
```
Get-ECSService -Cluster myCluster -Service my-hhtp-service
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeServices](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ECSCluster`
L'exemple de code suivant montre comment utiliser`New-ECSCluster`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande crée un nouveau cluster Amazon ECS.**
```
New-ECSCluster -ClusterName "LAB-ECS-CL" -Setting @{Name="containerInsights"; Value="enabled"}
```
**Sortie** :
```
ActiveServicesCount : 0
Attachments : {}
AttachmentsStatus :
CapacityProviders : {}
ClusterArn : arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS-CL
ClusterName : LAB-ECS-CL
DefaultCapacityProviderStrategy : {}
PendingTasksCount : 0
RegisteredContainerInstancesCount : 0
RunningTasksCount : 0
Settings : {containerInsights}
Statistics : {}
Status : ACTIVE
Tags : {}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateCluster](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ECSService`
L'exemple de code suivant montre comment utiliser`New-ECSService`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple de commande crée un service dans votre cluster par défaut appelé `ecs-simple-service`. Le service utilise la définition de tâche « ecs-demo » et conserve dix instanciations de cette tâche.**
```
New-ECSService -ServiceName ecs-simple-service -TaskDefinition ecs-demo -DesiredCount 10
```
**Exemple 2 : Cet exemple de commande crée un service derrière un équilibreur de charge dans votre cluster par défaut appelé `ecs-simple-service`. Le service utilise la définition de tâche « ecs-demo » et conserve dix instanciations de cette tâche.**
```
$lb = @{
LoadBalancerName = "EC2Contai-EcsElast-S06278JGSJCM"
ContainerName = "simple-demo"
ContainerPort = 80
}
New-ECSService -ServiceName ecs-simple-service -TaskDefinition ecs-demo -DesiredCount 10 -LoadBalancer $lb
```
+ Pour plus de détails sur l'API, reportez-vous [CreateService](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ECSCluster`
L'exemple de code suivant montre comment utiliser`Remove-ECSCluster`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande supprime le cluster ECS spécifié. Vous devez annuler l’enregistrement de toutes les instances de conteneur de ce cluster avant de pouvoir le supprimer.**
```
Remove-ECSCluster -Cluster "LAB-ECS"
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ECSCluster (DeleteCluster)" on target "LAB-ECS".
[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 [DeleteCluster](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ECSService`
L'exemple de code suivant montre comment utiliser`Remove-ECSService`.
**Outils pour PowerShell V4**
**Exemple 1 : Supprime le service nommé « my-http-service » dans le cluster par défaut. Le service doit avoir le nombre souhaité et le nombre en cours d’exécution sur 0 pour que vous puissiez le supprimer. Vous devrez confirmer avant que la commande ne se poursuive. Pour contourner l’invite de confirmation, ajoutez le commutateur -Force.**
```
Remove-ECSService -Service my-http-service
```
**Exemple 2 : Supprime le service nommé « my-http-service » dans le cluster nommé.**
```
Remove-ECSService -Cluster myCluster -Service my-http-service
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteService](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-ECSClusterSetting`
L'exemple de code suivant montre comment utiliser`Update-ECSClusterSetting`.
**Outils pour PowerShell V4**
**Exemple 1 : cette applet de commande modifie les paramètres à utiliser pour un cluster ECS.**
```
Update-ECSClusterSetting -Cluster "LAB-ECS-CL" -Setting @{Name="containerInsights"; Value="disabled"}
```
**Sortie** :
```
ActiveServicesCount : 0
Attachments : {}
AttachmentsStatus :
CapacityProviders : {}
ClusterArn : arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS-CL
ClusterName : LAB-ECS-CL
DefaultCapacityProviderStrategy : {}
PendingTasksCount : 0
RegisteredContainerInstancesCount : 0
RunningTasksCount : 0
Settings : {containerInsights}
Statistics : {}
Status : ACTIVE
Tags : {}
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateClusterSettings](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-ECSService`
L'exemple de code suivant montre comment utiliser`Update-ECSService`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple de commande met à jour le service my-http-service `` pour utiliser la définition de tâche amazon-ecs-sample ``.**
```
Update-ECSService -Service my-http-service -TaskDefinition amazon-ecs-sample
```
**Exemple 2 : Cet exemple de commande met à jour le nombre souhaité du service my-http-service `` à 10.**
```
Update-ECSService -Service my-http-service -DesiredCount 10
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateService](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Amazon EFS utilisant Tools for PowerShell V4
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 V4 avec Amazon EFS.
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
### `Edit-EFSMountTargetSecurityGroup`
L'exemple de code suivant montre comment utiliser`Edit-EFSMountTargetSecurityGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : met à jour les groupes de sécurité en vigueur pour la cible de montage spécifiée. Jusqu’à cinq peuvent être spécifiés, au format « sg-xxxxxxxx ».**
```
Edit-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d -SecurityGroup sg-group1,sg-group3
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyMountTargetSecurityGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EFSFileSystem`
L'exemple de code suivant montre comment utiliser`Get-EFSFileSystem`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie la collection de tous les systèmes de fichiers appartenant au compte de l’appelant dans la région.**
```
Get-EFSFileSystem
```
**Sortie** :
```
CreationTime : 5/26/2015 4:02:38 PM
CreationToken : 1a2bff54-85e0-4747-bd95-7bc172c4f555
FileSystemId : fs-1a2b3c4d
LifeCycleState : available
Name :
NumberOfMountTargets : 0
OwnerId : 123456789012
SizeInBytes : Amazon.ElasticFileSystem.Model.FileSystemSize
CreationTime : 5/26/2015 4:06:23 PM
CreationToken : 2b4daa14-85e0-4747-bd95-7bc172c4f555
FileSystemId : fs-4d3c2b1a
...
```
**Exemple 2 : renvoie les détails du système de fichiers spécifié.**
```
Get-EFSFileSystem -FileSystemId fs-1a2b3c4d
```
**Exemple 3 : renvoie les détails d’un système de fichiers à l’aide du jeton de création d’idempotence spécifié au moment de la création du système de fichiers.**
```
Get-EFSFileSystem -CreationToken 1a2bff54-85e0-4747-bd95-7bc172c4f555
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeFileSystems](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EFSMountTarget`
L'exemple de code suivant montre comment utiliser`Get-EFSMountTarget`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie la collection de cibles de montage associées au système de fichiers spécifié.**
```
Get-EFSMountTarget -FileSystemId fs-1a2b3c4d
```
**Sortie** :
```
FileSystemId : fs-1a2b3c4d
IpAddress : 10.0.0.131
LifeCycleState : available
MountTargetId : fsmt-1a2b3c4d
NetworkInterfaceId : eni-1a2b3c4d
OwnerId : 123456789012
SubnetId : subnet-1a2b3c4d
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMountTargets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EFSMountTargetSecurityGroup`
L'exemple de code suivant montre comment utiliser`Get-EFSMountTargetSecurityGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les ID des groupes de sécurité actuellement affectés à l’interface réseau associée à la cible de montage.**
```
Get-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d
```
**Sortie** :
```
sg-1a2b3c4d
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMountTargetSecurityGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EFSTag`
L'exemple de code suivant montre comment utiliser`Get-EFSTag`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie la collection de balises actuellement associées au système de fichiers spécifié.**
```
Get-EFSTag -FileSystemId fs-1a2b3c4d
```
**Sortie** :
```
Key Value
--- -----
Name My File System
tagkey1 tagvalue1
tagkey2 tagvalue2
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EFSFileSystem`
L'exemple de code suivant montre comment utiliser`New-EFSFileSystem`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un nouveau système de fichiers vide. Le jeton utilisé pour garantir la création d’idempotence sera généré automatiquement et sera accessible à partir du membre `CreationToken` de l’objet renvoyé.**
```
New-EFSFileSystem
```
**Sortie** :
```
CreationTime : 5/26/2015 4:02:38 PM
CreationToken : 1a2bff54-85e0-4747-bd95-7bc172c4f555
FileSystemId : fs-1a2b3c4d
LifeCycleState : creating
Name :
NumberOfMountTargets : 0
OwnerId : 123456789012
SizeInBytes : Amazon.ElasticFileSystem.Model.FileSystemSize
```
**Exemple 2 : crée un nouveau système de fichiers vide à l’aide d’un jeton personnalisé pour garantir une création d’idempotence.**
```
New-EFSFileSystem -CreationToken "MyUniqueToken"
```
+ Pour plus de détails sur l'API, reportez-vous [CreateFileSystem](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EFSMountTarget`
L'exemple de code suivant montre comment utiliser`New-EFSMountTarget`.
**Outils pour PowerShell V4**
**Exemple 1 : crée une cible de montage pour un système de fichiers. Le sous-réseau spécifié sera utilisé pour déterminer le cloud privé virtuel (VPC) dans lequel la cible de montage sera créée et l’adresse IP qui sera attribuée automatiquement (à partir de la plage d’adresses du sous-réseau). L’adresse IP attribuée peut être utilisée pour ensuite monter ce système de fichiers sur une instance Amazon EC2. Aucun groupe de sécurité n’ayant été spécifié, l’interface réseau créée pour la cible est associée au groupe de sécurité par défaut pour le VPC du sous-réseau.**
```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d
```
**Sortie** :
```
FileSystemId : fs-1a2b3c4d
IpAddress : 10.0.0.131
LifeCycleState : creating
MountTargetId : fsmt-1a2b3c4d
NetworkInterfaceId : eni-1a2b3c4d
OwnerId : 123456789012
SubnetId : subnet-1a2b3c4d
```
**Exemple 2 : crée une nouvelle cible de montage pour le système de fichiers spécifié avec une adresse IP attribuée automatiquement. L’interface réseau créée pour la cible de montage est associée aux groupes de sécurité spécifiés (jusqu’à cinq, au format « sg-xxxxxxxx », peuvent être spécifiés).**
```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -SecurityGroup sg-group1,sg-group2,sg-group3
```
**Exemple 3 : crée une nouvelle cible de montage pour le système de fichiers spécifié avec l’adresse IP spécifiée.**
```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -IpAddress 10.0.0.131
```
+ Pour plus de détails sur l'API, reportez-vous [CreateMountTarget](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EFSTag`
L'exemple de code suivant montre comment utiliser`New-EFSTag`.
**Outils pour PowerShell V4**
**Exemple 1 : applique la collection de balises au système de fichiers spécifié. Si une balise dont la clé est spécifiée existe déjà dans le système de fichiers, la valeur de la balise est mise à jour.**
```
New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="tagkey1";Value="tagvalue1"},@{Key="tagkey2";Value="tagvalue2"}
```
**Exemple 2 : définit la balise de nom pour le système de fichiers spécifié. Cette valeur est renvoyée avec d'autres détails du système de fichiers lorsque l' Get-EFSFileSystem applet de commande est utilisée.**
```
New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="Name";Value="My File System"}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EFSFileSystem`
L'exemple de code suivant montre comment utiliser`Remove-EFSFileSystem`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime le système de fichiers spécifié qui n’est plus utilisé (si le système de fichiers possède des cibles de montage, elles doivent d’abord être supprimées). Vous devez confirmer avant que l’applet de commande ne démarre. Pour supprimer la confirmation, utilisez le commutateur `-Force`.**
```
Remove-EFSFileSystem -FileSystemId fs-1a2b3c4d
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteFileSystem](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EFSMountTarget`
L'exemple de code suivant montre comment utiliser`Remove-EFSMountTarget`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime la cible de montage spécifiée. Vous êtes invité à confirmer avant de poursuivre l’opération. Pour supprimer l’invite, utilisez le commutateur `-Force`. Notez que cette opération interrompt de force tous les montages du système de fichiers via la cible. Vous pouvez envisager de démonter le système de fichiers avant d’exécuter cette commande, si possible.**
```
Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteMountTarget](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EFSTag`
L'exemple de code suivant montre comment utiliser`Remove-EFSTag`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime la collection d’une ou plusieurs balises d’un système de fichiers. Vous devez confirmer avant que l’applet de commande ne démarre. Pour supprimer la confirmation, utilisez le commutateur `-Force`.**
```
Remove-EFSTag -FileSystemId fs-1a2b3c4d -TagKey "tagkey1","tagkey2"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Amazon EKS utilisant Tools for PowerShell V4
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 V4 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 V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EKSCluster`
L'exemple de code suivant montre comment utiliser`Get-EKSCluster`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EKSClusterList`
L'exemple de code suivant montre comment utiliser`Get-EKSClusterList`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EKSFargateProfile`
L'exemple de code suivant montre comment utiliser`Get-EKSFargateProfile`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EKSFargateProfileList`
L'exemple de code suivant montre comment utiliser`Get-EKSFargateProfileList`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EKSNodegroup`
L'exemple de code suivant montre comment utiliser`Get-EKSNodegroup`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EKSNodegroupList`
L'exemple de code suivant montre comment utiliser`Get-EKSNodegroupList`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EKSResourceTag`
L'exemple de code suivant montre comment utiliser`Get-EKSResourceTag`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EKSUpdate`
L'exemple de code suivant montre comment utiliser`Get-EKSUpdate`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-EKSUpdateList`
L'exemple de code suivant montre comment utiliser`Get-EKSUpdateList`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EKSCluster`
L'exemple de code suivant montre comment utiliser`New-EKSCluster`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EKSFargateProfile`
L'exemple de code suivant montre comment utiliser`New-EKSFargateProfile`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-EKSNodeGroup`
L'exemple de code suivant montre comment utiliser`New-EKSNodeGroup`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EKSCluster`
L'exemple de code suivant montre comment utiliser`Remove-EKSCluster`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EKSFargateProfile`
L'exemple de code suivant montre comment utiliser`Remove-EKSFargateProfile`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EKSNodegroup`
L'exemple de code suivant montre comment utiliser`Remove-EKSNodegroup`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-EKSResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-EKSResourceTag`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-EKSClusterConfig`
L'exemple de code suivant montre comment utiliser`Update-EKSClusterConfig`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-EKSClusterVersion`
L'exemple de code suivant montre comment utiliser`Update-EKSClusterVersion`.
**Outils pour PowerShell V4**
**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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Elastic Load Balancing - Exemples de version 1 utilisant Tools for PowerShell V4
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 V4 avec Elastic Load Balancing - Version 1.
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-ELBLoadBalancerToSubnet`
L'exemple de code suivant montre comment utiliser`Add-ELBLoadBalancerToSubnet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute le sous-réseau spécifié à l’ensemble de sous-réseaux configurés pour l’équilibreur de charge spécifié. La sortie inclut la liste complète des sous-réseaux.**
```
Add-ELBLoadBalancerToSubnet -LoadBalancerName my-load-balancer -Subnet subnet-12345678
```
**Sortie** :
```
subnet-12345678
subnet-87654321
```
+ Pour plus de détails sur l'API, reportez-vous [AttachLoadBalancerToSubnets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-ELBResourceTag`
L'exemple de code suivant montre comment utiliser`Add-ELBResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute les balises spécifiées à l’équilibreur de charge spécifié. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
Add-ELBResourceTag -LoadBalancerName my-load-balancer -Tag @{ Key="project";Value="lima" },@{ Key="department";Value="digital-media" }
```
**Exemple 2 : avec PowerShell la version 2, vous devez utiliser New-Object pour créer une balise pour le paramètre Tag.**
```
$tag = New-Object Amazon.ElasticLoadBalancing.Model.Tag
$tag.Key = "project"
$tag.Value = "lima"
Add-ELBResourceTag -LoadBalancerName my-load-balancer -Tag $tag
```
+ Pour plus de détails sur l'API, reportez-vous [AddTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Disable-ELBAvailabilityZoneForLoadBalancer`
L'exemple de code suivant montre comment utiliser`Disable-ELBAvailabilityZoneForLoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la zone de disponibilité spécifiée de l’équilibreur de charge spécifié. La sortie inclut les zones de disponibilité restantes.**
```
Disable-ELBAvailabilityZoneForLoadBalancer -LoadBalancerName my-load-balancer -AvailabilityZone us-west-2a
```
**Sortie** :
```
us-west-2b
```
+ Pour plus de détails sur l'API, reportez-vous [DisableAvailabilityZonesForLoadBalancer](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Dismount-ELBLoadBalancerFromSubnet`
L'exemple de code suivant montre comment utiliser`Dismount-ELBLoadBalancerFromSubnet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le sous-réseau spécifié de l’ensemble de sous-réseaux configurés pour l’équilibreur de charge spécifié. La sortie inclut les sous-réseaux restants.**
```
Dismount-ELBLoadBalancerFromSubnet -LoadBalancerName my-load-balancer -Subnet subnet-12345678
```
**Sortie** :
```
subnet-87654321
```
+ Pour plus de détails sur l'API, reportez-vous [DetachLoadBalancerFromSubnets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-ELBLoadBalancerAttribute`
L'exemple de code suivant montre comment utiliser`Edit-ELBLoadBalancerAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active l’équilibrage de charge entre zones pour l’équilibreur de charge spécifié.**
```
Edit-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer -CrossZoneLoadBalancing_Enabled $true
```
**Exemple 2 : cet exemple désactive le drainage de la connexion pour l’équilibreur de charge spécifié.**
```
Edit-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer -ConnectionDraining_Enabled $false
```
**Exemple 3 : cet exemple active la journalisation des accès pour l’équilibreur de charge spécifié.**
```
Edit-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer `
>> -AccessLog_Enabled $true `
>> -AccessLog_S3BucketName amzn-s3-demo-logging-bucket `
>> -AccessLog_S3BucketPrefix my-app/prod `
>> -AccessLog_EmitInterval 60
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyLoadBalancerAttributes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-ELBAvailabilityZoneForLoadBalancer`
L'exemple de code suivant montre comment utiliser`Enable-ELBAvailabilityZoneForLoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute la zone de disponibilité spécifiée à l’équilibreur de charge spécifié. La sortie inclut la liste complète des zones de disponibilité.**
```
Enable-ELBAvailabilityZoneForLoadBalancer -LoadBalancerName my-load-balancer -AvailabilityZone us-west-2a
```
**Sortie** :
```
us-west-2a
us-west-2b
```
+ Pour plus de détails sur l'API, reportez-vous [EnableAvailabilityZonesForLoadBalancer](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELBInstanceHealth`
L'exemple de code suivant montre comment utiliser`Get-ELBInstanceHealth`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’état des instances enregistrées auprès de l’équilibreur de charge spécifié.**
```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer
```
**Sortie** :
```
Description InstanceId ReasonCode State
----------- ---------- ---------- -----
N/A i-87654321 N/A InService
Instance has failed at lea... i-12345678 Instance OutOfService
```
**Exemple 2 : cet exemple décrit l’état de l’instances spécifiée enregistrée auprès de l’équilibreur de charge spécifié.**
```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Exemple 3 : cet exemple affiche la description complète de l’état de l’instance spécifiée.**
```
(Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678).Description
```
**Sortie** :
```
Instance has failed at least the UnhealthyThreshold number of health checks consecutively.
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstanceHealth](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELBLoadBalancer`
L'exemple de code suivant montre comment utiliser`Get-ELBLoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les noms de vos équilibreurs de charge.**
```
Get-ELBLoadBalancer | format-table -property LoadBalancerName
```
**Sortie** :
```
LoadBalancerName
----------------
my-load-balancer
my-other-load-balancer
my-internal-load-balancer
```
**Exemple 2 : cet exemple décrit l’équilibreur de charge spécifié.**
```
Get-ELBLoadBalancer -LoadBalancerName my-load-balancer
```
**Sortie** :
```
AvailabilityZones : {us-west-2a, us-west-2b}
BackendServerDescriptions : {Amazon.ElasticLoadBalancing.Model.BackendServerDescription}
CanonicalHostedZoneName : my-load-balancer-1234567890.us-west-2.elb.amazonaws.com
CanonicalHostedZoneNameID : Z3DZXE0EXAMPLE
CreatedTime : 4/11/2015 12:12:45 PM
DNSName : my-load-balancer-1234567890.us-west-2.elb.amazonaws.com
HealthCheck : Amazon.ElasticLoadBalancing.Model.HealthCheck
Instances : {i-207d9717, i-afefb49b}
ListenerDescriptions : {Amazon.ElasticLoadBalancing.Model.ListenerDescription}
LoadBalancerName : my-load-balancer
Policies : Amazon.ElasticLoadBalancing.Model.Policies
Scheme : internet-facing
SecurityGroups : {sg-a61988c3}
SourceSecurityGroup : Amazon.ElasticLoadBalancing.Model.SourceSecurityGroup
Subnets : {subnet-15aaab61}
VPCId : vpc-a01106c2
```
**Exemple 3 : Cet exemple décrit tous vos équilibreurs de charge dans la AWS région actuelle.**
```
Get-ELBLoadBalancer
```
**Exemple 4 : cet exemple décrit tous vos équilibreurs de charge dans toutes les Régions AWS disponibles.**
```
Get-AWSRegion | % { Get-ELBLoadBalancer -Region $_ }
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLoadBalancers](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELBLoadBalancerAttribute`
L'exemple de code suivant montre comment utiliser`Get-ELBLoadBalancerAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les attributs de l’équilibreur de charge spécifié.**
```
Get-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer
```
**Sortie** :
```
AccessLog : Amazon.ElasticLoadBalancing.Model.AccessLog
AdditionalAttributes : {}
ConnectionDraining : Amazon.ElasticLoadBalancing.Model.ConnectionDraining
ConnectionSettings : Amazon.ElasticLoadBalancing.Model.ConnectionSettings
CrossZoneLoadBalancing : Amazon.ElasticLoadBalancing.Model.CrossZoneLoadBalancing
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLoadBalancerAttributes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELBLoadBalancerPolicy`
L'exemple de code suivant montre comment utiliser`Get-ELBLoadBalancerPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit toutes les politiques associées à l’équilibreur de charge spécifié.**
```
Get-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer
```
**Sortie** :
```
PolicyAttributeDescriptions PolicyName PolicyTypeName
--------------------------- ---------- --------------
{ProxyProtocol} my-ProxyProtocol-policy ProxyProtocolPolicyType
{CookieName} my-app-cookie-policy AppCookieStickinessPolicyType
```
**Exemple 2 : cet exemple décrit les attributs de la politique spécifiée.**
```
(Get-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer -PolicyName my-ProxyProtocol-policy).PolicyAttributeDescriptions
```
**Sortie** :
```
AttributeName AttributeValue
------------- --------------
ProxyProtocol true
```
**Exemple 3 : cet exemple décrit les politiques prédéfinies, y compris les exemples de politiques. Les noms des exemples de politiques comportent le préfixe ELBSample -.**
```
Get-ELBLoadBalancerPolicy
```
**Sortie** :
```
PolicyAttributeDescriptions PolicyName PolicyTypeName
--------------------------- ---------- --------------
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2015-05 SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2015-03 SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2015-02 SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2014-10 SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2014-01 SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSecurityPolicy-2011-08 SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSample-ELBDefaultCipherPolicy SSLNegotiationPolicyType
{Protocol-SSLv2, Protocol-TLSv1, Pro... ELBSample-OpenSSLDefaultCipherPolicy SSLNegotiationPolicyType
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLoadBalancerPolicies](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELBLoadBalancerPolicyType`
L'exemple de code suivant montre comment utiliser`Get-ELBLoadBalancerPolicyType`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient les types de politiques pris en charge par Elastic Load Balancing.**
```
Get-ELBLoadBalancerPolicyType
```
**Sortie** :
```
Description PolicyAttributeTypeDescriptions PolicyTypeName
----------- ------------------------------- --------------
Stickiness policy with session lifet... {CookieExpirationPeriod} LBCookieStickinessPolicyType
Policy that controls authentication ... {PublicKeyPolicyName} BackendServerAuthenticationPolicyType
Listener policy that defines the cip... {Protocol-SSLv2, Protocol-TLSv1, Pro... SSLNegotiationPolicyType
Policy containing a list of public k... {PublicKey} PublicKeyPolicyType
Stickiness policy with session lifet... {CookieName} AppCookieStickinessPolicyType
Policy that controls whether to incl... {ProxyProtocol} ProxyProtocolPolicyType
```
**Exemple 2 : cet exemple décrit le type de politique spécifié.**
```
Get-ELBLoadBalancerPolicyType -PolicyTypeName ProxyProtocolPolicyType
```
**Sortie** :
```
Description PolicyAttributeTypeDescriptions PolicyTypeName
----------- ------------------------------- --------------
Policy that controls whether to incl... {ProxyProtocol} ProxyProtocolPolicyType
```
**Exemple 3 : cet exemple affiche la description complète du type de politique spécifié.**
```
(Get-ELBLoadBalancerPolicyType -PolicyTypeName).Description
```
**Sortie** :
```
Policy that controls whether to include the IP address and port of the originating request for TCP messages.
This policy operates on TCP/SSL listeners only
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLoadBalancerPolicyTypes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELBResourceTag`
L'exemple de code suivant montre comment utiliser`Get-ELBResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les balises pour les équilibreurs de charge spécifiés.**
```
Get-ELBResourceTag -LoadBalancerName @("my-load-balancer","my-internal-load-balancer")
```
**Sortie** :
```
LoadBalancerName Tags
---------------- ----
my-load-balancer {project, department}
my-internal-load-balancer {project, department}
```
**Exemple 2 : cet exemple décrit les balises de l’équilibreur de charge spécifié.**
```
(Get-ELBResourceTag -LoadBalancerName my-load-balancer).Tags
```
**Sortie** :
```
Key Value
--- -----
project lima
department digital-media
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Join-ELBSecurityGroupToLoadBalancer`
L'exemple de code suivant montre comment utiliser`Join-ELBSecurityGroupToLoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple remplace le groupe de sécurité actuel pour l’équilibreur de charge spécifié par le groupe de sécurité spécifié.**
```
Join-ELBSecurityGroupToLoadBalancer -LoadBalancerName my-load-balancer -SecurityGroup sg-87654321
```
**Sortie** :
```
sg-87654321
```
**Exemple 2 : pour conserver le groupe de sécurité actuel et en spécifier un autre, spécifiez les deux groupes de sécurité existants et nouveaux.**
```
Join-ELBSecurityGroupToLoadBalancer -LoadBalancerName my-load-balancer -SecurityGroup @("sg-12345678", "sg-87654321")
```
**Sortie** :
```
sg-12345678
sg-87654321
```
+ Pour plus de détails sur l'API, reportez-vous [ApplySecurityGroupsToLoadBalancer](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ELBAppCookieStickinessPolicy`
L'exemple de code suivant montre comment utiliser`New-ELBAppCookieStickinessPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une stratégie de permanence qui suit les durées de vie des sessions permanentes du cookie généré par l’application spécifié.**
```
New-ELBAppCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-app-cookie-policy -CookieName my-app-cookie
```
+ Pour plus de détails sur l'API, reportez-vous [CreateAppCookieStickinessPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ELBLBCookieStickinessPolicy`
L'exemple de code suivant montre comment utiliser`New-ELBLBCookieStickinessPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une stratégie de permanence avec les durées de vie des sessions permanentes contrôlée par la période d’expiration spécifiée (en secondes).**
```
New-ELBLBCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy -CookieExpirationPeriod 60
```
**Exemple 2 : cet exemple crée une stratégie de permanence avec les durées de vie des sessions permanentes contrôlée par la durée de vie du navigateur (user-agent).**
```
New-ELBLBCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLbCookieStickinessPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ELBLoadBalancer`
L'exemple de code suivant montre comment utiliser`New-ELBLoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un équilibreur de charge avec un écouteur HTTP dans un VPC.**
```
$httpListener = New-Object Amazon.ElasticLoadBalancing.Model.Listener
$httpListener.Protocol = "http"
$httpListener.LoadBalancerPort = 80
$httpListener.InstanceProtocol = "http"
$httpListener.InstancePort = 80
New-ELBLoadBalancer -LoadBalancerName my-vpc-load-balancer -SecurityGroup sg-a61988c3 -Subnet subnet-15aaab61 -Listener $httpListener
my-vpc-load-balancer-1234567890.us-west-2.elb.amazonaws.com
```
**Exemple 2 : cet exemple crée un équilibreur de charge avec un écouteur HTTP dans EC2-Classic.**
```
New-ELBLoadBalancer -LoadBalancerName my-classic-load-balancer -AvailabilityZone us-west-2a` -Listener $httpListener
```
**Sortie** :
```
my-classic-load-balancer-123456789.us-west-2.elb.amazonaws.com
```
**Exemple 3 : cet exemple crée un équilibreur de charge avec un écouteur HTTP.**
```
$httpsListener = New-Object Amazon.ElasticLoadBalancing.Model.Listener
$httpsListener.Protocol = "https"
$httpsListener.LoadBalancerPort = 443
$httpsListener.InstanceProtocol = "http"
$httpsListener.InstancePort = 80
$httpsListener.SSLCertificateId="arn:aws:iam::123456789012:server-certificate/my-server-cert"
New-ELBLoadBalancer -LoadBalancerName my-load-balancer -AvailabilityZone us-west-2a -Listener $httpsListener
my-load-balancer-123456789.us-west-2.elb.amazonaws.com
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLoadBalancer](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ELBLoadBalancerListener`
L'exemple de code suivant montre comment utiliser`New-ELBLoadBalancerListener`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute un écouteur HTTPS à l’équilibreur de charge spécifié.**
```
$httpsListener = New-Object Amazon.ElasticLoadBalancing.Model.Listener
$httpsListener.Protocol = "https"
$httpsListener.LoadBalancerPort = 443
$httpsListener.InstanceProtocol = "https"
$httpsListener.InstancePort = 443
$httpsListener.SSLCertificateId="arn:aws:iam::123456789012:server-certificate/my-server-cert"
New-ELBLoadBalancerListener -LoadBalancerName my-load-balancer -Listener $httpsListener
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLoadBalancerListeners](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ELBLoadBalancerPolicy`
L'exemple de code suivant montre comment utiliser`New-ELBLoadBalancerPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une nouvelle politique de protocole proxy pour un équilibreur de charge spécifié.**
```
$attribute = New-Object Amazon.ElasticLoadBalancing.Model.PolicyAttribute -Property @{
AttributeName="ProxyProtocol"
AttributeValue="True"
}
New-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer -PolicyName my-ProxyProtocol-policy -PolicyTypeName ProxyProtocolPolicyType -PolicyAttribute $attribute
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLoadBalancerPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-ELBInstanceWithLoadBalancer`
L'exemple de code suivant montre comment utiliser`Register-ELBInstanceWithLoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre l’instance EC2 spécifiée auprès de l’équilibreur de charge spécifié.**
```
Register-ELBInstanceWithLoadBalancer -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Sortie** :
```
InstanceId
----------
i-12345678
i-87654321
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterInstancesWithLoadBalancer](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ELBInstanceFromLoadBalancer`
L'exemple de code suivant montre comment utiliser`Remove-ELBInstanceFromLoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’instance EC2 spécifiée de l’équilibreur de charge spécifié. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-ELBInstanceFromLoadBalancer -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ELBInstanceFromLoadBalancer (DeregisterInstancesFromLoadBalancer)" on Target
"Amazon.ElasticLoadBalancing.Model.Instance".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
InstanceId
----------
i-87654321
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterInstancesFromLoadBalancer](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ELBLoadBalancer`
L'exemple de code suivant montre comment utiliser`Remove-ELBLoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’équilibreur de charge spécifié. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-ELBLoadBalancer -LoadBalancerName my-load-balancer
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ELBLoadBalancer (DeleteLoadBalancer)" on Target "my-load-balancer".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLoadBalancer](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ELBLoadBalancerListener`
L'exemple de code suivant montre comment utiliser`Remove-ELBLoadBalancerListener`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’écouteur sur le port 80 pour l’équilibreur de charge spécifié. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-ELBLoadBalancerListener -LoadBalancerName my-load-balancer -LoadBalancerPort 80
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ELBLoadBalancerListener (DeleteLoadBalancerListeners)" on Target "80".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLoadBalancerListeners](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ELBLoadBalancerPolicy`
L'exemple de code suivant montre comment utiliser`Remove-ELBLoadBalancerPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la politique spécifiée pour l’équilibreur de charge spécifié. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force.**
```
Remove-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing operation "Remove-ELBLoadBalancerPolicy (DeleteLoadBalancerPolicy)" on Target "my-duration-cookie-policy".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLoadBalancerPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ELBResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-ELBResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la balise spécifiée de l’équilibreur de charge spécifié. Vous devrez confirmer avant de poursuivre l’opération, sauf si vous spécifiez également le paramètre Force. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
Remove-ELBResourceTag -LoadBalancerName my-load-balancer -Tag @{ Key="project" }
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ELBResourceTag (RemoveTags)" on target "Amazon.ElasticLoadBalancing.Model.TagKeyOnly".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
```
**Exemple 2 : avec PowerShell version 2, vous devez utiliser New-Object pour créer la balise pour le paramètre Balise.**
```
$tag = New-Object Amazon.ElasticLoadBalancing.Model.TagKeyOnly
$tag.Key = "project"
Remove-ELBResourceTag -Tag $tag -Force
```
+ Pour plus de détails sur l'API, reportez-vous [RemoveTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ELBHealthCheck`
L'exemple de code suivant montre comment utiliser`Set-ELBHealthCheck`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple configure les paramètres de surveillance de l’état de l’équilibreur de charge spécifié.**
```
Set-ELBHealthCheck -LoadBalancerName my-load-balancer `
>> -HealthCheck_HealthyThreshold 2 `
>> -HealthCheck_UnhealthyThreshold 2 `
>> -HealthCheck_Target "HTTP:80/ping" `
>> -HealthCheck_Interval 30 `
>> -HealthCheck_Timeout 3
```
**Sortie** :
```
HealthyThreshold : 2
Interval : 30
Target : HTTP:80/ping
Timeout : 3
UnhealthyThreshold : 2
```
+ Pour plus de détails sur l'API, reportez-vous [ConfigureHealthCheck](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ELBLoadBalancerListenerSSLCertificate`
L'exemple de code suivant montre comment utiliser`Set-ELBLoadBalancerListenerSSLCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple remplace le certificat qui résilie les connexions SSL pour l’écouteur spécifié.**
```
Set-ELBLoadBalancerListenerSSLCertificate -LoadBalancerName my-load-balancer `
>> -LoadBalancerPort 443 `
>> -SSLCertificateId "arn:aws:iam::123456789012:server-certificate/new-server-cert"
```
+ Pour plus de détails sur l'API, reportez-vous [SetLoadBalancerListenerSslCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ELBLoadBalancerPolicyForBackendServer`
L'exemple de code suivant montre comment utiliser`Set-ELBLoadBalancerPolicyForBackendServer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple remplace les politiques du port spécifié par la politique spécifiée.**
```
Set-ELBLoadBalancerPolicyForBackendServer -LoadBalancerName my-load-balancer -InstancePort 80 -PolicyName my-ProxyProtocol-policy
```
**Exemple 2 : cet exemple supprime toutes les politiques associées au port spécifié.**
```
Set-ELBLoadBalancerPolicyForBackendServer -LoadBalancerName my-load-balancer -InstancePort 80
```
+ Pour plus de détails sur l'API, reportez-vous [SetLoadBalancerPoliciesForBackendServer](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ELBLoadBalancerPolicyOfListener`
L'exemple de code suivant montre comment utiliser`Set-ELBLoadBalancerPolicyOfListener`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple remplace les politiques de l’écouteur spécifié par la politique spécifiée.**
```
Set-ELBLoadBalancerPolicyOfListener -LoadBalancerName my-load-balancer -LoadBalancerPort 443 -PolicyName my-SSLNegotiation-policy
```
**Exemple 2 : cet exemple supprime toutes les politiques associées à l’écouteur spécifié.**
```
Set-ELBLoadBalancerPolicyOfListener -LoadBalancerName my-load-balancer -LoadBalancerPort 443
```
+ Pour plus de détails sur l'API, reportez-vous [SetLoadBalancerPoliciesOfListener](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Elastic Load Balancing - Exemples de version 2 utilisant Tools for PowerShell V4
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 V4 avec Elastic Load Balancing - Version 2.
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-ELB2ListenerCertificate`
L'exemple de code suivant montre comment utiliser`Add-ELB2ListenerCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute un certificat supplémentaire à l’écouteur spécifié.**
```
Add-ELB2ListenerCertificate -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/3873f123b98f7618' -Certificate @{CertificateArn = 'arn:aws:acm:us-east-1:123456789012:certificate/19478bd5-491d-47d4-b1d7-5217feba1d97'}
```
**Sortie** :
```
CertificateArn IsDefault
-------------- ---------
arn:aws:acm:us-east-1:123456789012:certificate/19478bd5-491d-47d4-b1d7-5217feba1d97 False
```
+ Pour plus de détails sur l'API, reportez-vous [AddListenerCertificates](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-ELB2Tag`
L'exemple de code suivant montre comment utiliser`Add-ELB2Tag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute une balise à la ressource `AWS.Tools.ElasticLoadBalancingV2` spécifiée.**
```
Add-ELB2Tag -ResourceArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -Tag @{Key = 'productVersion'; Value = '1.0.0'}
```
+ Pour plus de détails sur l'API, reportez-vous [AddTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-ELB2Listener`
L'exemple de code suivant montre comment utiliser`Edit-ELB2Listener`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie l’action par défaut des écouteurs spécifiés en réponse fixe.**
```
$newDefaultAction = [Amazon.ElasticLoadBalancingV2.Model.Action]@{
"FixedResponseConfig" = @{
"ContentType" = "text/plain"
"MessageBody" = "Hello World"
"StatusCode" = "200"
}
"Type" = [Amazon.ElasticLoadBalancingV2.ActionTypeEnum]::FixedResponse
}
Edit-ELB2Listener -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/testALB/3e2f03b558e19676/d19f2f14974db685' -Port 8080 -DefaultAction $newDefaultAction
```
**Sortie** :
```
Certificates : {}
DefaultActions : {Amazon.ElasticLoadBalancingV2.Model.Action}
ListenerArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/testALB/3e2f03b558e19676/d19f2f14974db685
LoadBalancerArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/testALB/3e2f03b558e19676
Port : 8080
Protocol : HTTP
SslPolicy :
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyListener](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-ELB2LoadBalancerAttribute`
L'exemple de code suivant montre comment utiliser`Edit-ELB2LoadBalancerAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie les attributs de l’équilibreur de charge spécifié.**
```
Edit-ELB2LoadBalancerAttribute -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -Attribute @{Key = 'deletion_protection.enabled'; Value = 'true'}
```
**Sortie** :
```
Key Value
--- -----
deletion_protection.enabled true
access_logs.s3.enabled false
access_logs.s3.bucket
access_logs.s3.prefix
idle_timeout.timeout_seconds 60
routing.http2.enabled true
routing.http.drop_invalid_header_fields.enabled false
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyLoadBalancerAttributes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-ELB2Rule`
L'exemple de code suivant montre comment utiliser`Edit-ELB2Rule`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie les configurations de règles d’écouteur spécifiées.**
```
$newRuleCondition = [Amazon.ElasticLoadBalancingV2.Model.RuleCondition]@{
"PathPatternConfig" = @{
"Values" = "/login1","/login2","/login3"
}
"Field" = "path-pattern"
}
Edit-ELB2Rule -RuleArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/testALB/3e2f03b558e19676/1c84f02aec143e80/f4f51dfaa033a8cc' -Condition $newRuleCondition
```
**Sortie** :
```
Actions : {Amazon.ElasticLoadBalancingV2.Model.Action}
Conditions : {Amazon.ElasticLoadBalancingV2.Model.RuleCondition}
IsDefault : False
Priority : 10
RuleArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/testALB/3e2f03b558e19676/1c84f02aec143e80/f4f51dfaa033a8cc
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyRule](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-ELB2TargetGroup`
L'exemple de code suivant montre comment utiliser`Edit-ELB2TargetGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie les propriétés du groupe cible spécifié.**
```
Edit-ELB2TargetGroup -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970' -HealthCheckIntervalSecond 60 -HealthCheckPath '/index.html' -HealthCheckPort 8080
```
**Sortie** :
```
HealthCheckEnabled : True
HealthCheckIntervalSeconds : 60
HealthCheckPath : /index.html
HealthCheckPort : 8080
HealthCheckProtocol : HTTP
HealthCheckTimeoutSeconds : 5
HealthyThresholdCount : 5
LoadBalancerArns : {}
Matcher : Amazon.ElasticLoadBalancingV2.Model.Matcher
Port : 80
Protocol : HTTP
TargetGroupArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970
TargetGroupName : test-tg
TargetType : instance
UnhealthyThresholdCount : 2
VpcId : vpc-2cfd7000
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyTargetGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-ELB2TargetGroupAttribute`
L'exemple de code suivant montre comment utiliser`Edit-ELB2TargetGroupAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie l’attribut deregistration\$1delay du groupe cible spécifié.**
```
Edit-ELB2TargetGroupAttribute -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970' -Attribute @{Key = 'deregistration_delay.timeout_seconds'; Value = 600}
```
**Sortie** :
```
Key Value
--- -----
stickiness.enabled false
deregistration_delay.timeout_seconds 600
stickiness.type lb_cookie
stickiness.lb_cookie.duration_seconds 86400
slow_start.duration_seconds 0
load_balancing.algorithm.type round_robin
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyTargetGroupAttributes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELB2AccountLimit`
L'exemple de code suivant montre comment utiliser`Get-ELB2AccountLimit`.
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande répertorie les limites de ELB2 compte pour une région donnée.**
```
Get-ELB2AccountLimit
```
**Sortie** :
```
Max Name
--- ----
3000 target-groups
1000 targets-per-application-load-balancer
50 listeners-per-application-load-balancer
100 rules-per-application-load-balancer
50 network-load-balancers
3000 targets-per-network-load-balancer
500 targets-per-availability-zone-per-network-load-balancer
50 listeners-per-network-load-balancer
5 condition-values-per-alb-rule
5 condition-wildcards-per-alb-rule
100 target-groups-per-application-load-balancer
5 target-groups-per-action-on-application-load-balancer
1 target-groups-per-action-on-network-load-balancer
50 application-load-balancers
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAccountLimits](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELB2Listener`
L'exemple de code suivant montre comment utiliser`Get-ELB2Listener`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les écouteurs de l’ALB/du NLB spécifié.**
```
Get-ELB2Listener -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f'
```
**Sortie** :
```
Certificates : {}
DefaultActions : {Amazon.ElasticLoadBalancingV2.Model.Action}
ListenerArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/1dac07c21187d41e
LoadBalancerArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f
Port : 80
Protocol : HTTP
SslPolicy :
Certificates : {Amazon.ElasticLoadBalancingV2.Model.Certificate}
DefaultActions : {Amazon.ElasticLoadBalancingV2.Model.Action}
ListenerArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/66e10e3aaf5b6d9b
LoadBalancerArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f
Port : 443
Protocol : HTTPS
SslPolicy : ELBSecurityPolicy-2016-08
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeListeners](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELB2ListenerCertificate`
L'exemple de code suivant montre comment utiliser`Get-ELB2ListenerCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le certificat de l’écouteur spécifié.**
```
Get-ELB2ListenerCertificate -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/66e10e3aaf5b6d9b'
```
**Sortie** :
```
CertificateArn IsDefault
-------------- ---------
arn:aws:acm:us-east-1:123456789012:certificate/5fc7c092-68bf-4862-969c-22fd48b6e17c True
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeListenerCertificates](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELB2LoadBalancer`
L'exemple de code suivant montre comment utiliser`Get-ELB2LoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche tous les équilibreurs de charge pour une région donnée.**
```
Get-ELB2LoadBalancer
```
**Sortie** :
```
AvailabilityZones : {us-east-1c}
CanonicalHostedZoneId : Z26RNL4JYFTOTI
CreatedTime : 6/22/18 11:21:50 AM
DNSName : test-elb1234567890-238d34ad8d94bc2e.elb.us-east-1.amazonaws.com
IpAddressType : ipv4
LoadBalancerArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/test-elb1234567890/238d34ad8d94bc2e
LoadBalancerName : test-elb1234567890
Scheme : internet-facing
SecurityGroups : {}
State : Amazon.ElasticLoadBalancingV2.Model.LoadBalancerState
Type : network
VpcId : vpc-2cf00000
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLoadBalancers](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELB2LoadBalancerAttribute`
L'exemple de code suivant montre comment utiliser`Get-ELB2LoadBalancerAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande décrit les attributs d’un équilibreur de charge donné.**
```
Get-ELB2LoadBalancerAttribute -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/test-elb/238d34ad8d94bc2e'
```
**Sortie** :
```
Key Value
--- -----
access_logs.s3.enabled false
load_balancing.cross_zone.enabled true
access_logs.s3.prefix
deletion_protection.enabled false
access_logs.s3.bucket
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLoadBalancerAttributes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELB2Rule`
L'exemple de code suivant montre comment utiliser`Get-ELB2Rule`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les règles d’écouteur pour l’ARN de l’écouteur spécifié.**
```
Get-ELB2Rule -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/66e10e3aaf5b6d9b'
```
**Sortie** :
```
Actions : {Amazon.ElasticLoadBalancingV2.Model.Action}
Conditions : {Amazon.ElasticLoadBalancingV2.Model.RuleCondition}
IsDefault : False
Priority : 1
RuleArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/test-alb/3651b4394dd9a24f/66e10e3aaf5b6d9b/2286fff5055e0f79
Actions : {Amazon.ElasticLoadBalancingV2.Model.Action}
Conditions : {Amazon.ElasticLoadBalancingV2.Model.RuleCondition}
IsDefault : False
Priority : 2
RuleArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/test-alb/3651b4394dd9a24f/66e10e3aaf5b6d9b/14e7b036567623ba
Actions : {Amazon.ElasticLoadBalancingV2.Model.Action}
Conditions : {}
IsDefault : True
Priority : default
RuleArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/test-alb/3651b4394dd9a24f/66e10e3aaf5b6d9b/853948cf3aa9b2bf
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeRules](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELB2SSLPolicy`
L'exemple de code suivant montre comment utiliser`Get-ELB2SSLPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple répertorie toutes les politiques d'écoute disponibles pour la ElasticLoadBalancing version 2.**
```
Get-ELB2SSLPolicy
```
**Sortie** :
```
Ciphers Name SslProtocols
------- ---- ------------
{ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-SHA256, ECDHE-RSA-AES128-SHA256} ELBSecurityPolicy-2016-08 {TLSv1, TLSv1.1, TLSv1.2}
{ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-SHA256, ECDHE-RSA-AES128-SHA256} ELBSecurityPolicy-TLS-1-2-2017-01 {TLSv1.2}
{ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-SHA256, ECDHE-RSA-AES128-SHA256} ELBSecurityPolicy-TLS-1-1-2017-01 {TLSv1.1, TLSv1.2}
{ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-SHA256, ECDHE-RSA-AES128-SHA256} ELBSecurityPolicy-TLS-1-2-Ext-2018-06 {TLSv1.2}
{ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-SHA256, ECDHE-RSA-AES128-SHA256} ELBSecurityPolicy-FS-2018-06 {TLSv1, TLSv1.1, TLSv1.2}
{ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-SHA256, ECDHE-RSA-AES128-SHA256} ELBSecurityPolicy-2015-05 {TLSv1, TLSv1.1, TLSv1.2}
{ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-SHA256, ECDHE-RSA-AES128-SHA256} ELBSecurityPolicy-TLS-1-0-2015-04 {TLSv1, TLSv1.1, TLSv1.2}
{ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-SHA256, ECDHE-RSA-AES128-SHA256} ELBSecurityPolicy-FS-1-2-Res-2019-08 {TLSv1.2}
{ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-SHA256, ECDHE-RSA-AES128-SHA256} ELBSecurityPolicy-FS-1-1-2019-08 {TLSv1.1, TLSv1.2}
{ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES128-SHA256, ECDHE-RSA-AES128-SHA256} ELBSecurityPolicy-FS-1-2-2019-08 {TLSv1.2}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSslPolicies](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELB2Tag`
L'exemple de code suivant montre comment utiliser`Get-ELB2Tag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les balises pour la ressource spécifiée.**
```
Get-ELB2Tag -ResourceArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f'
```
**Sortie** :
```
ResourceArn Tags
----------- ----
arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f {stage, internalName, version}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELB2TargetGroup`
L'exemple de code suivant montre comment utiliser`Get-ELB2TargetGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit le groupe cible spécifié.**
```
Get-ELB2TargetGroup -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970'
```
**Sortie** :
```
HealthCheckEnabled : True
HealthCheckIntervalSeconds : 30
HealthCheckPath : /
HealthCheckPort : traffic-port
HealthCheckProtocol : HTTP
HealthCheckTimeoutSeconds : 5
HealthyThresholdCount : 5
LoadBalancerArns : {arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f}
Matcher : Amazon.ElasticLoadBalancingV2.Model.Matcher
Port : 80
Protocol : HTTP
TargetGroupArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970
TargetGroupName : test-tg
TargetType : instance
UnhealthyThresholdCount : 2
VpcId : vpc-2cfd7000
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTargetGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELB2TargetGroupAttribute`
L'exemple de code suivant montre comment utiliser`Get-ELB2TargetGroupAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les attributs du groupe cible spécifié.**
```
Get-ELB2TargetGroupAttribute -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970'
```
**Sortie** :
```
Key Value
--- -----
stickiness.enabled false
deregistration_delay.timeout_seconds 300
stickiness.type lb_cookie
stickiness.lb_cookie.duration_seconds 86400
slow_start.duration_seconds 0
load_balancing.algorithm.type round_robin
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTargetGroupAttributes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ELB2TargetHealth`
L'exemple de code suivant montre comment utiliser`Get-ELB2TargetHealth`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie le statut de santé des cibles présentes dans le groupe cible spécifié.**
```
Get-ELB2TargetHealth -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970'
```
**Sortie** :
```
HealthCheckPort Target TargetHealth
--------------- ------ ------------
80 Amazon.ElasticLoadBalancingV2.Model.TargetDescription Amazon.ElasticLoadBalancingV2.Model.TargetHealth
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTargetHealth](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ELB2Listener`
L'exemple de code suivant montre comment utiliser`New-ELB2Listener`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un nouvel écouteur ALB avec l’action par défaut « Forward » pour envoyer le trafic au groupe cible spécifié.**
```
$defaultAction = [Amazon.ElasticLoadBalancingV2.Model.Action]@{
ForwardConfig = @{
TargetGroups = @(
@{ TargetGroupArn = "arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/testAlbTG/3d61c2f20aa5bccb" }
)
TargetGroupStickinessConfig = @{
DurationSeconds = 900
Enabled = $true
}
}
Type = "Forward"
}
New-ELB2Listener -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/testALB/3e2f03b558e19676' -Port 8001 -Protocol "HTTP" -DefaultAction $defaultAction
```
**Sortie** :
```
Certificates : {}
DefaultActions : {Amazon.ElasticLoadBalancingV2.Model.Action}
ListenerArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/testALB/3e2f03b558e19676/1c84f02aec143e80
LoadBalancerArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/testALB/3e2f03b558e19676
Port : 8001
Protocol : HTTP
SslPolicy :
```
+ Pour plus de détails sur l'API, reportez-vous [CreateListener](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ELB2LoadBalancer`
L'exemple de code suivant montre comment utiliser`New-ELB2LoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un Application Load Balancer connecté à Internet avec deux sous-réseaux.**
```
New-ELB2LoadBalancer -Type application -Scheme internet-facing -IpAddressType ipv4 -Name 'New-Test-ALB' -SecurityGroup 'sg-07c3414abb8811cbd' -subnet 'subnet-c37a67a6','subnet-fc02eea0'
```
**Sortie** :
```
AvailabilityZones : {us-east-1b, us-east-1a}
CanonicalHostedZoneId : Z35SXDOTRQ7X7K
CreatedTime : 12/28/19 2:58:03 PM
DNSName : New-Test-ALB-1391502222.us-east-1.elb.amazonaws.com
IpAddressType : ipv4
LoadBalancerArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/New-Test-ALB/dab2e4d90eb51493
LoadBalancerName : New-Test-ALB
Scheme : internet-facing
SecurityGroups : {sg-07c3414abb8811cbd}
State : Amazon.ElasticLoadBalancingV2.Model.LoadBalancerState
Type : application
VpcId : vpc-2cfd7000
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLoadBalancer](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ELB2Rule`
L'exemple de code suivant montre comment utiliser`New-ELB2Rule`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une nouvelle règle d’écouteur avec une action à réponse fixe basée sur la valeur d’en-tête du client pour le récepteur spécifié.**
```
$newRuleAction = [Amazon.ElasticLoadBalancingV2.Model.Action]@{
"FixedResponseConfig" = @{
"ContentType" = "text/plain"
"MessageBody" = "Hello World"
"StatusCode" = "200"
}
"Type" = [Amazon.ElasticLoadBalancingV2.ActionTypeEnum]::FixedResponse
}
$newRuleCondition = [Amazon.ElasticLoadBalancingV2.Model.RuleCondition]@{
"httpHeaderConfig" = @{
"HttpHeaderName" = "customHeader"
"Values" = "header2","header1"
}
"Field" = "http-header"
}
New-ELB2Rule -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/testALB/3e2f03b558e19676/1c84f02aec143e80' -Action $newRuleAction -Condition $newRuleCondition -Priority 10
```
**Sortie** :
```
Actions : {Amazon.ElasticLoadBalancingV2.Model.Action}
Conditions : {Amazon.ElasticLoadBalancingV2.Model.RuleCondition}
IsDefault : False
Priority : 10
RuleArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/testALB/3e2f03b558e19676/1c84f02aec143e80/f4f51dfaa033a8cc
```
+ Pour plus de détails sur l'API, reportez-vous [CreateRule](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ELB2TargetGroup`
L'exemple de code suivant montre comment utiliser`New-ELB2TargetGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un groupe cible avec les paramètres fournis.**
```
New-ELB2TargetGroup -HealthCheckEnabled 1 -HealthCheckIntervalSeconds 30 -HealthCheckPath '/index.html' -HealthCheckPort 80 -HealthCheckTimeoutSecond 5 -HealthyThresholdCount 2 -UnhealthyThresholdCount 5 -Port 80 -Protocol 'HTTP' -TargetType instance -VpcId 'vpc-2cfd7000' -Name 'NewTargetGroup'
```
**Sortie** :
```
HealthCheckEnabled : True
HealthCheckIntervalSeconds : 30
HealthCheckPath : /index.html
HealthCheckPort : 80
HealthCheckProtocol : HTTP
HealthCheckTimeoutSeconds : 5
HealthyThresholdCount : 2
LoadBalancerArns : {}
Matcher : Amazon.ElasticLoadBalancingV2.Model.Matcher
Port : 80
Protocol : HTTP
TargetGroupArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/NewTargetGroup/534e484681d801bf
TargetGroupName : NewTargetGroup
TargetType : instance
UnhealthyThresholdCount : 5
VpcId : vpc-2cfd7000
```
+ Pour plus de détails sur l'API, reportez-vous [CreateTargetGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-ELB2Target`
L'exemple de code suivant montre comment utiliser`Register-ELB2Target`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre l’instance « i-0672a4c4cdeae3111 » auprès du groupe cible spécifié.**
```
Register-ELB2Target -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970' -Target @{Port = 80; Id = 'i-0672a4c4cdeae3111'}
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterTargets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ELB2Listener`
L'exemple de code suivant montre comment utiliser`Remove-ELB2Listener`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’écouteur spécifié.**
```
Remove-ELB2Listener -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/66e10e3aaf5b6d9b'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ELB2Listener (DeleteListener)" on target "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/66e10e3aaf5b6d9b".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y
```
**Exemple 2 : cet exemple supprime l’écouteur spécifié de l’équilibreur de charge.**
```
Remove-ELB2Listener -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/3873f123b98f7618'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ELB2Listener (DeleteListener)" on target "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/3873f123b98f7618".
[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 [DeleteListener](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ELB2ListenerCertificate`
L'exemple de code suivant montre comment utiliser`Remove-ELB2ListenerCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le certificate spécifié du groupe cible spécifié.**
```
Remove-ELB2ListenerCertificate -Certificate @{CertificateArn = 'arn:aws:acm:us-east-1:123456789012:certificate/19478bd5-491d-47d4-b1d7-5217feba1d97'} -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/3873f123b98f7618'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ELB2ListenerCertificate (RemoveListenerCertificates)" on target "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/3873f123b98f7618".
[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 [RemoveListenerCertificates](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ELB2LoadBalancer`
L'exemple de code suivant montre comment utiliser`Remove-ELB2LoadBalancer`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’équilibreur de charge spécifié.**
```
Remove-ELB2LoadBalancer -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ELB2LoadBalancer (DeleteLoadBalancer)" on target "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f".
[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 [DeleteLoadBalancer](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ELB2Rule`
L'exemple de code suivant montre comment utiliser`Remove-ELB2Rule`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la règle spécifiée pour l’écouteur.**
```
Remove-ELB2Rule -RuleArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/test-alb/3651b4394dd9a24f/3873f123b98f7618/4b25eb10a42e33ab'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ELB2Rule (DeleteRule)" on target "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/test-alb/3651b4394dd9a24f/3873f123b98f7618/4b25eb10a42e33ab".
[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 [DeleteRule](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ELB2Tag`
L'exemple de code suivant montre comment utiliser`Remove-ELB2Tag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la balise pour la clé spécifiée.**
```
Remove-ELB2Tag -ResourceArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -TagKey 'productVersion'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ELB2Tag (RemoveTags)" on target "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f".
[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 [RemoveTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-ELB2TargetGroup`
L'exemple de code suivant montre comment utiliser`Remove-ELB2TargetGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le groupe cible spécifié.**
```
Remove-ELB2TargetGroup -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/testsssss/4e0b6076bc6483a7'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-ELB2TargetGroup (DeleteTargetGroup)" on target "arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/testsssss/4e0b6076bc6483a7".
[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 [DeleteTargetGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ELB2IpAddressType`
L'exemple de code suivant montre comment utiliser`Set-ELB2IpAddressType`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple change le type d'adresse IP de l'équilibreur de charge de « IPv4 » à « DualStack ».**
```
Set-ELB2IpAddressType -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -IpAddressType dualstack
```
**Sortie** :
```
Value
-----
dualstack
```
+ Pour plus de détails sur l'API, reportez-vous [SetIpAddressType](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ELB2RulePriority`
L'exemple de code suivant montre comment utiliser`Set-ELB2RulePriority`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie la priorité de la règle d’écouteur spécifiée.**
```
Set-ELB2RulePriority -RulePriority -RulePriority @{Priority = 11; RuleArn = 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/test-alb/3651b4394dd9a24f/a4eb199fa5046f80/dbf4c6dcef3ec6f8'}
```
**Sortie** :
```
Actions : {Amazon.ElasticLoadBalancingV2.Model.Action}
Conditions : {Amazon.ElasticLoadBalancingV2.Model.RuleCondition}
IsDefault : False
Priority : 11
RuleArn : arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/test-alb/3651b4394dd9a24f/a4eb199fa5046f80/dbf4c6dcef3ec6f8
```
+ Pour plus de détails sur l'API, reportez-vous [SetRulePriorities](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ELB2SecurityGroup`
L'exemple de code suivant montre comment utiliser`Set-ELB2SecurityGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute le groupe de sécurité « sg-07c3414abb8811cbd » à l’équilibreur de charge spécifié.**
```
Set-ELB2SecurityGroup -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -SecurityGroup 'sg-07c3414abb8811cbd'
```
**Sortie** :
```
sg-07c3414abb8811cbd
```
+ Pour plus de détails sur l'API, reportez-vous [SetSecurityGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-ELB2Subnet`
L'exemple de code suivant montre comment utiliser`Set-ELB2Subnet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie les sous-réseaux de l’équilibreur de charge spécifié.**
```
Set-ELB2Subnet -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -Subnet 'subnet-7d8a0a51','subnet-c37a67a6'
```
**Sortie** :
```
LoadBalancerAddresses SubnetId ZoneName
--------------------- -------- --------
{} subnet-7d8a0a51 us-east-1c
{} subnet-c37a67a6 us-east-1b
```
+ Pour plus de détails sur l'API, reportez-vous [SetSubnets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-ELB2Target`
L'exemple de code suivant montre comment utiliser`Unregister-ELB2Target`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple annule l’enregistrement de l’instance « i-0672a4c4cdeae3111 » du groupe cible spécifié.**
```
$targetDescription = New-Object Amazon.ElasticLoadBalancingV2.Model.TargetDescription
$targetDescription.Id = 'i-0672a4c4cdeae3111'
Unregister-ELB2Target -Target $targetDescription -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970'
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterTargets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# FSx Exemples Amazon utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Amazon FSx.
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-FSXResourceTag`
L'exemple de code suivant montre comment utiliser`Add-FSXResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute des balises à la ressource donnée.**
```
Add-FSXResourceTag -ResourceARN "arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a" -Tag @{Key="Users";Value="Test"} -PassThru
```
**Sortie** :
```
arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a
```
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-FSXBackup`
L'exemple de code suivant montre comment utiliser`Get-FSXBackup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple récupère les sauvegardes créées depuis hier pour l’ID de système de fichiers donné.**
```
Get-FSXBackup -Filter @{Name="file-system-id";Values=$fsx.FileSystemId} | Where-Object CreationTime -gt (Get-Date).AddDays(-1)
```
**Sortie** :
```
BackupId : backup-01dac234e56782bcc
CreationTime : 6/14/2019 3:35:14 AM
FailureDetails :
FileSystem : Amazon.FSx.Model.FileSystem
KmsKeyId : arn:aws:kms:eu-west-1:123456789012:key/f1af23c4-1b23-1bde-a1f1-e1234c5af123
Lifecycle : AVAILABLE
ProgressPercent : 100
ResourceARN : arn:aws:fsx:eu-west-1:123456789012:backup/backup-01dac234e56782bcc
Tags : {}
Type : AUTOMATIC
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeBackups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-FSXFileSystem`
L'exemple de code suivant montre comment utiliser`Get-FSXFileSystem`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie la description du filesystemId donné.**
```
Get-FSXFileSystem -FileSystemId fs-01cd23bc4bdf5678a
```
**Sortie** :
```
CreationTime : 1/17/2019 9:55:30 AM
DNSName : fs-01cd23bc4bdf5678a.ktmsad.local
FailureDetails :
FileSystemId : fs-01cd23bc4bdf5678a
FileSystemType : WINDOWS
KmsKeyId : arn:aws:kms:eu-west-1:123456789012:key/f1af23c4-5b67-8bde-a9f0-e1234c5af678
Lifecycle : AVAILABLE
LustreConfiguration :
NetworkInterfaceIds : {eni-07d1dda1322b7e209}
OwnerId : 123456789012
ResourceARN : arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a
StorageCapacity : 300
SubnetIds : {subnet-7d123456}
Tags : {FSx-Service}
VpcId : vpc-41cf2b3f
WindowsConfiguration : Amazon.FSx.Model.WindowsFileSystemConfiguration
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeFileSystems](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-FSXResourceTagList`
L'exemple de code suivant montre comment utiliser`Get-FSXResourceTagList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les balises pour la ressource ARN fournie.**
```
Get-FSXResourceTagList -ResourceARN $fsx.ResourceARN
```
**Sortie** :
```
Key Value
--- -----
FSx-Service Windows
Users Dev
```
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-FSXBackup`
L'exemple de code suivant montre comment utiliser`New-FSXBackup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une sauvegarde du système de fichiers donné.**
```
New-FSXBackup -FileSystemId fs-0b1fac2345623456ba
```
**Sortie** :
```
BackupId : backup-0b1fac2345623456ba
CreationTime : 6/14/2019 5:37:17 PM
FailureDetails :
FileSystem : Amazon.FSx.Model.FileSystem
KmsKeyId : arn:aws:kms:eu-west-1:123456789012:key/f1af23c4-1b23-1bde-a1f3-e1234c5af678
Lifecycle : CREATING
ProgressPercent : 0
ResourceARN : arn:aws:fsx:eu-west-1:123456789012:backup/backup-0b1fac2345623456ba
Tags : {}
Type : USER_INITIATED
```
+ Pour plus de détails sur l'API, reportez-vous [CreateBackup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-FSXFileSystem`
L'exemple de code suivant montre comment utiliser`New-FSXFileSystem`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un nouveau système de fichiers Windows de 300 Go, autorisant l’accès depuis le sous-réseau spécifié, qui prend en charge un débit maximum de huit mégaoctets par seconde. Le nouveau système de fichiers est automatiquement joint au Microsoft Active Directory spécifié.**
```
New-FSXFileSystem -FileSystemType WINDOWS -StorageCapacity 300 -SubnetId subnet-1a2b3c4d5e6f -WindowsConfiguration @{ThroughputCapacity=8;ActiveDirectoryId='d-1a2b3c4d'}
```
**Sortie** :
```
CreationTime : 12/10/2018 6:06:59 PM
DNSName : fs-abcdef01234567890.example.com
FailureDetails :
FileSystemId : fs-abcdef01234567890
FileSystemType : WINDOWS
KmsKeyId : arn:aws:kms:us-west-2:123456789012:key/a1234567-252c-45e9-afaa-123456789abc
Lifecycle : CREATING
LustreConfiguration :
NetworkInterfaceIds : {}
OwnerId : 123456789012
ResourceARN : arn:aws:fsx:us-west-2:123456789012:file-system/fs-abcdef01234567890
StorageCapacity : 300
SubnetIds : {subnet-1a2b3c4d5e6f}
Tags : {}
VpcId : vpc-1a2b3c4d5e6f
WindowsConfiguration : Amazon.FSx.Model.WindowsFileSystemConfiguration
```
+ Pour plus de détails sur l'API, reportez-vous [CreateFileSystem](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-FSXFileSystemFromBackup`
L'exemple de code suivant montre comment utiliser`New-FSXFileSystemFromBackup`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un nouveau système de FSx fichiers Amazon à partir d'une sauvegarde existante du serveur de fichiers Amazon FSx pour Windows.**
```
New-FSXFileSystemFromBackup -BackupId $backupID -Tag @{Key="tag:Name";Value="from-manual-backup"} -SubnetId $SubnetID -SecurityGroupId $SG_ID -WindowsConfiguration @{ThroughputCapacity=8;ActiveDirectoryId=$DirectoryID}
```
**Sortie** :
```
CreationTime : 8/8/2019 12:59:58 PM
DNSName : fs-012ff34e56789120.ktmsad.local
FailureDetails :
FileSystemId : fs-012ff34e56789120
FileSystemType : WINDOWS
KmsKeyId : arn:aws:kms:eu-west-1:123456789012:key/f1af23c4-5b67-1bde-a2f3-e4567c8a9321
Lifecycle : CREATING
LustreConfiguration :
NetworkInterfaceIds : {}
OwnerId : 933303704102
ResourceARN : arn:aws:fsx:eu-west-1:123456789012:file-system/fs-012ff34e56789120
StorageCapacity : 300
SubnetIds : {subnet-fa1ae23c}
Tags : {tag:Name}
VpcId : vpc-12cf3b4f
WindowsConfiguration : Amazon.FSx.Model.WindowsFileSystemConfiguration
```
+ Pour plus de détails sur l'API, reportez-vous [CreateFileSystemFromBackup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-FSXBackup`
L'exemple de code suivant montre comment utiliser`Remove-FSXBackup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le backup-id spécifié.**
```
Remove-FSXBackup -BackupId $backupID
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-FSXBackup (DeleteBackup)" on target "backup-0bbca1e2345678e12".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
BackupId Lifecycle
-------- ---------
backup-0bbca1e2345678e12 DELETED
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBackup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-FSXFileSystem`
L'exemple de code suivant montre comment utiliser`Remove-FSXFileSystem`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’ID de système de fichiers FSX spécifié.**
```
Remove-FSXFileSystem -FileSystemId fs-012ff34e567890120
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-FSXFileSystem (DeleteFileSystem)" on target "fs-012ff34e567890120".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
FileSystemId Lifecycle WindowsResponse
------------ --------- ---------------
fs-012ff34e567890120 DELETING Amazon.FSx.Model.DeleteFileSystemWindowsResponse
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteFileSystem](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-FSXResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-FSXResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la balise de ressource pour l’ARN de ressource du système de fichiers FSX donné.**
```
Remove-FSXResourceTag -ResourceARN $FSX.ResourceARN -TagKey Users
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-FSXResourceTag (UntagResource)" on target "arn:aws:fsx:eu-west-1:933303704102:file-system/fs-07cd45bc6bdf2674a".
[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/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-FSXFileSystem`
L'exemple de code suivant montre comment utiliser`Update-FSXFileSystem`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple met à jour les jours de conservation automatique des sauvegardes du système de fichiers FSX via UpdateFileSystemWindowsConfiguration.**
```
$UpdateFSXWinConfig = [Amazon.FSx.Model.UpdateFileSystemWindowsConfiguration]::new()
$UpdateFSXWinConfig.AutomaticBackupRetentionDays = 35
Update-FSXFileSystem -FileSystemId $FSX.FileSystemId -WindowsConfiguration $UpdateFSXWinConfig
```
**Sortie** :
```
CreationTime : 1/17/2019 9:55:30 AM
DNSName : fs-01cd23bc4bdf5678a.ktmsad.local
FailureDetails :
FileSystemId : fs-01cd23bc4bdf5678a
FileSystemType : WINDOWS
KmsKeyId : arn:aws:kms:eu-west-1:123456789012:key/f1af23c4-1b23-1bde-a1f2-e1234c5af678
Lifecycle : AVAILABLE
LustreConfiguration :
NetworkInterfaceIds : {eni-01cd23bc4bdf5678a}
OwnerId : 933303704102
ResourceARN : arn:aws:fsx:eu-west-1:933303704102:file-system/fs-07cd45bc6bdf2674a
StorageCapacity : 300
SubnetIds : {subnet-1d234567}
Tags : {FSx-Service}
VpcId : vpc-23cf4b5f
WindowsConfiguration : Amazon.FSx.Model.WindowsFileSystemConfiguration
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateFileSystem](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Amazon Glacier utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Amazon Glacier.
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
### `Get-GLCJob`
L'exemple de code suivant montre comment utiliser`Get-GLCJob`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoi des détails de la tâche spécifiée. Lorsque la tâche est terminée avec succès, l'applet de commande GCJob Read-Output peut être utilisée pour récupérer le contenu de la tâche (une archive ou une liste d'inventaire) dans le système de fichiers local.**
```
Get-GLCJob -VaultName myvault -JobId "op1x...JSbthM"
```
**Sortie** :
```
Action : ArchiveRetrieval
ArchiveId : o9O9j...X-TpIhQJw
ArchiveSHA256TreeHash : 79f3ea754c02f58...dc57bf4395b
ArchiveSizeInBytes : 38034480
Completed : False
CompletionDate : 1/1/0001 12:00:00 AM
CreationDate : 12/13/2018 11:00:14 AM
InventoryRetrievalParameters :
InventorySizeInBytes : 0
JobDescription :
JobId : op1x...JSbthM
JobOutputPath :
OutputLocation :
RetrievalByteRange : 0-38034479
SelectParameters :
SHA256TreeHash : 79f3ea754c02f58...dc57bf4395b
SNSTopic :
StatusCode : InProgress
StatusMessage :
Tier : Standard
VaultARN : arn:aws:glacier:us-west-2:012345678912:vaults/test
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeJob](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-GLCVault`
L'exemple de code suivant montre comment utiliser`New-GLCVault`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un nouveau coffre-fort pour le compte de l’utilisateur. Comme aucune valeur n'a été fournie au AccountId paramètre -, les applets de commande utilisent la valeur par défaut « - » pour indiquer le compte courant.**
```
New-GLCVault -VaultName myvault
```
**Sortie** :
```
/01234567812/vaults/myvault
```
+ Pour plus de détails sur l'API, reportez-vous [CreateVault](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Read-GLCJobOutput`
L'exemple de code suivant montre comment utiliser`Read-GLCJobOutput`.
**Outils pour PowerShell V4**
**Exemple 1 : télécharge le contenu de l’archive dont l’extraction était planifiée dans le cadre de la tâche spécifiée et stocke le contenu dans un fichier sur disque. Le téléchargement valide le checksum pour vous, s’il est disponible. Si vous le souhaitez, la réponse complète, y compris le checksum, peut être renvoyée en spécifiant `-Select '*'`.**
```
Read-GLCJobOutput -VaultName myvault -JobId "HSWjArc...Zq2XLiW" -FilePath "c:\temp\blue.bin"
```
+ Pour plus de détails sur l'API, reportez-vous [GetJobOutput](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Start-GLCJob`
L'exemple de code suivant montre comment utiliser`Start-GLCJob`.
**Outils pour PowerShell V4**
**Exemple 1 : démarre une tâche pour extraire une archive dans le coffre-fort spécifié appartenant à l’utilisateur. L'état de la tâche peut être vérifié à l'aide de l'GLCJob applet de commande Get-. Lorsque le travail est terminé avec succès, l'applet de commande GCJob Read-Output peut être utilisée pour récupérer le contenu de l'archive dans le système de fichiers local.**
```
Start-GLCJob -VaultName myvault -JobType "archive-retrieval" -JobDescription "archive retrieval" -ArchiveId "o9O9j...TX-TpIhQJw"
```
**Sortie** :
```
JobId JobOutputPath Location
----- ------------- --------
op1x...JSbthM /012345678912/vaults/test/jobs/op1xe...I4HqCHkSJSbthM
```
+ Pour plus de détails sur l'API, reportez-vous [InitiateJob](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-GLCArchive`
L'exemple de code suivant montre comment utiliser`Write-GLCArchive`.
**Outils pour PowerShell V4**
**Exemple 1 : télécharge un seul fichier dans le coffre-fort spécifié, en renvoyant l’ID de l’archive et la somme de contrôle calculée.**
```
Write-GLCArchive -VaultName myvault -FilePath c:\temp\blue.bin
```
**Sortie** :
```
FilePath ArchiveId Checksum
-------- --------- --------
C:\temp\blue.bin o9O9jUUs...TTX-TpIhQJw 79f3e...f4395b
```
**Exemple 2 : charge le contenu d’une hiérarchie de dossiers dans le coffre-fort spécifié dans le compte de l’utilisateur. Pour chaque fichier chargé, l’applet de commande émet le nom du fichier, l’ID d’archive correspondant et la somme de contrôle calculée de l’archive.**
```
Write-GLCArchive -VaultName myvault -FolderPath . -Recurse
```
**Sortie** :
```
FilePath ArchiveId Checksum
-------- --------- --------
C:\temp\blue.bin o9O9jUUs...TTX-TpIhQJw 79f3e...f4395b
C:\temp\green.bin qXAfOdSG...czo729UHXrw d50a1...9184b9
C:\temp\lum.bin 39aNifP3...q9nb8nZkFIg 28886...5c3e27
C:\temp\red.bin vp7E6rU_...Ejk_HhjAxKA e05f7...4e34f5
C:\temp\Folder1\file1.txt _eRINlip...5Sxy7dD2BaA d0d2a...c8a3ba
C:\temp\Folder2\file2.iso -Ix3jlmu...iXiDh-XfOPA 7469e...3e86f1
```
+ Pour plus de détails sur l'API, reportez-vous [UploadArchive](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# AWS Glue exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec AWS Glue.
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
### `New-GLUEJob`
L'exemple de code suivant montre comment utiliser`New-GLUEJob`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée une nouvelle tâche dans AWS Glue. La valeur du nom de commande est toujours`glueetl`. AWS Glue permet d'exécuter des scripts de travail écrits en Python ou Scala. Dans cet exemple, le script de tâche (MyTestGlueJob.py) est écrit en Python. Les paramètres Python sont spécifiés dans la `$DefArgs` variable, puis transmis à la PowerShell commande dans le `DefaultArguments` paramètre, qui accepte une table de hachage. Les paramètres de la `$JobParams` variable proviennent de l' CreateJob API, documentés dans la rubrique Jobs (https://docs.aws.amazon.com/glue/latest/dg/aws- glue-api-jobs-job .html) de la référence de l'API AWS Glue.**
```
$Command = New-Object Amazon.Glue.Model.JobCommand
$Command.Name = 'glueetl'
$Command.ScriptLocation = 's3://amzn-s3-demo-source-bucket/admin/MyTestGlueJob.py'
$Command
$Source = "source_test_table"
$Target = "target_test_table"
$Connections = $Source, $Target
$DefArgs = @{
'--TempDir' = 's3://amzn-s3-demo-bucket/admin'
'--job-bookmark-option' = 'job-bookmark-disable'
'--job-language' = 'python'
}
$DefArgs
$ExecutionProp = New-Object Amazon.Glue.Model.ExecutionProperty
$ExecutionProp.MaxConcurrentRuns = 1
$ExecutionProp
$JobParams = @{
"AllocatedCapacity" = "5"
"Command" = $Command
"Connections_Connection" = $Connections
"DefaultArguments" = $DefArgs
"Description" = "This is a test"
"ExecutionProperty" = $ExecutionProp
"MaxRetries" = "1"
"Name" = "MyOregonTestGlueJob"
"Role" = "Amazon-GlueServiceRoleForSSM"
"Timeout" = "20"
}
New-GlueJob @JobParams
```
+ Pour plus de détails sur l'API, reportez-vous [CreateJob](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# AWS Health exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec AWS Health.
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
### `Get-HLTHEvent`
L'exemple de code suivant montre comment utiliser`Get-HLTHEvent`.
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande renvoie des événements depuis AWS Personal Health Dashboard. L’utilisateur ajoute le paramètre -Region pour voir les événements disponibles pour le service dans la région USA Est (Virginie du Nord), mais le paramètre -Filter\$1Region filtre les événements enregistrés dans les régions UE (Londres) et USA Ouest (Oregon) (eu-west-2 et us-west-2). Le StartTime paramètre -Filter\$1 filtre pour une plage d'heures pendant laquelle les événements peuvent commencer, tandis que le EndTime paramètre -Filter\$1 filtre pour une plage d'heures pendant laquelle les événements peuvent se terminer. Le résultat est un événement de maintenance planifié pour RDS qui commence dans la plage -Filter\$1 spécifiée et se termine dans la StartTime plage planifiée -Filter\$1. EndTime **
```
Get-HLTHEvent -Region us-east-1 -Filter_Region "eu-west-2","us-west-2" -Filter_StartTime @{from="3/14/2019 6:30:00AM";to="3/15/2019 5:00:00PM"} -Filter_EndTime @{from="3/21/2019 7:00:00AM";to="3/21/2019 5:00:00PM"}
```
**Sortie** :
```
Arn : arn:aws:health:us-west-2::event/RDS/AWS_RDS_HARDWARE_MAINTENANCE_SCHEDULED/AWS_RDS_HARDWARE_MAINTENANCE_SCHEDULED_USW2_20190314_20190321
AvailabilityZone :
EndTime : 3/21/2019 2:00:00 PM
EventTypeCategory : scheduledChange
EventTypeCode : AWS_RDS_HARDWARE_MAINTENANCE_SCHEDULED
LastUpdatedTime : 2/28/2019 2:26:07 PM
Region : us-west-2
Service : RDS
StartTime : 3/14/2019 2:00:00 PM
StatusCode : open
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEvents](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'IAM utilisant Tools for V4 PowerShell
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 V4 avec IAM.
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-IAMClientIDToOpenIDConnectProvider`
L'exemple de code suivant montre comment utiliser`Add-IAMClientIDToOpenIDConnectProvider`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande ajoute l’ID client (ou audience) `my-application-ID` au fournisseur OIDC existant nommé `server.example.com`.**
```
Add-IAMClientIDToOpenIDConnectProvider -ClientID "my-application-ID" -OpenIDConnectProviderARN "arn:aws:iam::123456789012:oidc-provider/server.example.com"
```
+ Pour plus de détails sur l'API, reportez-vous [AddClientIdToOpenIdConnectProvider](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-IAMRoleTag`
L'exemple de code suivant montre comment utiliser`Add-IAMRoleTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute une balise au rôle dans le service de gestion des identités**
```
Add-IAMRoleTag -RoleName AdminRoleacess -Tag @{ Key = 'abac'; Value = 'testing'}
```
+ Pour plus de détails sur l'API, reportez-vous [TagRole](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-IAMRoleToInstanceProfile`
L'exemple de code suivant montre comment utiliser`Add-IAMRoleToInstanceProfile`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande ajoute le rôle nommé `S3Access` à un profil d’instance existant nommé `webserver`. Pour créer le profil d’instance, utilisez la commande `New-IAMInstanceProfile`. Après avoir créé le profil d’instance et l’avoir associé à un rôle à l’aide de cette commande, vous pouvez l’associer à une instance EC2. Pour ce faire, utilisez l’applet de commande `New-EC2Instance` avec le paramètre `InstanceProfile_Arn` ou `InstanceProfile-Name` pour lancer la nouvelle instance.**
```
Add-IAMRoleToInstanceProfile -RoleName "S3Access" -InstanceProfileName "webserver"
```
+ Pour plus de détails sur l'API, reportez-vous [AddRoleToInstanceProfile](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-IAMUserTag`
L'exemple de code suivant montre comment utiliser`Add-IAMUserTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute une balise à l’utilisateur dans le service de gestion des identités**
```
Add-IAMUserTag -UserName joe -Tag @{ Key = 'abac'; Value = 'testing'}
```
+ Pour plus de détails sur l'API, reportez-vous [TagUser](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Add-IAMUserToGroup`
L'exemple de code suivant montre comment utiliser`Add-IAMUserToGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande ajoute l’utilisateur nommé `Bob` au groupe nommé `Admins`.**
```
Add-IAMUserToGroup -UserName "Bob" -GroupName "Admins"
```
+ Pour plus de détails sur l'API, reportez-vous [AddUserToGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Disable-IAMMFADevice`
L'exemple de code suivant montre comment utiliser`Disable-IAMMFADevice`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande désactive le dispositif MFA matériel associé à l’utilisateur `Bob` et possédant le numéro de série `123456789012`.**
```
Disable-IAMMFADevice -UserName "Bob" -SerialNumber "123456789012"
```
**Exemple 2 : cette commande désactive le dispositif MFA virtuel associé à l’utilisateur `David` qui possède l’ARN `arn:aws:iam::210987654321:mfa/David`. Notez que le dispositif MFA virtuel n’est pas supprimé du compte. Le dispositif virtuel est toujours présent et apparaît dans la sortie de la commande `Get-IAMVirtualMFADevice`. Avant de pouvoir créer un dispositif MFA virtuel pour le même utilisateur, vous devez supprimer l’ancien à l’aide de la `Remove-IAMVirtualMFADevice` commande.**
```
Disable-IAMMFADevice -UserName "David" -SerialNumber "arn:aws:iam::210987654321:mfa/David"
```
+ Pour plus de détails sur l'API, reportez-vous [DeactivateMfaDevice](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-IAMPassword`
L'exemple de code suivant montre comment utiliser`Edit-IAMPassword`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande modifie le mot de passe de l’utilisateur qui exécute la commande. Cette commande ne peut être appelée que par les utilisateurs IAM. Si cette commande est appelée lorsque vous êtes connecté avec les informations d'identification du AWS compte (root), elle renvoie une erreur. `InvalidUserType`**
```
Edit-IAMPassword -OldPassword "MyOldP@ssw0rd" -NewPassword "MyNewP@ssw0rd"
```
+ Pour plus de détails sur l'API, reportez-vous [ChangePassword](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Enable-IAMMFADevice`
L'exemple de code suivant montre comment utiliser`Enable-IAMMFADevice`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande active le dispositif MFA matériel dont le numéro de série est `987654321098` et l’associe à l’utilisateur `Bob`. Elle inclut les deux premiers codes en séquence provenant du dispositif.**
```
Enable-IAMMFADevice -UserName "Bob" -SerialNumber "987654321098" -AuthenticationCode1 "12345678" -AuthenticationCode2 "87654321"
```
**Exemple 2 : cet exemple crée et active un dispositif MFA virtuel. La première commande crée le dispositif virtuel et renvoie la représentation de l’objet du dispositif dans la variable `$MFADevice`. Vous pouvez utiliser les propriétés `.Base32StringSeed` ou `QRCodePng` pour configurer l’application logicielle de l’utilisateur. La commande finale attribue le dispositif à l’utilisateur `David`, en identifiant le dispositif par son numéro de série. La commande synchronise également le dispositif AWS en incluant les deux premiers codes en séquence à partir du dispositif MFA virtuel.**
```
$MFADevice = New-IAMVirtualMFADevice -VirtualMFADeviceName "MyMFADevice"
# see example for New-IAMVirtualMFADevice to see how to configure the software program with PNG or base32 seed code
Enable-IAMMFADevice -UserName "David" -SerialNumber -SerialNumber $MFADevice.SerialNumber -AuthenticationCode1 "24681357" -AuthenticationCode2 "13572468"
```
+ Pour plus de détails sur l'API, reportez-vous [EnableMfaDevice](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMAccessKey`
L'exemple de code suivant montre comment utiliser`Get-IAMAccessKey`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande répertorie les clés d’accès de l’utilisateur IAM nommé `Bob`. Notez que vous ne pouvez pas répertorier les clés d’accès secrètes des utilisateurs IAM. Si les clés d’accès secrètes sont perdues, vous devez générer de nouvelles clés d’accès à l’applet de commande `New-IAMAccessKey`.**
```
Get-IAMAccessKey -UserName "Bob"
```
**Sortie** :
```
AccessKeyId CreateDate Status UserName
----------- ---------- ------ --------
AKIAIOSFODNN7EXAMPLE 12/3/2014 10:53:41 AM Active Bob
AKIAI44QH8DHBEXAMPLE 6/6/2013 8:42:26 PM Inactive Bob
```
+ Pour plus de détails sur l'API, reportez-vous [ListAccessKeys](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMAccessKeyLastUsed`
L'exemple de code suivant montre comment utiliser`Get-IAMAccessKeyLastUsed`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie le nom d’utilisateur propriétaire et les informations relatives à la dernière utilisation de la clé d’accès fournie.**
```
Get-IAMAccessKeyLastUsed -AccessKeyId ABCDEXAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [GetAccessKeyLastUsed](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMAccountAlias`
L'exemple de code suivant montre comment utiliser`Get-IAMAccountAlias`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie l’alias de compte pour l’ Compte AWS.**
```
Get-IAMAccountAlias
```
**Sortie** :
```
ExampleCo
```
+ Pour plus de détails sur l'API, reportez-vous [ListAccountAliases](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMAccountAuthorizationDetail`
L'exemple de code suivant montre comment utiliser`Get-IAMAccountAuthorizationDetail`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple obtient les détails d'autorisation concernant les identités du AWS compte et affiche la liste des éléments de l'objet renvoyé, y compris les utilisateurs, les groupes et les rôles. Par exemple, la propriété `UserDetailList` affiche des informations sur les utilisateurs. Des informations similaires sont disponibles dans les propriétés `RoleDetailList` et `GroupDetailList`.**
```
$Details=Get-IAMAccountAuthorizationDetail
$Details
```
**Sortie** :
```
GroupDetailList : {Administrators, Developers, Testers, Backup}
IsTruncated : False
Marker :
RoleDetailList : {TestRole1, AdminRole, TesterRole, clirole...}
UserDetailList : {Administrator, Bob, BackupToS3, }
```
```
$Details.UserDetailList
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:user/Administrator
CreateDate : 10/16/2014 9:03:09 AM
GroupList : {Administrators}
Path : /
UserId : AIDACKCEVSQ6CEXAMPLE1
UserName : Administrator
UserPolicyList : {}
Arn : arn:aws:iam::123456789012:user/Bob
CreateDate : 4/6/2015 12:54:42 PM
GroupList : {Developers}
Path : /
UserId : AIDACKCEVSQ6CEXAMPLE2
UserName : bab
UserPolicyList : {}
Arn : arn:aws:iam::123456789012:user/BackupToS3
CreateDate : 1/27/2015 10:15:08 AM
GroupList : {Backup}
Path : /
UserId : AIDACKCEVSQ6CEXAMPLE3
UserName : BackupToS3
UserPolicyList : {BackupServicePermissionsToS3Buckets}
```
+ Pour plus de détails sur l'API, reportez-vous [GetAccountAuthorizationDetails](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMAccountPasswordPolicy`
L'exemple de code suivant montre comment utiliser`Get-IAMAccountPasswordPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche les détails de la politique de mot de passe du compte actuel. Si aucune politique de mot de passe n’est définie pour le compte, la commande renvoie une erreur `NoSuchEntity`.**
```
Get-IAMAccountPasswordPolicy
```
**Sortie** :
```
AllowUsersToChangePassword : True
ExpirePasswords : True
HardExpiry : False
MaxPasswordAge : 90
MinimumPasswordLength : 8
PasswordReusePrevention : 20
RequireLowercaseCharacters : True
RequireNumbers : True
RequireSymbols : False
RequireUppercaseCharacters : True
```
+ Pour plus de détails sur l'API, reportez-vous [GetAccountPasswordPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMAccountSummary`
L'exemple de code suivant montre comment utiliser`Get-IAMAccountSummary`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie des informations sur l’utilisation des entités IAM et sur les quotas IAM actuels dans Compte AWS.**
```
Get-IAMAccountSummary
```
**Sortie** :
```
Key Value
Users 7
GroupPolicySizeQuota 5120
PolicyVersionsInUseQuota 10000
ServerCertificatesQuota 20
AccountSigningCertificatesPresent 0
AccountAccessKeysPresent 0
Groups 3
UsersQuota 5000
RolePolicySizeQuota 10240
UserPolicySizeQuota 2048
GroupsPerUserQuota 10
AssumeRolePolicySizeQuota 2048
AttachedPoliciesPerGroupQuota 2
Roles 9
VersionsPerPolicyQuota 5
GroupsQuota 100
PolicySizeQuota 5120
Policies 5
RolesQuota 250
ServerCertificates 0
AttachedPoliciesPerRoleQuota 2
MFADevicesInUse 2
PoliciesQuota 1000
AccountMFAEnabled 1
Providers 2
InstanceProfilesQuota 100
MFADevices 4
AccessKeysPerUserQuota 2
AttachedPoliciesPerUserQuota 2
SigningCertificatesPerUserQuota 2
PolicyVersionsInUse 4
InstanceProfiles 1
...
```
+ Pour plus de détails sur l'API, reportez-vous [GetAccountSummary](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMAttachedGroupPolicyList`
L'exemple de code suivant montre comment utiliser`Get-IAMAttachedGroupPolicyList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande renvoie les noms et ARNs les politiques gérées attachés au groupe IAM nommé `Admins` dans le AWS compte. Pour consulter la liste des politiques intégrées au groupe, utilisez la commande `Get-IAMGroupPolicyList`.**
```
Get-IAMAttachedGroupPolicyList -GroupName "Admins"
```
**Sortie** :
```
PolicyArn PolicyName
--------- ----------
arn:aws:iam::aws:policy/SecurityAudit SecurityAudit
arn:aws:iam::aws:policy/AdministratorAccess AdministratorAccess
```
+ Pour plus de détails sur l'API, reportez-vous [ListAttachedGroupPolicies](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMAttachedRolePolicyList`
L'exemple de code suivant montre comment utiliser`Get-IAMAttachedRolePolicyList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande renvoie les noms et ARNs les politiques gérées associées au rôle IAM nommé `SecurityAuditRole` dans le AWS compte. Pour consulter la liste des politiques en ligne intégrées au rôle, utilisez la commande `Get-IAMRolePolicyList`.**
```
Get-IAMAttachedRolePolicyList -RoleName "SecurityAuditRole"
```
**Sortie** :
```
PolicyArn PolicyName
--------- ----------
arn:aws:iam::aws:policy/SecurityAudit SecurityAudit
```
+ Pour plus de détails sur l'API, reportez-vous [ListAttachedRolePolicies](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMAttachedUserPolicyList`
L'exemple de code suivant montre comment utiliser`Get-IAMAttachedUserPolicyList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande renvoie les noms et ARNs les politiques gérées pour l'utilisateur IAM nommé `Bob` dans le AWS compte. Pour voir la liste des politiques en ligne qui sont intégrées à l’utilisateur IAM, utilisez la commande `Get-IAMUserPolicyList`.**
```
Get-IAMAttachedUserPolicyList -UserName "Bob"
```
**Sortie** :
```
PolicyArn PolicyName
--------- ----------
arn:aws:iam::aws:policy/TesterPolicy TesterPolicy
```
+ Pour plus de détails sur l'API, reportez-vous [ListAttachedUserPolicies](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMContextKeysForCustomPolicy`
L'exemple de code suivant montre comment utiliser`Get-IAMContextKeysForCustomPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait toutes les clés de contexte présentes dans le JSON de la politique fourni. Afin de fournir plusieurs politiques, vous pouvez spécifier une liste de valeurs séparées par des virgules.**
```
$policy1 = '{"Version":"2012-10-17", "Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"arn:aws:dynamodb:us-west-2:123456789012:table/","Condition":{"DateGreaterThan":{"aws:CurrentTime":"2015-08-16T12:00:00Z"}}}}'
$policy2 = '{"Version":"2012-10-17", "Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"arn:aws:dynamodb:us-west-2:123456789012:table/"}}'
Get-IAMContextKeysForCustomPolicy -PolicyInputList $policy1,$policy2
```
+ Pour plus de détails sur l'API, reportez-vous [GetContextKeysForCustomPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMContextKeysForPrincipalPolicy`
L'exemple de code suivant montre comment utiliser`Get-IAMContextKeysForPrincipalPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait toutes les clés de contexte présentes dans le JSON de politique fourni et les politiques attachées à l’entité IAM (utilisateur/rôle, etc.). Pour : PolicyInputList vous pouvez fournir une liste de valeurs multiples sous forme de valeurs séparées par des virgules.**
```
$policy1 = '{"Version":"2012-10-17", "Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"arn:aws:dynamodb:us-west-2:123456789012:table/","Condition":{"DateGreaterThan":{"aws:CurrentTime":"2015-08-16T12:00:00Z"}}}}'
$policy2 = '{"Version":"2012-10-17", "Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"arn:aws:dynamodb:us-west-2:123456789012:table/"}}'
Get-IAMContextKeysForPrincipalPolicy -PolicyInputList $policy1,$policy2 -PolicySourceArn arn:aws:iam::852640994763:user/TestUser
```
+ Pour plus de détails sur l'API, reportez-vous [GetContextKeysForPrincipalPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMCredentialReport`
L'exemple de code suivant montre comment utiliser`Get-IAMCredentialReport`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ouvre le rapport renvoyé et le transmet au pipeline sous la forme d’un tableau de lignes de texte. La première ligne est l’en-tête avec les noms de colonnes séparés par des virgules. Chaque ligne successive est la ligne de détail d’un utilisateur, chaque champ étant séparé du suivant par une virgule. Avant de pouvoir consulter le rapport, vous devez le générer à l’aide de l’applet de commande `Request-IAMCredentialReport`. Pour récupérer le rapport sous forme de chaîne unique, utilisez à la `-Raw` place de `-AsTextArray`. L’alias `-SplitLines` est également accepté pour le commutateur `-AsTextArray`. Pour obtenir la liste complète des colonnes dans sortie, consultez la référence de l’API du service. Notez que si vous n’utilisez pas `-AsTextArray` ou `-SplitLines`, vous devez extraire le texte de la propriété `.Content` à l’aide de la classe .NET `StreamReader`.**
```
Request-IAMCredentialReport
```
**Sortie** :
```
Description State
----------- -----
No report exists. Starting a new report generation task STARTED
```
```
Get-IAMCredentialReport -AsTextArray
```
**Sortie** :
```
user,arn,user_creation_time,password_enabled,password_last_used,password_last_changed,password_next_rotation,mfa_active,access_key_1_active,access_key_1_last_rotated,access_key_2_active,access_key_2_last_rotated,cert_1_active,cert_1_last_rotated,cert_2_active,cert_2_last_rotated root_account,arn:aws:iam::123456789012:root,2014-10-15T16:31:25+00:00,not_supported,2015-04-20T17:41:10+00:00,not_supported,not_supported,true,false,N/A,false,N/A,false,N/A,false,N/A
Administrator,arn:aws:iam::123456789012:user/Administrator,2014-10-16T16:03:09+00:00,true,2015-04-20T15:18:32+00:00,2014-10-16T16:06:00+00:00,N/A,false,true,2014-12-03T18:53:41+00:00,true,2015-03-25T20:38:14+00:00,false,N/A,false,N/A
Bill,arn:aws:iam::123456789012:user/Bill,2015-04-15T18:27:44+00:00,false,N/A,N/A,N/A,false,false,N/A,false,N/A,false,2015-04-20T20:00:12+00:00,false,N/A
```
+ Pour plus de détails sur l'API, reportez-vous [GetCredentialReport](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMEntitiesForPolicy`
L'exemple de code suivant montre comment utiliser`Get-IAMEntitiesForPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie une liste de groupes, de rôles et d’utilisateurs IAM auxquels la politique `arn:aws:iam::123456789012:policy/TestPolicy` est attachée.**
```
Get-IAMEntitiesForPolicy -PolicyArn "arn:aws:iam::123456789012:policy/TestPolicy"
```
**Sortie** :
```
IsTruncated : False
Marker :
PolicyGroups : {}
PolicyRoles : {testRole}
PolicyUsers : {Bob, Theresa}
```
+ Pour plus de détails sur l'API, reportez-vous [ListEntitiesForPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMGroup`
L'exemple de code suivant montre comment utiliser`Get-IAMGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie des informations sur le groupe IAM `Testers`, y compris une collection de tous les utilisateurs IAM appartenant au groupe.**
```
$results = Get-IAMGroup -GroupName "Testers"
$results
```
**Sortie** :
```
Group IsTruncated Marker Users
----- ----------- ------ -----
Amazon.IdentityManagement.Model.Group False {Theresa, David}
```
```
$results.Group
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:group/Testers
CreateDate : 12/10/2014 3:39:11 PM
GroupId : 3RHNZZGQJ7QHMAEXAMPLE1
GroupName : Testers
Path : /
```
```
$results.Users
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:user/Theresa
CreateDate : 12/10/2014 3:39:27 PM
PasswordLastUsed : 1/1/0001 12:00:00 AM
Path : /
UserId : 4OSVDDJJTF4XEEXAMPLE2
UserName : Theresa
Arn : arn:aws:iam::123456789012:user/David
CreateDate : 12/10/2014 3:39:27 PM
PasswordLastUsed : 3/19/2015 8:44:04 AM
Path : /
UserId : Y4FKWQCXTA52QEXAMPLE3
UserName : David
```
+ Pour plus de détails sur l'API, reportez-vous [GetGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMGroupForUser`
L'exemple de code suivant montre comment utiliser`Get-IAMGroupForUser`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie la liste des groupes IAM auxquels `David` appartient l’utilisateur IAM.**
```
Get-IAMGroupForUser -UserName David
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:group/Administrators
CreateDate : 10/20/2014 10:06:24 AM
GroupId : 6WCH4TRY3KIHIEXAMPLE1
GroupName : Administrators
Path : /
Arn : arn:aws:iam::123456789012:group/Testers
CreateDate : 12/10/2014 3:39:11 PM
GroupId : RHNZZGQJ7QHMAEXAMPLE2
GroupName : Testers
Path : /
Arn : arn:aws:iam::123456789012:group/Developers
CreateDate : 12/10/2014 3:38:55 PM
GroupId : ZU2EOWMK6WBZOEXAMPLE3
GroupName : Developers
Path : /
```
+ Pour plus de détails sur l'API, reportez-vous [ListGroupsForUser](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMGroupList`
L'exemple de code suivant montre comment utiliser`Get-IAMGroupList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple renvoie une collection de tous les groupes IAM définis dans le fichier actuel Compte AWS.**
```
Get-IAMGroupList
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:group/Administrators
CreateDate : 10/20/2014 10:06:24 AM
GroupId : 6WCH4TRY3KIHIEXAMPLE1
GroupName : Administrators
Path : /
Arn : arn:aws:iam::123456789012:group/Developers
CreateDate : 12/10/2014 3:38:55 PM
GroupId : ZU2EOWMK6WBZOEXAMPLE2
GroupName : Developers
Path : /
Arn : arn:aws:iam::123456789012:group/Testers
CreateDate : 12/10/2014 3:39:11 PM
GroupId : RHNZZGQJ7QHMAEXAMPLE3
GroupName : Testers
Path : /
```
+ Pour plus de détails sur l'API, reportez-vous [ListGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMGroupPolicy`
L'exemple de code suivant montre comment utiliser`Get-IAMGroupPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie des informations sur la politique intégrée nommée `PowerUserAccess-Testers` pour le groupe `Testers`. La propriété `PolicyDocument` est encodée sous forme d’URL. Elle est décodée dans cet exemple à l’aide de la méthode .NET `UrlDecode`.**
```
$results = Get-IAMGroupPolicy -GroupName Testers -PolicyName PowerUserAccess-Testers
$results
```
**Sortie** :
```
GroupName PolicyDocument PolicyName
--------- -------------- ----------
Testers %7B%0A%20%20%22Version%22%3A%20%222012-10-17%22%2C%0A%20... PowerUserAccess-Testers
[System.Reflection.Assembly]::LoadWithPartialName("System.Web.HttpUtility")
[System.Web.HttpUtility]::UrlDecode($results.PolicyDocument)
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ec2:DescribeInstances"
],
"Resource": [
"arn:aws:ec2:us-east-1:555555555555:instance/i-b188560f"
]
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetGroupPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMGroupPolicyList`
L'exemple de code suivant montre comment utiliser`Get-IAMGroupPolicyList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie la liste des politiques en ligne intégrées au groupe `Testers`. Pour obtenir les politiques gérées attachées au groupe, utilisez la commande `Get-IAMAttachedGroupPolicyList`.**
```
Get-IAMGroupPolicyList -GroupName Testers
```
**Sortie** :
```
Deny-Assume-S3-Role-In-Production
PowerUserAccess-Testers
```
+ Pour plus de détails sur l'API, reportez-vous [ListGroupPolicies](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMInstanceProfile`
L'exemple de code suivant montre comment utiliser`Get-IAMInstanceProfile`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple renvoie les détails du profil d'instance nommé `ec2instancerole` défini dans le AWS compte courant.**
```
Get-IAMInstanceProfile -InstanceProfileName ec2instancerole
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:instance-profile/ec2instancerole
CreateDate : 2/17/2015 2:49:04 PM
InstanceProfileId : HH36PTZQJUR32EXAMPLE1
InstanceProfileName : ec2instancerole
Path : /
Roles : {ec2instancerole}
```
+ Pour plus de détails sur l'API, reportez-vous [GetInstanceProfile](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMInstanceProfileForRole`
L'exemple de code suivant montre comment utiliser`Get-IAMInstanceProfileForRole`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie les détails du profil d’instance associé au rôle `ec2instancerole`.**
```
Get-IAMInstanceProfileForRole -RoleName ec2instancerole
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:instance-profile/ec2instancerole
CreateDate : 2/17/2015 2:49:04 PM
InstanceProfileId : HH36PTZQJUR32EXAMPLE1
InstanceProfileName : ec2instancerole
Path : /
Roles : {ec2instancerole}
```
+ Pour plus de détails sur l'API, reportez-vous [ListInstanceProfilesForRole](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMInstanceProfileList`
L'exemple de code suivant montre comment utiliser`Get-IAMInstanceProfileList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple renvoie une collection des profils d'instance définis dans le fichier actuel Compte AWS.**
```
Get-IAMInstanceProfileList
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:instance-profile/ec2instancerole
CreateDate : 2/17/2015 2:49:04 PM
InstanceProfileId : HH36PTZQJUR32EXAMPLE1
InstanceProfileName : ec2instancerole
Path : /
Roles : {ec2instancerole}
```
+ Pour plus de détails sur l'API, reportez-vous [ListInstanceProfiles](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMLoginProfile`
L'exemple de code suivant montre comment utiliser`Get-IAMLoginProfile`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie la date de création du mot de passe et indique si une réinitialisation du mot de passe est requise pour l’utilisateur IAM `David`.**
```
Get-IAMLoginProfile -UserName David
```
**Sortie** :
```
CreateDate PasswordResetRequired UserName
---------- --------------------- --------
12/10/2014 3:39:44 PM False David
```
+ Pour plus de détails sur l'API, reportez-vous [GetLoginProfile](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMMFADevice`
L'exemple de code suivant montre comment utiliser`Get-IAMMFADevice`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie des informations sur le dispositif MFA attribué à l’utilisateur IAM `David`. Dans cet exemple, vous pouvez voir qu’il s’agit d’un dispositif virtuel, car le `SerialNumber` est un ARN au lieu du numéro de série réel du dispositif physique.**
```
Get-IAMMFADevice -UserName David
```
**Sortie** :
```
EnableDate SerialNumber UserName
---------- ------------ --------
4/8/2015 9:41:10 AM arn:aws:iam::123456789012:mfa/David David
```
+ Pour plus de détails sur l'API, reportez-vous [ListMfaDevices](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMOpenIDConnectProvider`
L'exemple de code suivant montre comment utiliser`Get-IAMOpenIDConnectProvider`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie des informations sur le fournisseur OpenID Connect dont l’ARN est `arn:aws:iam::123456789012:oidc-provider/accounts.google.com`. La `ClientIDList` propriété est une collection qui contient tous les clients IDs définis pour ce fournisseur.**
```
Get-IAMOpenIDConnectProvider -OpenIDConnectProviderArn arn:aws:iam::123456789012:oidc-provider/oidc.example.com
```
**Sortie** :
```
ClientIDList CreateDate ThumbprintList Url
------------ ---------- -------------- ---
{MyOIDCApp} 2/3/2015 3:00:30 PM {12345abcdefghijk67890lmnopqrst98765uvwxy} oidc.example.com
```
+ Pour plus de détails sur l'API, reportez-vous [GetOpenIdConnectProvider](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMOpenIDConnectProviderList`
L'exemple de code suivant montre comment utiliser`Get-IAMOpenIDConnectProviderList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie une liste des ARN de tous les fournisseurs OpenID Connect définis dans l’ Compte AWS actuel.**
```
Get-IAMOpenIDConnectProviderList
```
**Sortie** :
```
Arn
---
arn:aws:iam::123456789012:oidc-provider/server.example.com
arn:aws:iam::123456789012:oidc-provider/another.provider.com
```
+ Pour plus de détails sur l'API, reportez-vous [ListOpenIdConnectProviders](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMPolicy`
L'exemple de code suivant montre comment utiliser`Get-IAMPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie des détails sur la politique gérée dont l’ARN est `arn:aws:iam::123456789012:policy/MySamplePolicy`.**
```
Get-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy
```
**Sortie** :
```
Arn : arn:aws:iam::aws:policy/MySamplePolicy
AttachmentCount : 0
CreateDate : 2/6/2015 10:40:08 AM
DefaultVersionId : v1
Description :
IsAttachable : True
Path : /
PolicyId : Z27SI6FQMGNQ2EXAMPLE1
PolicyName : MySamplePolicy
UpdateDate : 2/6/2015 10:40:08 AM
```
+ Pour plus de détails sur l'API, reportez-vous [GetPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMPolicyList`
L'exemple de code suivant montre comment utiliser`Get-IAMPolicyList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple renvoie une collection des trois premières politiques gérées disponibles dans le AWS compte courant. Comme il n'`-scope`est pas spécifié, il utilise par défaut `all` et inclut à la fois des politiques AWS gérées et des politiques gérées par le client.**
```
Get-IAMPolicyList -MaxItem 3
```
**Sortie** :
```
Arn : arn:aws:iam::aws:policy/AWSDirectConnectReadOnlyAccess
AttachmentCount : 0
CreateDate : 2/6/2015 10:40:08 AM
DefaultVersionId : v1
Description :
IsAttachable : True
Path : /
PolicyId : Z27SI6FQMGNQ2EXAMPLE1
PolicyName : AWSDirectConnectReadOnlyAccess
UpdateDate : 2/6/2015 10:40:08 AM
Arn : arn:aws:iam::aws:policy/AmazonGlacierReadOnlyAccess
AttachmentCount : 0
CreateDate : 2/6/2015 10:40:27 AM
DefaultVersionId : v1
Description :
IsAttachable : True
Path : /
PolicyId : NJKMU274MET4EEXAMPLE2
PolicyName : AmazonGlacierReadOnlyAccess
UpdateDate : 2/6/2015 10:40:27 AM
Arn : arn:aws:iam::aws:policy/AWSMarketplaceFullAccess
AttachmentCount : 0
CreateDate : 2/11/2015 9:21:45 AM
DefaultVersionId : v1
Description :
IsAttachable : True
Path : /
PolicyId : 5ULJSO2FYVPYGEXAMPLE3
PolicyName : AWSMarketplaceFullAccess
UpdateDate : 2/11/2015 9:21:45 AM
```
**Exemple 2 : Cet exemple renvoie un ensemble des deux premières politiques gérées par le client disponibles dans le AWS compte courant. Il utilise `-Scope local` pour limiter la sortie aux seules politiques gérées par le client.**
```
Get-IAMPolicyList -Scope local -MaxItem 2
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:policy/MyLocalPolicy
AttachmentCount : 0
CreateDate : 2/12/2015 9:39:09 AM
DefaultVersionId : v2
Description :
IsAttachable : True
Path : /
PolicyId : SQVCBLC4VAOUCEXAMPLE4
PolicyName : MyLocalPolicy
UpdateDate : 2/12/2015 9:39:53 AM
Arn : arn:aws:iam::123456789012:policy/policyforec2instancerole
AttachmentCount : 1
CreateDate : 2/17/2015 2:51:38 PM
DefaultVersionId : v11
Description :
IsAttachable : True
Path : /
PolicyId : X5JPBLJH2Z2SOEXAMPLE5
PolicyName : policyforec2instancerole
UpdateDate : 2/18/2015 8:52:31 AM
```
+ Pour plus de détails sur l'API, reportez-vous [ListPolicies](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMPolicyVersion`
L'exemple de code suivant montre comment utiliser`Get-IAMPolicyVersion`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie le document de politique pour la version `v2` de la politique dont l’ARN est `arn:aws:iam::123456789012:policy/MyManagedPolicy` Le document de politique contenu dans la propriété `Document` est encodé sous forme d’URL et est décodé dans cet exemple à l’aide de la méthode .NET `UrlDecode`.**
```
$results = Get-IAMPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MyManagedPolicy -VersionId v2
$results
```
**Sortie** :
```
CreateDate Document IsDefaultVersion VersionId
---------- -------- ---------------- ---------
2/12/2015 9:39:53 AM %7B%0A%20%20%22Version%22%3A%20%222012-10... True v2
[System.Reflection.Assembly]::LoadWithPartialName("System.Web.HttpUtility")
$policy = [System.Web.HttpUtility]::UrlDecode($results.Document)
$policy
{
"Version":"2012-10-17",
"Statement":
{
"Effect": "Allow",
"Action": [
"ec2:DescribeInstances"
],
"Resource": [
"arn:aws:ec2:us-east-1:555555555555:instance/i-b188560f"
]
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetPolicyVersion](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMPolicyVersionList`
L'exemple de code suivant montre comment utiliser`Get-IAMPolicyVersionList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie la liste des versions disponibles de la politique dont l’ARN est `arn:aws:iam::123456789012:policy/MyManagedPolicy`. Pour obtenir le document de politique pour une version spécifique, utilisez la commande `Get-IAMPolicyVersion` et spécifiez le `VersionId` de celle que vous souhaitez.**
```
Get-IAMPolicyVersionList -PolicyArn arn:aws:iam::123456789012:policy/MyManagedPolicy
```
**Sortie** :
```
CreateDate Document IsDefaultVersion VersionId
---------- -------- ---------------- ---------
2/12/2015 9:39:53 AM True v2
2/12/2015 9:39:09 AM False v1
```
+ Pour plus de détails sur l'API, reportez-vous [ListPolicyVersions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMRole`
L'exemple de code suivant montre comment utiliser`Get-IAMRole`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie les détails du `lamda_exec_role`. Il inclut le document de politique d’approbation qui spécifie la personne capable d’assumer ce rôle. Le document de politique est encodé sous forme d’URL et peut être décodé à l’aide de la méthode .NET `UrlDecode`. Dans cet exemple, tous les espaces blancs ont été supprimés de la politique originale avant qu’elle ne soit chargée dans la politique. Pour consulter les documents de politique d’autorisation qui déterminent ce qu’une personne assumant le rôle peut faire, utilisez `Get-IAMRolePolicy` pour les politiques en ligne, et `Get-IAMPolicyVersion` pour les politiques gérées attachées.**
```
$results = Get-IamRole -RoleName lambda_exec_role
$results | Format-List
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:role/lambda_exec_role
AssumeRolePolicyDocument : %7B%22Version%22%3A%222012-10-17%22%2C%22Statement%22%3A%5B%7B%22Sid%22
%3A%22%22%2C%22Effect%22%3A%22Allow%22%2C%22Principal%22%3A%7B%22Service
%22%3A%22lambda.amazonaws.com%22%7D%2C%22Action%22%3A%22sts%3AAssumeRole
%22%7D%5D%7D
CreateDate : 4/2/2015 9:16:11 AM
Path : /
RoleId : 2YBIKAIBHNKB4EXAMPLE1
RoleName : lambda_exec_role
```
```
$policy = [System.Web.HttpUtility]::UrlDecode($results.AssumeRolePolicyDocument)
$policy
```
**Sortie** :
```
{"Version":"2012-10-17", "Statement":[{"Sid":"","Effect":"Allow","Principal":{"Service":"lambda.amazonaws.com"},"Action":"sts:AssumeRole"}]}
```
+ Pour plus de détails sur l'API, reportez-vous [GetRole](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMRoleList`
L'exemple de code suivant montre comment utiliser`Get-IAMRoleList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait une liste de tous les rôles IAM dans l Compte AWS.**
```
Get-IAMRoleList
```
+ Pour plus de détails sur l'API, reportez-vous [ListRoles](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMRolePolicy`
L'exemple de code suivant montre comment utiliser`Get-IAMRolePolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie le document de politique d’autorisations pour la politique nommée `oneClick_lambda_exec_role_policy` qui est intégrée au rôle IAM `lamda_exec_role`. Le document de politique qui en résulte est encodé sous forme d’URL. Elle est décodée dans cet exemple à l’aide de la méthode .NET `UrlDecode`.**
```
$results = Get-IAMRolePolicy -RoleName lambda_exec_role -PolicyName oneClick_lambda_exec_role_policy
$results
```
**Sortie** :
```
PolicyDocument PolicyName UserName
-------------- ---------- --------
%7B%0A%20%20%22Version%22%3A%20%222012-10-17%22%2C%... oneClick_lambda_exec_role_policy lambda_exec_role
```
```
[System.Reflection.Assembly]::LoadWithPartialName("System.Web.HttpUtility")
[System.Web.HttpUtility]::UrlDecode($results.PolicyDocument)
```
**Sortie** :
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:*"
],
"Resource": "arn:aws:logs:us-east-1:555555555555:log-group:/aws/lambda/aws-example-function:*"
},
{
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetRolePolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMRolePolicyList`
L'exemple de code suivant montre comment utiliser`Get-IAMRolePolicyList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie la liste des noms des politiques en ligne intégrées au rôle IAM `lamda_exec_role`. Pour consulter les détails d’une politique en ligne, utilisez la commande `Get-IAMRolePolicy`.**
```
Get-IAMRolePolicyList -RoleName lambda_exec_role
```
**Sortie** :
```
oneClick_lambda_exec_role_policy
```
+ Pour plus de détails sur l'API, reportez-vous [ListRolePolicies](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMRoleTagList`
L'exemple de code suivant montre comment utiliser`Get-IAMRoleTagList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple récupère la balise associée au rôle.**
```
Get-IAMRoleTagList -RoleName MyRoleName
```
+ Pour plus de détails sur l'API, reportez-vous [ListRoleTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMSAMLProvider`
L'exemple de code suivant montre comment utiliser`Get-IAMSAMLProvider`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait les détails du fournisseur SAML 2.0 dont l’ARN est arn:aws:iam::123456789012:saml-provider/SAMLADFS. La réponse inclut le document de métadonnées que vous avez obtenu du fournisseur d'identité pour créer l'entité du fournisseur AWS SAML ainsi que les dates de création et d'expiration.**
```
Get-IAMSAMLProvider -SAMLProviderArn arn:aws:iam::123456789012:saml-provider/SAMLADFS
```
**Sortie** :
```
CreateDate SAMLMetadataDocument ValidUntil
---------- -------------------- ----------
12/23/2014 12:16:55 PM
L'exemple de code suivant montre comment utiliser`Get-IAMSAMLProviderList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait la liste des fournisseurs SAML 2.0 créés dans l’ Compte AWS actuel. Il renvoie l’ARN, la date de création et la date d’expiration pour chaque fournisseur SAML.**
```
Get-IAMSAMLProviderList
```
**Sortie** :
```
Arn CreateDate ValidUntil
--- ---------- ----------
arn:aws:iam::123456789012:saml-provider/SAMLADFS 12/23/2014 12:16:55 PM 12/23/2114 12:16:54 PM
```
+ Pour plus de détails sur l'API, consultez [la section Liste SAMLProviders](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMServerCertificate`
L'exemple de code suivant montre comment utiliser`Get-IAMServerCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait les détails du certificat de serveur nommé `MyServerCertificate`. Vous trouverez les détails du certificat dans les propriétés `CertificateBody` et `ServerCertificateMetadata`.**
```
$result = Get-IAMServerCertificate -ServerCertificateName MyServerCertificate
$result | format-list
```
**Sortie** :
```
CertificateBody : -----BEGIN CERTIFICATE-----
MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD
VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z
b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
-----END CERTIFICATE-----
CertificateChain :
ServerCertificateMetadata : Amazon.IdentityManagement.Model.ServerCertificateMetadata
```
```
$result.ServerCertificateMetadata
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:server-certificate/Org1/Org2/MyServerCertificate
Expiration : 1/14/2018 9:52:36 AM
Path : /Org1/Org2/
ServerCertificateId : ASCAJIFEXAMPLE17HQZYW
ServerCertificateName : MyServerCertificate
UploadDate : 4/21/2015 11:14:16 AM
```
+ Pour plus de détails sur l'API, reportez-vous [GetServerCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMServerCertificateList`
L'exemple de code suivant montre comment utiliser`Get-IAMServerCertificateList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait la liste des certificats de serveur qui ont été chargés sur l’ Compte AWS actuel.**
```
Get-IAMServerCertificateList
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:server-certificate/Org1/Org2/MyServerCertificate
Expiration : 1/14/2018 9:52:36 AM
Path : /Org1/Org2/
ServerCertificateId : ASCAJIFEXAMPLE17HQZYW
ServerCertificateName : MyServerCertificate
UploadDate : 4/21/2015 11:14:16 AM
```
+ Pour plus de détails sur l'API, reportez-vous [ListServerCertificates](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMServiceLastAccessedDetail`
L'exemple de code suivant montre comment utiliser`Get-IAMServiceLastAccessedDetail`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple fournit des détails sur le dernier service auquel a accédé l’entité IAM (utilisateur, groupe, rôle ou politique) associée à l’appel de la requête.**
```
Request-IAMServiceLastAccessedDetail -Arn arn:aws:iam::123456789012:user/TestUser
```
**Sortie** :
```
f0b7a819-eab0-929b-dc26-ca598911cb9f
```
```
Get-IAMServiceLastAccessedDetail -JobId f0b7a819-eab0-929b-dc26-ca598911cb9f
```
+ Pour plus de détails sur l'API, reportez-vous [GetServiceLastAccessedDetails](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMServiceLastAccessedDetailWithEntity`
L'exemple de code suivant montre comment utiliser`Get-IAMServiceLastAccessedDetailWithEntity`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple fournit l’horodatage du dernier accès au service dans la requête par cette entité IAM respective.**
```
$results = Get-IAMServiceLastAccessedDetailWithEntity -JobId f0b7a819-eab0-929b-dc26-ca598911cb9f -ServiceNamespace ec2
$results
```
**Sortie** :
```
EntityDetailsList : {Amazon.IdentityManagement.Model.EntityDetails}
Error :
IsTruncated : False
JobCompletionDate : 12/29/19 11:19:31 AM
JobCreationDate : 12/29/19 11:19:31 AM
JobStatus : COMPLETED
Marker :
```
```
$results.EntityDetailsList
```
**Sortie** :
```
EntityInfo LastAuthenticated
---------- -----------------
Amazon.IdentityManagement.Model.EntityInfo 11/16/19 3:47:00 PM
```
```
$results.EntityInfo
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:user/TestUser
Id : AIDA4NBK5CXF5TZHU1234
Name : TestUser
Path : /
Type : USER
```
+ Pour plus de détails sur l'API, reportez-vous [GetServiceLastAccessedDetailsWithEntities](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMSigningCertificate`
L'exemple de code suivant montre comment utiliser`Get-IAMSigningCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait les détails du certificat de signature associé à l’utilisateur nommé `Bob`.**
```
Get-IAMSigningCertificate -UserName Bob
```
**Sortie** :
```
CertificateBody : -----BEGIN CERTIFICATE-----
MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD
VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z
b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
-----END CERTIFICATE-----
CertificateId : Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU
Status : Active
UploadDate : 4/20/2015 1:26:01 PM
UserName : Bob
```
+ Pour plus de détails sur l'API, reportez-vous [ListSigningCertificates](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMUser`
L'exemple de code suivant montre comment utiliser`Get-IAMUser`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet de récupérer des informations sur l’utilisateur nommé `David`.**
```
Get-IAMUser -UserName David
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:user/David
CreateDate : 12/10/2014 3:39:27 PM
PasswordLastUsed : 3/19/2015 8:44:04 AM
Path : /
UserId : Y4FKWQCXTA52QEXAMPLE1
UserName : David
```
**Exemple 2 : cet exemple récupère les détails de l’utilisateur IAM actuellement connecté.**
```
Get-IAMUser
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:user/Bob
CreateDate : 10/16/2014 9:03:09 AM
PasswordLastUsed : 3/4/2015 12:12:33 PM
Path : /
UserId : 7K3GJEANSKZF2EXAMPLE2
UserName : Bob
```
+ Pour plus de détails sur l'API, reportez-vous [GetUser](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMUserList`
L'exemple de code suivant montre comment utiliser`Get-IAMUserList`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple récupère une collection d'utilisateurs dans le fichier actuel Compte AWS.**
```
Get-IAMUserList
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:user/Administrator
CreateDate : 10/16/2014 9:03:09 AM
PasswordLastUsed : 3/4/2015 12:12:33 PM
Path : /
UserId : 7K3GJEANSKZF2EXAMPLE1
UserName : Administrator
Arn : arn:aws:iam::123456789012:user/Bob
CreateDate : 4/6/2015 12:54:42 PM
PasswordLastUsed : 1/1/0001 12:00:00 AM
Path : /
UserId : L3EWNONDOM3YUEXAMPLE2
UserName : bab
Arn : arn:aws:iam::123456789012:user/David
CreateDate : 12/10/2014 3:39:27 PM
PasswordLastUsed : 3/19/2015 8:44:04 AM
Path : /
UserId : Y4FKWQCXTA52QEXAMPLE3
UserName : David
```
+ Pour plus de détails sur l'API, reportez-vous [ListUsers](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMUserPolicy`
L'exemple de code suivant montre comment utiliser`Get-IAMUserPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait les détails de la politique intégrée nommée `Davids_IAM_Admin_Policy` intégrée dans le nom de l’utilisateur IAM `David`. Le document de politique est encodé sous forme d’URL.**
```
$results = Get-IAMUserPolicy -PolicyName Davids_IAM_Admin_Policy -UserName David
$results
```
**Sortie** :
```
PolicyDocument PolicyName UserName
-------------- ---------- --------
%7B%0A%20%20%22Version%22%3A%20%222012-10-17%22%2C%... Davids_IAM_Admin_Policy David
[System.Reflection.Assembly]::LoadWithPartialName("System.Web.HttpUtility")
[System.Web.HttpUtility]::UrlDecode($results.PolicyDocument)
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iam:GetUser",
"iam:ListUsers"
],
"Resource": [
"arn:aws:iam::111122223333:user/*"
]
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetUserPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMUserPolicyList`
L'exemple de code suivant montre comment utiliser`Get-IAMUserPolicyList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait la liste des noms des politiques en ligne intégrées à l’utilisateur IAM nommé `David`.**
```
Get-IAMUserPolicyList -UserName David
```
**Sortie** :
```
Davids_IAM_Admin_Policy
```
+ Pour plus de détails sur l'API, reportez-vous [ListUserPolicies](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMUserTagList`
L'exemple de code suivant montre comment utiliser`Get-IAMUserTagList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait la balise associée à l’utilisateur.**
```
Get-IAMUserTagList -UserName joe
```
+ Pour plus de détails sur l'API, reportez-vous [ListUserTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-IAMVirtualMFADevice`
L'exemple de code suivant montre comment utiliser`Get-IAMVirtualMFADevice`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple récupère un ensemble de dispositifs MFA virtuels assignés aux utilisateurs du compte. AWS La propriété `User` de chaque dispositif est un objet contenant les détails de l’utilisateur IAM auquel le dispositif est attribué.**
```
Get-IAMVirtualMFADevice -AssignmentStatus Assigned
```
**Sortie** :
```
Base32StringSeed :
EnableDate : 4/13/2015 12:03:42 PM
QRCodePNG :
SerialNumber : arn:aws:iam::123456789012:mfa/David
User : Amazon.IdentityManagement.Model.User
Base32StringSeed :
EnableDate : 4/13/2015 12:06:41 PM
QRCodePNG :
SerialNumber : arn:aws:iam::123456789012:mfa/root-account-mfa-device
User : Amazon.IdentityManagement.Model.User
```
+ Pour plus de détails sur l'API, reportez-vous [ListVirtualMfaDevices](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMAccessKey`
L'exemple de code suivant montre comment utiliser`New-IAMAccessKey`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une paire de clés d’accès et de clés d’accès secrètes et les attribue à l’utilisateur `David`. Prenez soin d’enregistrer les valeurs `AccessKeyId` et `SecretAccessKey` dans un fichier, car c’est la seule fois où vous pouvez obtenir les `SecretAccessKey`. Vous ne pourrez pas la récupérer ultérieurement. Si vous perdez votre clé d’accès secrète, vous devez créer une paire de clés.**
```
New-IAMAccessKey -UserName David
```
**Sortie** :
```
AccessKeyId : AKIAIOSFODNN7EXAMPLE
CreateDate : 4/13/2015 1:00:42 PM
SecretAccessKey : wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Status : Active
UserName : David
```
+ Pour plus de détails sur l'API, reportez-vous [CreateAccessKey](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMAccountAlias`
L'exemple de code suivant montre comment utiliser`New-IAMAccountAlias`.
**Outils pour PowerShell V4**
**Exemple 1 : Dans cet exemple, l'alias de votre AWS compte est remplacé par`mycompanyaws`. L'adresse de la page de connexion utilisateur devient panyaws.signin.aws.amazon.com/console. https://mycom L’URL d’origine utilisant le numéro de votre ID de compte au lieu de l’alias (https://.signin.aws.amazon.com/console) continue de fonctionner. Cependant, toute définition basée sur un alias précédemment définie URLs cesse de fonctionner.**
```
New-IAMAccountAlias -AccountAlias mycompanyaws
```
+ Pour plus de détails sur l'API, reportez-vous [CreateAccountAlias](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMGroup`
L'exemple de code suivant montre comment utiliser`New-IAMGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un groupe IAM nommé `Developers`.**
```
New-IAMGroup -GroupName Developers
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:group/Developers
CreateDate : 4/14/2015 11:21:31 AM
GroupId : QNEJ5PM4NFSQCEXAMPLE1
GroupName : Developers
Path : /
```
+ Pour plus de détails sur l'API, reportez-vous [CreateGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMInstanceProfile`
L'exemple de code suivant montre comment utiliser`New-IAMInstanceProfile`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un profil d’instance IAM nommé `ProfileForDevEC2Instance`. Vous devez exécuter la commande `Add-IAMRoleToInstanceProfile` séparément pour associer le profil d’instance à un rôle IAM existant qui fournit des autorisations à l’instance. Pour finir, attachez le profil d’instance à une instance EC2 lorsque vous la lancez. Pour ce faire, utilisez l’applet de commande `New-EC2Instance` avec le paramètre `InstanceProfile_Arn` ou `InstanceProfile_Name`.**
```
New-IAMInstanceProfile -InstanceProfileName ProfileForDevEC2Instance
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:instance-profile/ProfileForDevEC2Instance
CreateDate : 4/14/2015 11:31:39 AM
InstanceProfileId : DYMFXL556EY46EXAMPLE1
InstanceProfileName : ProfileForDevEC2Instance
Path : /
Roles : {}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateInstanceProfile](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMLoginProfile`
L'exemple de code suivant montre comment utiliser`New-IAMLoginProfile`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un mot de passe (temporaire) pour l’utilisateur IAM nommé Bob et définit l’indicateur qui oblige l’utilisateur à modifier le mot de passe lors de la prochaine connexion de `Bob`.**
```
New-IAMLoginProfile -UserName Bob -Password P@ssw0rd -PasswordResetRequired $true
```
**Sortie** :
```
CreateDate PasswordResetRequired UserName
---------- --------------------- --------
4/14/2015 12:26:30 PM True Bob
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLoginProfile](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMOpenIDConnectProvider`
L'exemple de code suivant montre comment utiliser`New-IAMOpenIDConnectProvider`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un fournisseur IAM OIDC associé au service de fournisseur compatible OIDC figurant sur l’URL `https://example.oidcprovider.com` et l’ID client `my-testapp-1`. Le fournisseur OIDC fournit l’empreinte numérique. Pour authentifier l'empreinte numérique, suivez les étapes indiquées sur http://docs.aws.amazon. com/IAM/latest/UserGuide/identity- providers-oidc-obtain-thumbprint .html.**
```
New-IAMOpenIDConnectProvider -Url https://example.oidcprovider.com -ClientIDList my-testapp-1 -ThumbprintList 990F419EXAMPLEECF12DDEDA5EXAMPLE52F20D9E
```
**Sortie** :
```
arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com
```
+ Pour plus de détails sur l'API, reportez-vous [CreateOpenIdConnectProvider](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMPolicy`
L'exemple de code suivant montre comment utiliser`New-IAMPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée une nouvelle stratégie IAM dans le AWS compte courant nommée Le fichier `MySamplePolicy.json` fournit `MySamplePolicy` le contenu de la stratégie. Notez que vous devez utiliser le paramètre booléen `-Raw` pour traiter correctement le fichier de politique JSON.**
```
New-IAMPolicy -PolicyName MySamplePolicy -PolicyDocument (Get-Content -Raw MySamplePolicy.json)
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:policy/MySamplePolicy
AttachmentCount : 0
CreateDate : 4/14/2015 2:45:59 PM
DefaultVersionId : v1
Description :
IsAttachable : True
Path : /
PolicyId : LD4KP6HVFE7WGEXAMPLE1
PolicyName : MySamplePolicy
UpdateDate : 4/14/2015 2:45:59 PM
```
+ Pour plus de détails sur l'API, reportez-vous [CreatePolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMPolicyVersion`
L'exemple de code suivant montre comment utiliser`New-IAMPolicyVersion`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une version « v2 » de la politique IAM dont l’ARN est `arn:aws:iam::123456789012:policy/MyPolicy` et en fait la version par défaut. Le fichier `NewPolicyVersion.json` fournit le contenu de la politique. Notez que vous devez utiliser le paramètre booléen `-Raw` pour traiter correctement le fichier de politique JSON.**
```
New-IAMPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MyPolicy -PolicyDocument (Get-content -Raw NewPolicyVersion.json) -SetAsDefault $true
```
**Sortie** :
```
CreateDate Document IsDefaultVersion VersionId
---------- -------- ---------------- ---------
4/15/2015 10:54:54 AM True v2
```
+ Pour plus de détails sur l'API, reportez-vous [CreatePolicyVersion](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMRole`
L'exemple de code suivant montre comment utiliser`New-IAMRole`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un rôle nommé `MyNewRole` et y attache la politique trouvée dans le fichier `NewRoleTrustPolicy.json`. Notez que vous devez utiliser le paramètre booléen `-Raw` pour traiter correctement le fichier de politique JSON. Le document de politique affiché dans la sortie est codé en URL. Il est décodé dans cet exemple à l’aide de la méthode .NET `UrlDecode`.**
```
$results = New-IAMRole -AssumeRolePolicyDocument (Get-Content -raw NewRoleTrustPolicy.json) -RoleName MyNewRole
$results
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:role/MyNewRole
AssumeRolePolicyDocument : %7B%0D%0A%20%20%22Version%22%3A%20%222012-10-17%22%2C%0D%0A%20%20%22Statement%22
%3A%20%5B%0D%0A%20%20%20%20%7B%0D%0A%20%20%20%20%20%20%22Sid%22%3A%20%22%22%2C
%0D%0A%20%20%20%20%20%20%22Effect%22%3A%20%22Allow%22%2C%0D%0A%20%20%20%20%20%20
%22Principal%22%3A%20%7B%0D%0A%20%20%20%20%20%20%20%20%22AWS%22%3A%20%22arn%3Aaws
%3Aiam%3A%3A123456789012%3ADavid%22%0D%0A%20%20%20%20%20%20%7D%2C%0D%0A%20%20%20
%20%20%20%22Action%22%3A%20%22sts%3AAssumeRole%22%0D%0A%20%20%20%20%7D%0D%0A%20
%20%5D%0D%0A%7D
CreateDate : 4/15/2015 11:04:23 AM
Path : /
RoleId : V5PAJI2KPN4EAEXAMPLE1
RoleName : MyNewRole
[System.Reflection.Assembly]::LoadWithPartialName("System.Web.HttpUtility")
[System.Web.HttpUtility]::UrlDecode($results.AssumeRolePolicyDocument)
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::123456789012:David"
},
"Action": "sts:AssumeRole"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateRole](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMSAMLProvider`
L'exemple de code suivant montre comment utiliser`New-IAMSAMLProvider`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une entité de fournisseur SAML dans IAM. Il est nommé `MySAMLProvider` et est décrit par le document de métadonnées SAML trouvé dans le fichier `SAMLMetaData.xml`, qui a été téléchargé séparément depuis le site Web du fournisseur de services SAML.**
```
New-IAMSAMLProvider -Name MySAMLProvider -SAMLMetadataDocument (Get-Content -Raw SAMLMetaData.xml)
```
**Sortie** :
```
arn:aws:iam::123456789012:saml-provider/MySAMLProvider
```
+ Pour plus de détails sur l'API, voir [Create SAMLProvider](https://docs.aws.amazon.com/powershell/v4/reference) in *Outils AWS pour PowerShell Cmdlet Reference (V4)*.
### `New-IAMServiceLinkedRole`
L'exemple de code suivant montre comment utiliser`New-IAMServiceLinkedRole`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un rôle lié à un service pour le service de mise à l’échelle automatique.**
```
New-IAMServiceLinkedRole -AWSServiceName autoscaling.amazonaws.com -CustomSuffix RoleNameEndsWithThis -Description "My service-linked role to support autoscaling"
```
+ Pour plus de détails sur l'API, reportez-vous [CreateServiceLinkedRole](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMUser`
L'exemple de code suivant montre comment utiliser`New-IAMUser`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un utilisateur IAM nommé `Bob`. Si Bob doit se connecter à la AWS console, vous devez exécuter la commande séparément `New-IAMLoginProfile` pour créer un profil de connexion avec un mot de passe. Si Bob doit exécuter AWS PowerShell des commandes CLI multiplateformes ou effectuer des appels d' AWS API, vous devez exécuter la `New-IAMAccessKey` commande séparément pour créer des clés d'accès.**
```
New-IAMUser -UserName Bob
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:user/Bob
CreateDate : 4/22/2015 12:02:11 PM
PasswordLastUsed : 1/1/0001 12:00:00 AM
Path : /
UserId : AIDAJWGEFDMEMEXAMPLE1
UserName : Bob
```
+ Pour plus de détails sur l'API, reportez-vous [CreateUser](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-IAMVirtualMFADevice`
L'exemple de code suivant montre comment utiliser`New-IAMVirtualMFADevice`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un dispositif MFA virtuel. Les lignes 2 et 3 extraient la valeur `Base32StringSeed` dont le logiciel MFA virtuel a besoin pour créer un compte (comme alternative au code QR). Après avoir configuré le programme avec la valeur, obtenez deux codes d’authentification séquentiels auprès du programme. Enfin, utilisez la dernière commande pour associer le dispositif MFA virtuel à l’utilisateur IAM `Bob` et synchroniser le compte avec les deux codes d’authentification.**
```
$Device = New-IAMVirtualMFADevice -VirtualMFADeviceName BobsMFADevice
$SR = New-Object System.IO.StreamReader($Device.Base32StringSeed)
$base32stringseed = $SR.ReadToEnd()
$base32stringseed
CZWZMCQNW4DEXAMPLE3VOUGXJFZYSUW7EXAMPLECR4NJFD65GX2SLUDW2EXAMPLE
```
**Sortie** :
```
-- Pause here to enter base-32 string seed code into virtual MFA program to register account. --
Enable-IAMMFADevice -SerialNumber $Device.SerialNumber -UserName Bob -AuthenticationCode1 123456 -AuthenticationCode2 789012
```
**Exemple 2 : cet exemple crée un dispositif MFA virtuel. Les lignes 2 et 3 extraient la valeur `QRCodePNG` et l’écrivent dans un fichier. Cette image peut être numérisée par le logiciel MFA virtuel pour créer un compte (au lieu de saisir manuellement la valeur Base32StringSeed ). Après avoir créé le compte dans votre programme MFA virtuel, obtenez deux codes d’authentification séquentiels et saisissez-les dans les dernières commandes pour associer le dispositif MFA virtuel à l’utilisateur IAM `Bob` et synchroniser le compte**
```
$Device = New-IAMVirtualMFADevice -VirtualMFADeviceName BobsMFADevice
$BR = New-Object System.IO.BinaryReader($Device.QRCodePNG)
$BR.ReadBytes($BR.BaseStream.Length) | Set-Content -Encoding Byte -Path QRCode.png
```
**Sortie** :
```
-- Pause here to scan PNG with virtual MFA program to register account. --
Enable-IAMMFADevice -SerialNumber $Device.SerialNumber -UserName Bob -AuthenticationCode1 123456 -AuthenticationCode2 789012
```
+ Pour plus de détails sur l'API, reportez-vous [CreateVirtualMfaDevice](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Publish-IAMServerCertificate`
L'exemple de code suivant montre comment utiliser`Publish-IAMServerCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple charge un nouveau certificat de serveur sur le compte IAM. Les fichiers contenant le corps du certificat, la clé privée et (éventuellement) la chaîne de certificats doivent tous être codés au format PEM. Notez que les paramètres nécessitent le contenu réel des fichiers plutôt que les noms de fichiers. Vous devez utiliser le paramètre booléen `-Raw` pour traiter correctement le contenu du fichier.**
```
Publish-IAMServerCertificate -ServerCertificateName MyTestCert -CertificateBody (Get-Content -Raw server.crt) -PrivateKey (Get-Content -Raw server.key)
```
**Sortie** :
```
Arn : arn:aws:iam::123456789012:server-certificate/MyTestCert
Expiration : 1/14/2018 9:52:36 AM
Path : /
ServerCertificateId : ASCAJIEXAMPLE7J7HQZYW
ServerCertificateName : MyTestCert
UploadDate : 4/21/2015 11:14:16 AM
```
+ Pour plus de détails sur l'API, reportez-vous [UploadServerCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Publish-IAMSigningCertificate`
L'exemple de code suivant montre comment utiliser`Publish-IAMSigningCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple charge un nouveau certificat de signature X.509 et l’associe à l’utilisateur IAM nommé `Bob`. Le fichier contenant le corps du certificat est codé au format PEM. Le paramètre `CertificateBody` nécessite le contenu réel du fichier de certificat plutôt que le nom du fichier. Vous devez utiliser le paramètre booléen `-Raw` pour traiter correctement le fichier.**
```
Publish-IAMSigningCertificate -UserName Bob -CertificateBody (Get-Content -Raw SampleSigningCert.pem)
```
**Sortie** :
```
CertificateBody : -----BEGIN CERTIFICATE-----
MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD
VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z
b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
-----END CERTIFICATE-----
CertificateId : Y3EK7RMEXAMPLESV33FCEXAMPLEHMJLU
Status : Active
UploadDate : 4/20/2015 1:26:01 PM
UserName : Bob
```
+ Pour plus de détails sur l'API, reportez-vous [UploadSigningCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-IAMGroupPolicy`
L'exemple de code suivant montre comment utiliser`Register-IAMGroupPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple associe la politique gérée par le client, nommée `TesterPolicy`, au groupe IAM `Testers`. Les utilisateurs de ce groupe sont immédiatement affectés par les autorisations définies dans la version par défaut de cette politique.**
```
Register-IAMGroupPolicy -GroupName Testers -PolicyArn arn:aws:iam::123456789012:policy/TesterPolicy
```
**Exemple 2 : Cet exemple associe la politique AWS gérée nommée `AdministratorAccess` au groupe `Admins` IAM. Les utilisateurs de ce groupe sont immédiatement affectés par les autorisations définies dans la version la plus récente de cette politique.**
```
Register-IAMGroupPolicy -GroupName Admins -PolicyArn arn:aws:iam::aws:policy/AdministratorAccess
```
+ Pour plus de détails sur l'API, reportez-vous [AttachGroupPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-IAMRolePolicy`
L'exemple de code suivant montre comment utiliser`Register-IAMRolePolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple associe la politique AWS gérée nommée `SecurityAudit` au rôle `CoSecurityAuditors` IAM. Les utilisateurs qui assument ce rôle sont immédiatement affectés par les autorisations définies dans la version la plus récente de cette politique.**
```
Register-IAMRolePolicy -RoleName CoSecurityAuditors -PolicyArn arn:aws:iam::aws:policy/SecurityAudit
```
+ Pour plus de détails sur l'API, reportez-vous [AttachRolePolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-IAMUserPolicy`
L'exemple de code suivant montre comment utiliser`Register-IAMUserPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple attache la politique AWS gérée nommée `AmazonCognitoPowerUser` à l'utilisateur `Bob` IAM. L’utilisateur est immédiatement affecté par les autorisations définies dans la version la plus récente de cette politique.**
```
Register-IAMUserPolicy -UserName Bob -PolicyArn arn:aws:iam::aws:policy/AmazonCognitoPowerUser
```
+ Pour plus de détails sur l'API, reportez-vous [AttachUserPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMAccessKey`
L'exemple de code suivant montre comment utiliser`Remove-IAMAccessKey`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime la paire de clés AWS d'accès avec l'ID `AKIAIOSFODNN7EXAMPLE` de clé de l'utilisateur nommé`Bob`.**
```
Remove-IAMAccessKey -AccessKeyId AKIAIOSFODNN7EXAMPLE -UserName Bob -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteAccessKey](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMAccountAlias`
L'exemple de code suivant montre comment utiliser`Remove-IAMAccountAlias`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime l'alias de compte de votre Compte AWS. La page de connexion de l'utilisateur avec l'alias https://mycom panyaws.signin.aws.amazon.com/console ne fonctionne plus. Vous devez plutôt utiliser l'URL d'origine avec votre numéro d' Compte AWS identification sur https ://.signin.aws.amazon.com/console.**
```
Remove-IAMAccountAlias -AccountAlias mycompanyaws
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteAccountAlias](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMAccountPasswordPolicy`
L'exemple de code suivant montre comment utiliser`Remove-IAMAccountPasswordPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime la politique de mot de passe pour le Compte AWS et rétablit toutes les valeurs par défaut d'origine. Si aucune politique de mot de passe n'existe actuellement, le message d'erreur suivant s'affiche : PasswordPolicy Impossible de trouver la politique de compte portant le nom.**
```
Remove-IAMAccountPasswordPolicy
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteAccountPasswordPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMClientIDFromOpenIDConnectProvider`
L'exemple de code suivant montre comment utiliser`Remove-IAMClientIDFromOpenIDConnectProvider`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime l'ID client `My-TestApp-3` de la liste des clients IDs associés au fournisseur IAM OIDC dont l'ARN est l'ARN. `arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com`**
```
Remove-IAMClientIDFromOpenIDConnectProvider -ClientID My-TestApp-3 -OpenIDConnectProviderArn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com
```
+ Pour plus de détails sur l'API, reportez-vous [RemoveClientIdFromOpenIdConnectProvider](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMGroup`
L'exemple de code suivant montre comment utiliser`Remove-IAMGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le groupe IAM nommé `MyTestGroup`. La première commande supprime tous les utilisateurs IAM membres du groupe, et la seconde supprime le groupe IAM. Les deux commandes fonctionnent sans qu’aucune invite de confirmation ne soit requise.**
```
(Get-IAMGroup -GroupName MyTestGroup).Users | Remove-IAMUserFromGroup -GroupName MyTestGroup -Force
Remove-IAMGroup -GroupName MyTestGroup -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMGroupPolicy`
L'exemple de code suivant montre comment utiliser`Remove-IAMGroupPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la politique en ligne nommée `TesterPolicy` du groupe IAM `Testers`. Les utilisateurs de ce groupe perdent immédiatement les autorisations définies dans cette politique.**
```
Remove-IAMGroupPolicy -GroupName Testers -PolicyName TestPolicy
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteGroupPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMInstanceProfile`
L'exemple de code suivant montre comment utiliser`Remove-IAMInstanceProfile`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le profil d’instance EC2 nommé `MyAppInstanceProfile`. La première commande détache tous les rôles du profil d’instance, puis la seconde commande supprime le profil d’instance.**
```
(Get-IAMInstanceProfile -InstanceProfileName MyAppInstanceProfile).Roles | Remove-IAMRoleFromInstanceProfile -InstanceProfileName MyAppInstanceProfile
Remove-IAMInstanceProfile -InstanceProfileName MyAppInstanceProfile
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteInstanceProfile](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMLoginProfile`
L'exemple de code suivant montre comment utiliser`Remove-IAMLoginProfile`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le profil de connexion de l’utilisateur IAM nommé `Bob`. Cela empêche l'utilisateur de se connecter à la AWS console. Cela n'empêche pas l'utilisateur d'exécuter des appels de AWS CLI ou d'API AWS à l'aide de clés d'accès qui peuvent toujours être associées au compte utilisateur. PowerShell**
```
Remove-IAMLoginProfile -UserName Bob
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLoginProfile](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMOpenIDConnectProvider`
L'exemple de code suivant montre comment utiliser`Remove-IAMOpenIDConnectProvider`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le fournisseur IAM OIDC qui se connecte au fournisseur `example.oidcprovider.com`. Assurez-vous de mettre à jour ou de supprimer tous les rôles qui font référence à ce fournisseur dans l’élément `Principal` de la politique d’approbation du rôle.**
```
Remove-IAMOpenIDConnectProvider -OpenIDConnectProviderArn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteOpenIdConnectProvider](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMPolicy`
L'exemple de code suivant montre comment utiliser`Remove-IAMPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la politique dont l’ARN est `arn:aws:iam::123456789012:policy/MySamplePolicy`. Avant de supprimer la politique, vous devez commencer par supprimer toutes les versions, à l’exception de la politique par défaut, en exécutant `Remove-IAMPolicyVersion`. Vous devez également détacher la politique de tous les utilisateurs, groupes ou rôles IAM.**
```
Remove-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy
```
**Exemple 2 : cet exemple supprime une politique en supprimant d’abord toutes les versions de politique autres que celles par défaut, en la détachant de toutes les entités IAM auxquelles elle est attachée, puis en supprimant la politique elle-même. La première ligne extrait l’objet de politique. La deuxième ligne extrait toutes les versions de la politique qui ne sont pas marquées comme étant la version par défaut dans une collection et supprime ensuite chaque politique de la collection. La troisième ligne extrait tous les utilisateurs, groupes et rôles IAM auxquels la politique est attachée. Les lignes quatre à six détachent la politique de chaque entité attachée. La dernière ligne utilise cette commande pour supprimer la politique gérée ainsi que la version par défaut restante. L’exemple inclut le paramètre booléen `-Force` sur toute ligne qui en a besoin pour supprimer les invites de confirmation.**
```
$pol = Get-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy
Get-IAMPolicyVersions -PolicyArn $pol.Arn | where {-not $_.IsDefaultVersion} | Remove-IAMPolicyVersion -PolicyArn $pol.Arn -force
$attached = Get-IAMEntitiesForPolicy -PolicyArn $pol.Arn
$attached.PolicyGroups | Unregister-IAMGroupPolicy -PolicyArn $pol.arn
$attached.PolicyRoles | Unregister-IAMRolePolicy -PolicyArn $pol.arn
$attached.PolicyUsers | Unregister-IAMUserPolicy -PolicyArn $pol.arn
Remove-IAMPolicy $pol.Arn -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeletePolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMPolicyVersion`
L'exemple de code suivant montre comment utiliser`Remove-IAMPolicyVersion`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la version identifiée comme `v2` de la politique dont l’ARN est `arn:aws:iam::123456789012:policy/MySamplePolicy`.**
```
Remove-IAMPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy -VersionID v2
```
**Exemple 2 : cet exemple supprime une politique en supprimant d’abord toutes les versions de politique autres que celles par défaut, puis en supprimant la politique elle-même. La première ligne extrait l’objet de politique. La deuxième ligne extrait toutes les versions de politique qui ne sont pas signalées comme étant par défaut dans une collection, puis utilise cette commande pour supprimer chaque politique de la collection. La dernière ligne supprime la politique elle-même ainsi que la version par défaut restante. Notez que pour supprimer correctement une politique gérée, vous devez également la détacher de tous les utilisateurs, groupes ou rôles à l’aide des commandes `Unregister-IAMUserPolicy`, `Unregister-IAMGroupPolicy` et `Unregister-IAMRolePolicy`. Consultez l’exemple pour l’applet de commande `Remove-IAMPolicy`.**
```
$pol = Get-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy
Get-IAMPolicyVersions -PolicyArn $pol.Arn | where {-not $_.IsDefaultVersion} | Remove-IAMPolicyVersion -PolicyArn $pol.Arn -force
Remove-IAMPolicy -PolicyArn $pol.Arn -force
```
+ Pour plus de détails sur l'API, reportez-vous [DeletePolicyVersion](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMRole`
L'exemple de code suivant montre comment utiliser`Remove-IAMRole`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le rôle nommé `MyNewRole` du compte IAM actuel. Avant de pouvoir supprimer le rôle, vous devez d’abord utiliser la commande `Unregister-IAMRolePolicy` pour détacher les politiques gérées. Les politiques en ligne sont supprimées avec le rôle.**
```
Remove-IAMRole -RoleName MyNewRole
```
**Exemple 2 : cet exemple détache toutes les politiques gérées du rôle nommé `MyNewRole`, puis supprime le rôle. La première ligne extrait toutes les politiques gérées associées au rôle en tant que collection, puis détache du rôle chaque politique de la collection. La deuxième ligne supprime le rôle lui-même. Les politiques en ligne sont supprimées en même temps que le rôle.**
```
Get-IAMAttachedRolePolicyList -RoleName MyNewRole | Unregister-IAMRolePolicy -RoleName MyNewRole
Remove-IAMRole -RoleName MyNewRole
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteRole](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMRoleFromInstanceProfile`
L'exemple de code suivant montre comment utiliser`Remove-IAMRoleFromInstanceProfile`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le rôle nommé `MyNewRole` du profil d’instance EC2 nommé `MyNewRole`. Un profil d’instance créé dans la console IAM porte toujours le même nom que le rôle, comme dans cet exemple. Si vous les créez dans l’API ou la CLI, ils peuvent porter des noms différents.**
```
Remove-IAMRoleFromInstanceProfile -InstanceProfileName MyNewRole -RoleName MyNewRole -Force
```
+ Pour plus de détails sur l'API, reportez-vous [RemoveRoleFromInstanceProfile](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMRolePermissionsBoundary`
L'exemple de code suivant montre comment utiliser`Remove-IAMRolePermissionsBoundary`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre comment supprimer la limite des autorisations attachée à un rôle IAM.**
```
Remove-IAMRolePermissionsBoundary -RoleName MyRoleName
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteRolePermissionsBoundary](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMRolePolicy`
L'exemple de code suivant montre comment utiliser`Remove-IAMRolePolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la politique en ligne `S3AccessPolicy` intégrée au rôle IAM `S3BackupRole`.**
```
Remove-IAMRolePolicy -PolicyName S3AccessPolicy -RoleName S3BackupRole
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteRolePolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMRoleTag`
L'exemple de code suivant montre comment utiliser`Remove-IAMRoleTag`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime la balise du rôle nommé « MyRoleName » avec la clé de balise « abac ». Pour supprimer plusieurs balises, fournissez une liste de clés de balises séparées par des virgules.**
```
Remove-IAMRoleTag -RoleName MyRoleName -TagKey "abac","xyzw"
```
+ Pour plus de détails sur l'API, reportez-vous [UntagRole](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMSAMLProvider`
L'exemple de code suivant montre comment utiliser`Remove-IAMSAMLProvider`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le fournisseur IAM SAML 2.0 dont l’ARN est `arn:aws:iam::123456789012:saml-provider/SAMLADFSProvider`.**
```
Remove-IAMSAMLProvider -SAMLProviderArn arn:aws:iam::123456789012:saml-provider/SAMLADFSProvider
```
+ Pour plus de détails sur l'API, voir [Supprimer SAMLProvider](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMServerCertificate`
L'exemple de code suivant montre comment utiliser`Remove-IAMServerCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le certificat de serveur nommé `MyServerCert`.**
```
Remove-IAMServerCertificate -ServerCertificateName MyServerCert
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteServerCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMServiceLinkedRole`
L'exemple de code suivant montre comment utiliser`Remove-IAMServiceLinkedRole`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le rôle lié au service. Notez que si le service utilise toujours ce rôle, l’exécution de cette commande se soldera par un échec.**
```
Remove-IAMServiceLinkedRole -RoleName AWSServiceRoleForAutoScaling_RoleNameEndsWithThis
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteServiceLinkedRole](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMSigningCertificate`
L'exemple de code suivant montre comment utiliser`Remove-IAMSigningCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le certificat de signature portant l’ID `Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU` de l’utilisateur IAM nommé. `Bob`**
```
Remove-IAMSigningCertificate -UserName Bob -CertificateId Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteSigningCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMUser`
L'exemple de code suivant montre comment utiliser`Remove-IAMUser`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’utilisateur IAM nommé `Bob`.**
```
Remove-IAMUser -UserName Bob
```
**Exemple 2 : cet exemple supprime l’utilisateur IAM nommé `Theresa`, ainsi que tous les éléments qui doivent être supprimés au préalable.**
```
$name = "Theresa"
# find any groups and remove user from them
$groups = Get-IAMGroupForUser -UserName $name
foreach ($group in $groups) { Remove-IAMUserFromGroup -GroupName $group.GroupName -UserName $name -Force }
# find any inline policies and delete them
$inlinepols = Get-IAMUserPolicies -UserName $name
foreach ($pol in $inlinepols) { Remove-IAMUserPolicy -PolicyName $pol -UserName $name -Force}
# find any managed polices and detach them
$managedpols = Get-IAMAttachedUserPolicies -UserName $name
foreach ($pol in $managedpols) { Unregister-IAMUserPolicy -PolicyArn $pol.PolicyArn -UserName $name }
# find any signing certificates and delete them
$certs = Get-IAMSigningCertificate -UserName $name
foreach ($cert in $certs) { Remove-IAMSigningCertificate -CertificateId $cert.CertificateId -UserName $name -Force }
# find any access keys and delete them
$keys = Get-IAMAccessKey -UserName $name
foreach ($key in $keys) { Remove-IAMAccessKey -AccessKeyId $key.AccessKeyId -UserName $name -Force }
# delete the user's login profile, if one exists - note: need to use try/catch to suppress not found error
try { $prof = Get-IAMLoginProfile -UserName $name -ea 0 } catch { out-null }
if ($prof) { Remove-IAMLoginProfile -UserName $name -Force }
# find any MFA device, detach it, and if virtual, delete it.
$mfa = Get-IAMMFADevice -UserName $name
if ($mfa) {
Disable-IAMMFADevice -SerialNumber $mfa.SerialNumber -UserName $name
if ($mfa.SerialNumber -like "arn:*") { Remove-IAMVirtualMFADevice -SerialNumber $mfa.SerialNumber }
}
# finally, remove the user
Remove-IAMUser -UserName $name -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteUser](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMUserFromGroup`
L'exemple de code suivant montre comment utiliser`Remove-IAMUserFromGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’utilisateur IAM `Bob` du groupe `Testers`.**
```
Remove-IAMUserFromGroup -GroupName Testers -UserName Bob
```
**Exemple 2 : cet exemple trouve tous les groupes dont l’utilisateur IAM `Theresa` est membre, puis retire `Theresa` de ces groupes.**
```
$groups = Get-IAMGroupForUser -UserName Theresa
foreach ($group in $groups) { Remove-IAMUserFromGroup -GroupName $group.GroupName -UserName Theresa -Force }
```
**Exemple 3 : cet exemple montre une autre méthode pour supprimer l’utilisateur IAM `Bob` du groupe `Testers`.**
```
Get-IAMGroupForUser -UserName Bob | Remove-IAMUserFromGroup -UserName Bob -GroupName Testers -Force
```
+ Pour plus de détails sur l'API, reportez-vous [RemoveUserFromGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMUserPermissionsBoundary`
L'exemple de code suivant montre comment utiliser`Remove-IAMUserPermissionsBoundary`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre comment supprimer la limite des autorisations attachée à un utilisateur IAM.**
```
Remove-IAMUserPermissionsBoundary -UserName joe
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteUserPermissionsBoundary](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMUserPolicy`
L'exemple de code suivant montre comment utiliser`Remove-IAMUserPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la politique en ligne nommée `AccessToEC2Policy` intégrée dans le nom de l’utilisateur IAM `Bob`.**
```
Remove-IAMUserPolicy -PolicyName AccessToEC2Policy -UserName Bob
```
**Exemple 2 : cet exemple recherche toutes les politiques en ligne qui sont intégrées dans l’utilisateur IAM nommé `Theresa`, puis les supprime.**
```
$inlinepols = Get-IAMUserPolicies -UserName Theresa
foreach ($pol in $inlinepols) { Remove-IAMUserPolicy -PolicyName $pol -UserName Theresa -Force}
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteUserPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMUserTag`
L'exemple de code suivant montre comment utiliser`Remove-IAMUserTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la balise de l’utilisateur nommée « joe » dont les clés de balise sont « abac » et « xyzw ». Pour supprimer plusieurs balises, fournissez une liste de clés de balises séparées par des virgules.**
```
Remove-IAMUserTag -UserName joe -TagKey "abac","xyzw"
```
+ Pour plus de détails sur l'API, reportez-vous [UntagUser](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-IAMVirtualMFADevice`
L'exemple de code suivant montre comment utiliser`Remove-IAMVirtualMFADevice`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le dispositif MFA virtuel IAM dont l’ARN est `arn:aws:iam::123456789012:mfa/bob`.**
```
Remove-IAMVirtualMFADevice -SerialNumber arn:aws:iam::123456789012:mfa/bob
```
**Exemple 2 : cet exemple vérifie si l’utilisateur IAM Theresa s’est vu attribuer un dispositif MFA. S’il en trouve un, le dispositif est désactivé pour l’utilisateur IAM. Si le dispositif est virtuel, il est également supprimé.**
```
$mfa = Get-IAMMFADevice -UserName Theresa
if ($mfa) {
Disable-IAMMFADevice -SerialNumber $mfa.SerialNumber -UserName $name
if ($mfa.SerialNumber -like "arn:*") { Remove-IAMVirtualMFADevice -SerialNumber $mfa.SerialNumber }
}
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteVirtualMfaDevice](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Request-IAMCredentialReport`
L'exemple de code suivant montre comment utiliser`Request-IAMCredentialReport`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple demande la génération d’un nouveau rapport, qui peut être effectué toutes les quatre heures. Si le dernier rapport est encore récent, le champ État est libellé comme suit : `COMPLETE`. Utilisez `Get-IAMCredentialReport` pour afficher le rapport complété.**
```
Request-IAMCredentialReport
```
**Sortie** :
```
Description State
----------- -----
No report exists. Starting a new report generation task STARTED
```
+ Pour plus de détails sur l'API, reportez-vous [GenerateCredentialReport](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Request-IAMServiceLastAccessedDetail`
L'exemple de code suivant montre comment utiliser`Request-IAMServiceLastAccessedDetail`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple est une applet de commande équivalente à l' GenerateServiceLastAccessedDetails API. Cela fournit un identifiant de tâche qui peut être utilisé dans Get-IAMServiceLastAccessedDetail et Get- IAMService LastAccessedDetailWithEntity**
```
Request-IAMServiceLastAccessedDetail -Arn arn:aws:iam::123456789012:user/TestUser
```
+ Pour plus de détails sur l'API, reportez-vous [GenerateServiceLastAccessedDetails](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-IAMDefaultPolicyVersion`
L'exemple de code suivant montre comment utiliser`Set-IAMDefaultPolicyVersion`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple définit la version `v2` de la politique dont l’ARN est `arn:aws:iam::123456789012:policy/MyPolicy` en tant que version active par défaut.**
```
Set-IAMDefaultPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MyPolicy -VersionId v2
```
+ Pour plus de détails sur l'API, reportez-vous [SetDefaultPolicyVersion](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-IAMRolePermissionsBoundary`
L'exemple de code suivant montre comment utiliser`Set-IAMRolePermissionsBoundary`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre comment définir la limite des autorisations pour un rôle IAM. Vous pouvez définir des politiques AWS gérées ou des politiques personnalisées comme limite d'autorisation.**
```
Set-IAMRolePermissionsBoundary -RoleName MyRoleName -PermissionsBoundary arn:aws:iam::123456789012:policy/intern-boundary
```
+ Pour plus de détails sur l'API, reportez-vous [PutRolePermissionsBoundary](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-IAMUserPermissionsBoundary`
L'exemple de code suivant montre comment utiliser`Set-IAMUserPermissionsBoundary`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre comment définir la limite des autorisations pour l’utilisateur. Vous pouvez définir des politiques AWS gérées ou des politiques personnalisées comme limite d'autorisation.**
```
Set-IAMUserPermissionsBoundary -UserName joe -PermissionsBoundary arn:aws:iam::123456789012:policy/intern-boundary
```
+ Pour plus de détails sur l'API, reportez-vous [PutUserPermissionsBoundary](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Sync-IAMMFADevice`
L'exemple de code suivant montre comment utiliser`Sync-IAMMFADevice`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple synchronise le dispositif MFA associé à l’utilisateur IAM `Bob` et dont l’ARN est `arn:aws:iam::123456789012:mfa/bob` avec un programme d’authentification qui a fourni les deux codes d’authentification.**
```
Sync-IAMMFADevice -SerialNumber arn:aws:iam::123456789012:mfa/theresa -AuthenticationCode1 123456 -AuthenticationCode2 987654 -UserName Bob
```
**Exemple 2 : cet exemple synchronise le dispositif MFA IAM associé à l’utilisateur IAM `Theresa` avec un périphérique physique possédant le numéro de série `ABCD12345678` et qui a fourni les deux codes d’authentification.**
```
Sync-IAMMFADevice -SerialNumber ABCD12345678 -AuthenticationCode1 123456 -AuthenticationCode2 987654 -UserName Theresa
```
+ Pour plus de détails sur l'API, reportez-vous [ResyncMfaDevice](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-IAMGroupPolicy`
L'exemple de code suivant montre comment utiliser`Unregister-IAMGroupPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple détache la politique de groupe géré dont l’ARN est `arn:aws:iam::123456789012:policy/TesterAccessPolicy` du groupe nommé `Testers`.**
```
Unregister-IAMGroupPolicy -GroupName Testers -PolicyArn arn:aws:iam::123456789012:policy/TesterAccessPolicy
```
**Exemple 2 : cet exemple trouve toutes les politiques gérées associées au groupe nommé `Testers` et les détache du groupe.**
```
Get-IAMAttachedGroupPolicies -GroupName Testers | Unregister-IAMGroupPolicy -Groupname Testers
```
+ Pour plus de détails sur l'API, reportez-vous [DetachGroupPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-IAMRolePolicy`
L'exemple de code suivant montre comment utiliser`Unregister-IAMRolePolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple détache la politique de groupe géré dont l’ARN est `arn:aws:iam::123456789012:policy/FederatedTesterAccessPolicy` du rôle nommé `FedTesterRole`.**
```
Unregister-IAMRolePolicy -RoleName FedTesterRole -PolicyArn arn:aws:iam::123456789012:policy/FederatedTesterAccessPolicy
```
**Exemple 2 : cet exemple recherche toutes les politiques gérées associées au rôle nommé `FedTesterRole` et les détache du rôle.**
```
Get-IAMAttachedRolePolicyList -RoleName FedTesterRole | Unregister-IAMRolePolicy -Rolename FedTesterRole
```
+ Pour plus de détails sur l'API, reportez-vous [DetachRolePolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-IAMUserPolicy`
L'exemple de code suivant montre comment utiliser`Unregister-IAMUserPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple détache la politique gérée dont l’ARN est `arn:aws:iam::123456789012:policy/TesterPolicy` de l’utilisateur IAM nommé `Bob`.**
```
Unregister-IAMUserPolicy -UserName Bob -PolicyArn arn:aws:iam::123456789012:policy/TesterPolicy
```
**Exemple 2 : cet exemple trouve toutes les politiques gérées associées à l’utilisateur IAM nommé `Theresa` et détache ces politiques de l’utilisateur.**
```
Get-IAMAttachedUserPolicyList -UserName Theresa | Unregister-IAMUserPolicy -Username Theresa
```
+ Pour plus de détails sur l'API, reportez-vous [DetachUserPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMAccessKey`
L'exemple de code suivant montre comment utiliser`Update-IAMAccessKey`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie le statut de la clé d’accès `AKIAIOSFODNN7EXAMPLE`, pour l’utilisateur IAM nommé `Bob`, à `Inactive`.**
```
Update-IAMAccessKey -UserName Bob -AccessKeyId AKIAIOSFODNN7EXAMPLE -Status Inactive
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateAccessKey](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMAccountPasswordPolicy`
L'exemple de code suivant montre comment utiliser`Update-IAMAccountPasswordPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la politique de mot de passe du compte avec les paramètres spécifiés. Notez que les paramètres qui ne sont pas inclus dans la commande ne sont pas laissés inchangés. Au lieu de cela, ils sont réinitialisés aux valeurs par défaut.**
```
Update-IAMAccountPasswordPolicy -AllowUsersToChangePasswords $true -HardExpiry $false -MaxPasswordAge 90 -MinimumPasswordLength 8 -PasswordReusePrevention 20 -RequireLowercaseCharacters $true -RequireNumbers $true -RequireSymbols $true -RequireUppercaseCharacters $true
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateAccountPasswordPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMAssumeRolePolicy`
L'exemple de code suivant montre comment utiliser`Update-IAMAssumeRolePolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour le rôle IAM nommé `ClientRole` avec une nouvelle politique d’approbation dont le contenu provient du fichier `ClientRolePolicy.json`. Notez que vous devez utiliser le paramètre booléen `-Raw` pour traiter correctement le contenu du fichier JSON.**
```
Update-IAMAssumeRolePolicy -RoleName ClientRole -PolicyDocument (Get-Content -raw ClientRolePolicy.json)
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateAssumeRolePolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMGroup`
L'exemple de code suivant montre comment utiliser`Update-IAMGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renomme le groupe IAM `Testers` en `AppTesters`.**
```
Update-IAMGroup -GroupName Testers -NewGroupName AppTesters
```
**Exemple 2 : dans cet exemple, le chemin du groupe IAM `AppTesters` est remplacé par `/Org1/Org2/`. Cela change l’ARN du groupe en `arn:aws:iam::123456789012:group/Org1/Org2/AppTesters`.**
```
Update-IAMGroup -GroupName AppTesters -NewPath /Org1/Org2/
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMLoginProfile`
L'exemple de code suivant montre comment utiliser`Update-IAMLoginProfile`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple définit un nouveau mot de passe temporaire pour l’utilisateur IAM `Bob` et demande à ce dernier de le modifier lors de sa prochaine connexion.**
```
Update-IAMLoginProfile -UserName Bob -Password "P@ssw0rd1234" -PasswordResetRequired $true
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateLoginProfile](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMOpenIDConnectProviderThumbprint`
L'exemple de code suivant montre comment utiliser`Update-IAMOpenIDConnectProviderThumbprint`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la liste des empreintes numériques des certificats pour le fournisseur OIDC dont l’ARN est `arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com` afin d’utiliser une nouvelle empreinte. Le fournisseur OIDC partage la nouvelle valeur lorsque le certificat associé au fournisseur change.**
```
Update-IAMOpenIDConnectProviderThumbprint -OpenIDConnectProviderArn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com -ThumbprintList 7359755EXAMPLEabc3060bce3EXAMPLEec4542a3
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateOpenIdConnectProviderThumbprint](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMRole`
L'exemple de code suivant montre comment utiliser`Update-IAMRole`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la description du rôle et la durée maximale de session (en secondes) pour laquelle la session d’un rôle peut être demandée.**
```
Update-IAMRole -RoleName MyRoleName -Description "My testing role" -MaxSessionDuration 43200
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateRole](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMRoleDescription`
L'exemple de code suivant montre comment utiliser`Update-IAMRoleDescription`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la description d’un rôle IAM dans votre compte.**
```
Update-IAMRoleDescription -RoleName MyRoleName -Description "My testing role"
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateRoleDescription](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMSAMLProvider`
L'exemple de code suivant montre comment utiliser`Update-IAMSAMLProvider`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour le fournisseur SAML dans IAM, dont l’ARN est `arn:aws:iam::123456789012:saml-provider/SAMLADFS`, avec un nouveau document de métadonnées SAML issu du fichier `SAMLMetaData.xml`. Notez que vous devez utiliser le paramètre booléen `-Raw` pour traiter correctement le contenu du fichier JSON.**
```
Update-IAMSAMLProvider -SAMLProviderArn arn:aws:iam::123456789012:saml-provider/SAMLADFS -SAMLMetadataDocument (Get-Content -Raw SAMLMetaData.xml)
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateSamlProvider](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMServerCertificate`
L'exemple de code suivant montre comment utiliser`Update-IAMServerCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renomme le certificat nommé `MyServerCertificate` en `MyRenamedServerCertificate`.**
```
Update-IAMServerCertificate -ServerCertificateName MyServerCertificate -NewServerCertificateName MyRenamedServerCertificate
```
**Exemple 2 : cet exemple déplace le certificat nommé `MyServerCertificate` vers le chemin /Org1/Org2/. Cela change l’ARN de la ressource en `arn:aws:iam::123456789012:server-certificate/Org1/Org2/MyServerCertificate`.**
```
Update-IAMServerCertificate -ServerCertificateName MyServerCertificate -NewPath /Org1/Org2/
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateServerCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMSigningCertificate`
L'exemple de code suivant montre comment utiliser`Update-IAMSigningCertificate`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour le certificat associé à l’utilisateur IAM nommé `Bob` et dont l’ID de certificat est `Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU` pour le marquer comme inactif.**
```
Update-IAMSigningCertificate -CertificateId Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU -UserName Bob -Status Inactive
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateSigningCertificate](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-IAMUser`
L'exemple de code suivant montre comment utiliser`Update-IAMUser`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renomme l’utilisateur IAM `Bob` en `Robert`.**
```
Update-IAMUser -UserName Bob -NewUserName Robert
```
**Exemple 2 : cet exemple modifie le chemin de l’utilisateur IAM `Bob` en `/Org1/Org2/`, ce qui change effectivement l’ARN de l’utilisateur en `arn:aws:iam::123456789012:user/Org1/Org2/bob`.**
```
Update-IAMUser -UserName Bob -NewPath /Org1/Org2/
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateUser](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-IAMGroupPolicy`
L'exemple de code suivant montre comment utiliser`Write-IAMGroupPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une politique en ligne nommée `AppTesterPolicy` et l’intègre au groupe IAM `AppTesters`. Si une politique en ligne portant le même nom existe déjà, elle est remplacée. Le contenu de la politique JSON provient du fichier `apptesterpolicy.json`. Notez que vous devez utiliser le paramètre `-Raw` pour traiter correctement le contenu du fichier JSON.**
```
Write-IAMGroupPolicy -GroupName AppTesters -PolicyName AppTesterPolicy -PolicyDocument (Get-Content -Raw apptesterpolicy.json)
```
+ Pour plus de détails sur l'API, reportez-vous [PutGroupPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-IAMRolePolicy`
L'exemple de code suivant montre comment utiliser`Write-IAMRolePolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une politique en ligne nommée `FedTesterRolePolicy` et l’intègre au rôle IAM. `FedTesterRole` Si une politique en ligne portant le même nom existe déjà, elle est remplacée. Le contenu de la politique JSON provient du fichier `FedTesterPolicy.json`. Notez que vous devez utiliser le paramètre `-Raw` pour traiter correctement le contenu du fichier JSON.**
```
Write-IAMRolePolicy -RoleName FedTesterRole -PolicyName FedTesterRolePolicy -PolicyDocument (Get-Content -Raw FedTesterPolicy.json)
```
+ Pour plus de détails sur l'API, reportez-vous [PutRolePolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-IAMUserPolicy`
L'exemple de code suivant montre comment utiliser`Write-IAMUserPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une politique en ligne nommée `EC2AccessPolicy` et l’intègre à l’utilisateur IAM `Bob`. Si une politique en ligne portant le même nom existe déjà, elle est remplacée. Le contenu de la politique JSON provient du fichier `EC2AccessPolicy.json`. Notez que vous devez utiliser le paramètre `-Raw` pour traiter correctement le contenu du fichier JSON.**
```
Write-IAMUserPolicy -UserName Bob -PolicyName EC2AccessPolicy -PolicyDocument (Get-Content -Raw EC2AccessPolicy.json)
```
+ Pour plus de détails sur l'API, reportez-vous [PutUserPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples de Kinesis utilisant Tools for V4 PowerShell
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 V4 avec Kinesis.
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
### `Get-KINRecord`
L'exemple de code suivant montre comment utiliser`Get-KINRecord`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre comment renvoyer et extraire des données à partir d’une série d’un ou plusieurs enregistrements. L'itérateur fourni Get-KINRecord détermine la position de départ des enregistrements à renvoyer qui, dans cet exemple, sont capturés dans une variable, \$1records. Chaque enregistrement individuel est ensuite accessible en indexant la collection \$1records. En supposant que les données de l'enregistrement soient du texte codé en UTF-8, la commande finale indique comment extraire les données de l' MemoryStream objet et les renvoyer sous forme de texte à la console.**
```
$records
$records = Get-KINRecord -ShardIterator "AAAAAAAAAAGIc....9VnbiRNaP"
```
**Sortie** :
```
MillisBehindLatest NextShardIterator Records
------------------ ----------------- -------
0 AAAAAAAAAAERNIq...uDn11HuUs {Key1, Key2}
```
```
$records.Records[0]
```
**Sortie** :
```
ApproximateArrivalTimestamp Data PartitionKey SequenceNumber
--------------------------- ---- ------------ --------------
3/7/2016 5:14:33 PM System.IO.MemoryStream Key1 4955986459776...931586
```
```
[Text.Encoding]::UTF8.GetString($records.Records[0].Data.ToArray())
```
**Sortie** :
```
test data from string
```
+ Pour plus de détails sur l'API, reportez-vous [GetRecords](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-KINShardIterator`
L'exemple de code suivant montre comment utiliser`Get-KINShardIterator`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie un itérateur de partition pour la partition et la position de départ spécifiées. Les détails des identificateurs de partition et des numéros de séquence peuvent être obtenus à partir de la sortie de l' Get-KINStream applet de commande, en faisant référence à la collection Shards de l'objet de flux renvoyé. L'itérateur renvoyé peut être utilisé avec l' Get-KINRecord applet de commande pour extraire des enregistrements de données dans la partition.**
```
Get-KINShardIterator -StreamName "mystream" -ShardId "shardId-000000000000" -ShardIteratorType AT_SEQUENCE_NUMBER -StartingSequenceNumber "495598645..."
```
**Sortie** :
```
AAAAAAAAAAGIc....9VnbiRNaP
```
+ Pour plus de détails sur l'API, reportez-vous [GetShardIterator](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-KINStream`
L'exemple de code suivant montre comment utiliser`Get-KINStream`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les détails du flux spécifié.**
```
Get-KINStream -StreamName "mystream"
```
**Sortie** :
```
HasMoreShards : False
RetentionPeriodHours : 24
Shards : {}
StreamARN : arn:aws:kinesis:us-west-2:123456789012:stream/mystream
StreamName : mystream
StreamStatus : ACTIVE
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeStream](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-KINStream`
L'exemple de code suivant montre comment utiliser`New-KINStream`.
**Outils pour PowerShell V4**
**Exemple 1 : crée un nouveau flux. Par défaut, cette applet de commande ne renvoie aucune sortie. Le PassThru commutateur - est donc ajouté pour renvoyer la valeur fournie au StreamName paramètre - pour une utilisation ultérieure.**
```
$streamName = New-KINStream -StreamName "mystream" -ShardCount 1 -PassThru
```
+ Pour plus de détails sur l'API, reportez-vous [CreateStream](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-KINStream`
L'exemple de code suivant montre comment utiliser`Remove-KINStream`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime le flux spécifié. Vous devrez confirmer avant que la commande ne s’exécute. Pour supprimer les invites de confirmation, utilisez le commutateur -Force.**
```
Remove-KINStream -StreamName "mystream"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteStream](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-KINRecord`
L'exemple de code suivant montre comment utiliser`Write-KINRecord`.
**Outils pour PowerShell V4**
**Exemple 1 : écrit un enregistrement contenant la chaîne fournie au paramètre -Text.**
```
Write-KINRecord -Text "test data from string" -StreamName "mystream" -PartitionKey "Key1"
```
**Exemple 2 : écrit un enregistrement contenant les données contenues dans le fichier spécifié. Le fichier est traité comme une séquence d’octets. S’il contient du texte, il doit être écrit avec le codage nécessaire avant de l’utiliser avec cette applet de commande.**
```
Write-KINRecord -FilePath "C:\TestData.txt" -StreamName "mystream" -PartitionKey "Key2"
```
+ Pour plus de détails sur l'API, reportez-vous [PutRecord](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples Lambda utilisant Tools for V4 PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Lambda.
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-LMResourceTag`
L'exemple de code suivant montre comment utiliser`Add-LMResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : ajoute les trois balises (Washington, Oregon et Californie) et leurs valeurs associées à la fonction spécifiée identifiée par son ARN.**
```
Add-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction" -Tag @{ "Washington" = "Olympia"; "Oregon" = "Salem"; "California" = "Sacramento" }
```
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-LMAccountSetting`
L'exemple de code suivant montre comment utiliser`Get-LMAccountSetting`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche une comparaison entre la limite et l’utilisation du compte**
```
Get-LMAccountSetting | Select-Object @{Name="TotalCodeSizeLimit";Expression={$_.AccountLimit.TotalCodeSize}}, @{Name="TotalCodeSizeUsed";Expression={$_.AccountUsage.TotalCodeSize}}
```
**Sortie** :
```
TotalCodeSizeLimit TotalCodeSizeUsed
------------------ -----------------
80530636800 15078795
```
+ Pour plus de détails sur l'API, reportez-vous [GetAccountSettings](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-LMAlias`
L'exemple de code suivant montre comment utiliser`Get-LMAlias`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple récupère les poids de la configuration de routage pour un alias de fonction Lambda spécifique.**
```
Get-LMAlias -FunctionName "MylambdaFunction123" -Name "newlabel1" -Select RoutingConfig
```
**Sortie** :
```
AdditionalVersionWeights
------------------------
{[1, 0.6]}
```
+ Pour plus de détails sur l'API, reportez-vous [GetAlias](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-LMFunctionConcurrency`
L'exemple de code suivant montre comment utiliser`Get-LMFunctionConcurrency`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet d’obtenir la simultanéité réservée pour la fonction Lambda**
```
Get-LMFunctionConcurrency -FunctionName "MylambdaFunction123" -Select *
```
**Sortie** :
```
ReservedConcurrentExecutions
----------------------------
100
```
+ Pour plus de détails sur l'API, reportez-vous [GetFunctionConcurrency](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-LMFunctionConfiguration`
L'exemple de code suivant montre comment utiliser`Get-LMFunctionConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie la configuration spécifique à la version d’une fonction Lambda.**
```
Get-LMFunctionConfiguration -FunctionName "MylambdaFunction123" -Qualifier "PowershellAlias"
```
**Sortie** :
```
CodeSha256 : uWOW0R7z+f0VyLuUg7+/D08hkMFsq0SF4seuyUZJ/R8=
CodeSize : 1426
DeadLetterConfig : Amazon.Lambda.Model.DeadLetterConfig
Description : Verson 3 to test Aliases
Environment : Amazon.Lambda.Model.EnvironmentResponse
FunctionArn : arn:aws:lambda:us-east-1:123456789012:function:MylambdaFunction123
:PowershellAlias
FunctionName : MylambdaFunction123
Handler : lambda_function.launch_instance
KMSKeyArn :
LastModified : 2019-12-25T09:52:59.872+0000
LastUpdateStatus : Successful
LastUpdateStatusReason :
LastUpdateStatusReasonCode :
Layers : {}
MasterArn :
MemorySize : 128
RevisionId : 5d7de38b-87f2-4260-8f8a-e87280e10c33
Role : arn:aws:iam::123456789012:role/service-role/lambda
Runtime : python3.8
State : Active
StateReason :
StateReasonCode :
Timeout : 600
TracingConfig : Amazon.Lambda.Model.TracingConfigResponse
Version : 4
VpcConfig : Amazon.Lambda.Model.VpcConfigDetail
```
+ Pour plus de détails sur l'API, reportez-vous [GetFunctionConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-LMFunctionList`
L'exemple de code suivant montre comment utiliser`Get-LMFunctionList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche toutes les fonctions Lambda avec une taille de code triée**
```
Get-LMFunctionList | Sort-Object -Property CodeSize | Select-Object FunctionName, RunTime, Timeout, CodeSize
```
**Sortie** :
```
FunctionName Runtime Timeout CodeSize
------------ ------- ------- --------
test python2.7 3 243
MylambdaFunction123 python3.8 600 659
myfuncpython1 python3.8 303 675
```
+ Pour plus de détails sur l'API, reportez-vous [ListFunctions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-LMPolicy`
L'exemple de code suivant montre comment utiliser`Get-LMPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche la stratégie de fonction de la fonction Lambda**
```
Get-LMPolicy -FunctionName test -Select Policy
```
**Sortie** :
```
{"Version":"2012-10-17", "Id":"default","Statement":[{"Sid":"xxxx","Effect":"Allow","Principal":{"Service":"sns.amazonaws.com"},"Action":"lambda:InvokeFunction","Resource":"arn:aws:lambda:us-east-1:123456789102:function:test"}]}
```
+ Pour plus de détails sur l'API, reportez-vous [GetPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-LMProvisionedConcurrencyConfig`
L'exemple de code suivant montre comment utiliser`Get-LMProvisionedConcurrencyConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient la configuration de simultanéité allouée pour l’alias spécifié de la fonction Lambda.**
```
C:\>Get-LMProvisionedConcurrencyConfig -FunctionName "MylambdaFunction123" -Qualifier "NewAlias1"
```
**Sortie** :
```
AllocatedProvisionedConcurrentExecutions : 0
AvailableProvisionedConcurrentExecutions : 0
LastModified : 2020-01-15T03:21:26+0000
RequestedProvisionedConcurrentExecutions : 70
Status : IN_PROGRESS
StatusReason :
```
+ Pour plus de détails sur l'API, reportez-vous [GetProvisionedConcurrencyConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-LMProvisionedConcurrencyConfigList`
L'exemple de code suivant montre comment utiliser`Get-LMProvisionedConcurrencyConfigList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple récupère la liste des configurations de la simultanéité allouée pour une fonction Lambda.**
```
Get-LMProvisionedConcurrencyConfigList -FunctionName "MylambdaFunction123"
```
+ Pour plus de détails sur l'API, reportez-vous [ListProvisionedConcurrencyConfigs](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-LMResourceTag`
L'exemple de code suivant montre comment utiliser`Get-LMResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : récupère les balises et leurs valeurs actuellement définies sur la fonction spécifiée.**
```
Get-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction"
```
**Sortie** :
```
Key Value
--- -----
California Sacramento
Oregon Salem
Washington Olympia
```
+ Pour plus de détails sur l'API, reportez-vous [ListTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-LMVersionsByFunction`
L'exemple de code suivant montre comment utiliser`Get-LMVersionsByFunction`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie la liste des configurations spécifiques à chaque version de la fonction Lambda.**
```
Get-LMVersionsByFunction -FunctionName "MylambdaFunction123"
```
**Sortie** :
```
FunctionName Runtime MemorySize Timeout CodeSize LastModified RoleName
------------ ------- ---------- ------- -------- ------------ --------
MylambdaFunction123 python3.8 128 600 659 2020-01-10T03:20:56.390+0000 lambda
MylambdaFunction123 python3.8 128 5 1426 2019-12-25T09:19:02.238+0000 lambda
MylambdaFunction123 python3.8 128 5 1426 2019-12-25T09:39:36.779+0000 lambda
MylambdaFunction123 python3.8 128 600 1426 2019-12-25T09:52:59.872+0000 lambda
```
+ Pour plus de détails sur l'API, reportez-vous [ListVersionsByFunction](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-LMAlias`
L'exemple de code suivant montre comment utiliser`New-LMAlias`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un alias Lambda pour une version et une configuration de routage spécifiées afin de déterminer le pourcentage de requêtes d’invocation reçues.**
```
New-LMAlias -FunctionName "MylambdaFunction123" -RoutingConfig_AdditionalVersionWeight @{Name="1";Value="0.6} -Description "Alias for version 4" -FunctionVersion 4 -Name "PowershellAlias"
```
+ Pour plus de détails sur l'API, reportez-vous [CreateAlias](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Publish-LMFunction`
L'exemple de code suivant montre comment utiliser`Publish-LMFunction`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée une nouvelle fonction C\$1 (dotnetcore1.0 runtime) nommée dans MyFunction AWS Lambda, fournissant les fichiers binaires compilés pour la fonction à partir d'un fichier zip sur le système de fichiers local (des chemins relatifs ou absolus peuvent être utilisés). Les fonctions Lambda C\$1 spécifient le gestionnaire de la fonction en utilisant la désignation : :Namespace. AssemblyName ClassName: :MethodName. Vous devez remplacer les parties du nom de l’assemblage (sans le suffixe .dll), de l’espace de noms, du nom de classe et du nom de méthode de la spécification du gestionnaire de manière appropriée. La nouvelle fonction aura les variables d’environnement « envvar1 » et « envvar2 » configurées à partir des valeurs fournies.**
```
Publish-LMFunction -Description "My C# Lambda Function" `
-FunctionName MyFunction `
-ZipFilename .\MyFunctionBinaries.zip `
-Handler "AssemblyName::Namespace.ClassName::MethodName" `
-Role "arn:aws:iam::123456789012:role/LambdaFullExecRole" `
-Runtime dotnetcore1.0 `
-Environment_Variable @{ "envvar1"="value";"envvar2"="value" }
```
**Sortie** :
```
CodeSha256 : /NgBMd...gq71I=
CodeSize : 214784
DeadLetterConfig :
Description : My C# Lambda Function
Environment : Amazon.Lambda.Model.EnvironmentResponse
FunctionArn : arn:aws:lambda:us-west-2:123456789012:function:ToUpper
FunctionName : MyFunction
Handler : AssemblyName::Namespace.ClassName::MethodName
KMSKeyArn :
LastModified : 2016-12-29T23:50:14.207+0000
MemorySize : 128
Role : arn:aws:iam::123456789012:role/LambdaFullExecRole
Runtime : dotnetcore1.0
Timeout : 3
Version : $LATEST
VpcConfig :
```
**Exemple 2 : cet exemple est similaire au précédent, sauf que les fichiers binaires des fonctions sont d’abord chargés dans un compartiment Amazon S3 (qui doit se trouver dans la même région que la fonction Lambda prévue) et que l’objet S3 obtenu est ensuite référencé lors de la création de la fonction.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Key MyFunctionBinaries.zip -File .\MyFunctionBinaries.zip
Publish-LMFunction -Description "My C# Lambda Function" `
-FunctionName MyFunction `
-BucketName amzn-s3-demo-bucket `
-Key MyFunctionBinaries.zip `
-Handler "AssemblyName::Namespace.ClassName::MethodName" `
-Role "arn:aws:iam::123456789012:role/LambdaFullExecRole" `
-Runtime dotnetcore1.0 `
-Environment_Variable @{ "envvar1"="value";"envvar2"="value" }
```
+ Pour plus de détails sur l'API, reportez-vous [CreateFunction](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Publish-LMVersion`
L'exemple de code suivant montre comment utiliser`Publish-LMVersion`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une version pour l’instantané existant du code de fonction Lambda**
```
Publish-LMVersion -FunctionName "MylambdaFunction123" -Description "Publishing Existing Snapshot of function code as a new version through Powershell"
```
+ Pour plus de détails sur l'API, reportez-vous [PublishVersion](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-LMAlias`
L'exemple de code suivant montre comment utiliser`Remove-LMAlias`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’alias de la fonction Lambda mentionnée dans la commande.**
```
Remove-LMAlias -FunctionName "MylambdaFunction123" -Name "NewAlias"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteAlias](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-LMFunction`
L'exemple de code suivant montre comment utiliser`Remove-LMFunction`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime une version spécifique d’une fonction Lambda**
```
Remove-LMFunction -FunctionName "MylambdaFunction123" -Qualifier '3'
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteFunction](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-LMFunctionConcurrency`
L'exemple de code suivant montre comment utiliser`Remove-LMFunctionConcurrency`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la simultanéité des fonctions de la fonction Lambda.**
```
Remove-LMFunctionConcurrency -FunctionName "MylambdaFunction123"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteFunctionConcurrency](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-LMPermission`
L'exemple de code suivant montre comment utiliser`Remove-LMPermission`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple supprime la politique de fonction pour la fonction Lambda spécifiée StatementId .**
```
$policy = Get-LMPolicy -FunctionName "MylambdaFunction123" -Select Policy | ConvertFrom-Json| Select-Object -ExpandProperty Statement
Remove-LMPermission -FunctionName "MylambdaFunction123" -StatementId $policy[0].Sid
```
+ Pour plus de détails sur l'API, reportez-vous [RemovePermission](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-LMProvisionedConcurrencyConfig`
L'exemple de code suivant montre comment utiliser`Remove-LMProvisionedConcurrencyConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la configuration de simultanéité allouée pour un alias spécifique.**
```
Remove-LMProvisionedConcurrencyConfig -FunctionName "MylambdaFunction123" -Qualifier "NewAlias1"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteProvisionedConcurrencyConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-LMResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-LMResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime les balises fournies d’une fonction. L’applet de commande vous invitera à confirmer avant de poursuivre, à moins que l’option -Force ne soit spécifiée. Un seul appel est envoyé au service pour supprimer les tags.**
```
Remove-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction" -TagKey "Washington","Oregon","California"
```
**Exemple 2 : supprime les balises fournies d’une fonction. L’applet de commande vous invitera à confirmer avant de poursuivre, à moins que l’option -Force ne soit spécifiée. Un seul appel au service est effectué par tag fourni.**
```
"Washington","Oregon","California" | Remove-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction"
```
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-LMAlias`
L'exemple de code suivant montre comment utiliser`Update-LMAlias`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la configuration d’un alias de fonction Lambda existant. Il met à jour la RoutingConfiguration valeur pour transférer 60 % (0,6) du trafic vers la version 1**
```
Update-LMAlias -FunctionName "MylambdaFunction123" -Description " Alias for version 2" -FunctionVersion 2 -Name "newlabel1" -RoutingConfig_AdditionalVersionWeight @{Name="1";Value="0.6}
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateAlias](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-LMFunctionCode`
L'exemple de code suivant montre comment utiliser`Update-LMFunctionCode`.
**Outils pour PowerShell V4**
**Exemple 1 : met à jour la fonction nommée MyFunction « » avec le nouveau contenu contenu dans le fichier zip spécifié. Pour une fonction Lambda C\$1 .NET Core, le fichier zip doit contenir l’assemblage compilé.**
```
Update-LMFunctionCode -FunctionName MyFunction -ZipFilename .\UpdatedCode.zip
```
**Exemple 2 : cet exemple est similaire au précédent, mais utilise un objet Amazon S3 contenant le code mis à jour pour actualiser la fonction.**
```
Update-LMFunctionCode -FunctionName MyFunction -BucketName amzn-s3-demo-bucket -Key UpdatedCode.zip
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateFunctionCode](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-LMFunctionConfiguration`
L'exemple de code suivant montre comment utiliser`Update-LMFunctionConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la configuration de la fonction Lambda existante**
```
Update-LMFunctionConfiguration -FunctionName "MylambdaFunction123" -Handler "lambda_function.launch_instance" -Timeout 600 -Environment_Variable @{ "envvar1"="value";"envvar2"="value" } -Role arn:aws:iam::123456789101:role/service-role/lambda -DeadLetterConfig_TargetArn arn:aws:sns:us-east-1: 123456789101:MyfirstTopic
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateFunctionConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-LMFunctionConcurrency`
L'exemple de code suivant montre comment utiliser`Write-LMFunctionConcurrency`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple applique les paramètres de simultanéité pour la fonction dans son ensemble.**
```
Write-LMFunctionConcurrency -FunctionName "MylambdaFunction123" -ReservedConcurrentExecution 100
```
+ Pour plus de détails sur l'API, reportez-vous [PutFunctionConcurrency](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-LMProvisionedConcurrencyConfig`
L'exemple de code suivant montre comment utiliser`Write-LMProvisionedConcurrencyConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute une configuration de simultanéité allouée à l’alias d’une fonction**
```
Write-LMProvisionedConcurrencyConfig -FunctionName "MylambdaFunction123" -ProvisionedConcurrentExecution 20 -Qualifier "NewAlias1"
```
+ Pour plus de détails sur l'API, reportez-vous [PutProvisionedConcurrencyConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Amazon ML utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Amazon ML.
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
### `Get-MLBatchPrediction`
L'exemple de code suivant montre comment utiliser`Get-MLBatchPrediction`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les métadonnées détaillées d’une prédiction par lots avec l’ID id.**
```
Get-MLBatchPrediction -BatchPredictionId ID
```
+ Pour plus de détails sur l'API, reportez-vous [GetBatchPrediction](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-MLBatchPredictionList`
L'exemple de code suivant montre comment utiliser`Get-MLBatchPredictionList`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie une liste de tous BatchPredictions les enregistrements de données associés qui correspondent au critère de recherche indiqué dans la demande.**
```
Get-MLBatchPredictionList
```
**Exemple 2 : renvoie une liste de toutes les données BatchPredictions dont le statut est COMPLETED.**
```
Get-MLBatchPredictionList -FilterVariable Status -EQ COMPLETED
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeBatchPredictions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-MLDataSource`
L'exemple de code suivant montre comment utiliser`Get-MLDataSource`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les métadonnées, le statut et les informations du fichier de données pour un DataSource avec l'ID ID**
```
Get-MLDataSource -DataSourceId ID
```
+ Pour plus de détails sur l'API, reportez-vous [GetDataSource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-MLDataSourceList`
L'exemple de code suivant montre comment utiliser`Get-MLDataSourceList`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie une liste de tous DataSources les enregistrements de données associés.**
```
Get-MLDataSourceList
```
**Exemple 2 : renvoie une liste de toutes les données DataSources dont le statut est COMPLETED.**
```
Get-MLDataDourceList -FilterVariable Status -EQ COMPLETED
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeDataSources](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-MLEvaluation`
L'exemple de code suivant montre comment utiliser`Get-MLEvaluation`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les métadonnées et le statut d’une évaluation avec l’ID id.**
```
Get-MLEvaluation -EvaluationId ID
```
+ Pour plus de détails sur l'API, reportez-vous [GetEvaluation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-MLEvaluationList`
L'exemple de code suivant montre comment utiliser`Get-MLEvaluationList`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie une liste de toutes les ressources d’évaluation**
```
Get-MLEvaluationList
```
**Exemple 2 : renvoie une liste de toutes les évaluations dont le statut est COMPLETED.**
```
Get-MLEvaluationList -FilterVariable Status -EQ COMPLETED
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEvaluations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-MLModel`
L'exemple de code suivant montre comment utiliser`Get-MLModel`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les métadonnées détaillées, le statut, le schéma et les informations du fichier de données pour un identifiant MLModel avec identifiant.**
```
Get-MLModel -ModelId ID
```
+ Pour plus de détails sur l'API, consultez la section [Get MLModel](https://docs.aws.amazon.com/powershell/v4/reference) in *Outils AWS pour PowerShell Cmdlet Reference (V4)*.
### `Get-MLModelList`
L'exemple de code suivant montre comment utiliser`Get-MLModelList`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie une liste de tous les modèles et de leurs enregistrements de données associés.**
```
Get-MLModelList
```
**Exemple 2 : renvoie une liste de tous les modèles dont le statut est TERMINÉ.**
```
Get-MLModelList -FilterVariable Status -EQ COMPLETED
```
+ Pour plus de détails sur l'API, consultez la section [Description MLModels](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-MLPrediction`
L'exemple de code suivant montre comment utiliser`Get-MLPrediction`.
**Outils pour PowerShell V4**
**Exemple 1 : envoyer un enregistrement à l’URL du point de terminaison de prédiction en temps réel pour le modèle avec l’ID id.**
```
Get-MLPrediction -ModelId ID -PredictEndpoint URL -Record @{"A" = "B"; "C" = "D";}
```
+ Pour plus de détails sur l’API, consultez [Predict](https://docs.aws.amazon.com/powershell/v4/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V4)*.
### `New-MLBatchPrediction`
L'exemple de code suivant montre comment utiliser`New-MLBatchPrediction`.
**Outils pour PowerShell V4**
**Exemple 1 : créer une nouvelle demande de prédiction par lots pour le modèle avec l’ID id et placez la sortie à l’emplacement S3 spécifié.**
```
New-MLBatchPrediction -ModelId ID -Name NAME -OutputURI s3://...
```
+ Pour plus de détails sur l'API, reportez-vous [CreateBatchPrediction](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-MLDataSourceFromS3`
L'exemple de code suivant montre comment utiliser`New-MLDataSourceFromS3`.
**Outils pour PowerShell V4**
**Exemple 1 : créer une source de données contenant les données d’un emplacement S3, portant le nom NAME et le schéma SCHEMA.**
```
New-MLDataSourceFromS3 -Name NAME -ComputeStatistics $true -DataSpec_DataLocationS3 "s3://BUCKET/KEY" -DataSchema SCHEMA
```
+ Pour plus de détails sur l'API, consultez [CreateDataSourceFromS3](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-MLEvaluation`
L'exemple de code suivant montre comment utiliser`New-MLEvaluation`.
**Outils pour PowerShell V4**
**Exemple 1 : créer une évaluation pour un ID de source de données et un ID de modèle donnés**
```
New-MLEvaluation -Name NAME -DataSourceId DSID -ModelId MID
```
+ Pour plus de détails sur l'API, reportez-vous [CreateEvaluation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-MLModel`
L'exemple de code suivant montre comment utiliser`New-MLModel`.
**Outils pour PowerShell V4**
**Exemple 1 : créer un nouveau modèle avec des données d’entraînement.**
```
New-MLModel -Name NAME -ModelType BINARY -Parameter @{...} -TrainingDataSourceId ID
```
+ Pour plus de détails sur l'API, voir [Create MLModel](https://docs.aws.amazon.com/powershell/v4/reference) in *Outils AWS pour PowerShell Cmdlet Reference (V4)*.
### `New-MLRealtimeEndpoint`
L'exemple de code suivant montre comment utiliser`New-MLRealtimeEndpoint`.
**Outils pour PowerShell V4**
**Exemple 1 : créer un nouveau point de terminaison de prédiction en temps réel pour l’ID du modèle donné.**
```
New-MLRealtimeEndpoint -ModelId ID
```
+ Pour plus de détails sur l'API, reportez-vous [CreateRealtimeEndpoint](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples de Macie utilisant Tools for V4 PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Macie.
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
### `Get-MAC2FindingList`
L'exemple de code suivant montre comment utiliser`Get-MAC2FindingList`.
**Outils pour PowerShell V4**
**Exemple 1 : Renvoie la liste des quatre résultats contenant une détection FindingIds de données sensibles de type « CREDIT\$1CARD\$1NUMBER » ou « US\$1SOCIAL\$1SECURITY\$1NUMBER »**
```
$criterionAddProperties = New-Object Amazon.Macie2.Model.CriterionAdditionalProperties
$criterionAddProperties.Eq = @(
"CREDIT_CARD_NUMBER"
"US_SOCIAL_SECURITY_NUMBER"
)
$FindingCriterion = @{
'classificationDetails.result.sensitiveData.detections.type' = [Amazon.Macie2.Model.CriterionAdditionalProperties]$criterionAddProperties
}
Get-MAC2FindingList -FindingCriteria_Criterion $FindingCriterion -MaxResult 5
```
+ Pour plus de détails sur l'API, reportez-vous [ListFindings](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# AWS Price List exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec AWS Price List.
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
### `Get-PLSAttributeValue`
L'exemple de code suivant montre comment utiliser`Get-PLSAttributeValue`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les valeurs de l’attribut « volumeType » pour Amazon EC2 dans la région us-east-1.**
```
Get-PLSAttributeValue -ServiceCode AmazonEC2 -AttributeName "volumeType" -region us-east-1
```
**Sortie** :
```
Value
-----
Cold HDD
General Purpose
Magnetic
Provisioned IOPS
Throughput Optimized HDD
```
+ Pour plus de détails sur l'API, reportez-vous [GetAttributeValues](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-PLSProduct`
L'exemple de code suivant montre comment utiliser`Get-PLSProduct`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les détails de tous les produits pour Amazon EC2.**
```
Get-PLSProduct -ServiceCode AmazonEC2 -Region us-east-1
```
**Sortie** :
```
{"product":{"productFamily":"Compute Instance","attributes":{"enhancedNetworkingSupported":"Yes","memory":"30.5 GiB","dedicatedEbsThroughput":"800 Mbps","vcpu":"4","locationType":"AWS Region","storage":"EBS only","instanceFamily":"Memory optimized","operatingSystem":"SUSE","physicalProcessor":"Intel Xeon E5-2686 v4 (Broadwell)","clockSpeed":"2.3 GHz","ecu":"Variable","networkPerformance":"Up to 10 Gigabit","servicename":"Amazon Elastic Compute Cloud","instanceType":"r4.xlarge","tenancy":"Shared","usagetype":"USW2-BoxUsage:r4.xlarge","normalizationSizeFactor":"8","processorFeatures":"Intel AVX, Intel AVX2, Intel Turbo","servicecode":"AmazonEC2","licenseModel":"No License required","currentGeneration":"Yes","preInstalledSw":"NA","location":"US West (Oregon)","processorArchitecture":"64-bit","operation":"RunInstances:000g"},...
```
**Exemple 2 : renvoie des données pour Amazon EC2 dans la région us-east-1, filtrées par types de volumes « à usage général » sauvegardés sur SSD.**
```
Get-PLSProduct -ServiceCode AmazonEC2 -Filter @{Type="TERM_MATCH";Field="volumeType";Value="General Purpose"},@{Type="TERM_MATCH";Field="storageMedia";Value="SSD-backed"} -Region us-east-1
```
**Sortie** :
```
{"product":{"productFamily":"Storage","attributes":{"storageMedia":"SSD-backed","maxThroughputvolume":"160 MB/sec","volumeType":"General Purpose","maxIopsvolume":"10000",...
```
+ Pour plus de détails sur l'API, reportez-vous [GetProducts](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-PLSService`
L'exemple de code suivant montre comment utiliser`Get-PLSService`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les métadonnées pour tous les codes de service disponibles dans la région us-east-1.**
```
Get-PLSService -Region us-east-1
```
**Sortie** :
```
AttributeNames ServiceCode
-------------- -----------
{productFamily, servicecode, groupDescription, termType...} AWSBudgets
{productFamily, servicecode, termType, usagetype...} AWSCloudTrail
{productFamily, servicecode, termType, usagetype...} AWSCodeCommit
{productFamily, servicecode, termType, usagetype...} AWSCodeDeploy
{productFamily, servicecode, termType, usagetype...} AWSCodePipeline
{productFamily, servicecode, termType, usagetype...} AWSConfig
...
```
**Exemple 2 : renvoie les métadonnées pour le service Amazon EC2 dans la région us-east-1.**
```
Get-PLSService -ServiceCode AmazonEC2 -Region us-east-1
```
**Sortie** :
```
AttributeNames ServiceCode
-------------- -----------
{volumeType, maxIopsvolume, instanceCapacity10xlarge, locationType...} AmazonEC2
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeServices](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples de groupes de ressources utilisant Tools for PowerShell V4
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 V4 avec Resource Groups.
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-RGResourceTag`
L'exemple de code suivant montre comment utiliser`Add-RGResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute la clé de balise « Instances » avec la valeur « workboxes » à l’ARN du groupe de ressources donné**
```
Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes
```
**Sortie** :
```
Arn Tags
--- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]}
```
+ Pour plus de détails sur l’API, consultez [Tag](https://docs.aws.amazon.com/powershell/v4/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V4)*.
### `Find-RGResource`
L'exemple de code suivant montre comment utiliser`Find-RGResource`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un type de ressource ResourceQuery for Instance avec des filtres de balises et trouve des ressources.**
```
$query = [Amazon.ResourceGroups.Model.ResourceQuery]::new()
$query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0
$query.Query = ConvertTo-Json -Compress -Depth 4 -InputObject @{
ResourceTypeFilters = @('AWS::EC2::Instance')
TagFilters = @(@{
Key = 'auto'
Values = @('no')
})
}
Find-RGResource -ResourceQuery $query | Select-Object -ExpandProperty ResourceIdentifiers
```
**Sortie** :
```
ResourceArn ResourceType
----------- ------------
arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance
```
+ Pour plus de détails sur l'API, reportez-vous [SearchResources](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-RGGroup`
L'exemple de code suivant montre comment utiliser`Get-RGGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait le groupe de ressources selon le nom du groupe**
```
Get-RGGroup -GroupName auto-no
```
**Sortie** :
```
Description GroupArn Name
----------- -------- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no
```
+ Pour plus de détails sur l'API, reportez-vous [GetGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-RGGroupList`
L'exemple de code suivant montre comment utiliser`Get-RGGroupList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les groupes de ressources déjà créés.**
```
Get-RGGroupList
```
**Sortie** :
```
GroupArn GroupName
-------- ---------
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes
arn:aws:resource-groups:eu-west-1:123456789012:group/build600 build600
```
+ Pour plus de détails sur l'API, reportez-vous [ListGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-RGGroupQuery`
L'exemple de code suivant montre comment utiliser`Get-RGGroupQuery`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait la requête de ressources pour le groupe de ressources donné**
```
Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery
```
**Sortie** :
```
Query Type
----- ----
{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0
```
+ Pour plus de détails sur l'API, reportez-vous [GetGroupQuery](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-RGGroupResourceList`
L'exemple de code suivant montre comment utiliser`Get-RGGroupResourceList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les ressources du groupe sur la base du filtrage par type de ressource**
```
Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers
```
**Sortie** :
```
ResourceArn ResourceType
----------- ------------
arn:aws:ec2:eu-west-1:123456789012:instance/i-0123bc45b567890e1 AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-0a1caf2345f67d8dc AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-012e3cb4df567e8aa AWS::EC2::Instance
arn:aws:ec2:eu-west-1:123456789012:instance/i-0fd12dd3456789012 AWS::EC2::Instance
```
+ Pour plus de détails sur l'API, reportez-vous [ListGroupResources](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-RGResourceTag`
L'exemple de code suivant montre comment utiliser`Get-RGResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les balises pour l’ARN du groupe de ressources donné**
```
Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes
```
**Sortie** :
```
Key Value
--- -----
Instances workboxes
```
+ Pour plus de détails sur l'API, reportez-vous [GetTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-RGGroup`
L'exemple de code suivant montre comment utiliser`New-RGGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un nouveau groupe de AWS ressources Resource Groups basé sur des balises nommé TestPowerShellGroup. Le groupe inclut les instances Amazon EC2 de la région actuelle qui sont balisées avec la clé de balise « Name » et la valeur de balise « test2 ». La commande renvoie la requête et le type de groupe, ainsi que les résultats de l’opération.**
```
$ResourceQuery = New-Object -TypeName Amazon.ResourceGroups.Model.ResourceQuery
$ResourceQuery.Type = "TAG_FILTERS_1_0"
$ResourceQuery.Query = '{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]}'
$ResourceQuery
New-RGGroup -Name TestPowerShellGroup -ResourceQuery $ResourceQuery -Description "Test resource group."
```
**Sortie** :
```
Query Type
----- ----
{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]} TAG_FILTERS_1_0
LoggedAt : 11/20/2018 2:40:59 PM
Group : Amazon.ResourceGroups.Model.Group
ResourceQuery : Amazon.ResourceGroups.Model.ResourceQuery
Tags : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 338
HttpStatusCode : OK
```
+ Pour plus de détails sur l'API, reportez-vous [CreateGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-RGGroup`
L'exemple de code suivant montre comment utiliser`Remove-RGGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le groupe de ressources nommé**
```
Remove-RGGroup -GroupName non-tag-cfn-elbv2
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-RGGroup (DeleteGroup)" on target "non-tag-cfn-elbv2".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Description GroupArn Name
----------- -------- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/non-tag-cfn-elbv2 non-tag-cfn-elbv2
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-RGResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-RGResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la balise mentionnée du groupe de ressources**
```
Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-RGResourceTag (Untag)" on target "arn:aws:resource-groups:eu-west-1:933303704102:group/workboxes".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Arn Keys
--- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {Instances}
```
+ Pour plus de détails sur l’API, consultez [Untag](https://docs.aws.amazon.com/powershell/v4/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V4)*.
### `Update-RGGroup`
L'exemple de code suivant montre comment utiliser`Update-RGGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la description du groupe**
```
Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove"
```
**Sortie** :
```
Description GroupArn Name
----------- -------- ----
Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-RGGroupQuery`
L'exemple de code suivant montre comment utiliser`Update-RGGroupQuery`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un objet de requête et met à jour la requête pour le groupe.**
```
$query = [Amazon.ResourceGroups.Model.ResourceQuery]::new()
$query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0
$query.Query = @{
ResourceTypeFilters = @('AWS::EC2::Instance')
TagFilters = @(@{
Key='Environment'
Values='Build600.11'
})
} | ConvertTo-Json -Compress -Depth 4
Update-RGGroupQuery -GroupName build600 -ResourceQuery $query
```
**Sortie** :
```
GroupName ResourceQuery
--------- -------------
build600 Amazon.ResourceGroups.Model.ResourceQuery
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateGroupQuery](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'API de balisage de groupes de ressources à l'aide de Tools for V4 PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de l'API de balisage Outils AWS pour PowerShell V4 with Resource Groups.
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-RGTResourceTag`
L'exemple de code suivant montre comment utiliser`Add-RGTResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute les clés de balise « stage » et « version » avec les valeurs « beta » et « preprod\$1test » à un compartiment Amazon S3 et à une table Amazon DynamoDB. Un seul appel est fait au service pour supprimer les balises.**
```
$arn1 = "arn:aws:s3:::amzn-s3-demo-bucket"
$arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable"
Add-RGTResourceTag -ResourceARNList $arn1,$arn2 -Tag @{ "stage"="beta"; "version"="preprod_test" }
```
**Exemple 2 : cet exemple ajoute les balises et les valeurs spécifiées à un compartiment Amazon S3 et à une table Amazon DynamoDB. Deux appels sont effectués vers le service, un pour chaque ARN de ressource redirigé vers l’applet de commande.**
```
$arn1 = "arn:aws:s3:::amzn-s3-demo-bucket"
$arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable"
$arn1,$arn2 | Add-RGTResourceTag -Tag @{ "stage"="beta"; "version"="preprod_test" }
```
+ Pour plus de détails sur l'API, reportez-vous [TagResources](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-RGTResource`
L'exemple de code suivant montre comment utiliser`Get-RGTResource`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie toutes les ressources balisées d’une région et les clés de balise associées à la ressource. Si aucun paramètre -Region n’est fourni à l’applet de commande, elle tentera de déduire la région à partir des métadonnées du shell ou de l’instance EC2.**
```
Get-RGTResource
```
**Sortie** :
```
ResourceARN Tags
----------- ----
arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version}
arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag}
```
**Exemple 2 : renvoie toutes les ressources balisées du type spécifié dans une région. La chaîne pour chaque nom de service et type de ressource est la même que celle incorporée dans l’Amazon Resource Name (ARN) d’une ressource.**
```
Get-RGTResource -ResourceType "s3"
```
**Sortie** :
```
ResourceARN Tags
----------- ----
arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag}
```
**Exemple 3 : renvoie toutes les ressources balisées du type spécifié dans une région. Notez que lorsque les types de ressources sont redirigés vers l’applet de commande, un appel au service est effectué pour chaque type de ressource fourni.**
```
"dynamodb","s3" | Get-RGTResource
```
**Sortie** :
```
ResourceARN Tags
----------- ----
arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version}
arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag}
```
**Exemple 4 : renvoie toutes les ressources balisées correspondant au filtre spécifié.**
```
Get-RGTResource -TagFilter @{ Key="stage" }
```
**Sortie** :
```
ResourceARN Tags
----------- ----
arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag}
```
**Exemple 5 : renvoie toutes les ressources balisées correspondant au filtre et au type de ressource spécifiés.**
```
Get-RGTResource -TagFilter @{ Key="stage" } -ResourceType "dynamodb"
```
**Sortie** :
```
ResourceARN Tags
----------- ----
arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version}
```
**Exemple 6 : renvoie toutes les ressources balisées correspondant au filtre spécifié.**
```
Get-RGTResource -TagFilter @{ Key="stage"; Values=@("beta","gamma") }
```
**Sortie** :
```
ResourceARN Tags
----------- ----
arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version}
```
+ Pour plus de détails sur l'API, reportez-vous [GetResources](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-RGTTagKey`
L'exemple de code suivant montre comment utiliser`Get-RGTTagKey`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie toutes les clés de balise de la région spécifiée. Si le paramètre -Region n’est pas spécifié, l’applet de commande tentera de déduire la région à partir de la région shell par défaut ou des métadonnées de l’instance EC2. Notez que les clés de la balise ne sont pas renvoyées dans un ordre spécifique.**
```
Get-RGTTagKey -region us-west-2
```
**Sortie** :
```
version
stage
```
+ Pour plus de détails sur l'API, reportez-vous [GetTagKeys](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-RGTTagValue`
L'exemple de code suivant montre comment utiliser`Get-RGTTagValue`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie la valeur de la balise spécifiée dans une région. Si le paramètre -Region n’est pas spécifié, l’applet de commande tentera de déduire la région à partir de la région shell par défaut ou des métadonnées de l’instance EC2.**
```
Get-RGTTagValue -Key "stage" -Region us-west-2
```
**Sortie** :
```
beta
```
+ Pour plus de détails sur l'API, reportez-vous [GetTagValues](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-RGTResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-RGTResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime les clés de balise « stage » et « version », ainsi que les valeurs associées, d’un compartiment Amazon S3 et d’une table Amazon DynamoDB. Un seul appel est envoyé au service pour supprimer les tags. Avant de supprimer les balises, l’applet de commande vous invite à confirmer. Pour contourner la confirmation, ajoutez le paramètre -Force.**
```
$arn1 = "arn:aws:s3:::amzn-s3-demo-bucket"
$arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable"
Remove-RGTResourceTag -ResourceARNList $arn1,$arn2 -TagKey "stage","version"
```
**Exemple 2 : supprime les clés de balise « stage » et « version », ainsi que les valeurs associées, d’un compartiment Amazon S3 et d’une table Amazon DynamoDB. Deux appels sont effectués vers le service, un pour chaque ARN de ressource redirigé vers l’applet de commande. Avant chaque appel, l’applet de commande demande une confirmation. Pour contourner la confirmation, ajoutez le paramètre -Force.**
```
$arn1 = "arn:aws:s3:::amzn-s3-demo-bucket"
$arn2 = "arn:aws:dynamodb:us-west-2:123456789012:table/mytable"
$arn1,$arn2 | Remove-RGTResourceTag -TagKey "stage","version"
```
+ Pour plus de détails sur l'API, reportez-vous [UntagResources](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples de Route 53 utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Route 53.
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
### `Edit-R53ResourceRecordSet`
L'exemple de code suivant montre comment utiliser`Edit-R53ResourceRecordSet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un enregistrement A pour www.exemple.com et modifie l’enregistrement A pour test.example.com de 192.0.2.3 à 192.0.2.1. Notez que les valeurs des modifications des enregistrements de type TXT doivent être entre guillemets doubles. Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "www.example.com"
$change1.ResourceRecordSet.Type = "TXT"
$change1.ResourceRecordSet.TTL = 600
$change1.ResourceRecordSet.ResourceRecords.Add(@{Value="item 1 item 2 item 3"})
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "DELETE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "test.example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.TTL = 600
$change2.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.3"})
$change3 = New-Object Amazon.Route53.Model.Change
$change3.Action = "CREATE"
$change3.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change3.ResourceRecordSet.Name = "test.example.com"
$change3.ResourceRecordSet.Type = "A"
$change3.ResourceRecordSet.TTL = 600
$change3.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.1"})
$params = @{
HostedZoneId="Z1PA6795UKMFR9"
ChangeBatch_Comment="This change batch creates a TXT record for www.example.com. and changes the A record for test.example.com. from 192.0.2.3 to 192.0.2.1."
ChangeBatch_Change=$change1,$change2,$change3
}
Edit-R53ResourceRecordSet @params
```
**Exemple 2 : cet exemple montre comment créer des ensembles d’enregistrements de ressources d’alias. « Z222222222 » est l’ID de la zone hébergée Amazon Route 53 dans laquelle vous créez le jeu d’enregistrements de ressources d’alias. « exemple.com » est la zone apex pour laquelle vous souhaitez créer un alias et « www.exemple.com » est un sous-domaine pour lequel vous souhaitez également créer un alias. « Z1111111111111 » est un exemple d'ID de zone hébergée pour l'équilibreur de charge et « example-load-balancer -1111111111.us-east-1.elb.amazonaws.com » est un exemple de nom de domaine d'équilibreur de charge avec lequel Amazon Route 53 répond aux requêtes pour exemple.com et www.example.com. Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-1111111111.us-east-1.elb.amazonaws.com."
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "www.example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-1111111111.us-east-1.elb.amazonaws.com."
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $false
$params = @{
HostedZoneId="Z222222222"
ChangeBatch_Comment="This change batch creates two alias resource record sets, one for the zone apex, example.com, and one for www.example.com, that both point to example-load-balancer-1111111111.us-east-1.elb.amazonaws.com."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
**Exemple 3 : cet exemple crée deux enregistrements A pour www.example.com. Dans un quart des cas (1/(1\$13)), Amazon Route 53 répond aux requêtes relatives à www.example.com avec les deux valeurs du premier ensemble d’enregistrements de ressources (192.0.2.9 et 192.0.2.10). Dans trois quarts des cas (3/(1\$13)), Amazon Route 53 répond aux requêtes relatives à www.example.com avec les deux valeurs du second ensemble d’enregistrements de ressources (192.0.2.11 et 192.0.2.12). Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "www.example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.SetIdentifier = "Rack 2, Positions 4 and 5"
$change1.ResourceRecordSet.Weight = 1
$change1.ResourceRecordSet.TTL = 600
$change1.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.9"})
$change1.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.10"})
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "www.example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.SetIdentifier = "Rack 5, Positions 1 and 2"
$change2.ResourceRecordSet.Weight = 3
$change2.ResourceRecordSet.TTL = 600
$change2.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.11"})
$change2.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.12"})
$params = @{
HostedZoneId="Z1PA6795UKMFR9"
ChangeBatch_Comment="This change creates two weighted resource record sets, each of which has two values."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
**Exemple 4 : Cet exemple montre comment créer des ensembles d'enregistrements de ressources d'alias pondérés en supposant que exemple.com est le domaine pour lequel vous souhaitez créer des ensembles d'enregistrements de ressources d'alias pondérés. SetIdentifier différencie les deux ensembles d'enregistrements de ressources alias pondérés l'un de l'autre. Cet élément est obligatoire, car les éléments Name et Type ont les mêmes valeurs pour les deux jeux d’enregistrements de ressources. Z1111111111111 et Z3333333333333 sont des exemples de zone hébergée pour l'équilibreur de charge ELB spécifié par la valeur de. IDs DNSName example-load-balancer-2222222222.us-east-1.elb.amazonaws.com et example-load-balancer -4444444444.us-east-1.elb.amazonaws.com sont des exemples de domaines Elastic Load Balancing à partir desquels Amazon Route 53 répond aux requêtes pour exemple.com. Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.SetIdentifier = "1"
$change1.ResourceRecordSet.Weight = 3
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-2222222222.us-east-1.elb.amazonaws.com."
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.SetIdentifier = "2"
$change2.ResourceRecordSet.Weight = 1
$change2.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change2.ResourceRecordSet.AliasTarget.HostedZoneId = "Z3333333333333"
$change2.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-4444444444.us-east-1.elb.amazonaws.com."
$change2.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $false
$params = @{
HostedZoneId="Z5555555555"
ChangeBatch_Comment="This change batch creates two weighted alias resource record sets. Amazon Route 53 responds to queries for example.com with the first ELB domain 3/4ths of the times and the second one 1/4th of the time."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
**Exemple 5 : cet exemple crée deux jeux d’enregistrements de ressources d’alias de latence, l’un pour un équilibreur de charge ELB dans la région USA Ouest (Oregon) (us-west-2) et l’autre pour un équilibreur de charge dans la région Asie-Pacifique (Singapour) (ap-southeast-1). Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.SetIdentifier = "Oregon load balancer 1"
$change1.ResourceRecordSet.Region = us-west-2
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-2222222222.us-west-2.elb.amazonaws.com"
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.SetIdentifier = "Singapore load balancer 1"
$change2.ResourceRecordSet.Region = ap-southeast-1
$change2.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change2.ResourceRecordSet.AliasTarget.HostedZoneId = "Z2222222222222"
$change2.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-1111111111.ap-southeast-1.elb.amazonaws.com"
$change2.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$params = @{
HostedZoneId="Z5555555555"
ChangeBatch_Comment="This change batch creates two latency resource record sets, one for the US West (Oregon) region and one for the Asia Pacific (Singapore) region."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
+ Pour plus de détails sur l'API, reportez-vous [ChangeResourceRecordSets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-R53AccountLimit`
L'exemple de code suivant montre comment utiliser`Get-R53AccountLimit`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie le nombre maximum de zones hébergées qui peuvent être créées à l’aide du compte actuel.**
```
Get-R53AccountLimit -Type MAX_HOSTED_ZONES_BY_OWNER
```
**Sortie** :
```
15
```
+ Pour plus de détails sur l'API, reportez-vous [GetAccountLimit](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-R53CheckerIpRanges`
L'exemple de code suivant montre comment utiliser`Get-R53CheckerIpRanges`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple renvoie le CIDRs pour les vérificateurs de santé Route53**
```
Get-R53CheckerIpRanges
```
**Sortie** :
```
15.177.2.0/23
15.177.6.0/23
15.177.10.0/23
15.177.14.0/23
15.177.18.0/23
15.177.22.0/23
15.177.26.0/23
15.177.30.0/23
15.177.34.0/23
15.177.38.0/23
15.177.42.0/23
15.177.46.0/23
15.177.50.0/23
15.177.54.0/23
15.177.58.0/23
15.177.62.0/23
54.183.255.128/26
54.228.16.0/26
54.232.40.64/26
54.241.32.64/26
54.243.31.192/26
54.244.52.192/26
54.245.168.0/26
54.248.220.0/26
54.250.253.192/26
54.251.31.128/26
54.252.79.128/26
54.252.254.192/26
54.255.254.192/26
107.23.255.0/26
176.34.159.192/26
177.71.207.128/26
```
+ Pour plus de détails sur l'API, reportez-vous [GetCheckerIpRanges](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-R53HostedZone`
L'exemple de code suivant montre comment utiliser`Get-R53HostedZone`.
**Outils pour PowerShell V4**
**Exemple 1 : Renvoie les détails de la zone hébergée avec l'ID PJN98 FT9 Z1D633.**
```
Get-R53HostedZone -Id Z1D633PJN98FT9
```
+ Pour plus de détails sur l'API, reportez-vous [GetHostedZone](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-R53HostedZoneCount`
L'exemple de code suivant montre comment utiliser`Get-R53HostedZoneCount`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie le nombre total de zones hébergées publiques et privées pour la période actuelle Compte AWS.**
```
Get-R53HostedZoneCount
```
+ Pour plus de détails sur l'API, reportez-vous [GetHostedZoneCount](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-R53HostedZoneLimit`
L'exemple de code suivant montre comment utiliser`Get-R53HostedZoneLimit`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie la limite du nombre maximum d’enregistrements pouvant être créés dans la zone hébergée spécifiée.**
```
Get-R53HostedZoneLimit -HostedZoneId Z3MEQ8T7HAAAAF -Type MAX_RRSETS_BY_ZONE
```
**Sortie** :
```
5
```
+ Pour plus de détails sur l'API, reportez-vous [GetHostedZoneLimit](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-R53HostedZoneList`
L'exemple de code suivant montre comment utiliser`Get-R53HostedZoneList`.
**Outils pour PowerShell V4**
**Exemple 1 : affiche toutes vos zones hébergées publiques et privées.**
```
Get-R53HostedZoneList
```
**Exemple 2 : affiche toutes les zones hébergées associées à l'ensemble de délégations réutilisable portant l'ID NZ8 X2CISAMPLE**
```
Get-R53HostedZoneList -DelegationSetId NZ8X2CISAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [ListHostedZones](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-R53HostedZonesByName`
L'exemple de code suivant montre comment utiliser`Get-R53HostedZonesByName`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie toutes vos zones hébergées publiques et privées dans l’ordre ASCII par nom de domaine.**
```
Get-R53HostedZonesByName
```
**Exemple 2 : renvoie vos zones hébergées publiques et privées, dans l’ordre ASCII par nom de domaine, en commençant par le nom DNS spécifié.**
```
Get-R53HostedZonesByName -DnsName example2.com
```
+ Pour plus de détails sur l'API, reportez-vous [ListHostedZonesByName](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-R53QueryLoggingConfigList`
L'exemple de code suivant montre comment utiliser`Get-R53QueryLoggingConfigList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie toutes les configurations de journalisation de requêtes DNS qui sont associées au Compte AWS actuel.**
```
Get-R53QueryLoggingConfigList
```
**Sortie** :
```
Id HostedZoneId CloudWatchLogsLogGroupArn
-- ------------ -------------------------
59b0fa33-4fea-4471-a88c-926476aaa40d Z385PDS6EAAAZR arn:aws:logs:us-east-1:111111111112:log-group:/aws/route53/example1.com:*
ee528e95-4e03-4fdc-9d28-9e24ddaaa063 Z94SJHBV1AAAAZ arn:aws:logs:us-east-1:111111111112:log-group:/aws/route53/example2.com:*
e38dddda-ceb6-45c1-8cb7-f0ae56aaaa2b Z3MEQ8T7AAA1BF arn:aws:logs:us-east-1:111111111112:log-group:/aws/route53/example3.com:*
```
+ Pour plus de détails sur l'API, reportez-vous [ListQueryLoggingConfigs](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-R53ReusableDelegationSet`
L'exemple de code suivant montre comment utiliser`Get-R53ReusableDelegationSet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait des informations relatives à l’ensemble de délégations spécifié, y compris les quatre serveurs de noms affectés à l’ensemble de délégations.**
```
Get-R53ReusableDelegationSet -Id N23DS9X4AYEAAA
```
**Sortie** :
```
Id CallerReference NameServers
-- --------------- -----------
/delegationset/N23DS9X4AYEAAA testcaller {ns-545.awsdns-04.net, ns-1264.awsdns-30.org, ns-2004.awsdns-58.co.uk, ns-240.awsdns-30.com}
```
+ Pour plus de détails sur l'API, reportez-vous [GetReusableDelegationSet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-R53HostedZone`
L'exemple de code suivant montre comment utiliser`New-R53HostedZone`.
**Outils pour PowerShell V4**
**Exemple 1 : crée une nouvelle zone hébergée nommée « exemple.com », associée à un ensemble de délégations réutilisable Notez que vous devez fournir une valeur pour le CallerReference paramètre afin que les demandes puissent être réessayées si nécessaire sans risquer d'exécuter l'opération deux fois. Comme la zone hébergée est créée dans un VPC, elle est automatiquement privée et vous ne devez pas définir le paramètre - HostedZoneConfig \$1PrivateZone .**
```
$params = @{
Name="example.com"
CallerReference="myUniqueIdentifier"
HostedZoneConfig_Comment="This is my first hosted zone"
DelegationSetId="NZ8X2CISAMPLE"
VPC_VPCId="vpc-1a2b3c4d"
VPC_VPCRegion="us-east-1"
}
New-R53HostedZone @params
```
+ Pour plus de détails sur l'API, reportez-vous [CreateHostedZone](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-R53QueryLoggingConfig`
L'exemple de code suivant montre comment utiliser`New-R53QueryLoggingConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une nouvelle configuration de journalisation des requêtes DNS Route53 pour la zone hébergée spécifiée. Amazon Route53 publiera les journaux de requêtes DNS dans le groupe de journaux Cloudwatch spécifié.**
```
New-R53QueryLoggingConfig -HostedZoneId Z3MEQ8T7HAAAAF -CloudWatchLogsLogGroupArn arn:aws:logs:us-east-1:111111111111:log-group:/aws/route53/example.com:*
```
**Sortie** :
```
QueryLoggingConfig Location
------------------ --------
Amazon.Route53.Model.QueryLoggingConfig https://route53.amazonaws.com/2013-04-01/queryloggingconfig/ee5aaa95-4e03-4fdc-9d28-9e24ddaaaaa3
```
+ Pour plus de détails sur l'API, reportez-vous [CreateQueryLoggingConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-R53ReusableDelegationSet`
L'exemple de code suivant montre comment utiliser`New-R53ReusableDelegationSet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un ensemble de délégations réutilisable de quatre serveurs de noms qui peuvent être réutilisés par plusieurs zones hébergées.**
```
New-R53ReusableDelegationSet -CallerReference testcallerreference
```
**Sortie** :
```
DelegationSet Location
------------- --------
Amazon.Route53.Model.DelegationSet https://route53.amazonaws.com/2013-04-01/delegationset/N23DS9XAAAAAXM
```
+ Pour plus de détails sur l'API, reportez-vous [CreateReusableDelegationSet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-R53VPCWithHostedZone`
L'exemple de code suivant montre comment utiliser`Register-R53VPCWithHostedZone`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple associe le VPC spécifié à la zone hébergée privée.**
```
Register-R53VPCWithHostedZone -HostedZoneId Z3MEQ8T7HAAAAF -VPC_VPCId vpc-f1b9aaaa -VPC_VPCRegion us-east-1
```
**Sortie** :
```
Id Status SubmittedAt Comment
-- ------ ----------- -------
/change/C3SCAAA633Z6DX PENDING 01/28/2020 19:32:02
```
+ Pour plus de détails sur l'API, voir [Associer VPCWith HostedZone](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-R53HostedZone`
L'exemple de code suivant montre comment utiliser`Remove-R53HostedZone`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime la zone hébergée avec l’ID spécifié. Vous devrez confirmer avant que la commande ne soit exécutée, sauf si vous ajoutez le paramètre de commutation -Force.**
```
Remove-R53HostedZone -Id Z1PA6795UKMFR9
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteHostedZone](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-R53QueryLoggingConfig`
L'exemple de code suivant montre comment utiliser`Remove-R53QueryLoggingConfig`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la configuration spécifiée de la journalisation des requêtes DNS.**
```
Remove-R53QueryLoggingConfig -Id ee528e95-4e03-4fdc-9d28-9e24daaa20063
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteQueryLoggingConfig](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-R53ReusableDelegationSet`
L'exemple de code suivant montre comment utiliser`Remove-R53ReusableDelegationSet`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’ensemble de délégations réutilisable spécifié.**
```
Remove-R53ReusableDelegationSet -Id N23DS9X4AYAAAM
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteReusableDelegationSet](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-R53VPCFromHostedZone`
L'exemple de code suivant montre comment utiliser`Unregister-R53VPCFromHostedZone`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple dissocie le VPC spécifié de la zone hébergée privée.**
```
Unregister-R53VPCFromHostedZone -HostedZoneId Z3MEQ8T7HAAAAF -VPC_VPCId vpc-f1b9aaaa -VPC_VPCRegion us-east-1
```
**Sortie** :
```
Id Status SubmittedAt Comment
-- ------ ----------- -------
/change/C2XFCAAAA9HKZG PENDING 01/28/2020 10:35:55
```
+ Pour plus de détails sur l'API, consultez [Dissociate VPCFrom HostedZone](https://docs.aws.amazon.com/powershell/v4/reference) in *Outils AWS pour PowerShell Cmdlet Reference (*V4).
### `Update-R53HostedZoneComment`
L'exemple de code suivant montre comment utiliser`Update-R53HostedZoneComment`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande met à jour le commentaire pour la zone hébergée spécifiée.**
```
Update-R53HostedZoneComment -Id Z385PDS6AAAAAR -Comment "This is my first hosted zone"
```
**Sortie** :
```
Id : /hostedzone/Z385PDS6AAAAAR
Name : example.com.
CallerReference : C5B55555-7147-EF04-8341-69131E805C89
Config : Amazon.Route53.Model.HostedZoneConfig
ResourceRecordSetCount : 9
LinkedService :
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateHostedZoneComment](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Amazon S3 utilisant des outils pour PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Amazon S3.
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
### `Copy-S3Object`
L'exemple de code suivant montre comment utiliser`Copy-S3Object`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande copie l’objet « sample.txt » depuis le compartiment « test-files » vers le même compartiment, mais avec une nouvelle clé « sample-copy.txt ».**
```
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -DestinationKey sample-copy.txt
```
**Exemple 2 : cette commande copie l’objet « sample.txt » depuis le compartiment « test-files » vers le compartiment « backup-files » avec une clé « sample-copy.txt ».**
```
Copy-S3Object -BucketName amzn-s3-demo-source-bucket -Key sample.txt -DestinationKey sample-copy.txt -DestinationBucket amzn-s3-demo-destination-bucket
```
**Exemple 3 : cette commande télécharge l’objet « sample.txt » depuis le compartiment « test-files » vers un fichier local nommé « local-sample.txt ».**
```
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -LocalFile local-sample.txt
```
**Exemple 4 : télécharge l’objet unique dans le fichier spécifié. Le fichier téléchargé se trouve dans c:\$1downloads\$1data\$1archive.zip**
```
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key data/archive.zip -LocalFolder c:\downloads
```
**Exemple 5 : télécharge tous les objets qui correspondent au préfixe de clé spécifié dans le dossier local. La hiérarchie des clés relative sera préservée sous forme de sous-dossiers dans l’emplacement de téléchargement global.**
```
Copy-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data -LocalFolder c:\downloads
```
+ Pour plus de détails sur l'API, reportez-vous [CopyObject](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3ACL`
L'exemple de code suivant montre comment utiliser`Get-S3ACL`.
**Outils pour PowerShell V4**
**Exemple 1 : la commande obtient les détails du propriétaire de l’objet S3.**
```
Get-S3ACL -BucketName 'amzn-s3-demo-bucket' -key 'initialize.ps1' -Select AccessControlList.Owner
```
**Sortie** :
```
DisplayName Id
----------- --
testusername 9988776a6554433d22f1100112e334acb45566778899009e9887bd7f66c5f544
```
+ Pour plus de détails sur l’API, consultez [GetACL](https://docs.aws.amazon.com/powershell/v4/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V4)*.
### `Get-S3Bucket`
L'exemple de code suivant montre comment utiliser`Get-S3Bucket`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie tous les compartiments S3.**
```
Get-S3Bucket
```
**Exemple 2 : cette commande renvoie un compartiment nommé « test-files »**
```
Get-S3Bucket -BucketName amzn-s3-demo-bucket
```
+ Pour plus de détails sur l'API, reportez-vous [ListBuckets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketAccelerateConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3BucketAccelerateConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie la valeur Enabled, si les paramètres d’accélération du transfert sont activés pour le compartiment spécifié.**
```
Get-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket'
```
**Sortie** :
```
Value
-----
Enabled
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketAccelerateConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketAnalyticsConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3BucketAnalyticsConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie les détails du filtre d’analyse nommé « testfilter » dans le compartiment S3 donné.**
```
Get-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketAnalyticsConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketAnalyticsConfigurationList`
L'exemple de code suivant montre comment utiliser`Get-S3BucketAnalyticsConfigurationList`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie les cent premières configurations d’analyse du compartiment S3 donné.**
```
Get-S3BucketAnalyticsConfigurationList -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [ListBucketAnalyticsConfigurations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketEncryption`
L'exemple de code suivant montre comment utiliser`Get-S3BucketEncryption`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie toutes les règles de chiffrement côté serveur associées au compartiment donné.**
```
Get-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketEncryption](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketInventoryConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3BucketInventoryConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie les détails de l’inventaire nommé « testinventory » pour le compartiment S3 donné.**
```
Get-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testinventory'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketInventoryConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketInventoryConfigurationList`
L'exemple de code suivant montre comment utiliser`Get-S3BucketInventoryConfigurationList`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie les cent premières configurations d’inventaire du compartiment S3 donné.**
```
Get-S3BucketInventoryConfigurationList -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [ListBucketInventoryConfigurations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketLocation`
L'exemple de code suivant montre comment utiliser`Get-S3BucketLocation`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie la contrainte d’emplacement pour le compartiment « amzn-s3-demo-bucket », s’il en existe une.**
```
Get-S3BucketLocation -BucketName 'amzn-s3-demo-bucket'
```
**Sortie** :
```
Value
-----
ap-south-1
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketLocation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketLogging`
L'exemple de code suivant montre comment utiliser`Get-S3BucketLogging`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie le statut de journalisation pour le compartiment spécifié.**
```
Get-S3BucketLogging -BucketName 'amzn-s3-demo-bucket'
```
**Sortie** :
```
TargetBucketName Grants TargetPrefix
---------------- ------ ------------
testbucket1 {} testprefix
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketLogging](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketMetricsConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3BucketMetricsConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie les détails du filtre de métriques nommé « testfilter » pour le compartiment S3 donné.**
```
Get-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testfilter'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketMetricsConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketNotification`
L'exemple de code suivant montre comment utiliser`Get-S3BucketNotification`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait la configuration des notifications pour le compartiment donné**
```
Get-S3BucketNotification -BucketName amzn-s3-demo-bucket | select -ExpandProperty TopicConfigurations
```
**Sortie** :
```
Id Topic
-- -----
mimo arn:aws:sns:eu-west-1:123456789012:topic-1
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketNotification](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketPolicy`
L'exemple de code suivant montre comment utiliser`Get-S3BucketPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande génère la stratégie de compartiment associée au compartiment S3 donné.**
```
Get-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketPolicyStatus`
L'exemple de code suivant montre comment utiliser`Get-S3BucketPolicyStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie le statut de la stratégie pour le compartiment S3 donné, indiquant si ce compartiment est public.**
```
Get-S3BucketPolicyStatus -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketPolicyStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketReplication`
L'exemple de code suivant montre comment utiliser`Get-S3BucketReplication`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les informations de configuration de réplication définies sur le compartiment nommé « amzn-s3-demo-bucket ».**
```
Get-S3BucketReplication -BucketName amzn-s3-demo-bucket
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketReplication](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketRequestPayment`
L'exemple de code suivant montre comment utiliser`Get-S3BucketRequestPayment`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie la configuration de paiement des demandes pour le compartiment nommé « amzn-s3-demo-bucket ». Par défaut, le propriétaire du compartiment paie les téléchargements effectués depuis le compartiment.**
```
Get-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketRequestPayment](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketTagging`
L'exemple de code suivant montre comment utiliser`Get-S3BucketTagging`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie toutes les balises associées au compartiment donné.**
```
Get-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketTagging](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketVersioning`
L'exemple de code suivant montre comment utiliser`Get-S3BucketVersioning`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie le statut de la gestion des versions par rapport au compartiment donné.**
```
Get-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketVersioning](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3BucketWebsite`
L'exemple de code suivant montre comment utiliser`Get-S3BucketWebsite`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie les détails des configurations de site Web statiques du compartiment S3 donné.**
```
Get-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [GetBucketWebsite](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3CORSConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3CORSConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie un objet contenant toutes les règles de configuration CORS correspondant au compartiment S3 donné.**
```
Get-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket' -Select Configuration.Rules
```
**Sortie** :
```
AllowedMethods : {PUT, POST, DELETE}
AllowedOrigins : {http://www.example1.com}
Id :
ExposeHeaders : {}
MaxAgeSeconds : 0
AllowedHeaders : {*}
AllowedMethods : {PUT, POST, DELETE}
AllowedOrigins : {http://www.example2.com}
Id :
ExposeHeaders : {}
MaxAgeSeconds : 0
AllowedHeaders : {*}
AllowedMethods : {GET}
AllowedOrigins : {*}
Id :
ExposeHeaders : {}
MaxAgeSeconds : 0
AllowedHeaders : {}
```
+ Pour plus de détails sur l'API, consultez la section [Get CORSConfiguration](https://docs.aws.amazon.com/powershell/v4/reference) in *Outils AWS pour PowerShell Cmdlet Reference (V4)*.
### `Get-S3LifecycleConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3LifecycleConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait la configuration du cycle de vie du compartiment.**
```
Get-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket
```
**Sortie** :
```
Rules
-----
{Remove-in-150-days, Archive-to-Glacier-in-30-days}
```
+ Pour plus de détails sur l'API, reportez-vous [GetLifecycleConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3Object`
L'exemple de code suivant montre comment utiliser`Get-S3Object`.
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande récupère les informations relatives à tous les éléments du compartiment « test-files ».**
```
Get-S3Object -BucketName amzn-s3-demo-bucket
```
**Exemple 2 : Cette commande récupère les informations relatives à l’élément « sample.txt » depuis le compartiment « test-files ».**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt
```
**Exemple 3 : Cette commande récupère les informations relatives à tous les éléments portant le préfixe « sample » à partir du compartiment « test-files ».**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample
```
+ Pour plus de détails sur l'API, reportez-vous [ListObjects](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3ObjectLockConfiguration`
L'exemple de code suivant montre comment utiliser`Get-S3ObjectLockConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie la valeur « Enabled » si la configuration du verrouillage d’objet est activée pour le compartiment S3 donné.**
```
Get-S3ObjectLockConfiguration -BucketName 'amzn-s3-demo-bucket' -Select ObjectLockConfiguration.ObjectLockEnabled
```
**Sortie** :
```
Value
-----
Enabled
```
+ Pour plus de détails sur l'API, reportez-vous [GetObjectLockConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3ObjectMetadata`
L'exemple de code suivant montre comment utiliser`Get-S3ObjectMetadata`.
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande renvoie les métadonnées de l'objet avec la clé « ListTrusts .txt » dans le compartiment S3 donné.**
```
Get-S3ObjectMetadata -BucketName 'amzn-s3-demo-bucket' -Key 'ListTrusts.txt'
```
**Sortie** :
```
Headers : Amazon.S3.Model.HeadersCollection
Metadata : Amazon.S3.Model.MetadataCollection
DeleteMarker :
AcceptRanges : bytes
ContentRange :
Expiration :
RestoreExpiration :
RestoreInProgress : False
LastModified : 01/01/2020 08:02:05
ETag : "d000011112a222e333e3bb4ee5d43d21"
MissingMeta : 0
VersionId : null
Expires : 01/01/0001 00:00:00
WebsiteRedirectLocation :
ServerSideEncryptionMethod : AES256
ServerSideEncryptionCustomerMethod :
ServerSideEncryptionKeyManagementServiceKeyId :
ReplicationStatus :
PartsCount :
ObjectLockLegalHoldStatus :
ObjectLockMode :
ObjectLockRetainUntilDate : 01/01/0001 00:00:00
StorageClass :
RequestCharged :
```
+ Pour plus de détails sur l'API, reportez-vous [GetObjectMetadata](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3ObjectRetention`
L'exemple de code suivant montre comment utiliser`Get-S3ObjectRetention`.
**Outils pour PowerShell V4**
**Exemple 1 : la commande renvoie le mode et la date de conservation de l’objet.**
```
Get-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt'
```
+ Pour plus de détails sur l'API, reportez-vous [GetObjectRetention](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3ObjectTagSet`
L'exemple de code suivant montre comment utiliser`Get-S3ObjectTagSet`.
**Outils pour PowerShell V4**
**Exemple 1 : l’exemple renvoie les balises associées à l’objet présent dans le compartiment S3 donné.**
```
Get-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket'
```
**Sortie** :
```
Key Value
--- -----
test value
```
+ Pour plus de détails sur l'API, reportez-vous [GetObjectTagging](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3PreSignedURL`
L'exemple de code suivant montre comment utiliser`Get-S3PreSignedURL`.
**Outils pour PowerShell V4**
**Exemple 1 : la commande renvoie une URL pré-signée pour une clé spécifiée et une date d’expiration.**
```
Get-S3PreSignedURL -BucketName 'amzn-s3-demo-bucket' -Key 'testkey' -Expires '2023-11-16'
```
**Exemple 2 : la commande renvoie une URL pré-signée pour un compartiment de répertoire avec une clé spécifiée et une date d’expiration.**
```
[Amazon.AWSConfigsS3]::UseSignatureVersion4 = $true
Get-S3PreSignedURL -BucketName amzn-s3-demo-bucket--usw2-az1--x-s3 -Key 'testkey' -Expire '2023-11-17'
```
+ Pour plus de détails sur l'API, voir [GetPreSignedURL](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3PublicAccessBlock`
L'exemple de code suivant montre comment utiliser`Get-S3PublicAccessBlock`.
**Outils pour PowerShell V4**
**Exemple 1 : la commande renvoie la configuration du bloc d’accès public du compartiment S3 donné.**
```
Get-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [GetPublicAccessBlock](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-S3Version`
L'exemple de code suivant montre comment utiliser`Get-S3Version`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie les métadonnées relatives à toutes les versions des objets du compartiment S3 donné.**
```
Get-S3Version -BucketName 'amzn-s3-demo-bucket'
```
**Sortie** :
```
IsTruncated : False
KeyMarker :
VersionIdMarker :
NextKeyMarker :
NextVersionIdMarker :
Versions : {EC2.txt, EC2MicrosoftWindowsGuide.txt, ListDirectories.json, ListTrusts.json}
Name : amzn-s3-demo-bucket
Prefix :
MaxKeys : 1000
CommonPrefixes : {}
Delimiter :
```
+ Pour plus de détails sur l'API, reportez-vous [ListVersions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-S3Bucket`
L'exemple de code suivant montre comment utiliser`New-S3Bucket`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande crée un nouveau compartiment privé nommé « sample-bucket ».**
```
New-S3Bucket -BucketName amzn-s3-demo-bucket
```
**Exemple 2 : cette commande crée un nouveau compartiment nommé « sample-bucket » avec des autorisations de lecture-écriture.**
```
New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadWrite
```
**Exemple 3 : cette commande crée un nouveau compartiment nommé « sample-bucket » avec des autorisations de lecture seule.**
```
New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadOnly
```
**Exemple 4 : Cette commande crée un nouveau compartiment de répertoire nommé « amzn-s3-demo-bucket--use1-az5--x-s3" avec. PutBucketConfiguration**
```
$bucketConfiguration = @{
BucketInfo = @{
DataRedundancy = 'SingleAvailabilityZone'
Type = 'Directory'
}
Location = @{
Name = 'usw2-az1'
Type = 'AvailabilityZone'
}
}
New-S3Bucket -BucketName amzn-s3-demo-bucket--usw2-az1--x-s3 -BucketConfiguration $bucketConfiguration -Region us-west-2
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucket](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Read-S3Object`
L'exemple de code suivant montre comment utiliser`Read-S3Object`.
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande récupère l'élément « sample.txt » du bucket « amzn-s3-demo-bucket » et l'enregistre dans un fichier nommé « local-sample.txt » à l'emplacement actuel. Il n’est pas nécessaire que le fichier « local-sample.txt » existe pour que cette commande soit appelée.**
```
Read-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -File local-sample.txt
```
**Exemple 2 : Cette commande extrait le répertoire virtuel « DIR » du bucket « amzn-s3-demo-bucket » et l'enregistre dans un dossier nommé « Local-dir » à l'emplacement actuel. Il n’est pas nécessaire que le fichier « "Local-DIR » existe pour que cette commande soit appelée.**
```
Read-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix DIR -Folder Local-DIR
```
**Exemple 3 : télécharge tous les objets dont les clés se terminent par « .json » à partir des compartiments dont le nom contient « config » vers les fichiers du dossier spécifié. Les clés d’objet sont utilisées pour définir les noms de fichiers.**
```
Get-S3Bucket | ? { $_.BucketName -like '*config*' } | Get-S3Object | ? { $_.Key -like '*.json' } | Read-S3Object -Folder C:\ConfigObjects
```
+ Pour plus de détails sur l'API, reportez-vous [GetObject](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3Bucket`
L'exemple de code suivant montre comment utiliser`Remove-S3Bucket`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande supprime tous les objets et toutes les versions d’objets du compartiment « test-files », puis supprime le compartiment. La commande vous invite à confirmer avant de poursuivre. Ajoutez le commutateur -Force pour supprimer la confirmation. Notez que les compartiments qui ne sont pas vides ne peuvent pas être supprimés.**
```
Remove-S3Bucket -BucketName amzn-s3-demo-bucket -DeleteBucketContent
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucket](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3BucketAnalyticsConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketAnalyticsConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : ma commande supprime le filtre d’analyse nommé « testfilter » dans le compartiment S3 donné.**
```
Remove-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketAnalyticsConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3BucketEncryption`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketEncryption`.
**Outils pour PowerShell V4**
**Exemple 1 : cela désactive le chiffrement activé pour le compartiment S3 fourni.**
```
Remove-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketEncryption (DeleteBucketEncryption)" on target "s3casetestbucket".
[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 [DeleteBucketEncryption](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3BucketInventoryConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketInventoryConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande supprime l'inventaire nommé « testInventoryName » correspondant au compartiment S3 donné.**
```
Remove-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testInventoryName'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketInventoryConfiguration (DeleteBucketInventoryConfiguration)" on target "amzn-s3-demo-bucket".
[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 [DeleteBucketInventoryConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3BucketMetricsConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketMetricsConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : la commande supprime le filtre de métriques nommé « testmetrics » dans le compartiment S3 donné.**
```
Remove-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testmetrics'
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketMetricsConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3BucketPolicy`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketPolicy`.
**Outils pour PowerShell V4**
**Exemple 1 : la commande supprime la stratégie de compartiment associée au compartiment S3 donné.**
```
Remove-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketPolicy](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3BucketReplication`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketReplication`.
**Outils pour PowerShell V4**
**Exemple 1 : supprime la configuration de réplication associée au compartiment nommé « amzn-s3-demo-bucket ». Notez que cette opération nécessite une autorisation pour l'DeleteReplicationConfiguration action s3 :. Vous devrez confirmer avant que l’opération ne se poursuive. Pour supprimer la confirmation, utilisez le commutateur -Force.**
```
Remove-S3BucketReplication -BucketName amzn-s3-demo-bucket
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteBucketReplication](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3BucketTagging`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketTagging`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande supprime toutes les balises associées au compartiment S3 donné.**
```
Remove-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketTagging (DeleteBucketTagging)" on target "amzn-s3-demo-bucket".
[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 [DeleteBucketTagging](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3BucketWebsite`
L'exemple de code suivant montre comment utiliser`Remove-S3BucketWebsite`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande désactive la propriété d’hébergement statique du site Web du compartiment S3 donné.**
```
Remove-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3BucketWebsite (DeleteBucketWebsite)" on target "amzn-s3-demo-bucket".
[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 [DeleteBucketWebsite](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3CORSConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-S3CORSConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande supprime la configuration CORS pour le compartiment S3 donné.**
```
Remove-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3CORSConfiguration (DeleteCORSConfiguration)" on target "amzn-s3-demo-bucket".
[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, voir [Supprimer CORSConfiguration](https://docs.aws.amazon.com/powershell/v4/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3LifecycleConfiguration`
L'exemple de code suivant montre comment utiliser`Remove-S3LifecycleConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : la commande supprime toutes les règles de cycle de vie pour le compartiment S3 donné.**
```
Remove-S3LifecycleConfiguration -BucketName 'amzn-s3-demo-bucket'
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLifecycleConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3MultipartUpload`
L'exemple de code suivant montre comment utiliser`Remove-S3MultipartUpload`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande annule les chargements partitionnés créés il y a moins de cinq jours.**
```
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -DaysBefore 5
```
**Exemple 2 : cette commande annule les chargements partitionnés créés avant le 2 janvier 2014.**
```
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "Thursday, January 02, 2014"
```
**Exemple 3 : cette commande annule les chargements partitionnés créés avant le 2 janvier 2014, à 10 h 45 m 37 s.**
```
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "2014/01/02 10:45:37"
```
+ Pour plus de détails sur l'API, reportez-vous [AbortMultipartUpload](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3Object`
L'exemple de code suivant montre comment utiliser`Remove-S3Object`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande supprime l’objet « sample.txt » du compartiment « test-files ». Vous devrez confirmer avant l’exécution de la commande ; pour supprimer l’invite, utilisez le commutateur -Force.**
```
Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt
```
**Exemple 2 : cette commande supprime la version de l’objet « sample.txt » depuis le compartiment « test-files », en supposant que le compartiment a été configuré pour activer les versions d’objet.**
```
Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -VersionId HLbxnx6V9omT6AQYVpks8mmFKQcejpqt
```
**Exemple 3 : cette commande supprime les objets « sample1.txt », « sample2.txt » et « sample3.txt » du compartiment « test-files » en une seule opération par lots. La réponse du service répertoriera toutes les clés traitées, quel que soit le statut de réussite ou d’erreur de la suppression. Pour obtenir uniquement les erreurs pour les clés qui n'ont pas pu être traitées par le service, ajoutez le ReportErrorsOnly paramètre - (ce paramètre peut également être spécifié avec l'alias -Quiet).**
```
Remove-S3Object -BucketName amzn-s3-demo-bucket -KeyCollection @( "sample1.txt", "sample2.txt", "sample3.txt" )
```
**Exemple 4 : Cet exemple utilise une expression en ligne avec le KeyCollection paramètre - pour obtenir les clés des objets à supprimer. Get-S3Objectrenvoie une collection d'instances Amazon.S3.Model.S3Object, dont chacune possède un membre clé de type chaîne identifiant** l'objet.
```
Remove-S3Object -bucketname "amzn-s3-demo-bucket" -KeyCollection (Get-S3Object "test-files" -KeyPrefix "prefix/subprefix" | select -ExpandProperty Key)
```
**Exemple 5 : cet exemple obtient tous les objets dont le préfixe clé est « prefix/subprefix » dans le compartiment et les supprime. Notez que les objets entrants sont traités un par un. Pour les collections volumineuses, pensez à transmettre la collection au paramètre - InputObject (alias -S3ObjectCollection) de l'applet de commande pour permettre à la suppression de se produire par lots avec un seul appel au service.**
```
Get-S3Object -BucketName "amzn-s3-demo-bucket" -KeyPrefix "prefix/subprefix" | Remove-S3Object -Force
```
**Exemple 6 : Cet exemple dirige une collection d'ObjectVersion instances Amazon.S3.Model.S3 qui représentent des marqueurs de suppression vers l'applet de commande pour suppression. Notez que les objets entrants sont traités un par un. Pour les collections volumineuses, pensez à transmettre la collection au paramètre - InputObject (alias -S3ObjectCollection) de l'applet de commande pour permettre à la suppression de se produire par lots avec un seul appel au service.**
```
(Get-S3Version -BucketName "amzn-s3-demo-bucket").Versions | Where {$_.IsDeleteMarker -eq "True"} | Remove-S3Object -Force
```
**Exemple 7 : Ce script montre comment supprimer par lots un ensemble d'objets (dans ce cas, des marqueurs de suppression) en créant un tableau d'objets à utiliser avec le KeyAndVersionCollection paramètre -.**
```
$keyVersions = @()
$markers = (Get-S3Version -BucketName $BucketName).Versions | Where {$_.IsDeleteMarker -eq "True"}
foreach ($marker in $markers) { $keyVersions += @{ Key = $marker.Key; VersionId = $marker.VersionId } }
Remove-S3Object -BucketName $BucketName -KeyAndVersionCollection $keyVersions -Force
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteObjects](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3ObjectTagSet`
L'exemple de code suivant montre comment utiliser`Remove-S3ObjectTagSet`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande supprime toutes les balises associées à l’objet avec la clé « testfile.txt » dans le compartiment S3 donné.**
```
Remove-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket' -Select '^Key'
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-S3ObjectTagSet (DeleteObjectTagging)" on target "testfile.txt".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
testfile.txt
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteObjectTagging](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-S3PublicAccessBlock`
L'exemple de code suivant montre comment utiliser`Remove-S3PublicAccessBlock`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande désactive le paramètre de blocage de l’accès public pour le compartiment donné.**
```
Remove-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket' -Force -Select '^BucketName'
```
**Sortie** :
```
amzn-s3-demo-bucket
```
+ Pour plus de détails sur l'API, reportez-vous [DeletePublicAccessBlock](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-S3BucketEncryption`
L'exemple de code suivant montre comment utiliser`Set-S3BucketEncryption`.
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande active le chiffrement côté AES256 serveur par défaut avec les clés gérées Amazon S3 (SSE-S3) sur le compartiment donné.**
```
$Encryptionconfig = @{ServerSideEncryptionByDefault = @{ServerSideEncryptionAlgorithm = "AES256"}}
Set-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket' -ServerSideEncryptionConfiguration_ServerSideEncryptionRule $Encryptionconfig
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketEncryption](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Test-S3Bucket`
L'exemple de code suivant montre comment utiliser`Test-S3Bucket`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie True si le compartiment existe, ou False dans le cas contraire. La commande renvoie True même si le compartiment n’appartient pas à l’utilisateur.**
```
Test-S3Bucket -BucketName amzn-s3-demo-bucket
```
+ Pour plus de détails sur l'API, reportez-vous [Test-S3Bucket](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-S3BucketAccelerateConfiguration`
L'exemple de code suivant montre comment utiliser`Write-S3BucketAccelerateConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande active l’accélération du transfert pour le compartiment S3 donné.**
```
$statusVal = New-Object Amazon.S3.BucketAccelerateStatus('Enabled')
Write-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket' -AccelerateConfiguration_Status $statusVal
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketAccelerateConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-S3BucketNotification`
L'exemple de code suivant montre comment utiliser`Write-S3BucketNotification`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple configure la configuration de la rubrique SNS pour l'événement S3 ObjectRemovedDelete et active les notifications pour le compartiment s3 donné**
```
$topic = [Amazon.S3.Model.TopicConfiguration] @{
Id = "delete-event"
Topic = "arn:aws:sns:eu-west-1:123456789012:topic-1"
Event = [Amazon.S3.EventType]::ObjectRemovedDelete
}
Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -TopicConfiguration $topic
```
**Exemple 2 : Cet exemple active les notifications ObjectCreatedAll pour le bucket donné qui l'envoient à la fonction Lambda.**
```
$lambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{
Events = "s3:ObjectCreated:*"
FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:rdplock"
Id = "ObjectCreated-Lambda"
Filter = @{
S3KeyFilter = @{
FilterRules = @(
@{Name="Prefix";Value="dada"}
@{Name="Suffix";Value=".pem"}
)
}
}
}
Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -LambdaFunctionConfiguration $lambdaConfig
```
**Exemple 3 : cet exemple crée deux configurations Lambda différentes sur la base d’un suffixe clé différent et configure les deux en une seule commande.**
```
#Lambda Config 1
$firstLambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{
Events = "s3:ObjectCreated:*"
FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:verifynet"
Id = "ObjectCreated-dada-ps1"
Filter = @{
S3KeyFilter = @{
FilterRules = @(
@{Name="Prefix";Value="dada"}
@{Name="Suffix";Value=".ps1"}
)
}
}
}
#Lambda Config 2
$secondlambdaConfig = [Amazon.S3.Model.LambdaFunctionConfiguration] @{
Events = [Amazon.S3.EventType]::ObjectCreatedAll
FunctionArn = "arn:aws:lambda:eu-west-1:123456789012:function:verifyssm"
Id = "ObjectCreated-dada-json"
Filter = @{
S3KeyFilter = @{
FilterRules = @(
@{Name="Prefix";Value="dada"}
@{Name="Suffix";Value=".json"}
)
}
}
}
Write-S3BucketNotification -BucketName amzn-s3-demo-bucket -LambdaFunctionConfiguration $firstLambdaConfig,$secondlambdaConfig
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketNotification](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-S3BucketReplication`
L'exemple de code suivant montre comment utiliser`Write-S3BucketReplication`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple définit une configuration de réplication avec une règle unique permettant de répliquer dans le compartiment « amzn-s3-demo-bucket » tous les nouveaux objets créés avec le préfixe de nom clé « » dans le compartiment « amzn-s3-demo-bucket ». TaxDocs**
```
$rule1 = New-Object Amazon.S3.Model.ReplicationRule
$rule1.ID = "Rule-1"
$rule1.Status = "Enabled"
$rule1.Prefix = "TaxDocs"
$rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
$params = @{
BucketName = "amzn-s3-demo-bucket"
Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3"
Configuration_Rule = $rule1
}
Write-S3BucketReplication @params
```
**Exemple 2 : Cet exemple définit une configuration de réplication avec plusieurs règles permettant de répliquer vers le compartiment « amzn-s3-demo-bucket » tous les nouveaux objets créés avec le préfixe de nom de clé « » ou « ». TaxDocs OtherDocs Les préfixes de clés ne doivent pas se chevaucher.**
```
$rule1 = New-Object Amazon.S3.Model.ReplicationRule
$rule1.ID = "Rule-1"
$rule1.Status = "Enabled"
$rule1.Prefix = "TaxDocs"
$rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
$rule2 = New-Object Amazon.S3.Model.ReplicationRule
$rule2.ID = "Rule-2"
$rule2.Status = "Enabled"
$rule2.Prefix = "OtherDocs"
$rule2.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
$params = @{
BucketName = "amzn-s3-demo-bucket"
Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3"
Configuration_Rule = $rule1,$rule2
}
Write-S3BucketReplication @params
```
**Exemple 3 : Cet exemple met à jour la configuration de réplication sur le compartiment spécifié afin de désactiver la règle contrôlant la réplication des objets portant le préfixe de nom de clé « » vers le compartiment TaxDocs « amzn-s3-demo-bucket ».**
```
$rule1 = New-Object Amazon.S3.Model.ReplicationRule
$rule1.ID = "Rule-1"
$rule1.Status = "Disabled"
$rule1.Prefix = "TaxDocs"
$rule1.Destination = @{ BucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket" }
$params = @{
BucketName = "amzn-s3-demo-bucket"
Configuration_Role = "arn:aws:iam::35667example:role/CrossRegionReplicationRoleForS3"
Configuration_Rule = $rule1
}
Write-S3BucketReplication @params
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketReplication](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-S3BucketRequestPayment`
L'exemple de code suivant montre comment utiliser`Write-S3BucketRequestPayment`.
**Outils pour PowerShell V4**
**Exemple 1 : met à jour la configuration du paiement des demandes pour le compartiment nommé « amzn-s3-demo-bucket » afin que le téléchargement soit facturé à la personne demandant des téléchargements depuis le compartiment. Par défaut, le propriétaire du compartiment paie les téléchargements. Pour rétablir la valeur par défaut du paiement de la demande, utilisez « BucketOwner » pour le paramètre RequestPaymentConfiguration \$1Payer.**
```
Write-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket -RequestPaymentConfiguration_Payer Requester
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketRequestPayment](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-S3BucketTagging`
L'exemple de code suivant montre comment utiliser`Write-S3BucketTagging`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande applique deux balises à un compartiment nommé `cloudtrail-test-2018` : une balise avec une clé Stage et une valeur Test, et une balise avec une clé Environment et une valeur Alpha. Pour vérifier que les balises ont été ajoutées au compartiment, exécutez `Get-S3BucketTagging -BucketName bucket_name`. Les résultats doivent indiquer les balises que vous avez appliquées au compartiment lors de la première commande. Notez que `Write-S3BucketTagging` remplace la totalité du jeu de balises existant sur un compartiment. Pour ajouter ou supprimer des balises individuelles, exécutez les applets de commande Resource Groups et Tagging API, ainsi que `Add-RGTResourceTag` et `Remove-RGTResourceTag`. Vous pouvez également utiliser l'éditeur de balises dans la console AWS de gestion pour gérer les balises de compartiment S3.**
```
Write-S3BucketTagging -BucketName amzn-s3-demo-bucket -TagSet @( @{ Key="Stage"; Value="Test" }, @{ Key="Environment"; Value="Alpha" } )
```
**Exemple 2 : cette commande dirige un compartiment nommé `cloudtrail-test-2018` vers l’applet de commande `Write-S3BucketTagging`. Elle applique les balises Stage:Production et Department:Finance au compartiment. Notez que `Write-S3BucketTagging` remplace la totalité du jeu de balises existant sur un compartiment.**
```
Get-S3Bucket -BucketName amzn-s3-demo-bucket | Write-S3BucketTagging -TagSet @( @{ Key="Stage"; Value="Production" }, @{ Key="Department"; Value="Finance" } )
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketTagging](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-S3BucketVersioning`
L'exemple de code suivant montre comment utiliser`Write-S3BucketVersioning`.
**Outils pour PowerShell V4**
**Exemple 1 : la commande active la gestion des versions pour le compartiment S3 donné.**
```
Write-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket' -VersioningConfig_Status Enabled
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketVersioning](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-S3BucketWebsite`
L'exemple de code suivant montre comment utiliser`Write-S3BucketWebsite`.
**Outils pour PowerShell V4**
**Exemple 1 : la commande active l’hébergement du site Web pour le compartiment donné avec le document d’index « index.html » et le document d’erreur « error.html ».**
```
Write-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket' -WebsiteConfiguration_IndexDocumentSuffix 'index.html' -WebsiteConfiguration_ErrorDocument 'error.html'
```
+ Pour plus de détails sur l'API, reportez-vous [PutBucketWebsite](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-S3LifecycleConfiguration`
L'exemple de code suivant montre comment utiliser`Write-S3LifecycleConfiguration`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple écrit/remplace la configuration fournie dans le \$1NewRule. Cette configuration garantit de limiter les objets de portée avec des valeurs de préfixe et de balise données.**
```
$NewRule = [Amazon.S3.Model.LifecycleRule] @{
Expiration = @{
Days= 50
}
Id = "Test-From-Write-cmdlet-1"
Filter= @{
LifecycleFilterPredicate = [Amazon.S3.Model.LifecycleAndOperator]@{
Operands= @(
[Amazon.S3.Model.LifecyclePrefixPredicate] @{
"Prefix" = "py"
},
[Amazon.S3.Model.LifecycleTagPredicate] @{
"Tag"= @{
"Key" = "non-use"
"Value" = "yes"
}
}
)
}
}
"Status"= 'Enabled'
NoncurrentVersionExpiration = @{
NoncurrentDays = 75
}
}
Write-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket -Configuration_Rule $NewRule
```
**Exemple 2 : Cet exemple définit plusieurs règles avec le filtrage. \$1 ArchiveRule définit les objets à archiver dans 30 jours dans Glacier et 120 dans DeepArchive. \$1 ExpireRule expire les versions actuelles et précédentes en 150 jours pour les objets dont le préfixe « py » et le tag:key « archivé » sont définis sur « yes ».**
```
$ExpireRule = [Amazon.S3.Model.LifecycleRule] @{
Expiration = @{
Days= 150
}
Id = "Remove-in-150-days"
Filter= @{
LifecycleFilterPredicate = [Amazon.S3.Model.LifecycleAndOperator]@{
Operands= @(
[Amazon.S3.Model.LifecyclePrefixPredicate] @{
"Prefix" = "py"
},
[Amazon.S3.Model.LifecycleTagPredicate] @{
"Tag"= @{
"Key" = "archived"
"Value" = "yes"
}
}
)
}
}
Status= 'Enabled'
NoncurrentVersionExpiration = @{
NoncurrentDays = 150
}
}
$ArchiveRule = [Amazon.S3.Model.LifecycleRule] @{
Expiration = $null
Id = "Archive-to-Glacier-in-30-days"
Filter= @{
LifecycleFilterPredicate = [Amazon.S3.Model.LifecycleAndOperator]@{
Operands= @(
[Amazon.S3.Model.LifecyclePrefixPredicate] @{
"Prefix" = "py"
},
[Amazon.S3.Model.LifecycleTagPredicate] @{
"Tag"= @{
"Key" = "reviewed"
"Value" = "yes"
}
}
)
}
}
Status = 'Enabled'
NoncurrentVersionExpiration = @{
NoncurrentDays = 75
}
Transitions = @(
@{
Days = 30
"StorageClass"= 'Glacier'
},
@{
Days = 120
"StorageClass"= [Amazon.S3.S3StorageClass]::DeepArchive
}
)
}
Write-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket -Configuration_Rule $ExpireRule,$ArchiveRule
```
+ Pour plus de détails sur l'API, reportez-vous [PutLifecycleConfiguration](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-S3Object`
L'exemple de code suivant montre comment utiliser`Write-S3Object`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande charge le fichier unique « local-sample.txt » sur Amazon S3, créant un objet avec la clé « sample.txt » dans le compartiment « test-files ».**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -File .\local-sample.txt
```
**Exemple 2 : cette commande charge le fichier unique « sample.txt » sur Amazon S3, créant un objet avec la clé « sample.txt » dans le compartiment « test-files ». Si le paramètre -Key n’est pas fourni, le nom du fichier est utilisé comme clé d’objet S3.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -File .\sample.txt
```
**Exemple 3 : cette commande télécharge le fichier unique « local-sample.txt » sur Amazon S3, créant un objet avec la clé « prefix/to/sample .txt » dans le compartiment « test-files ».**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "prefix/to/sample.txt" -File .\local-sample.txt
```
**Exemple 4 : Cette commande télécharge tous les fichiers du sous-répertoire « Scripts » vers le bucket « test-files » et applique le préfixe de clé commun « » à chaque objet. SampleScripts Chaque fichier téléchargé aura une clé « SampleScripts /filename » où « filename » varie.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\
```
**Exemple 5 : Cette commande télécharge tous les fichiers\$1.ps1 du répertoire local « Scripts » vers le bucket « test-files » et applique le préfixe de clé commun « » à chaque objet. SampleScripts Chaque fichier téléchargé aura une clé « SampleScripts /filename.ps1 » où le « nom de fichier » varie.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\ -SearchPattern *.ps1
```
**Exemple 6 : cette commande crée un nouvel objet S3 contenant la chaîne de contenu spécifiée avec la clé « sample.txt ».**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -Content "object contents"
```
**Exemple 7 : cette commande charge le fichier spécifié (le nom du fichier est utilisé comme clé) et applique les balises spécifiées au nouvel objet.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -File "sample.txt" -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}
```
**Exemple 8 : cette commande charge de manière récursive le dossier spécifié et applique les balises spécifiées à tous les nouveaux objets.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder . -KeyPrefix "TaggedFiles" -Recurse -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}
```
+ Pour plus de détails sur l'API, reportez-vous [PutObject](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-S3ObjectRetention`
L'exemple de code suivant montre comment utiliser`Write-S3ObjectRetention`.
**Outils pour PowerShell V4**
**Exemple 1 : la commande active le mode de rétention de la gouvernance jusqu’à la date du 31 décembre 2019 à 00 h 00 m 00 s pour l’objet « testfile.txt » dans le compartiment S3 donné.**
```
Write-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt' -Retention_Mode GOVERNANCE -Retention_RetainUntilDate "2019-12-31T00:00:00"
```
+ Pour plus de détails sur l'API, reportez-vous [PutObjectRetention](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples de Security Hub CSPM utilisant Tools for V4 PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la version Outils AWS pour PowerShell V4 avec Security Hub CSPM.
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
### `Get-SHUBFinding`
L'exemple de code suivant montre comment utiliser`Get-SHUBFinding`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande extrait les résultats du Security Hub auprès du service Amazon EC2.**
```
$filter = New-Object -TypeName Amazon.SecurityHub.Model.AwsSecurityFindingFilters
$filter.ResourceType = New-Object -TypeName Amazon.SecurityHub.Model.StringFilter -Property @{
Comparison = 'PREFIX'
Value = 'AwsEc2'
}
Get-SHUBFinding -Filter $filter
```
**Exemple 2 : Cette commande récupère les résultats du Security Hub à partir de l'ID de AWS compte 123456789012.**
```
$filter = New-Object -TypeName Amazon.SecurityHub.Model.AwsSecurityFindingFilters
$filter.AwsAccountId = New-Object -TypeName Amazon.SecurityHub.Model.StringFilter -Property @{
Comparison = 'EQUALS'
Value = '123456789012'
}
Get-SHUBFinding -Filter $filter
```
**Exemple 3 : cette commande extrait les résultats du Security Hub générés pour le standard « pci-dss ».**
```
$filter = New-Object -TypeName Amazon.SecurityHub.Model.AwsSecurityFindingFilters
$filter.GeneratorId = New-Object -TypeName Amazon.SecurityHub.Model.StringFilter -Property @{
Comparison = 'PREFIX'
Value = 'pci-dss'
}
Get-SHUBFinding -Filter $filter
```
**Exemple 4 : cette commande extrait les résultats de gravité critique de Security Hub dont le statut de flux de travail est NOTIFIÉ.**
```
$filter = New-Object -TypeName Amazon.SecurityHub.Model.AwsSecurityFindingFilters
$filter.SeverityLabel = New-Object -TypeName Amazon.SecurityHub.Model.StringFilter -Property @{
Comparison = 'EQUALS'
Value = 'CRITICAL'
}
$filter.WorkflowStatus = New-Object -TypeName Amazon.SecurityHub.Model.StringFilter -Property @{
Comparison = 'EQUALS'
Value = 'NOTIFIED'
}
Get-SHUBFinding -Filter $filter
```
+ Pour plus de détails sur l'API, reportez-vous [GetFindings](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Amazon SES utilisant Tools for PowerShell V4
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 V4 avec Amazon SES.
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
### `Get-SESIdentity`
L'exemple de code suivant montre comment utiliser`Get-SESIdentity`.
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande renvoie une liste contenant toutes les identités (adresses e-mail et domaines) d'un AWS compte spécifique, quel que soit le statut de vérification.**
```
Get-SESIdentity
```
+ Pour plus de détails sur l'API, reportez-vous [ListIdentities](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SESSendQuota`
L'exemple de code suivant montre comment utiliser`Get-SESSendQuota`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie les limites d’envoi actuelles de l’utilisateur.**
```
Get-SESSendQuota
```
+ Pour plus de détails sur l'API, reportez-vous [GetSendQuota](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SESSendStatistic`
L'exemple de code suivant montre comment utiliser`Get-SESSendStatistic`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande renvoie les statistiques d’envoi de l’utilisateur. Le résultat est une liste de points de données représentant les deux dernières semaines de l’activité d’envoi. Chaque point de données de la liste contient des statistiques pour un intervalle de 15 minutes.**
```
Get-SESSendStatistic
```
+ Pour plus de détails sur l'API, reportez-vous [GetSendStatistics](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'API Amazon SES v2 utilisant Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la version Outils AWS pour PowerShell V4 avec l'API Amazon SES v2.
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
### `Send-SES2Email`
L'exemple de code suivant montre comment utiliser`Send-SES2Email`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre comment envoyer un e-mail standard.**
```
Send-SES2Email -FromEmailAddress "sender@example.com" -Destination_ToAddress "recipient@example.com" -Subject_Data "Email Subject" -Text_Data "Email Body"
```
+ Pour plus de détails sur l'API, reportez-vous [SendEmail](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Amazon SNS utilisant Tools for V4 PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Amazon SNS.
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
### `Publish-SNSMessage`
L'exemple de code suivant montre comment utiliser`Publish-SNSMessage`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple montre la publication d'un message avec un seul élément MessageAttribute déclaré en ligne.**
```
Publish-SNSMessage -TopicArn "arn:aws:sns:us-west-2:123456789012:my-topic" -Message "Hello" -MessageAttribute @{'City'=[Amazon.SimpleNotificationService.Model.MessageAttributeValue]@{DataType='String'; StringValue ='AnyCity'}}
```
**Exemple 2 : Cet exemple montre la publication d'un message dont plusieurs MessageAttributes ont été déclarés à l'avance.**
```
$cityAttributeValue = New-Object Amazon.SimpleNotificationService.Model.MessageAttributeValue
$cityAttributeValue.DataType = "String"
$cityAttributeValue.StringValue = "AnyCity"
$populationAttributeValue = New-Object Amazon.SimpleNotificationService.Model.MessageAttributeValue
$populationAttributeValue.DataType = "Number"
$populationAttributeValue.StringValue = "1250800"
$messageAttributes = New-Object System.Collections.Hashtable
$messageAttributes.Add("City", $cityAttributeValue)
$messageAttributes.Add("Population", $populationAttributeValue)
Publish-SNSMessage -TopicArn "arn:aws:sns:us-west-2:123456789012:my-topic" -Message "Hello" -MessageAttribute $messageAttributes
```
+ Pour plus de détails sur l’API, consultez [Publish](https://docs.aws.amazon.com/powershell/v4/reference) dans la *Référence des applets de commande pour les Outils AWS pour PowerShell (V4)*.
# Exemples d'Amazon SQS utilisant Tools for V4 PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la version Outils AWS pour PowerShell V4 avec Amazon SQS.
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-SQSPermission`
L'exemple de code suivant montre comment utiliser`Add-SQSPermission`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple permet à la personne spécifiée Compte AWS d'envoyer des messages depuis la file d'attente spécifiée.**
```
Add-SQSPermission -Action SendMessage -AWSAccountId 80398EXAMPLE -Label SendMessagesFromMyQueue -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Pour plus de détails sur l'API, reportez-vous [AddPermission](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Clear-SQSQueue`
L'exemple de code suivant montre comment utiliser`Clear-SQSQueue`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime tous les messages de la file d’attente spécifiée.**
```
Clear-SQSQueue -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Pour plus de détails sur l'API, reportez-vous [PurgeQueue](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-SQSMessageVisibility`
L'exemple de code suivant montre comment utiliser`Edit-SQSMessageVisibility`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie le délai de visibilité du message avec le descripteur de réception spécifié dans la file d’attente spécifiée à 10 heures (10 heures \$1 60 minutes \$1 60 secondes = 36 000 secondes).**
```
Edit-SQSMessageVisibility -QueueUrl https://sqs.us-east-1.amazonaws.com/8039EXAMPLE/MyQueue -ReceiptHandle AQEBgGDh...J/Iqww== -VisibilityTimeout 36000
```
+ Pour plus de détails sur l'API, reportez-vous [ChangeMessageVisibility](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-SQSMessageVisibilityBatch`
L'exemple de code suivant montre comment utiliser`Edit-SQSMessageVisibilityBatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie le délai de visibilité pour deux messages avec les descripteurs de réception spécifiés dans la file d’attente spécifiée. Le délai de visibilité du premier message passe à 10 heures (10 heures \$1 60 minutes \$1 60 secondes = 36 000 secondes). Le délai de visibilité du second message passe à 5 heures (5 heures \$1 60 minutes \$1 60 secondes = 18 000 secondes).**
```
$changeVisibilityRequest1 = New-Object Amazon.SQS.Model.ChangeMessageVisibilityBatchRequestEntry
$changeVisibilityRequest1.Id = "Request1"
$changeVisibilityRequest1.ReceiptHandle = "AQEBd329...v6gl8Q=="
$changeVisibilityRequest1.VisibilityTimeout = 36000
$changeVisibilityRequest2 = New-Object Amazon.SQS.Model.ChangeMessageVisibilityBatchRequestEntry
$changeVisibilityRequest2.Id = "Request2"
$changeVisibilityRequest2.ReceiptHandle = "AQEBgGDh...J/Iqww=="
$changeVisibilityRequest2.VisibilityTimeout = 18000
Edit-SQSMessageVisibilityBatch -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue -Entry $changeVisibilityRequest1, $changeVisibilityRequest2
```
**Sortie** :
```
Failed Successful
------ ----------
{} {Request2, Request1}
```
+ Pour plus de détails sur l'API, reportez-vous [ChangeMessageVisibilityBatch](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SQSDeadLetterSourceQueue`
L'exemple de code suivant montre comment utiliser`Get-SQSDeadLetterSourceQueue`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple répertorie toutes les URLs files d'attente qui utilisent la file d'attente spécifiée comme file d'attente de lettres mortes.**
```
Get-SQSDeadLetterSourceQueue -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyDeadLetterQueue
```
**Sortie** :
```
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyOtherQueue
```
+ Pour plus de détails sur l'API, reportez-vous [ListDeadLetterSourceQueues](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SQSQueue`
L'exemple de code suivant montre comment utiliser`Get-SQSQueue`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les files d’attente.**
```
Get-SQSQueue
```
**Sortie** :
```
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/AnotherQueue
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/DeadLetterQueue
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyOtherQueue
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyDeadLetterQueue
```
**Exemple 2 : cet exemple répertorie toutes les files d’attente qui commencent par le nom spécifié.**
```
Get-SQSQueue -QueueNamePrefix My
```
**Sortie** :
```
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyOtherQueue
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyDeadLetterQueue
```
+ Pour plus de détails sur l'API, reportez-vous [ListQueues](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SQSQueueAttribute`
L'exemple de code suivant montre comment utiliser`Get-SQSQueueAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie tous les attributs de la file d’attente spécifiée.**
```
Get-SQSQueueAttribute -AttributeName All -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
**Sortie** :
```
VisibilityTimeout : 30
DelaySeconds : 0
MaximumMessageSize : 262144
MessageRetentionPeriod : 345600
ApproximateNumberOfMessages : 0
ApproximateNumberOfMessagesNotVisible : 0
ApproximateNumberOfMessagesDelayed : 0
CreatedTimestamp : 2/11/2015 5:53:35 PM
LastModifiedTimestamp : 12/29/2015 2:23:17 PM
QueueARN : arn:aws:sqs:us-east-1:80398EXAMPLE:MyQueue
Policy : {"Version":"2012-10-17", "Id":"arn:aws:sqs:us-east-1:80398EXAMPLE:MyQueue/SQSDefaultPolicy","Statement":[{"Sid":"Sid14
495134224EX","Effect":"Allow","Principal":{"AWS":"*"},"Action":"SQS:SendMessage","Resource":"arn:aws:sqs:us-east-1:80
398EXAMPLE:MyQueue","Condition":{"ArnEquals":{"aws:SourceArn":"arn:aws:sns:us-east-1:80398EXAMPLE:MyTopic"}}},{"Sid":
"SendMessagesFromMyQueue","Effect":"Allow","Principal":{"AWS":"80398EXAMPLE"},"Action":"SQS:SendMessage","Resource":"
arn:aws:sqs:us-east-1:80398EXAMPLE:MyQueue"}]}
Attributes : {[QueueArn, arn:aws:sqs:us-east-1:80398EXAMPLE:MyQueue], [ApproximateNumberOfMessages, 0],
[ApproximateNumberOfMessagesNotVisible, 0], [ApproximateNumberOfMessagesDelayed, 0]...}
```
**Exemple 2 : cet exemple répertorie séparément uniquement les attributs spécifiés pour la file d’attente spécifiée.**
```
Get-SQSQueueAttribute -AttributeName MaximumMessageSize, VisibilityTimeout -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
**Sortie** :
```
VisibilityTimeout : 30
DelaySeconds : 0
MaximumMessageSize : 262144
MessageRetentionPeriod : 345600
ApproximateNumberOfMessages : 0
ApproximateNumberOfMessagesNotVisible : 0
ApproximateNumberOfMessagesDelayed : 0
CreatedTimestamp : 2/11/2015 5:53:35 PM
LastModifiedTimestamp : 12/29/2015 2:23:17 PM
QueueARN : arn:aws:sqs:us-east-1:80398EXAMPLE:MyQueue
Policy : {"Version":"2012-10-17", "Id":"arn:aws:sqs:us-east-1:80398EXAMPLE:MyQueue/SQSDefaultPolicy","Statement":[{"Sid":"Sid14
495134224EX","Effect":"Allow","Principal":{"AWS":"*"},"Action":"SQS:SendMessage","Resource":"arn:aws:sqs:us-east-1:80
398EXAMPLE:MyQueue","Condition":{"ArnEquals":{"aws:SourceArn":"arn:aws:sns:us-east-1:80398EXAMPLE:MyTopic"}}},{"Sid":
"SendMessagesFromMyQueue","Effect":"Allow","Principal":{"AWS":"80398EXAMPLE"},"Action":"SQS:SendMessage","Resource":"
arn:aws:sqs:us-east-1:80398EXAMPLE:MyQueue"}]}
Attributes : {[MaximumMessageSize, 262144], [VisibilityTimeout, 30]}
```
+ Pour plus de détails sur l'API, reportez-vous [GetQueueAttributes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SQSQueueUrl`
L'exemple de code suivant montre comment utiliser`Get-SQSQueueUrl`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie l’URL de la file d’attente portant le nom spécifié.**
```
Get-SQSQueueUrl -QueueName MyQueue
```
**Sortie** :
```
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Pour plus de détails sur l'API, reportez-vous [GetQueueUrl](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-SQSQueue`
L'exemple de code suivant montre comment utiliser`New-SQSQueue`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une file d’attente portant le nom spécifié.**
```
New-SQSQueue -QueueName MyQueue
```
**Sortie** :
```
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Pour plus de détails sur l'API, reportez-vous [CreateQueue](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Receive-SQSMessage`
L'exemple de code suivant montre comment utiliser`Receive-SQSMessage`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les informations relatives aux dix prochains messages à recevoir pour la file d’attente spécifiée. Les informations contiendront des valeurs pour les attributs de message spécifiés, s’ils existent.**
```
Receive-SQSMessage -AttributeName SenderId, SentTimestamp -MessageAttributeName StudentName, StudentGrade -MessageCount 10 -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
**Sortie** :
```
Attributes : {[SenderId, AIDAIAZKMSNQ7TEXAMPLE], [SentTimestamp, 1451495923744]}
Body : Information about John Doe's grade.
MD5OfBody : ea572796e3c231f974fe75d89EXAMPLE
MD5OfMessageAttributes : 48c1ee811f0fe7c4e88fbe0f5EXAMPLE
MessageAttributes : {[StudentGrade, Amazon.SQS.Model.MessageAttributeValue], [StudentName, Amazon.SQS.Model.MessageAttributeValue]}
MessageId : 53828c4b-631b-469b-8833-c093cEXAMPLE
ReceiptHandle : AQEBpfGp...20Q5cg==
```
+ Pour plus de détails sur l'API, reportez-vous [ReceiveMessage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-SQSMessage`
L'exemple de code suivant montre comment utiliser`Remove-SQSMessage`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le message avec le descripteur de réception spécifié de la file d’attente spécifiée.**
```
Remove-SQSMessage -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue -ReceiptHandle AQEBd329...v6gl8Q==
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteMessage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-SQSMessageBatch`
L'exemple de code suivant montre comment utiliser`Remove-SQSMessageBatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime deux messages avec les descripteurs de réception spécifiés de la file d’attente spécifiée.**
```
$deleteMessageRequest1 = New-Object Amazon.SQS.Model.DeleteMessageBatchRequestEntry
$deleteMessageRequest1.Id = "Request1"
$deleteMessageRequest1.ReceiptHandle = "AQEBX2g4...wtJSQg=="
$deleteMessageRequest2 = New-Object Amazon.SQS.Model.DeleteMessageBatchRequestEntry
$deleteMessageRequest2.Id = "Request2"
$deleteMessageRequest2.ReceiptHandle = "AQEBqOVY...KTsLYg=="
Remove-SQSMessageBatch -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue -Entry $deleteMessageRequest1, $deleteMessageRequest2
```
**Sortie** :
```
Failed Successful
------ ----------
{} {Request1, Request2}
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteMessageBatch](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-SQSPermission`
L'exemple de code suivant montre comment utiliser`Remove-SQSPermission`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime les paramètres des autorisations avec l’étiquette spécifiée de la file d’attente spécifiée.**
```
Remove-SQSPermission -Label SendMessagesFromMyQueue -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Pour plus de détails sur l'API, reportez-vous [RemovePermission](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-SQSQueue`
L'exemple de code suivant montre comment utiliser`Remove-SQSQueue`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la file d’attente spécifiée.**
```
Remove-SQSQueue -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteQueue](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Send-SQSMessage`
L'exemple de code suivant montre comment utiliser`Send-SQSMessage`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple envoie un message avec les attributs et le corps du message spécifiés à la file d’attente spécifiée avec un délai de livraison du message de dix secondes.**
```
$cityAttributeValue = New-Object Amazon.SQS.Model.MessageAttributeValue
$cityAttributeValue.DataType = "String"
$cityAttributeValue.StringValue = "AnyCity"
$populationAttributeValue = New-Object Amazon.SQS.Model.MessageAttributeValue
$populationAttributeValue.DataType = "Number"
$populationAttributeValue.StringValue = "1250800"
$messageAttributes = New-Object System.Collections.Hashtable
$messageAttributes.Add("City", $cityAttributeValue)
$messageAttributes.Add("Population", $populationAttributeValue)
Send-SQSMessage -DelayInSeconds 10 -MessageAttributes $messageAttributes -MessageBody "Information about the largest city in Any Region." -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
**Sortie** :
```
MD5OfMessageAttributes MD5OfMessageBody MessageId
---------------------- ---------------- ---------
1d3e51347bc042efbdf6dda31EXAMPLE 51b0a3256d59467f973009b73EXAMPLE c35fed8f-c739-4d0c-818b-1820eEXAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [SendMessage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Send-SQSMessageBatch`
L'exemple de code suivant montre comment utiliser`Send-SQSMessageBatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple envoie deux messages avec les attributs et les corps de message spécifiés à la file d’attente spécifiée. La livraison est retardée de 15 secondes pour le premier message et de 10 secondes pour le second.**
```
$student1NameAttributeValue = New-Object Amazon.SQS.Model.MessageAttributeValue
$student1NameAttributeValue.DataType = "String"
$student1NameAttributeValue.StringValue = "John Doe"
$student1GradeAttributeValue = New-Object Amazon.SQS.Model.MessageAttributeValue
$student1GradeAttributeValue.DataType = "Number"
$student1GradeAttributeValue.StringValue = "89"
$student2NameAttributeValue = New-Object Amazon.SQS.Model.MessageAttributeValue
$student2NameAttributeValue.DataType = "String"
$student2NameAttributeValue.StringValue = "Jane Doe"
$student2GradeAttributeValue = New-Object Amazon.SQS.Model.MessageAttributeValue
$student2GradeAttributeValue.DataType = "Number"
$student2GradeAttributeValue.StringValue = "93"
$message1 = New-Object Amazon.SQS.Model.SendMessageBatchRequestEntry
$message1.DelaySeconds = 15
$message1.Id = "FirstMessage"
$message1.MessageAttributes.Add("StudentName", $student1NameAttributeValue)
$message1.MessageAttributes.Add("StudentGrade", $student1GradeAttributeValue)
$message1.MessageBody = "Information about John Doe's grade."
$message2 = New-Object Amazon.SQS.Model.SendMessageBatchRequestEntry
$message2.DelaySeconds = 10
$message2.Id = "SecondMessage"
$message2.MessageAttributes.Add("StudentName", $student2NameAttributeValue)
$message2.MessageAttributes.Add("StudentGrade", $student2GradeAttributeValue)
$message2.MessageBody = "Information about Jane Doe's grade."
Send-SQSMessageBatch -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue -Entry $message1, $message2
```
**Sortie** :
```
Failed Successful
------ ----------
{} {FirstMessage, SecondMessage}
```
+ Pour plus de détails sur l'API, reportez-vous [SendMessageBatch](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Set-SQSQueueAttribute`
L'exemple de code suivant montre comment utiliser`Set-SQSQueueAttribute`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre comment définir une stratégie d’abonnement d’une file d’attente à une rubrique SNS. Lorsqu’un message est publié dans la rubrique, un message est envoyé à la file d’attente qui y est abonnée.**
```
# create the queue and topic to be associated
$qurl = New-SQSQueue -QueueName "myQueue"
$topicarn = New-SNSTopic -Name "myTopic"
# get the queue ARN to inject into the policy; it will be returned
# in the output's QueueARN member but we need to put it into a variable
# so text expansion in the policy string takes effect
$qarn = (Get-SQSQueueAttribute -QueueUrl $qurl -AttributeName "QueueArn").QueueARN
# construct the policy and inject arns
$policy = @"
{
"Version":"2012-10-17",
"Id": "$qarn/SQSPOLICY",
"Statement": [
{
"Sid": "1",
"Effect": "Allow",
"Principal": "*",
"Action": "SQS:SendMessage",
"Resource": "$qarn",
"Condition": {
"ArnEquals": {
"aws:SourceArn": "$topicarn"
}
}
}
]
}
"@
# set the policy
Set-SQSQueueAttribute -QueueUrl $qurl -Attribute @{ Policy=$policy }
```
**Exemple 2 : cet exemple définit les attributs spécifiés pour la file d’attente spécifiée.**
```
Set-SQSQueueAttribute -Attribute @{"DelaySeconds" = "10"; "MaximumMessageSize" = "131072"} -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Pour plus de détails sur l'API, reportez-vous [SetQueueAttributes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# AWS STS exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec AWS STS.
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
### `Convert-STSAuthorizationMessage`
L'exemple de code suivant montre comment utiliser`Convert-STSAuthorizationMessage`.
**Outils pour PowerShell V4**
**Exemple 1 : décode les informations supplémentaires contenues dans le contenu du message codé fourni qui a été renvoyé en réponse à une demande. Les informations supplémentaires sont codées parce que les détails du statut de l’autorisation peuvent constituer des informations privilégiées que l’utilisateur qui a demandé l’action ne devrait pas voir.**
```
Convert-STSAuthorizationMessage -EncodedMessage "...encoded message..."
```
+ Pour plus de détails sur l'API, reportez-vous [DecodeAuthorizationMessage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-STSFederationToken`
L'exemple de code suivant montre comment utiliser`Get-STSFederationToken`.
**Outils pour PowerShell V4**
**Exemple 1 : demande un jeton fédéré valable une heure en utilisant « Bob » comme nom de l’utilisateur fédéré. Ce nom peut être utilisé pour référencer le nom de l’utilisateur fédéré dans une politique basée sur les ressources (telle qu’une politique de compartiment Amazon S3). La politique IAM fournie, au format JSON, est utilisée pour limiter les autorisations disponibles pour l’utilisateur IAM. La politique fournie ne peut accorder plus d’autorisations que celles accordées à l’utilisateur qui effectue la demande, les autorisations finales pour l’utilisateur fédéré constituant l’ensemble le plus restrictif à la croisée de la politique transmise et la politique de l’utilisateur IAM.**
```
Get-STSFederationToken -Name "Bob" -Policy "...JSON policy..." -DurationInSeconds 3600
```
+ Pour plus de détails sur l'API, reportez-vous [GetFederationToken](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-STSSessionToken`
L'exemple de code suivant montre comment utiliser`Get-STSSessionToken`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie une instance `Amazon.RuntimeAWSCredentials` contenant des informations d’identification temporaires valables pendant une période définie. Les informations d’identification utilisées pour demander des informations d’identification temporaires sont déduites des paramètres par défaut actuels du shell. Pour spécifier d'autres informations d'identification, utilisez les SecretKey paramètres - ProfileName ou - AccessKey /-.**
```
Get-STSSessionToken
```
**Sortie** :
```
AccessKeyId Expiration SecretAccessKey SessionToken
----------- ---------- --------------- ------------
EXAMPLEACCESSKEYID 2/16/2015 9:12:28 PM examplesecretaccesskey... SamPleTokeN.....
```
**Exemple 2 : renvoie une instance `Amazon.RuntimeAWSCredentials` contenant des informations d’identification temporaires valides pour une heure. Les informations d’identification utilisées pour effectuer la demande sont obtenues à partir du profil spécifié.**
```
Get-STSSessionToken -DurationInSeconds 3600 -ProfileName myprofile
```
**Sortie** :
```
AccessKeyId Expiration SecretAccessKey SessionToken
----------- ---------- --------------- ------------
EXAMPLEACCESSKEYID 2/16/2015 9:12:28 PM examplesecretaccesskey... SamPleTokeN.....
```
**Exemple 3 : renvoie une instance `Amazon.RuntimeAWSCredentials` contenant des informations d’identification temporaires valables pendant une heure en utilisant le numéro d’identification du dispositif MFA associé au compte dont les informations d’identification sont spécifiées dans le profil « myprofilename » et la valeur fournie par le dispositif.**
```
Get-STSSessionToken -DurationInSeconds 3600 -ProfileName myprofile -SerialNumber YourMFADeviceSerialNumber -TokenCode 123456
```
**Sortie** :
```
AccessKeyId Expiration SecretAccessKey SessionToken
----------- ---------- --------------- ------------
EXAMPLEACCESSKEYID 2/16/2015 9:12:28 PM examplesecretaccesskey... SamPleTokeN.....
```
+ Pour plus de détails sur l'API, reportez-vous [GetSessionToken](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Use-STSRole`
L'exemple de code suivant montre comment utiliser`Use-STSRole`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie un ensemble d'informations d'identification temporaires (clé d'accès, clé secrète et jeton de session) qui peuvent être utilisées pendant une heure pour accéder à AWS des ressources auxquelles l'utilisateur demandeur n'a pas normalement accès. Les informations d’identification renvoyées disposent des autorisations autorisées par la stratégie d’accès du rôle assumé et par la politique fournie (vous ne pouvez pas utiliser la politique fournie pour accorder des autorisations supérieures à celles définies par la stratégie d’accès du rôle assumé).**
```
Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -Policy "...JSON policy..." -DurationInSeconds 3600
```
**Exemple 2 : renvoie un ensemble d’informations d’identification temporaires, valides pendant une heure, dotées des mêmes autorisations que celles définies dans la stratégie d’accès du rôle assumé.**
```
Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -DurationInSeconds 3600
```
**Exemple 3 : renvoie un ensemble d’informations d’identification temporaires fournissant le numéro de série et le jeton généré par une MFA associée aux informations d’identification de l’utilisateur utilisées pour exécuter l’applet de commande.**
```
Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -DurationInSeconds 3600 -SerialNumber "GAHT12345678" -TokenCode "123456"
```
**Exemple 4 : renvoie un ensemble d’informations d’identification temporaires qui ont endossé un rôle défini dans le compte d’un client. Pour chaque rôle que le tiers peut assumer, le compte client doit créer un rôle à l'aide d'un identifiant qui doit être transmis dans le ExternalId paramètre - chaque fois que le rôle est assumé.**
```
Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -DurationInSeconds 3600 -ExternalId "ABC123"
```
+ Pour plus de détails sur l'API, reportez-vous [AssumeRole](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Use-STSWebIdentityRole`
L'exemple de code suivant montre comment utiliser`Use-STSWebIdentityRole`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie un ensemble d’informations d’identification temporaires, valables pendant une heure, pour un utilisateur qui a été authentifié avec le fournisseur d’identité Login with Amazon. Les informations d’identification reposent sur la stratégie d’accès associée au rôle identifié par l’ARN du rôle. En option, vous pouvez transmettre une politique JSON au paramètre -Policy qui affine davantage les autorisations d’accès (vous ne pouvez pas accorder plus d’autorisations que celles qui sont disponibles dans les autorisations associées au rôle). La valeur fournie à - WebIdentityToken est l'identifiant utilisateur unique renvoyé par le fournisseur d'identité.**
```
Use-STSWebIdentityRole -DurationInSeconds 3600 -ProviderId "www.amazon.com" -RoleSessionName "app1" -RoleArn "arn:aws:iam::123456789012:role/FederatedWebIdentityRole" -WebIdentityToken "Atza...DVI0r1"
```
+ Pour plus de détails sur l'API, reportez-vous [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Support exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Support.
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-ASACommunicationToCase`
L'exemple de code suivant montre comment utiliser`Add-ASACommunicationToCase`.
**Outils pour PowerShell V4**
**Exemple 1 : ajoute le corps d’une communication par e-mail au cas spécifié.**
```
Add-ASACommunicationToCase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -CommunicationBody "Some text about the case"
```
**Exemple 2 : ajoute le corps d’une communication par e-mail au cas spécifié, plus une ou plusieurs adresses e-mail contenues dans la ligne CC de l’e-mail.**
```
Add-ASACommunicationToCase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -CcEmailAddress @("email1@address.com", "email2@address.com") -CommunicationBody "Some text about the case"
```
+ Pour plus de détails sur l'API, reportez-vous [AddCommunicationToCase](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASACase`
L'exemple de code suivant montre comment utiliser`Get-ASACase`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les détails de tous les cas de support.**
```
Get-ASACase
```
**Exemple 2 : renvoie les détails de tous les cas de support depuis la date et l’heure spécifiées.**
```
Get-ASACase -AfterTime "2013-09-10T03:06Z"
```
**Exemple 3 : renvoie les détails des dix premiers cas de support, y compris ceux qui ont été résolus.**
```
Get-ASACase -MaxResult 10 -IncludeResolvedCases $true
```
**Exemple 4 : renvoie les détails de l’unique cas de support spécifié.**
```
Get-ASACase -CaseIdList "case-12345678910-2013-c4c1d2bf33c5cf47"
```
**Exemple 5 : renvoie les détails des cas de support spécifiées.**
```
Get-ASACase -CaseIdList @("case-12345678910-2013-c4c1d2bf33c5cf47", "case-18929034710-2011-c4fdeabf33c5cf47")
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeCases](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASACommunication`
L'exemple de code suivant montre comment utiliser`Get-ASACommunication`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie toutes les communications pour le cas spécifié.**
```
Get-ASACommunication -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47"
```
**Exemple 2 : renvoie toutes les communications depuis minuit UTC le 1er janvier 2012 pour le cas spécifié.**
```
Get-ASACommunication -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -AfterTime "2012-01-10T00:00Z"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeCommunications](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASAService`
L'exemple de code suivant montre comment utiliser`Get-ASAService`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie tous les codes de service, noms et catégories disponibles.**
```
Get-ASAService
```
**Exemple 2 : renvoie le nom et les catégories du service avec le code spécifié.**
```
Get-ASAService -ServiceCodeList "amazon-cloudfront"
```
**Exemple 3 : renvoie le nom et les catégories des codes de service spécifiés.**
```
Get-ASAService -ServiceCodeList @("amazon-cloudfront", "amazon-cloudwatch")
```
**Exemple 4 : renvoie le nom et les catégories (en japonais) des codes de service spécifiés. Les codes de langue anglais (« en ») et japonais (« ja ») sont actuellement pris en charge.**
```
Get-ASAService -ServiceCodeList @("amazon-cloudfront", "amazon-cloudwatch") -Language "ja"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeServices](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASASeverityLevel`
L'exemple de code suivant montre comment utiliser`Get-ASASeverityLevel`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie la liste des niveaux de gravité qui peuvent être attribués à un dossier AWS Support.**
```
Get-ASASeverityLevel
```
**Exemple 2 : renvoie la liste des niveaux de gravité qui peuvent être attribués à un dossier AWS Support. Les noms des niveaux sont renvoyés en japonais.**
```
Get-ASASeverityLevel -Language "ja"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeSeverityLevels](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASATrustedAdvisorCheck`
L'exemple de code suivant montre comment utiliser`Get-ASATrustedAdvisorCheck`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie la collection de vérifications Trusted Advisor. Vous devez spécifier le paramètre Language qui peut accepter soit « en » pour la sortie en anglais, soit « ja » pour la sortie japonaise.**
```
Get-ASATrustedAdvisorCheck -Language "en"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTrustedAdvisorChecks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASATrustedAdvisorCheckRefreshStatus`
L'exemple de code suivant montre comment utiliser`Get-ASATrustedAdvisorCheckRefreshStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie le statut actuel des demandes d’actualisation pour les vérifications spécifiées. Request- ASATrusted AdvisorCheckRefresh peut être utilisé pour demander que les informations d'état des chèques soient actualisées.**
```
Get-ASATrustedAdvisorCheckRefreshStatus -CheckId @("checkid1", "checkid2")
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTrustedAdvisorCheckRefreshStatuses](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASATrustedAdvisorCheckResult`
L'exemple de code suivant montre comment utiliser`Get-ASATrustedAdvisorCheckResult`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie les résultats d’une vérification Trusted Advisor. La liste des chèques Trusted Advisor disponibles peut être obtenue à l'aide de Get- ASATrustedAdvisorChecks. Le résultat est le statut général de la vérification, l’horodatage auquel la vérification a été exécutée pour la dernière fois et le checkid unique pour la vérification spécifique. Pour que les résultats soient affichés en japonais, ajoutez le paramètre -Language « ja.**
```
Get-ASATrustedAdvisorCheckResult -CheckId "checkid1"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTrustedAdvisorCheckResult](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-ASATrustedAdvisorCheckSummary`
L'exemple de code suivant montre comment utiliser`Get-ASATrustedAdvisorCheckSummary`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie le dernier résumé de la vérification Trusted Advisor spécifiée.**
```
Get-ASATrustedAdvisorCheckSummary -CheckId "checkid1"
```
**Exemple 2 : renvoie les derniers résumés des vérifications Trusted Advisor spécifiées.**
```
Get-ASATrustedAdvisorCheckSummary -CheckId @("checkid1", "checkid2")
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTrustedAdvisorCheckSummaries](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-ASACase`
L'exemple de code suivant montre comment utiliser`New-ASACase`.
**Outils pour PowerShell V4**
**Exemple 1 : Crée un nouveau dossier dans le AWS Support Center. Les valeurs des CategoryCode paramètres - ServiceCode et - peuvent être obtenues à l'aide de l' Get-ASAService applet de commande. La valeur du SeverityCode paramètre - peut être obtenue à l'aide de l' Get-ASASeverityLevel applet de commande. La valeur du IssueType paramètre - peut être « service client » ou « technique ». En cas de succès, le numéro de dossier de AWS support est affiché. Par défaut, le cas sera traité en anglais. Pour utiliser le japonais, ajoutez le paramètre -Language « ja ». Les CommunicationBody paramètres -ServiceCode, -CategoryCode, -Subject et - sont obligatoires.**
```
New-ASACase -ServiceCode "amazon-cloudfront" -CategoryCode "APIs" -SeverityCode "low" -Subject "subject text" -CommunicationBody "description of the case" -CcEmailAddress @("email1@domain.com", "email2@domain.com") -IssueType "technical"
```
+ Pour plus de détails sur l'API, reportez-vous [CreateCase](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Request-ASATrustedAdvisorCheckRefresh`
L'exemple de code suivant montre comment utiliser`Request-ASATrustedAdvisorCheckRefresh`.
**Outils pour PowerShell V4**
**Exemple 1 : demande une actualisation pour la vérification Trusted Advisor spécifiée.**
```
Request-ASATrustedAdvisorCheckRefresh -CheckId "checkid1"
```
+ Pour plus de détails sur l'API, reportez-vous [RefreshTrustedAdvisorCheck](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Resolve-ASACase`
L'exemple de code suivant montre comment utiliser`Resolve-ASACase`.
**Outils pour PowerShell V4**
**Exemple 1 : renvoie l’état initial du cas spécifié et l’état actuel une fois l’appel pour le résoudre terminé.**
```
Resolve-ASACase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47"
```
+ Pour plus de détails sur l'API, reportez-vous [ResolveCase](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples de Systems Manager utilisant Tools for PowerShell V4
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 V4 avec Systems Manager.
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-SSMResourceTag`
L'exemple de code suivant montre comment utiliser`Add-SSMResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour une fenêtre de maintenance avec de nouvelles balises. Il n’y a pas de sortie si la commande réussit. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$option1 = @{Key="Stack";Value=@("Production")}
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $option1
```
**Exemple 2 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer chaque balise. Il n’y a pas de sortie si la commande réussit.**
```
$tag1 = New-Object Amazon.SimpleSystemsManagement.Model.Tag
$tag1.Key = "Stack"
$tag1.Value = "Production"
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $tag1
```
+ Pour plus de détails sur l'API, reportez-vous [AddTagsToResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-SSMDocumentPermission`
L'exemple de code suivant montre comment utiliser`Edit-SSMDocumentPermission`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute des autorisations de « partage » à tous les comptes pour un document. Il n’y a pas de sortie si la commande réussit.**
```
Edit-SSMDocumentPermission -Name "RunShellScript" -PermissionType "Share" -AccountIdsToAdd all
```
**Exemple 2 : cet exemple ajoute des autorisations de « partage » à un compte spécifique pour un document. Il n’y a pas de sortie si la commande réussit.**
```
Edit-SSMDocumentPermission -Name "RunShellScriptNew" -PermissionType "Share" -AccountIdsToAdd "123456789012"
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyDocumentPermission](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMActivation`
L'exemple de code suivant montre comment utiliser`Get-SSMActivation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple fournit des détails sur les activations de votre compte.**
```
Get-SSMActivation
```
**Sortie** :
```
ActivationId : 08e51e79-1e36-446c-8e63-9458569c1363
CreatedDate : 3/1/2017 12:01:51 AM
DefaultInstanceName : MyWebServers
Description :
ExpirationDate : 3/2/2017 12:01:51 AM
Expired : False
IamRole : AutomationRole
RegistrationLimit : 10
RegistrationsCount : 0
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeActivations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMAssociation`
L'exemple de code suivant montre comment utiliser`Get-SSMAssociation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit l’association entre une instance et un document.**
```
Get-SSMAssociation -InstanceId "i-0000293ffd8c57862" -Name "AWS-UpdateSSMAgent"
```
**Sortie** :
```
Name : AWS-UpdateSSMAgent
InstanceId : i-0000293ffd8c57862
Date : 2/23/2017 6:55:22 PM
Status.Name : Pending
Status.Date : 2/20/2015 8:31:11 AM
Status.Message : temp_status_change
Status.AdditionalInfo : Additional-Config-Needed
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAssociation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMAssociationExecution`
L'exemple de code suivant montre comment utiliser`Get-SSMAssociationExecution`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie les exécutions pour l’identifiant d’association fourni**
```
Get-SSMAssociationExecution -AssociationId 123a45a0-c678-9012-3456-78901234db5e
```
**Sortie** :
```
AssociationId : 123a45a0-c678-9012-3456-78901234db5e
AssociationVersion : 2
CreatedTime : 3/2/2019 8:53:29 AM
DetailedStatus :
ExecutionId : 123a45a0-c678-9012-3456-78901234db5e
LastExecutionDate : 1/1/0001 12:00:00 AM
ResourceCountByStatus : {Success=4}
Status : Success
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAssociationExecutions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMAssociationExecutionTarget`
L'exemple de code suivant montre comment utiliser`Get-SSMAssociationExecutionTarget`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche l’identifiant de la ressource et son statut d’exécution qui font partie des cibles d’exécution de l’association**
```
Get-SSMAssociationExecutionTarget -AssociationId 123a45a0-c678-9012-3456-78901234db5e -ExecutionId 123a45a0-c678-9012-3456-78901234db5e | Select-Object ResourceId, Status
```
**Sortie** :
```
ResourceId Status
---------- ------
i-0b1b2a3456f7a890b Success
i-01c12a45d6fc7a89f Success
i-0a1caf234f56d7dc8 Success
i-012a3fd45af6dbcfe Failed
i-0ddc1df23c4a5fb67 Success
```
**Exemple 2 : cette commande vérifie l’exécution particulière d’une automatisation particulière depuis hier, où un document de commande est associé. Elle vérifie également si l’exécution de l’association a échoué, et si c’est le cas, elle affiche les détails de l’invocation de la commande pour l’exécution ainsi que l’identifiant de l’instance**
```
$AssociationExecution= Get-SSMAssociationExecutionTarget -AssociationId 1c234567-890f-1aca-a234-5a678d901cb0 -ExecutionId 12345ca12-3456-2345-2b45-23456789012 |
Where-Object {$_.LastExecutionDate -gt (Get-Date -Hour 00 -Minute 00).AddDays(-1)}
foreach ($execution in $AssociationExecution) {
if($execution.Status -ne 'Success'){
Write-Output "There was an issue executing the association $($execution.AssociationId) on $($execution.ResourceId)"
Get-SSMCommandInvocation -CommandId $execution.OutputSource.OutputSourceId -Detail:$true | Select-Object -ExpandProperty CommandPlugins
}
}
```
**Sortie** :
```
There was an issue executing the association 1c234567-890f-1aca-a234-5a678d901cb0 on i-0a1caf234f56d7dc8
Name : aws:runPowerShellScript
Output :
----------ERROR-------
failed to run commands: exit status 1
OutputS3BucketName :
OutputS3KeyPrefix :
OutputS3Region : eu-west-1
ResponseCode : 1
ResponseFinishDateTime : 5/29/2019 11:04:49 AM
ResponseStartDateTime : 5/29/2019 11:04:49 AM
StandardErrorUrl :
StandardOutputUrl :
Status : Failed
StatusDetails : Failed
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAssociationExecutionTargets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMAssociationList`
L'exemple de code suivant montre comment utiliser`Get-SSMAssociationList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les associations pour une instance. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$filter1 = @{Key="InstanceId";Value=@("i-0000293ffd8c57862")}
Get-SSMAssociationList -AssociationFilterList $filter1
```
**Sortie** :
```
AssociationId : d8617c07-2079-4c18-9847-1655fc2698b0
DocumentVersion :
InstanceId : i-0000293ffd8c57862
LastExecutionDate : 2/20/2015 8:31:11 AM
Name : AWS-UpdateSSMAgent
Overview : Amazon.SimpleSystemsManagement.Model.AssociationOverview
ScheduleExpression :
Targets : {InstanceIds}
```
**Exemple 2 : cet exemple répertorie toutes les associations pour un document de configuration. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$filter2 = @{Key="Name";Value=@("AWS-UpdateSSMAgent")}
Get-SSMAssociationList -AssociationFilterList $filter2
```
**Sortie** :
```
AssociationId : d8617c07-2079-4c18-9847-1655fc2698b0
DocumentVersion :
InstanceId : i-0000293ffd8c57862
LastExecutionDate : 2/20/2015 8:31:11 AM
Name : AWS-UpdateSSMAgent
Overview : Amazon.SimpleSystemsManagement.Model.AssociationOverview
ScheduleExpression :
Targets : {InstanceIds}
```
**Exemple 3 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer chaque filtre.**
```
$filter1 = New-Object Amazon.SimpleSystemsManagement.Model.AssociationFilter
$filter1.Key = "InstanceId"
$filter1.Value = "i-0000293ffd8c57862"
Get-SSMAssociationList -AssociationFilterList $filter1
```
**Sortie** :
```
AssociationId : d8617c07-2079-4c18-9847-1655fc2698b0
DocumentVersion :
InstanceId : i-0000293ffd8c57862
LastExecutionDate : 2/20/2015 8:31:11 AM
Name : AWS-UpdateSSMAgent
Overview : Amazon.SimpleSystemsManagement.Model.AssociationOverview
ScheduleExpression :
Targets : {InstanceIds}
```
+ Pour plus de détails sur l'API, reportez-vous [ListAssociations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMAssociationVersionList`
L'exemple de code suivant montre comment utiliser`Get-SSMAssociationVersionList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet de récupérer toutes les versions de l’association fournie.**
```
Get-SSMAssociationVersionList -AssociationId 123a45a0-c678-9012-3456-78901234db5e
```
**Sortie** :
```
AssociationId : 123a45a0-c678-9012-3456-78901234db5e
AssociationName :
AssociationVersion : 2
ComplianceSeverity :
CreatedDate : 3/12/2019 9:21:01 AM
DocumentVersion :
MaxConcurrency :
MaxErrors :
Name : AWS-GatherSoftwareInventory
OutputLocation :
Parameters : {}
ScheduleExpression :
Targets : {InstanceIds}
AssociationId : 123a45a0-c678-9012-3456-78901234db5e
AssociationName : test-case-1234567890
AssociationVersion : 1
ComplianceSeverity :
CreatedDate : 3/2/2019 8:53:29 AM
DocumentVersion :
MaxConcurrency :
MaxErrors :
Name : AWS-GatherSoftwareInventory
OutputLocation :
Parameters : {}
ScheduleExpression : rate(30minutes)
Targets : {InstanceIds}
```
+ Pour plus de détails sur l'API, reportez-vous [ListAssociationVersions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMAutomationExecution`
L'exemple de code suivant montre comment utiliser`Get-SSMAutomationExecution`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche les détails d’une exécution d’automatisation.**
```
Get-SSMAutomationExecution -AutomationExecutionId "4105a4fc-f944-11e6-9d32-8fb2db27a909"
```
**Sortie** :
```
AutomationExecutionId : 4105a4fc-f944-11e6-9d32-8fb2db27a909
AutomationExecutionStatus : Failed
DocumentName : AWS-UpdateLinuxAmi
DocumentVersion : 1
ExecutionEndTime : 2/22/2017 9:17:08 PM
ExecutionStartTime : 2/22/2017 9:17:02 PM
FailureMessage : Step launchInstance failed maximum allowed times. You are not authorized to perform this operation. Encoded
authorization failure message: B_V2QyyN7NhSZQYpmVzpEc4oSnj2GLTNYnXUHsTbqJkNMoDgubmbtthLmZyaiUYekORIrA42-fv1x-04q5Fjff6glh
Yb6TI5b0GQeeNrpwNvpDzmO-PSR1swlAbg9fdM9BcNjyrznspUkWpuKu9EC1Ou6v3OXU1KC9nZ7mPlWMFZNkSioQqpwWEvMw-GZktsQzm67qOhUhBNOLWYhbS
pkfiqzY-5nw3S0obx30fhd3EJa5O_-GjV_a0nFXQJa70ik40bFOrEh3MtCSbrQT6--DvFy_FQ8TKvkIXadyVskeJI84XOF5WmA60f1pi5GI08i-nRfZS6oDeU
gELBjjoFKD8s3L2aI0B6umWVxnQOjqhQRxwJ53b54sZJ2PW3v_mtg9-q0CK0ezS3xfh_y0ilaUGOAZG-xjQFuvU_JZedWpla3xi-MZsmblAifBI
(Service: AmazonEC2; Status Code: 403; Error Code: UnauthorizedOperation; Request ID:
6a002f94-ba37-43fd-99e6-39517715fce5)
Outputs : {[createImage.ImageId, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]}
Parameters : {[AutomationAssumeRole, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]], [InstanceIamRole,
Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]], [SourceAmiId,
Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]}
StepExecutions : {launchInstance, updateOSSoftware, stopInstance, createImage...}
```
**Exemple 2 : cet exemple répertorie les détails des étapes pour l’ID d’exécution d’automatisation donné**
```
Get-SSMAutomationExecution -AutomationExecutionId e1d2bad3-4567-8901-ae23-456c7c8901be | Select-Object -ExpandProperty StepExecutions | Select-Object StepName, Action, StepStatus, ValidNextSteps
```
**Sortie** :
```
StepName Action StepStatus ValidNextSteps
-------- ------ ---------- --------------
LaunchInstance aws:runInstances Success {OSCompatibilityCheck}
OSCompatibilityCheck aws:runCommand Success {RunPreUpdateScript}
RunPreUpdateScript aws:runCommand Success {UpdateEC2Config}
UpdateEC2Config aws:runCommand Cancelled {}
UpdateSSMAgent aws:runCommand Pending {}
UpdateAWSPVDriver aws:runCommand Pending {}
UpdateAWSEnaNetworkDriver aws:runCommand Pending {}
UpdateAWSNVMe aws:runCommand Pending {}
InstallWindowsUpdates aws:runCommand Pending {}
RunPostUpdateScript aws:runCommand Pending {}
RunSysprepGeneralize aws:runCommand Pending {}
StopInstance aws:changeInstanceState Pending {}
CreateImage aws:createImage Pending {}
TerminateInstance aws:changeInstanceState Pending {}
```
+ Pour plus de détails sur l'API, reportez-vous [GetAutomationExecution](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMAutomationExecutionList`
L'exemple de code suivant montre comment utiliser`Get-SSMAutomationExecutionList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit toutes les exécutions d’automatisation actives et résiliées associées à votre compte.**
```
Get-SSMAutomationExecutionList
```
**Sortie** :
```
AutomationExecutionId : 4105a4fc-f944-11e6-9d32-8fb2db27a909
AutomationExecutionStatus : Failed
DocumentName : AWS-UpdateLinuxAmi
DocumentVersion : 1
ExecutedBy : admin
ExecutionEndTime : 2/22/2017 9:17:08 PM
ExecutionStartTime : 2/22/2017 9:17:02 PM
LogFile :
Outputs : {[createImage.ImageId, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]}
```
**Exemple 2 : cet exemple affiche l'ExecutionID, le document et l' start/end horodatage d'exécution pour les exécutions dont la valeur n'est pas « AutomationExecutionStatus Success »**
```
Get-SSMAutomationExecutionList | Where-Object AutomationExecutionStatus -ne "Success" | Select-Object AutomationExecutionId, DocumentName, AutomationExecutionStatus, ExecutionStartTime, ExecutionEndTime | Format-Table -AutoSize
```
**Sortie** :
```
AutomationExecutionId DocumentName AutomationExecutionStatus ExecutionStartTime ExecutionEndTime
--------------------- ------------ ------------------------- ------------------ ----------------
e1d2bad3-4567-8901-ae23-456c7c8901be AWS-UpdateWindowsAmi Cancelled 4/16/2019 5:37:04 AM 4/16/2019 5:47:29 AM
61234567-a7f8-90e1-2b34-567b8bf9012c Fixed-UpdateAmi Cancelled 4/16/2019 5:33:04 AM 4/16/2019 5:40:15 AM
91234d56-7e89-0ac1-2aee-34ea5d6a7c89 AWS-UpdateWindowsAmi Failed 4/16/2019 5:22:46 AM 4/16/2019 5:27:29 AM
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAutomationExecutions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMAutomationStepExecution`
L'exemple de code suivant montre comment utiliser`Get-SSMAutomationStepExecution`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche des informations sur toutes les exécutions d’étapes actives et résiliées d’un flux de travail d’automatisation.**
```
Get-SSMAutomationStepExecution -AutomationExecutionId e1d2bad3-4567-8901-ae23-456c7c8901be | Select-Object StepName, Action, StepStatus
```
**Sortie** :
```
StepName Action StepStatus
-------- ------ ----------
LaunchInstance aws:runInstances Success
OSCompatibilityCheck aws:runCommand Success
RunPreUpdateScript aws:runCommand Success
UpdateEC2Config aws:runCommand Cancelled
UpdateSSMAgent aws:runCommand Pending
UpdateAWSPVDriver aws:runCommand Pending
UpdateAWSEnaNetworkDriver aws:runCommand Pending
UpdateAWSNVMe aws:runCommand Pending
InstallWindowsUpdates aws:runCommand Pending
RunPostUpdateScript aws:runCommand Pending
RunSysprepGeneralize aws:runCommand Pending
StopInstance aws:changeInstanceState Pending
CreateImage aws:createImage Pending
TerminateInstance aws:changeInstanceState Pending
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAutomationStepExecutions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMAvailablePatch`
L'exemple de code suivant montre comment utiliser`Get-SSMAvailablePatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet d’obtenir tous les correctifs disponibles pour Windows Server 2012 dont la sévérité MSRC est Critique. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$filter1 = @{Key="PRODUCT";Values=@("WindowsServer2012")}
$filter2 = @{Key="MSRC_SEVERITY";Values=@("Critical")}
Get-SSMAvailablePatch -Filter $filter1,$filter2
```
**Sortie** :
```
Classification : SecurityUpdates
ContentUrl : https://support.microsoft.com/en-us/kb/2727528
Description : A security issue has been identified that could allow an unauthenticated remote attacker to compromise your system and gain control
over it. You can help protect your system by installing this update from Microsoft. After you install this update, you may have to
restart your system.
Id : 1eb507be-2040-4eeb-803d-abc55700b715
KbNumber : KB2727528
Language : All
MsrcNumber : MS12-072
MsrcSeverity : Critical
Product : WindowsServer2012
ProductFamily : Windows
ReleaseDate : 11/13/2012 6:00:00 PM
Title : Security Update for Windows Server 2012 (KB2727528)
Vendor : Microsoft
...
```
**Exemple 2 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer chaque filtre.**
```
$filter1 = New-Object Amazon.SimpleSystemsManagement.Model.PatchOrchestratorFilter
$filter1.Key = "PRODUCT"
$filter1.Values = "WindowsServer2012"
$filter2 = New-Object Amazon.SimpleSystemsManagement.Model.PatchOrchestratorFilter
$filter2.Key = "MSRC_SEVERITY"
$filter2.Values = "Critical"
Get-SSMAvailablePatch -Filter $filter1,$filter2
```
**Exemple 3 : Cet exemple récupère toutes les mises à jour publiées au cours des 20 derniers jours et applicables aux produits correspondant WindowsServer à 2019**
```
Get-SSMAvailablePatch | Where-Object ReleaseDate -ge (Get-Date).AddDays(-20) | Where-Object Product -eq "WindowsServer2019" | Select-Object ReleaseDate, Product, Title
```
**Sortie** :
```
ReleaseDate Product Title
----------- ------- -----
4/9/2019 5:00:12 PM WindowsServer2019 2019-04 Security Update for Adobe Flash Player for Windows Server 2019 for x64-based Systems (KB4493478)
4/9/2019 5:00:06 PM WindowsServer2019 2019-04 Cumulative Update for Windows Server 2019 for x64-based Systems (KB4493509)
4/2/2019 5:00:06 PM WindowsServer2019 2019-03 Servicing Stack Update for Windows Server 2019 for x64-based Systems (KB4493510)
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeAvailablePatches](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMCommand`
L'exemple de code suivant montre comment utiliser`Get-SSMCommand`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les commandes demandées.**
```
Get-SSMCommand
```
**Sortie** :
```
CommandId : 4b75a163-d39a-4d97-87c9-98ae52c6be35
Comment : Apply association with id at update time: 4cc73e42-d5ae-4879-84f8-57e09c0efcd0
CompletedCount : 1
DocumentName : AWS-RefreshAssociation
ErrorCount : 0
ExpiresAfter : 2/24/2017 3:19:08 AM
InstanceIds : {i-0cb2b964d3e14fd9f}
MaxConcurrency : 50
MaxErrors : 0
NotificationConfig : Amazon.SimpleSystemsManagement.Model.NotificationConfig
OutputS3BucketName :
OutputS3KeyPrefix :
OutputS3Region :
Parameters : {[associationIds, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]}
RequestedDateTime : 2/24/2017 3:18:08 AM
ServiceRole :
Status : Success
StatusDetails : Success
TargetCount : 1
Targets : {}
```
**Exemple 2 : cet exemple permet d’obtenir le statut d’une commande spécifique.**
```
Get-SSMCommand -CommandId "4b75a163-d39a-4d97-87c9-98ae52c6be35"
```
**Exemple 3 : cet exemple récupère toutes les commandes SSM invoquées après 2019-04-01T00:00:00Z **
```
Get-SSMCommand -Filter @{Key="InvokedAfter";Value="2019-04-01T00:00:00Z"} | Select-Object CommandId, DocumentName, Status, RequestedDateTime | Sort-Object -Property RequestedDateTime -Descending
```
**Sortie** :
```
CommandId DocumentName Status RequestedDateTime
--------- ------------ ------ -----------------
edb1b23e-456a-7adb-aef8-90e-012ac34f AWS-RunPowerShellScript Cancelled 4/16/2019 5:45:23 AM
1a2dc3fb-4567-890d-a1ad-234b5d6bc7d9 AWS-ConfigureAWSPackage Success 4/6/2019 9:19:42 AM
12c3456c-7e90-4f12-1232-1234f5b67893 KT-Retrieve-Cloud-Type-Win Failed 4/2/2019 4:13:07 AM
fe123b45-240c-4123-a2b3-234bdd567ecf AWS-RunInspecChecks Failed 4/1/2019 2:27:31 PM
1eb23aa4-567d-4123-12a3-4c1c2ab34561 AWS-RunPowerShellScript Success 4/1/2019 1:05:55 PM
1c2f3bb4-ee12-4bc1-1a23-12345eea123e AWS-RunInspecChecks Failed 4/1/2019 11:13:09 AM
```
+ Pour plus de détails sur l'API, reportez-vous [ListCommands](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMCommandInvocation`
L'exemple de code suivant montre comment utiliser`Get-SSMCommandInvocation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les invocations d’une commande.**
```
Get-SSMCommandInvocation -CommandId "b8eac879-0541-439d-94ec-47a80d554f44" -Detail $true
```
**Sortie** :
```
CommandId : b8eac879-0541-439d-94ec-47a80d554f44
CommandPlugins : {aws:runShellScript}
Comment : IP config
DocumentName : AWS-RunShellScript
InstanceId : i-0cb2b964d3e14fd9f
InstanceName :
NotificationConfig : Amazon.SimpleSystemsManagement.Model.NotificationConfig
RequestedDateTime : 2/22/2017 8:13:16 PM
ServiceRole :
StandardErrorUrl :
StandardOutputUrl :
Status : Success
StatusDetails : Success
TraceOutput :
```
**Exemple 2 : Cet exemple répertorie CommandPlugins pour l'invocation de l'identifiant de commande e1eb2e3c-ed4c-5123-45c1-234f5612345f**
```
Get-SSMCommandInvocation -CommandId e1eb2e3c-ed4c-5123-45c1-234f5612345f -Detail:$true | Select-Object -ExpandProperty CommandPlugins
```
**Sortie** :
```
Name : aws:runPowerShellScript
Output : Completed 17.7 KiB/17.7 KiB (40.1 KiB/s) with 1 file(s) remainingdownload: s3://dd-aess-r-ctmer/KUMO.png to ..\..\programdata\KUMO.png
kumo available
OutputS3BucketName :
OutputS3KeyPrefix :
OutputS3Region : eu-west-1
ResponseCode : 0
ResponseFinishDateTime : 4/3/2019 11:53:23 AM
ResponseStartDateTime : 4/3/2019 11:53:21 AM
StandardErrorUrl :
StandardOutputUrl :
Status : Success
StatusDetails : Success
```
+ Pour plus de détails sur l'API, reportez-vous [ListCommandInvocations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMCommandInvocationDetail`
L'exemple de code suivant montre comment utiliser`Get-SSMCommandInvocationDetail`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche les détails d’une commande exécutée sur une instance.**
```
Get-SSMCommandInvocationDetail -InstanceId "i-0cb2b964d3e14fd9f" -CommandId "b8eac879-0541-439d-94ec-47a80d554f44"
```
**Sortie** :
```
CommandId : b8eac879-0541-439d-94ec-47a80d554f44
Comment : IP config
DocumentName : AWS-RunShellScript
ExecutionElapsedTime : PT0.004S
ExecutionEndDateTime : 2017-02-22T20:13:16.651Z
ExecutionStartDateTime : 2017-02-22T20:13:16.651Z
InstanceId : i-0cb2b964d3e14fd9f
PluginName : aws:runShellScript
ResponseCode : 0
StandardErrorContent :
StandardErrorUrl :
StandardOutputContent :
StandardOutputUrl :
Status : Success
StatusDetails : Success
```
+ Pour plus de détails sur l'API, reportez-vous [GetCommandInvocation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMComplianceItemList`
L'exemple de code suivant montre comment utiliser`Get-SSMComplianceItemList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les éléments de conformité pour l’identifiant et le type de ressource donnés, le type de conformité de filtrage étant « Association »**
```
Get-SSMComplianceItemList -ResourceId i-1a2caf345f67d0dc2 -ResourceType ManagedInstance -Filter @{Key="ComplianceType";Values="Association"}
```
**Sortie** :
```
ComplianceType : Association
Details : {[DocumentName, AWS-GatherSoftwareInventory], [DocumentVersion, 1]}
ExecutionSummary : Amazon.SimpleSystemsManagement.Model.ComplianceExecutionSummary
Id : 123a45a1-c234-1234-1245-67891236db4e
ResourceId : i-1a2caf345f67d0dc2
ResourceType : ManagedInstance
Severity : UNSPECIFIED
Status : COMPLIANT
Title :
```
+ Pour plus de détails sur l'API, reportez-vous [ListComplianceItems](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMComplianceSummaryList`
L'exemple de code suivant montre comment utiliser`Get-SSMComplianceSummaryList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie un récapitulatif des ressources conformes et non conformes pour tous les types de conformité.**
```
Get-SSMComplianceSummaryList
```
**Sortie** :
```
ComplianceType CompliantSummary NonCompliantSummary
-------------- ---------------- -------------------
FleetTotal Amazon.SimpleSystemsManagement.Model.CompliantSummary Amazon.SimpleSystemsManagement.Model.NonCompliantSummary
Association Amazon.SimpleSystemsManagement.Model.CompliantSummary Amazon.SimpleSystemsManagement.Model.NonCompliantSummary
Custom:InSpec Amazon.SimpleSystemsManagement.Model.CompliantSummary Amazon.SimpleSystemsManagement.Model.NonCompliantSummary
Patch Amazon.SimpleSystemsManagement.Model.CompliantSummary Amazon.SimpleSystemsManagement.Model.NonCompliantSummary
```
+ Pour plus de détails sur l'API, reportez-vous [ListComplianceSummaries](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMConnectionStatus`
L'exemple de code suivant montre comment utiliser`Get-SSMConnectionStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple récupère le statut de connexion de Session Manager pour une instance afin de déterminer si elle est connectée et prête à recevoir des connexions Session Manager. **
```
Get-SSMConnectionStatus -Target i-0a1caf234f12d3dc4
```
**Sortie** :
```
Status Target
------ ------
Connected i-0a1caf234f12d3dc4
```
+ Pour plus de détails sur l'API, reportez-vous [GetConnectionStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMDefaultPatchBaseline`
L'exemple de code suivant montre comment utiliser`Get-SSMDefaultPatchBaseline`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche le référentiel de correctifs par défaut.**
```
Get-SSMDefaultPatchBaseline
```
**Sortie** :
```
arn:aws:ssm:us-west-2:123456789012:patchbaseline/pb-04fb4ae6142167966
```
+ Pour plus de détails sur l'API, reportez-vous [GetDefaultPatchBaseline](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMDeployablePatchSnapshotForInstance`
L'exemple de code suivant montre comment utiliser`Get-SSMDeployablePatchSnapshotForInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche l’instantané actuel pour le référentiel de correctifs utilisé par une instance. Cette commande doit être exécutée à partir de l’instance en utilisant les informations d’identification de l’instance. Pour s’assurer qu’il utilise les informations d’identification de l’instance, l’exemple passe un objet `Amazon.Runtime.InstanceProfileAWSCredentials` au paramètre Credentials.**
```
$credentials = [Amazon.Runtime.InstanceProfileAWSCredentials]::new()
Get-SSMDeployablePatchSnapshotForInstance -SnapshotId "4681775b-098f-4435-a956-0ef33373ac11" -InstanceId "i-0cb2b964d3e14fd9f" -Credentials $credentials
```
**Sortie** :
```
InstanceId SnapshotDownloadUrl
---------- -------------------
i-0cb2b964d3e14fd9f https://patch-baseline-snapshot-us-west-2.s3-us-west-2.amazonaws.com/853d0d3db0f0cafe...1692/4681775b-098f-4435...
```
**Exemple 2 : Cet exemple montre comment obtenir le résultat complet SnapshotDownloadUrl. Cette commande doit être exécutée à partir de l’instance en utilisant les informations d’identification de l’instance. Pour s'assurer qu'elle utilise les informations d'identification de l'instance, l'exemple configure la PowerShell session pour qu'elle utilise un `Amazon.Runtime.InstanceProfileAWSCredentials` objet.**
```
Set-AWSCredential -Credential ([Amazon.Runtime.InstanceProfileAWSCredentials]::new())
(Get-SSMDeployablePatchSnapshotForInstance -SnapshotId "4681775b-098f-4435-a956-0ef33373ac11" -InstanceId "i-0cb2b964d3e14fd9f").SnapshotDownloadUrl
```
**Sortie** :
```
https://patch-baseline-snapshot-us-west-2.s3-us-west-2.amazonaws.com/853d0d3db0f0cafe...
```
+ Pour plus de détails sur l'API, reportez-vous [GetDeployablePatchSnapshotForInstance](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMDocument`
L'exemple de code suivant montre comment utiliser`Get-SSMDocument`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie le contenu d’un document.**
```
Get-SSMDocument -Name "RunShellScript"
```
**Sortie** :
```
Content
-------
{...
```
**Exemple 2 : cet exemple affiche le contenu complet d’un document.**
```
(Get-SSMDocument -Name "RunShellScript").Content
{
"schemaVersion":"2.0",
"description":"Run an updated script",
"parameters":{
"commands":{
"type":"StringList",
"description":"(Required) Specify a shell script or a command to run.",
"minItems":1,
"displayType":"textarea"
}
},
"mainSteps":[
{
"action":"aws:runShellScript",
"name":"runShellScript",
"inputs":{
"commands":"{{ commands }}"
}
},
{
"action":"aws:runPowerShellScript",
"name":"runPowerShellScript",
"inputs":{
"commands":"{{ commands }}"
}
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetDocument](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMDocumentDescription`
L'exemple de code suivant montre comment utiliser`Get-SSMDocumentDescription`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie des informations sur un document.**
```
Get-SSMDocumentDescription -Name "RunShellScript"
```
**Sortie** :
```
CreatedDate : 2/24/2017 5:25:13 AM
DefaultVersion : 1
Description : Run an updated script
DocumentType : Command
DocumentVersion : 1
Hash : f775e5df4904c6fa46686c4722fae9de1950dace25cd9608ff8d622046b68d9b
HashType : Sha256
LatestVersion : 1
Name : RunShellScript
Owner : 123456789012
Parameters : {commands}
PlatformTypes : {Linux}
SchemaVersion : 2.0
Sha1 :
Status : Active
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeDocument](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMDocumentList`
L'exemple de code suivant montre comment utiliser`Get-SSMDocumentList`.
**Outils pour PowerShell V4**
**Exemple 1 : répertorie tous les documents de configuration de votre compte.**
```
Get-SSMDocumentList
```
**Sortie** :
```
DocumentType : Command
DocumentVersion : 1
Name : AWS-ApplyPatchBaseline
Owner : Amazon
PlatformTypes : {Windows}
SchemaVersion : 1.2
DocumentType : Command
DocumentVersion : 1
Name : AWS-ConfigureAWSPackage
Owner : Amazon
PlatformTypes : {Windows, Linux}
SchemaVersion : 2.0
DocumentType : Command
DocumentVersion : 1
Name : AWS-ConfigureCloudWatch
Owner : Amazon
PlatformTypes : {Windows}
SchemaVersion : 1.2
...
```
**Exemple 2 : cet exemple récupère tous les documents d’automatisation dont le nom correspond à ’Plateforme’**
```
Get-SSMDocumentList -DocumentFilterList @{Key="DocumentType";Value="Automation"} | Where-Object Name -Match "Platform"
```
**Sortie** :
```
DocumentFormat : JSON
DocumentType : Automation
DocumentVersion : 7
Name : KT-Get-Platform
Owner : 987654123456
PlatformTypes : {Windows, Linux}
SchemaVersion : 0.3
Tags : {}
TargetType :
VersionName :
```
+ Pour plus de détails sur l'API, reportez-vous [ListDocuments](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMDocumentPermission`
L'exemple de code suivant montre comment utiliser`Get-SSMDocumentPermission`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les versions pour un document.**
```
Get-SSMDocumentVersionList -Name "RunShellScript"
```
**Sortie** :
```
CreatedDate DocumentVersion IsDefaultVersion Name
----------- --------------- ---------------- ----
2/24/2017 5:25:13 AM 1 True RunShellScript
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeDocumentPermission](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMDocumentVersionList`
L'exemple de code suivant montre comment utiliser`Get-SSMDocumentVersionList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les versions pour un document.**
```
Get-SSMDocumentVersionList -Name "AWS-UpdateSSMAgent"
```
**Sortie** :
```
CreatedDate : 6/1/2021 5:19:10 PM
DocumentFormat : JSON
DocumentVersion : 1
IsDefaultVersion : True
Name : AWS-UpdateSSMAgent
Status : Active
```
+ Pour plus de détails sur l'API, reportez-vous [ListDocumentVersions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMEffectiveInstanceAssociationList`
L'exemple de code suivant montre comment utiliser`Get-SSMEffectiveInstanceAssociationList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple décrit les associations effectives d’une instance.**
```
Get-SSMEffectiveInstanceAssociationList -InstanceId "i-0000293ffd8c57862" -MaxResult 5
```
**Sortie** :
```
AssociationId Content
------------- -------
d8617c07-2079-4c18-9847-1655fc2698b0 {...
```
**Exemple 2 : cet exemple affiche le contenu des associations effectives d’une instance.**
```
(Get-SSMEffectiveInstanceAssociationList -InstanceId "i-0000293ffd8c57862" -MaxResult 5).Content
```
**Sortie** :
```
{
"schemaVersion": "1.2",
"description": "Update the Amazon SSM Agent to the latest version or specified version.",
"parameters": {
"version": {
"default": "",
"description": "(Optional) A specific version of the Amazon SSM Agent to install. If not specified, the agen
t will be updated to the latest version.",
"type": "String"
},
"allowDowngrade": {
"default": "false",
"description": "(Optional) Allow the Amazon SSM Agent service to be downgraded to an earlier version. If set
to false, the service can be upgraded to newer versions only (default). If set to true, specify the earlier version.",
"type": "String",
"allowedValues": [
"true",
"false"
]
}
},
"runtimeConfig": {
"aws:updateSsmAgent": {
"properties": [
{
"agentName": "amazon-ssm-agent",
"source": "https://s3.{Region}.amazonaws.com/amazon-ssm-{Region}/ssm-agent-manifest.json",
"allowDowngrade": "{{ allowDowngrade }}",
"targetVersion": "{{ version }}"
}
]
}
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEffectiveInstanceAssociations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMEffectivePatchesForPatchBaseline`
L'exemple de code suivant montre comment utiliser`Get-SSMEffectivePatchesForPatchBaseline`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les référentiels de correctifs, avec une liste de résultats maximale de 1.**
```
Get-SSMEffectivePatchesForPatchBaseline -BaselineId "pb-0a2f1059b670ebd31" -MaxResult 1
```
**Sortie** :
```
Patch PatchStatus
----- -----------
Amazon.SimpleSystemsManagement.Model.Patch Amazon.SimpleSystemsManagement.Model.PatchStatus
```
**Exemple 2 : cet exemple affiche le statut des correctifs pour tous les référentiels de correctifs, avec une liste de résultats maximale de 1.**
```
(Get-SSMEffectivePatchesForPatchBaseline -BaselineId "pb-0a2f1059b670ebd31" -MaxResult 1).PatchStatus
```
**Sortie** :
```
ApprovalDate DeploymentStatus
------------ ----------------
12/21/2010 6:00:00 PM APPROVED
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEffectivePatchesForPatchBaseline](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMInstanceAssociationsStatus`
L'exemple de code suivant montre comment utiliser`Get-SSMInstanceAssociationsStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre les détails des associations d’une instance.**
```
Get-SSMInstanceAssociationsStatus -InstanceId "i-0000293ffd8c57862"
```
**Sortie** :
```
AssociationId : d8617c07-2079-4c18-9847-1655fc2698b0
DetailedStatus : Pending
DocumentVersion : 1
ErrorCode :
ExecutionDate : 2/20/2015 8:31:11 AM
ExecutionSummary : temp_status_change
InstanceId : i-0000293ffd8c57862
Name : AWS-UpdateSSMAgent
OutputUrl :
Status : Pending
```
**Exemple 2 : cet exemple contrôle le statut des associations de l’instance pour l’ID d’instance donné et affiche ensuite le statut d’exécution de ces associations**
```
Get-SSMInstanceAssociationsStatus -InstanceId i-012e3cb4df567e8aa | ForEach-Object {Get-SSMAssociationExecution -AssociationId .AssociationId}
```
**Sortie** :
```
AssociationId : 512a34a5-c678-1234-1234-12345678db9e
AssociationVersion : 2
CreatedTime : 3/2/2019 8:53:29 AM
DetailedStatus :
ExecutionId : 512a34a5-c678-1234-1234-12345678db9e
LastExecutionDate : 1/1/0001 12:00:00 AM
ResourceCountByStatus : {Success=9}
Status : Success
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstanceAssociationsStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMInstanceInformation`
L'exemple de code suivant montre comment utiliser`Get-SSMInstanceInformation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre les détails de chacune de vos instances.**
```
Get-SSMInstanceInformation
```
**Sortie** :
```
ActivationId :
AgentVersion : 2.0.672.0
AssociationOverview : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview
AssociationStatus : Success
ComputerName : ip-172-31-44-222.us-west-2.compute.internal
IamRole :
InstanceId : i-0cb2b964d3e14fd9f
IPAddress : 172.31.44.222
IsLatestVersion : True
LastAssociationExecutionDate : 2/24/2017 3:18:09 AM
LastPingDateTime : 2/24/2017 3:35:03 AM
LastSuccessfulAssociationExecutionDate : 2/24/2017 3:18:09 AM
Name :
PingStatus : ConnectionLost
PlatformName : Amazon Linux AMI
PlatformType : Linux
PlatformVersion : 2016.09
RegistrationDate : 1/1/0001 12:00:00 AM
ResourceType : EC2Instance
```
**Exemple 2 : Cet exemple montre comment utiliser le paramètre -Filter pour filtrer les résultats uniquement en fonction des instances de AWS Systems Manager situées dans une région `us-east-1` avec un `AgentVersion` de`2.2.800.0`. Vous trouverez une liste des valeurs de clé -Filter valides dans la rubrique de référence de l' InstanceInformation API (https://docs.aws.amazon.com/systems-manager/latest/APIReference/API\$1 InstanceInformation .html \$1systemsmanager -Type- -InstanceInformation). ActivationId**
```
$Filters = @{
Key="AgentVersion"
Values="2.2.800.0"
}
Get-SSMInstanceInformation -Region us-east-1 -Filter $Filters
```
**Sortie** :
```
ActivationId :
AgentVersion : 2.2.800.0
AssociationOverview : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview
AssociationStatus : Success
ComputerName : EXAMPLE-EXAMPLE.WORKGROUP
IamRole :
InstanceId : i-EXAMPLEb0792d98ce
IPAddress : 10.0.0.01
IsLatestVersion : False
LastAssociationExecutionDate : 8/16/2018 12:02:50 AM
LastPingDateTime : 8/16/2018 7:40:27 PM
LastSuccessfulAssociationExecutionDate : 8/16/2018 12:02:50 AM
Name :
PingStatus : Online
PlatformName : Microsoft Windows Server 2016 Datacenter
PlatformType : Windows
PlatformVersion : 10.0.14393
RegistrationDate : 1/1/0001 12:00:00 AM
ResourceType : EC2Instance
ActivationId :
AgentVersion : 2.2.800.0
AssociationOverview : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview
AssociationStatus : Success
ComputerName : EXAMPLE-EXAMPLE.WORKGROUP
IamRole :
InstanceId : i-EXAMPLEac7501d023
IPAddress : 10.0.0.02
IsLatestVersion : False
LastAssociationExecutionDate : 8/16/2018 12:00:20 AM
LastPingDateTime : 8/16/2018 7:40:35 PM
LastSuccessfulAssociationExecutionDate : 8/16/2018 12:00:20 AM
Name :
PingStatus : Online
PlatformName : Microsoft Windows Server 2016 Datacenter
PlatformType : Windows
PlatformVersion : 10.0.14393
RegistrationDate : 1/1/0001 12:00:00 AM
ResourceType : EC2Instance
```
**Exemple 3 : Cet exemple montre comment utiliser le InstanceInformationFilterList paramètre - pour filtrer les résultats uniquement en fonction des instances `PlatformTypes` de AWS Systems Manager situées dans `us-east-1` une région avec `Windows` ou`Linux`. Vous trouverez une liste des valeurs InstanceInformationFilterList clés valides dans la rubrique de référence de l' InstanceInformationFilter API (https://docs.aws.amazon.com/systems-manager/latest/APIReference/API\$1 InstanceInformationFilter .html).**
```
$Filters = @{
Key="PlatformTypes"
ValueSet=("Windows","Linux")
}
Get-SSMInstanceInformation -Region us-east-1 -InstanceInformationFilterList $Filters
```
**Sortie** :
```
ActivationId :
AgentVersion : 2.2.800.0
AssociationOverview : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview
AssociationStatus : Success
ComputerName : EXAMPLE-EXAMPLE.WORKGROUP
IamRole :
InstanceId : i-EXAMPLEb0792d98ce
IPAddress : 10.0.0.27
IsLatestVersion : False
LastAssociationExecutionDate : 8/16/2018 12:02:50 AM
LastPingDateTime : 8/16/2018 7:40:27 PM
LastSuccessfulAssociationExecutionDate : 8/16/2018 12:02:50 AM
Name :
PingStatus : Online
PlatformName : Ubuntu Server 18.04 LTS
PlatformType : Linux
PlatformVersion : 18.04
RegistrationDate : 1/1/0001 12:00:00 AM
ResourceType : EC2Instance
ActivationId :
AgentVersion : 2.2.800.0
AssociationOverview : Amazon.SimpleSystemsManagement.Model.InstanceAggregatedAssociationOverview
AssociationStatus : Success
ComputerName : EXAMPLE-EXAMPLE.WORKGROUP
IamRole :
InstanceId : i-EXAMPLEac7501d023
IPAddress : 10.0.0.100
IsLatestVersion : False
LastAssociationExecutionDate : 8/16/2018 12:00:20 AM
LastPingDateTime : 8/16/2018 7:40:35 PM
LastSuccessfulAssociationExecutionDate : 8/16/2018 12:00:20 AM
Name :
PingStatus : Online
PlatformName : Microsoft Windows Server 2016 Datacenter
PlatformType : Windows
PlatformVersion : 10.0.14393
RegistrationDate : 1/1/0001 12:00:00 AM
ResourceType : EC2Instance
```
**Exemple 4 : Cet exemple répertorie les instances gérées par SSM et les exportations InstanceId PingStatus, LastPingDateTime et PlatformName vers un fichier csv.**
```
Get-SSMInstanceInformation | Select-Object InstanceId, PingStatus, LastPingDateTime, PlatformName | Export-Csv Instance-details.csv -NoTypeInformation
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstanceInformation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMInstancePatch`
L'exemple de code suivant montre comment utiliser`Get-SSMInstancePatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet d’obtenir les détails de la conformité des correctifs pour une instance.**
```
Get-SSMInstancePatch -InstanceId "i-08ee91c0b17045407"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstancePatches](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMInstancePatchState`
L'exemple de code suivant montre comment utiliser`Get-SSMInstancePatchState`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet d’obtenir les états récapitulatifs des correctifs pour une instance.**
```
Get-SSMInstancePatchState -InstanceId "i-08ee91c0b17045407"
```
**Exemple 2 : cet exemple permet d’obtenir les états récapitulatifs des correctifs pour deux instances.**
```
Get-SSMInstancePatchState -InstanceId "i-08ee91c0b17045407","i-09a618aec652973a9"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstancePatchStates](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMInstancePatchStatesForPatchGroup`
L'exemple de code suivant montre comment utiliser`Get-SSMInstancePatchStatesForPatchGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet d’obtenir les états récapitulatifs des correctifs par instance pour un groupe de correctifs.**
```
Get-SSMInstancePatchStatesForPatchGroup -PatchGroup "Production"
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeInstancePatchStatesForPatchGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMInventory`
L'exemple de code suivant montre comment utiliser`Get-SSMInventory`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet d’obtenir les métadonnées personnalisées de votre inventaire.**
```
Get-SSMInventory
```
**Sortie** :
```
Data Id
---- --
{[AWS:InstanceInformation, Amazon.SimpleSystemsManagement.Model.InventoryResultItem]} i-0cb2b964d3e14fd9f
```
+ Pour plus de détails sur l'API, reportez-vous [GetInventory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMInventoryEntriesList`
L'exemple de code suivant montre comment utiliser`Get-SSMInventoryEntriesList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les entrées d’inventaire personnalisées d’une instance.**
```
Get-SSMInventoryEntriesList -InstanceId "i-0cb2b964d3e14fd9f" -TypeName "Custom:RackInfo"
```
**Sortie** :
```
CaptureTime : 2016-08-22T10:01:01Z
Entries : {Amazon.Runtime.Internal.Util.AlwaysSendDictionary`2[System.String,System.String]}
InstanceId : i-0cb2b964d3e14fd9f
NextToken :
SchemaVersion : 1.0
TypeName : Custom:RackInfo
```
**Exemple 2 : cet exemple répertorie les détails.**
```
(Get-SSMInventoryEntriesList -InstanceId "i-0cb2b964d3e14fd9f" -TypeName "Custom:RackInfo").Entries
```
**Sortie** :
```
Key Value
--- -----
RackLocation Bay B/Row C/Rack D/Shelf E
```
+ Pour plus de détails sur l'API, reportez-vous [ListInventoryEntries](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMInventoryEntryList`
L'exemple de code suivant montre comment utiliser`Get-SSMInventoryEntryList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple extrait des entrées d’inventaire de type `AWS:Network` pour l’instance.**
```
Get-SSMInventoryEntryList -InstanceId mi-088dcb0ecea37b076 -TypeName AWS:Network | Select-Object -ExpandProperty Entries
```
**Sortie** :
```
Key Value
--- -----
DHCPServer 172.31.11.2
DNSServer 172.31.0.1
Gateway 172.31.11.2
IPV4 172.31.11.222
IPV6 fe12::3456:7da8:901a:12a3
MacAddress 1A:23:4E:5B:FB:67
Name Amazon Elastic Network Adapter
SubnetMask 255.255.240.0
```
+ Pour plus de détails sur l'API, consultez la *référence de l'Outils AWS pour PowerShell applet de commande [Get- SSMInventory EntryList](https://docs.aws.amazon.com/powershell/v4/reference) in (V4)*.
### `Get-SSMInventorySchema`
L'exemple de code suivant montre comment utiliser`Get-SSMInventorySchema`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie une liste de noms de types d’inventaire pour le compte.**
```
Get-SSMInventorySchema
```
+ Pour plus de détails sur l'API, reportez-vous [GetInventorySchema](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMLatestEC2Image`
L'exemple de code suivant montre comment utiliser`Get-SSMLatestEC2Image`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple répertorie toutes les dernières versions de Windows AMIs.**
```
PS Get-SSMLatestEC2Image -Path ami-windows-latest
```
**Sortie** :
```
Name Value
---- -----
Windows_Server-2008-R2_SP1-English-64Bit-SQL_2012_SP4_Express ami-0e5ddd288daff4fab
Windows_Server-2012-R2_RTM-Chinese_Simplified-64Bit-Base ami-0c5ea64e6bec1cb50
Windows_Server-2012-R2_RTM-Chinese_Traditional-64Bit-Base ami-09775eff0bf8c113d
Windows_Server-2012-R2_RTM-Dutch-64Bit-Base ami-025064b67e28cf5df
...
```
**Exemple 2 : cet exemple récupère l’ID AMI d’une image Amazon Linux spécifique pour la région us-west-2.**
```
PS Get-SSMLatestEC2Image -Path ami-amazon-linux-latest -ImageName amzn-ami-hvm-x86_64-ebs -Region us-west-2
```
**Sortie** :
```
ami-09b92cd132204c704
```
**Exemple 3 : Cet exemple répertorie toutes les dernières fenêtres AMIs correspondant à l'expression générique spécifiée.**
```
Get-SSMLatestEC2Image -Path ami-windows-latest -ImageName *Windows*2019*English*
```
**Sortie** :
```
Name Value
---- -----
Windows_Server-2019-English-Full-SQL_2017_Web ami-085e9d27da5b73a42
Windows_Server-2019-English-STIG-Core ami-0bfd85c29148c7f80
Windows_Server-2019-English-Full-SQL_2019_Web ami-02099560d7fb11f20
Windows_Server-2019-English-Full-SQL_2016_SP2_Standard ami-0d7ae2d81c07bd598
...
```
+ Pour plus de détails sur l'API, voir [Get- SSMLatest EC2 Image](https://docs.aws.amazon.com/powershell/v4/reference) in *Outils AWS pour PowerShell Cmdlet Reference (V4)*.
### `Get-SSMMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindow`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet d’obtenir des informations sur une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d"
```
**Sortie** :
```
AllowUnassociatedTargets : False
CreatedDate : 2/20/2017 6:14:05 PM
Cutoff : 1
Duration : 2
Enabled : True
ModifiedDate : 2/20/2017 6:14:05 PM
Name : TestMaintWin
Schedule : cron(0 */30 * * * ? *)
WindowId : mw-03eb9db42890fb82d
```
+ Pour plus de détails sur l'API, reportez-vous [GetMaintenanceWindow](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMMaintenanceWindowExecution`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowExecution`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les informations relatives à une tâche exécutée dans le cadre de l’exécution d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowExecution -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Sortie** :
```
EndTime : 2/21/2017 4:00:35 PM
StartTime : 2/21/2017 4:00:34 PM
Status : FAILED
StatusDetails : One or more tasks in the orchestration failed.
TaskIds : {ac0c6ae1-daa3-4a89-832e-d384503b6586}
WindowExecutionId : 518d5565-5969-4cca-8f0e-da3b2a638355
```
+ Pour plus de détails sur l'API, reportez-vous [GetMaintenanceWindowExecution](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMMaintenanceWindowExecutionList`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowExecutionList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les exécutions pour une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d"
```
**Sortie** :
```
EndTime : 2/20/2017 6:30:17 PM
StartTime : 2/20/2017 6:30:16 PM
Status : FAILED
StatusDetails : One or more tasks in the orchestration failed.
WindowExecutionId : 6f3215cf-4101-4fa0-9b7b-9523269599c7
WindowId : mw-03eb9db42890fb82d
```
**Exemple 2 : cet exemple répertorie toutes les exécutions pour une fenêtre de maintenance avant une date spécifiée.**
```
$option1 = @{Key="ExecutedBefore";Values=@("2016-11-04T05:00:00Z")}
Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d" -Filter $option1
```
**Exemple 3 : cet exemple répertorie toutes les exécutions d’une fenêtre de maintenance après une date spécifiée.**
```
$option1 = @{Key="ExecutedAfter";Values=@("2016-11-04T05:00:00Z")}
Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d" -Filter $option1
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindowExecutions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMMaintenanceWindowExecutionTask`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowExecutionTask`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les informations relatives à une tâche qui fait partie de l’exécution d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowExecutionTask -TaskId "ac0c6ae1-daa3-4a89-832e-d384503b6586" -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Sortie** :
```
EndTime : 2/21/2017 4:00:35 PM
MaxConcurrency : 1
MaxErrors : 1
Priority : 10
ServiceRole : arn:aws:iam::123456789012:role/MaintenanceWindowsRole
StartTime : 2/21/2017 4:00:34 PM
Status : FAILED
StatusDetails : The maximum error count was exceeded.
TaskArn : AWS-RunShellScript
TaskExecutionId : ac0c6ae1-daa3-4a89-832e-d384503b6586
TaskParameters : {Amazon.Runtime.Internal.Util.AlwaysSendDictionary`2[System.String,Amazon.SimpleSystemsManagement.Model.MaintenanceWindowTaskPara
meterValueExpression]}
Type : RUN_COMMAND
WindowExecutionId : 518d5565-5969-4cca-8f0e-da3b2a638355
```
+ Pour plus de détails sur l'API, reportez-vous [GetMaintenanceWindowExecutionTask](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMMaintenanceWindowExecutionTaskInvocationList`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowExecutionTaskInvocationList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les invocations d’une tâche exécutée dans le cadre de l’exécution d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowExecutionTaskInvocationList -TaskId "ac0c6ae1-daa3-4a89-832e-d384503b6586" -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Sortie** :
```
EndTime : 2/21/2017 4:00:34 PM
ExecutionId :
InvocationId : e274b6e1-fe56-4e32-bd2a-8073c6381d8b
OwnerInformation :
Parameters : {"documentName":"AWS-RunShellScript","instanceIds":["i-0000293ffd8c57862"],"parameters":{"commands":["df"]},"maxConcurrency":"1",
"maxErrors":"1"}
StartTime : 2/21/2017 4:00:34 PM
Status : FAILED
StatusDetails : The instance IDs list contains an invalid entry.
TaskExecutionId : ac0c6ae1-daa3-4a89-832e-d384503b6586
WindowExecutionId : 518d5565-5969-4cca-8f0e-da3b2a638355
WindowTargetId :
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindowExecutionTaskInvocations](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMMaintenanceWindowExecutionTaskList`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowExecutionTaskList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les tâches associées à l’exécution d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowExecutionTaskList -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Sortie** :
```
EndTime : 2/21/2017 4:00:35 PM
StartTime : 2/21/2017 4:00:34 PM
Status : SUCCESS
TaskArn : AWS-RunShellScript
TaskExecutionId : ac0c6ae1-daa3-4a89-832e-d384503b6586
TaskType : RUN_COMMAND
WindowExecutionId : 518d5565-5969-4cca-8f0e-da3b2a638355
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindowExecutionTasks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMMaintenanceWindowList`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les fenêtres de maintenance de votre compte.**
```
Get-SSMMaintenanceWindowList
```
**Sortie** :
```
Cutoff : 1
Duration : 4
Enabled : True
Name : My-First-Maintenance-Window
WindowId : mw-06d59c1a07c022145
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindows](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMMaintenanceWindowTarget`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowTarget`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les cibles d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowTarget -WindowId "mw-06cf17cbefcb4bf4f"
```
**Sortie** :
```
OwnerInformation : Single instance
ResourceType : INSTANCE
Targets : {InstanceIds}
WindowId : mw-06cf17cbefcb4bf4f
WindowTargetId : 350d44e6-28cc-44e2-951f-4b2c985838f6
OwnerInformation : Two instances in a list
ResourceType : INSTANCE
Targets : {InstanceIds}
WindowId : mw-06cf17cbefcb4bf4f
WindowTargetId : e078a987-2866-47be-bedd-d9cf49177d3a
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindowTargets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMMaintenanceWindowTaskList`
L'exemple de code suivant montre comment utiliser`Get-SSMMaintenanceWindowTaskList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie toutes les tâches d’une fenêtre de maintenance.**
```
Get-SSMMaintenanceWindowTaskList -WindowId "mw-06cf17cbefcb4bf4f"
```
**Sortie** :
```
LoggingInfo :
MaxConcurrency : 1
MaxErrors : 1
Priority : 10
ServiceRoleArn : arn:aws:iam::123456789012:role/MaintenanceWindowsRole
Targets : {InstanceIds}
TaskArn : AWS-RunShellScript
TaskParameters : {[commands, Amazon.SimpleSystemsManagement.Model.MaintenanceWindowTaskParameterValueExpression]}
Type : RUN_COMMAND
WindowId : mw-06cf17cbefcb4bf4f
WindowTaskId : a23e338d-ff30-4398-8aa3-09cd052ebf17
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeMaintenanceWindowTasks](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMParameterHistory`
L'exemple de code suivant montre comment utiliser`Get-SSMParameterHistory`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie l’historique des valeurs d’un paramètre.**
```
Get-SSMParameterHistory -Name "Welcome"
```
**Sortie** :
```
Description :
KeyId :
LastModifiedDate : 3/3/2017 6:55:25 PM
LastModifiedUser : arn:aws:iam::123456789012:user/admin
Name : Welcome
Type : String
Value : helloWorld
```
+ Pour plus de détails sur l'API, reportez-vous [GetParameterHistory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMParameterList`
L'exemple de code suivant montre comment utiliser`Get-SSMParameterList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie tous les paramètres.**
```
Get-SSMParameterList
```
**Sortie** :
```
Description :
KeyId :
LastModifiedDate : 3/3/2017 6:58:23 PM
LastModifiedUser : arn:aws:iam::123456789012:user/admin
Name : Welcome
Type : String
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeParameters](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMParameterValue`
L'exemple de code suivant montre comment utiliser`Get-SSMParameterValue`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les valeurs d’un paramètre.**
```
Get-SSMParameterValue -Name "Welcome"
```
**Sortie** :
```
InvalidParameters Parameters
----------------- ----------
{} {Welcome}
```
**Exemple 2 : cet exemple répertorie les détails de la valeur.**
```
(Get-SSMParameterValue -Name "Welcome").Parameters
```
**Sortie** :
```
Name Type Value
---- ---- -----
Welcome String Good day, Sunshine!
```
+ Pour plus de détails sur l'API, reportez-vous [GetParameters](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMPatchBaseline`
L'exemple de code suivant montre comment utiliser`Get-SSMPatchBaseline`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie tous les référentiels de correctifs.**
```
Get-SSMPatchBaseline
```
**Sortie** :
```
BaselineDescription BaselineId BaselineName
------------------- ---------- ------------
Default Patch Baseline Provided by AWS. arn:aws:ssm:us-west-2:123456789012:patchbaseline/pb-04fb4ae6142167966 AWS-DefaultP...
Baseline containing all updates approved for production systems pb-045f10b4f382baeda Production-B...
Baseline containing all updates approved for production systems pb-0a2f1059b670ebd31 Production-B...
```
**Exemple 2 : Cet exemple répertorie toutes les lignes de base de correctifs fournies par AWS. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$filter1 = @{Key="OWNER";Values=@("AWS")}
```
**Sortie** :
```
Get-SSMPatchBaseline -Filter $filter1
```
**Exemple 3 : cet exemple répertorie tous les référentiels de correctifs dont vous êtes le propriétaire. La syntaxe utilisée dans cet exemple nécessite PowerShell la version 3 ou ultérieure.**
```
$filter1 = @{Key="OWNER";Values=@("Self")}
```
**Sortie** :
```
Get-SSMPatchBaseline -Filter $filter1
```
**Exemple 4 : Avec PowerShell la version 2, vous devez utiliser New-Object pour créer chaque balise.**
```
$filter1 = New-Object Amazon.SimpleSystemsManagement.Model.PatchOrchestratorFilter
$filter1.Key = "OWNER"
$filter1.Values = "AWS"
Get-SSMPatchBaseline -Filter $filter1
```
**Sortie** :
```
BaselineDescription BaselineId BaselineName DefaultBaselin
e
------------------- ---------- ------------ --------------
Default Patch Baseline Provided by AWS. arn:aws:ssm:us-west-2:123456789012:patchbaseline/pb-04fb4ae6142167966 AWS-DefaultPatchBaseline True
```
+ Pour plus de détails sur l'API, reportez-vous [DescribePatchBaselines](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMPatchBaselineDetail`
L'exemple de code suivant montre comment utiliser`Get-SSMPatchBaselineDetail`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche les détails d’un référentiel de correctifs.**
```
Get-SSMPatchBaselineDetail -BaselineId "pb-03da896ca3b68b639"
```
**Sortie** :
```
ApprovalRules : Amazon.SimpleSystemsManagement.Model.PatchRuleGroup
ApprovedPatches : {}
BaselineId : pb-03da896ca3b68b639
CreatedDate : 3/3/2017 5:02:19 PM
Description : Baseline containing all updates approved for production systems
GlobalFilters : Amazon.SimpleSystemsManagement.Model.PatchFilterGroup
ModifiedDate : 3/3/2017 5:02:19 PM
Name : Production-Baseline
PatchGroups : {}
RejectedPatches : {}
```
+ Pour plus de détails sur l'API, reportez-vous [GetPatchBaseline](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMPatchBaselineForPatchGroup`
L'exemple de code suivant montre comment utiliser`Get-SSMPatchBaselineForPatchGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple affiche le référentiel de correctifs pour un groupe de correctifs.**
```
Get-SSMPatchBaselineForPatchGroup -PatchGroup "Production"
```
**Sortie** :
```
BaselineId PatchGroup
---------- ----------
pb-045f10b4f382baeda Production
```
+ Pour plus de détails sur l'API, reportez-vous [GetPatchBaselineForPatchGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMPatchGroup`
L'exemple de code suivant montre comment utiliser`Get-SSMPatchGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les enregistrements de groupes de correctifs.**
```
Get-SSMPatchGroup
```
**Sortie** :
```
BaselineIdentity PatchGroup
---------------- ----------
Amazon.SimpleSystemsManagement.Model.PatchBaselineIdentity Production
```
+ Pour plus de détails sur l'API, reportez-vous [DescribePatchGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMPatchGroupState`
L'exemple de code suivant montre comment utiliser`Get-SSMPatchGroupState`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet d’obtenir le récapitulatif de haut niveau de la conformité des correctifs pour un groupe de correctifs.**
```
Get-SSMPatchGroupState -PatchGroup "Production"
```
**Sortie** :
```
Instances : 4
InstancesWithFailedPatches : 1
InstancesWithInstalledOtherPatches : 4
InstancesWithInstalledPatches : 3
InstancesWithMissingPatches : 0
InstancesWithNotApplicablePatches : 0
```
+ Pour plus de détails sur l'API, reportez-vous [DescribePatchGroupState](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMResourceComplianceSummaryList`
L'exemple de code suivant montre comment utiliser`Get-SSMResourceComplianceSummaryList`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple permet d’obtenir un récapitulatif du niveau des ressources. Le récapitulatif comprend des informations sur les statuts de conformité et de non-conformité ainsi que des comptes détaillés de la sévérité des éléments de conformité pour les produits qui correspondent à « Windows10 ». Comme la valeur MaxResult par défaut est 100 si le paramètre n'est pas spécifié et que cette valeur n'est pas valide, le MaxResult paramètre est ajouté et la valeur est définie sur 50.**
```
$FilterValues = @{
"Key"="Product"
"Type"="EQUAL"
"Values"="Windows10"
}
Get-SSMResourceComplianceSummaryList -Filter $FilterValues -MaxResult 50
```
+ Pour plus de détails sur l'API, reportez-vous [ListResourceComplianceSummaries](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-SSMResourceTag`
L'exemple de code suivant montre comment utiliser`Get-SSMResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les balises d’une fenêtre de maintenance.**
```
Get-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow"
```
**Sortie** :
```
Key Value
--- -----
Stack Production
```
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-SSMActivation`
L'exemple de code suivant montre comment utiliser`New-SSMActivation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une instance gérée.**
```
New-SSMActivation -DefaultInstanceName "MyWebServers" -IamRole "SSMAutomationRole" -RegistrationLimit 10
```
**Sortie** :
```
ActivationCode ActivationId
-------------- ------------
KWChhOxBTiwDcKE9BlKC 08e51e79-1e36-446c-8e63-9458569c1363
```
+ Pour plus de détails sur l'API, reportez-vous [CreateActivation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-SSMAssociation`
L'exemple de code suivant montre comment utiliser`New-SSMAssociation`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple associe un document de configuration à une instance, en utilisant l'instance IDs.**
```
New-SSMAssociation -InstanceId "i-0cb2b964d3e14fd9f" -Name "AWS-UpdateSSMAgent"
```
**Sortie** :
```
Name : AWS-UpdateSSMAgent
InstanceId : i-0000293ffd8c57862
Date : 2/23/2017 6:55:22 PM
Status.Name : Associated
Status.Date : 2/20/2015 8:31:11 AM
Status.Message : Associated with AWS-UpdateSSMAgent
Status.AdditionalInfo :
```
**Exemple 2 : cet exemple associe un document de configuration à une instance, en utilisant des cibles.**
```
$target = @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")}
New-SSMAssociation -Name "AWS-UpdateSSMAgent" -Target $target
```
**Sortie** :
```
Name : AWS-UpdateSSMAgent
InstanceId :
Date : 3/1/2017 6:22:21 PM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
**Exemple 3 : cet exemple associe un document de configuration à une instance, en utilisant des cibles et des paramètres.**
```
$target = @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")}
$params = @{
"action"="configure"
"mode"="ec2"
"optionalConfigurationSource"="ssm"
"optionalConfigurationLocation"=""
"optionalRestart"="yes"
}
New-SSMAssociation -Name "Configure-CloudWatch" -AssociationName "CWConfiguration" -Target $target -Parameter $params
```
**Sortie** :
```
Name : Configure-CloudWatch
InstanceId :
Date : 5/17/2018 3:17:44 PM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
**Exemple 4 : cet exemple crée une association avec toutes les instances de la région, avec `AWS-GatherSoftwareInventory`. Il fournit également des fichiers personnalisés et des emplacements de registre dans les paramètres à collecter**
```
$params = [Collections.Generic.Dictionary[String,Collections.Generic.List[String]]]::new()
$params["windowsRegistry"] ='[{"Path":"HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\MachineImage","Recursive":false,"ValueNames":["AMIName"]}]'
$params["files"] = '[{"Path":"C:\Program Files","Pattern":["*.exe"],"Recursive":true}, {"Path":"C:\ProgramData","Pattern":["*.log"],"Recursive":true}]'
New-SSMAssociation -AssociationName new-in-mum -Name AWS-GatherSoftwareInventory -Target @{Key="instanceids";Values="*"} -Parameter $params -region ap-south-1 -ScheduleExpression "rate(720 minutes)"
```
**Sortie** :
```
Name : AWS-GatherSoftwareInventory
InstanceId :
Date : 6/9/2019 8:57:56 AM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
+ Pour plus de détails sur l'API, reportez-vous [CreateAssociation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-SSMAssociationFromBatch`
L'exemple de code suivant montre comment utiliser`New-SSMAssociationFromBatch`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple associe un document de configuration à plusieurs instances. La sortie renvoie une liste des opérations réussies et échouées, le cas échéant.**
```
$option1 = @{InstanceId="i-0cb2b964d3e14fd9f";Name=@("AWS-UpdateSSMAgent")}
$option2 = @{InstanceId="i-0000293ffd8c57862";Name=@("AWS-UpdateSSMAgent")}
New-SSMAssociationFromBatch -Entry $option1,$option2
```
**Sortie** :
```
Failed Successful
------ ----------
{} {Amazon.SimpleSystemsManagement.Model.FailedCreateAssociation, Amazon.SimpleSystemsManagement.Model.FailedCreateAsso...
```
**Exemple 2 : cet exemple montre tous les détails d’une opération réussie.**
```
$option1 = @{InstanceId="i-0cb2b964d3e14fd9f";Name=@("AWS-UpdateSSMAgent")}
$option2 = @{InstanceId="i-0000293ffd8c57862";Name=@("AWS-UpdateSSMAgent")}
(New-SSMAssociationFromBatch -Entry $option1,$option2).Successful
```
+ Pour plus de détails sur l'API, reportez-vous [CreateAssociationBatch](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-SSMDocument`
L'exemple de code suivant montre comment utiliser`New-SSMDocument`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un document dans votre compte. Le document doit être au format JSON. Pour plus d’informations sur la rédaction d’un document de configuration, consultez Document de configuration dans la Référence d’API SSM.**
```
New-SSMDocument -Content (Get-Content -Raw "c:\temp\RunShellScript.json") -Name "RunShellScript" -DocumentType "Command"
```
**Sortie** :
```
CreatedDate : 3/1/2017 1:21:33 AM
DefaultVersion : 1
Description : Run an updated script
DocumentType : Command
DocumentVersion : 1
Hash : 1d5ce820e999ff051eb4841ed887593daf77120fd76cae0d18a53cc42e4e22c1
HashType : Sha256
LatestVersion : 1
Name : RunShellScript
Owner : 809632081692
Parameters : {commands}
PlatformTypes : {Linux}
SchemaVersion : 2.0
Sha1 :
Status : Creating
```
+ Pour plus de détails sur l'API, reportez-vous [CreateDocument](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-SSMMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`New-SSMMaintenanceWindow`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée une nouvelle fenêtre de maintenance portant le nom spécifié, qui s’exécute tous les mardis à 16 heures pendant 4 heures, avec une coupure d’une heure, et qui autorise les cibles non associées.**
```
New-SSMMaintenanceWindow -Name "MyMaintenanceWindow" -Duration 4 -Cutoff 1 -AllowUnassociatedTarget $true -Schedule "cron(0 16 ? * TUE *)"
```
**Sortie** :
```
mw-03eb53e1ea7383998
```
+ Pour plus de détails sur l'API, reportez-vous [CreateMaintenanceWindow](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-SSMPatchBaseline`
L'exemple de code suivant montre comment utiliser`New-SSMPatchBaseline`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un référentiel de correctifs qui approuve les correctifs, sept jours après qu’ils ont été publiés par Microsoft, pour les instances gérées qui exécutent Windows Server 2019 dans un environnement de production.**
```
$rule = New-Object Amazon.SimpleSystemsManagement.Model.PatchRule
$rule.ApproveAfterDays = 7
$ruleFilters = New-Object Amazon.SimpleSystemsManagement.Model.PatchFilterGroup
$patchFilter = New-Object Amazon.SimpleSystemsManagement.Model.PatchFilter
$patchFilter.Key="PRODUCT"
$patchFilter.Values="WindowsServer2019"
$severityFilter = New-Object Amazon.SimpleSystemsManagement.Model.PatchFilter
$severityFilter.Key="MSRC_SEVERITY"
$severityFilter.Values.Add("Critical")
$severityFilter.Values.Add("Important")
$severityFilter.Values.Add("Moderate")
$classificationFilter = New-Object Amazon.SimpleSystemsManagement.Model.PatchFilter
$classificationFilter.Key = "CLASSIFICATION"
$classificationFilter.Values.Add( "SecurityUpdates" )
$classificationFilter.Values.Add( "Updates" )
$classificationFilter.Values.Add( "UpdateRollups" )
$classificationFilter.Values.Add( "CriticalUpdates" )
$ruleFilters.PatchFilters.Add($severityFilter)
$ruleFilters.PatchFilters.Add($classificationFilter)
$ruleFilters.PatchFilters.Add($patchFilter)
$rule.PatchFilterGroup = $ruleFilters
New-SSMPatchBaseline -Name "Production-Baseline-Windows2019" -Description "Baseline containing all updates approved for production systems" -ApprovalRules_PatchRule $rule
```
**Sortie** :
```
pb-0z4z6221c4296b23z
```
+ Pour plus de détails sur l'API, reportez-vous [CreatePatchBaseline](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-SSMDefaultPatchBaseline`
L'exemple de code suivant montre comment utiliser`Register-SSMDefaultPatchBaseline`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre un référentiel de correctifs en tant que référence de correctifs par défaut.**
```
Register-SSMDefaultPatchBaseline -BaselineId "pb-03da896ca3b68b639"
```
**Sortie** :
```
pb-03da896ca3b68b639
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterDefaultPatchBaseline](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-SSMPatchBaselineForPatchGroup`
L'exemple de code suivant montre comment utiliser`Register-SSMPatchBaselineForPatchGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre un référentiel de correctifs pour un groupe de correctifs.**
```
Register-SSMPatchBaselineForPatchGroup -BaselineId "pb-03da896ca3b68b639" -PatchGroup "Production"
```
**Sortie** :
```
BaselineId PatchGroup
---------- ----------
pb-03da896ca3b68b639 Production
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterPatchBaselineForPatchGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-SSMTargetWithMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Register-SSMTargetWithMaintenanceWindow`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre une instance avec une fenêtre de maintenance.**
```
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"
```
**Sortie** :
```
d8e47760-23ed-46a5-9f28-927337725398
```
**Exemple 2 : cet exemple enregistre plusieurs instances avec une fenêtre de maintenance.**
```
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"
```
**Sortie** :
```
6ab5c208-9fc4-4697-84b7-b02a6cc25f7d
```
**Exemple 3 : cet exemple enregistre une instance avec une fenêtre de maintenance à l’aide des balises EC2.**
```
$option1 = @{Key="tag:Environment";Values=@("Production")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE"
```
**Sortie** :
```
2994977e-aefb-4a71-beac-df620352f184
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterTargetWithMaintenanceWindow](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-SSMTaskWithMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Register-SSMTaskWithMaintenanceWindow`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre une tâche avec une fenêtre de maintenance à l’aide d’un ID d’instance. Le résultat est l’ID de tâche.**
```
$parameters = @{}
$parameterValues = New-Object Amazon.SimpleSystemsManagement.Model.MaintenanceWindowTaskParameterValueExpression
$parameterValues.Values = @("Install")
$parameters.Add("Operation", $parameterValues)
Register-SSMTaskWithMaintenanceWindow -WindowId "mw-03a342e62c96d31b0" -ServiceRoleArn "arn:aws:iam::123456789012:role/MaintenanceWindowsRole" -MaxConcurrency 1 -MaxError 1 -TaskArn "AWS-RunShellScript" -Target @{ Key="InstanceIds";Values="i-0000293ffd8c57862" } -TaskType "RUN_COMMAND" -Priority 10 -TaskParameter $parameters
```
**Sortie** :
```
f34a2c47-ddfd-4c85-a88d-72366b69af1b
```
**Exemple 2 : cet exemple enregistre une tâche avec une fenêtre de maintenance à l’aide d’un ID cible. Le résultat est l’ID de tâche.**
```
$parameters = @{}
$parameterValues = New-Object Amazon.SimpleSystemsManagement.Model.MaintenanceWindowTaskParameterValueExpression
$parameterValues.Values = @("Install")
$parameters.Add("Operation", $parameterValues)
register-ssmtaskwithmaintenancewindow -WindowId "mw-03a342e62c96d31b0" -ServiceRoleArn "arn:aws:iam::123456789012:role/MaintenanceWindowsRole" -MaxConcurrency 1 -MaxError 1 -TaskArn "AWS-RunShellScript" -Target @{ Key="WindowTargetIds";Values="350d44e6-28cc-44e2-951f-4b2c985838f6" } -TaskType "RUN_COMMAND" -Priority 10 -TaskParameter $parameters
```
**Sortie** :
```
f34a2c47-ddfd-4c85-a88d-72366b69af1b
```
**Exemple 3 : cet exemple crée un objet paramètre pour le document de commande d’exécution `AWS-RunPowerShellScript` et crée une tâche avec une fenêtre de maintenance donnée à l’aide de l’ID cible. La sortie de retour est l’ID de la tâche.**
```
$parameters = [Collections.Generic.Dictionary[String,Collections.Generic.List[String]]]::new()
$parameters.Add("commands",@("ipconfig","dir env:\computername"))
$parameters.Add("executionTimeout",@(3600))
$props = @{
WindowId = "mw-0123e4cce56ff78ae"
ServiceRoleArn = "arn:aws:iam::123456789012:role/MaintenanceWindowsRole"
MaxConcurrency = 1
MaxError = 1
TaskType = "RUN_COMMAND"
TaskArn = "AWS-RunPowerShellScript"
Target = @{Key="WindowTargetIds";Values="fe1234ea-56d7-890b-12f3-456b789bee0f"}
Priority = 1
RunCommand_Parameter = $parameters
Name = "set-via-cmdlet"
}
Register-SSMTaskWithMaintenanceWindow @props
```
**Sortie** :
```
f1e2ef34-5678-12e3-456a-12334c5c6cbe
```
**Exemple 4 : Cet exemple enregistre une tâche d'automatisation de AWS Systems Manager à l'aide d'un document nommé`Create-Snapshots`.**
```
$automationParameters = @{}
$automationParameters.Add( "instanceId", @("{{ TARGET_ID }}") )
$automationParameters.Add( "AutomationAssumeRole", @("{arn:aws:iam::111111111111:role/AutomationRole}") )
$automationParameters.Add( "SnapshotTimeout", @("PT20M") )
Register-SSMTaskWithMaintenanceWindow -WindowId mw-123EXAMPLE456`
-ServiceRoleArn "arn:aws:iam::123456789012:role/MW-Role"`
-MaxConcurrency 1 -MaxError 1 -TaskArn "CreateVolumeSnapshots"`
-Target @{ Key="WindowTargetIds";Values="4b5acdf4-946c-4355-bd68-4329a43a5fd1" }`
-TaskType "AUTOMATION"`
-Priority 4`
-Automation_DocumentVersion '$DEFAULT' -Automation_Parameter $automationParameters -Name "Create-Snapshots"
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterTaskWithMaintenanceWindow](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-SSMActivation`
L'exemple de code suivant montre comment utiliser`Remove-SSMActivation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime une activation. Il n’y a pas de sortie si la commande réussit.**
```
Remove-SSMActivation -ActivationId "08e51e79-1e36-446c-8e63-9458569c1363"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteActivation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-SSMAssociation`
L'exemple de code suivant montre comment utiliser`Remove-SSMAssociation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime l’association entre une instance et un document. Il n’y a pas de sortie si la commande réussit.**
```
Remove-SSMAssociation -InstanceId "i-0cb2b964d3e14fd9f" -Name "AWS-UpdateSSMAgent"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteAssociation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-SSMDocument`
L'exemple de code suivant montre comment utiliser`Remove-SSMDocument`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime un document. Il n’y a pas de sortie si la commande réussit.**
```
Remove-SSMDocument -Name "RunShellScript"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteDocument](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-SSMMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Remove-SSMMaintenanceWindow`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime une fenêtre de maintenance.**
```
Remove-SSMMaintenanceWindow -WindowId "mw-06d59c1a07c022145"
```
**Sortie** :
```
mw-06d59c1a07c022145
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteMaintenanceWindow](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-SSMParameter`
L'exemple de code suivant montre comment utiliser`Remove-SSMParameter`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime un paramètre. Il n’y a pas de sortie si la commande réussit.**
```
Remove-SSMParameter -Name "helloWorld"
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteParameter](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-SSMPatchBaseline`
L'exemple de code suivant montre comment utiliser`Remove-SSMPatchBaseline`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime un référentiel de correctifs.**
```
Remove-SSMPatchBaseline -BaselineId "pb-045f10b4f382baeda"
```
**Sortie** :
```
pb-045f10b4f382baeda
```
+ Pour plus de détails sur l'API, reportez-vous [DeletePatchBaseline](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-SSMResourceTag`
L'exemple de code suivant montre comment utiliser`Remove-SSMResourceTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime une balise d’une fenêtre de maintenance. Il n’y a pas de sortie si la commande réussit.**
```
Remove-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -TagKey "Production"
```
+ Pour plus de détails sur l'API, reportez-vous [RemoveTagsFromResource](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Send-SSMCommand`
L'exemple de code suivant montre comment utiliser`Send-SSMCommand`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple exécute une commande echo sur une instance cible.**
```
Send-SSMCommand -DocumentName "AWS-RunPowerShellScript" -Parameter @{commands = "echo helloWorld"} -Target @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")}
```
**Sortie** :
```
CommandId : d8d190fc-32c1-4d65-a0df-ff5ff3965524
Comment :
CompletedCount : 0
DocumentName : AWS-RunPowerShellScript
ErrorCount : 0
ExpiresAfter : 3/7/2017 10:48:37 PM
InstanceIds : {}
MaxConcurrency : 50
MaxErrors : 0
NotificationConfig : Amazon.SimpleSystemsManagement.Model.NotificationConfig
OutputS3BucketName :
OutputS3KeyPrefix :
OutputS3Region :
Parameters : {[commands, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]}
RequestedDateTime : 3/7/2017 9:48:37 PM
ServiceRole :
Status : Pending
StatusDetails : Pending
TargetCount : 0
Targets : {instanceids}
```
**Exemple 2 : cet exemple montre comment exécuter une commande qui accepte des paramètres imbriqués.**
```
Send-SSMCommand -DocumentName "AWS-RunRemoteScript" -Parameter @{ sourceType="GitHub";sourceInfo='{"owner": "me","repository": "amazon-ssm","path": "Examples/Install-Win32OpenSSH"}'; "commandLine"=".\Install-Win32OpenSSH.ps1"} -InstanceId i-0cb2b964d3e14fd9f
```
+ Pour plus de détails sur l'API, reportez-vous [SendCommand](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Start-SSMAutomationExecution`
L'exemple de code suivant montre comment utiliser`Start-SSMAutomationExecution`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple exécute un document qui spécifie un rôle d’automatisation, un ID de source AMI et un rôle d’instance Amazon EC2.**
```
Start-SSMAutomationExecution -DocumentName AWS-UpdateLinuxAmi -Parameter @{'AutomationAssumeRole'='arn:aws:iam::123456789012:role/SSMAutomationRole';'SourceAmiId'='ami-f173cc91';'InstanceIamRole'='EC2InstanceRole'}
```
**Sortie** :
```
3a532a4f-0382-11e7-9df7-6f11185f6dd1
```
+ Pour plus de détails sur l'API, reportez-vous [StartAutomationExecution](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Start-SSMSession`
L'exemple de code suivant montre comment utiliser`Start-SSMSession`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple initie une connexion à une cible pour une session Session Manager, en activant la redirection de port.**
```
Start-SSMSession -Target 'i-064578e5e7454488f' -DocumentName 'AWS-StartPortForwardingSession' -Parameter @{ localPortNumber = '8080'; portNumber = '80' }
```
**Sortie** :
```
SessionId StreamUrl
---------- ----------
random-id0 wss://ssmmessages.amazonaws.com/v1/data-channel/random-id
```
+ Pour plus de détails sur l'API, reportez-vous [StartSession](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-SSMAutomationExecution`
L'exemple de code suivant montre comment utiliser`Stop-SSMAutomationExecution`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple arrête l’exécution d’une automatisation. Il n’y a pas de sortie si la commande réussit.**
```
Stop-SSMAutomationExecution -AutomationExecutionId "4105a4fc-f944-11e6-9d32-8fb2db27a909"
```
+ Pour plus de détails sur l'API, reportez-vous [StopAutomationExecution](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-SSMCommand`
L'exemple de code suivant montre comment utiliser`Stop-SSMCommand`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple tente d’annuler une commande. Il n’y a pas de sortie si l’opération réussit.**
```
Stop-SSMCommand -CommandId "9ded293e-e792-4440-8e3e-7b8ec5feaa38"
```
+ Pour plus de détails sur l'API, reportez-vous [CancelCommand](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-SSMManagedInstance`
L'exemple de code suivant montre comment utiliser`Unregister-SSMManagedInstance`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple désenregistre une instance gérée. Il n’y a pas de sortie si la commande réussit.**
```
Unregister-SSMManagedInstance -InstanceId "mi-08ab247cdf1046573"
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterManagedInstance](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-SSMPatchBaselineForPatchGroup`
L'exemple de code suivant montre comment utiliser`Unregister-SSMPatchBaselineForPatchGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple désenregistre un groupe de correctifs d’un référentiel de correctifs.**
```
Unregister-SSMPatchBaselineForPatchGroup -BaselineId "pb-045f10b4f382baeda" -PatchGroup "Production"
```
**Sortie** :
```
BaselineId PatchGroup
---------- ----------
pb-045f10b4f382baeda Production
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterPatchBaselineForPatchGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-SSMTargetFromMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Unregister-SSMTargetFromMaintenanceWindow`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime une cible d’une fenêtre de maintenance.**
```
Unregister-SSMTargetFromMaintenanceWindow -WindowTargetId "6ab5c208-9fc4-4697-84b7-b02a6cc25f7d" -WindowId "mw-06cf17cbefcb4bf4f"
```
**Sortie** :
```
WindowId WindowTargetId
-------- --------------
mw-06cf17cbefcb4bf4f 6ab5c208-9fc4-4697-84b7-b02a6cc25f7d
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterTargetFromMaintenanceWindow](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-SSMTaskFromMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Unregister-SSMTaskFromMaintenanceWindow`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime une tâche d’une fenêtre de maintenance.**
```
Unregister-SSMTaskFromMaintenanceWindow -WindowTaskId "f34a2c47-ddfd-4c85-a88d-72366b69af1b" -WindowId "mw-03a342e62c96d31b0"
```
**Sortie** :
```
WindowId WindowTaskId
-------- ------------
mw-03a342e62c96d31b0 f34a2c47-ddfd-4c85-a88d-72366b69af1b
```
+ Pour plus de détails sur l'API, reportez-vous [DeregisterTaskFromMaintenanceWindow](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-SSMAssociation`
L'exemple de code suivant montre comment utiliser`Update-SSMAssociation`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour une association avec une nouvelle version de document.**
```
Update-SSMAssociation -AssociationId "93285663-92df-44cb-9f26-2292d4ecc439" -DocumentVersion "1"
```
**Sortie** :
```
Name : AWS-UpdateSSMAgent
InstanceId :
Date : 3/1/2017 6:22:21 PM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateAssociation](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-SSMAssociationStatus`
L'exemple de code suivant montre comment utiliser`Update-SSMAssociationStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour le statut de l’association entre une instance et un document de configuration.**
```
Update-SSMAssociationStatus -Name "AWS-UpdateSSMAgent" -InstanceId "i-0000293ffd8c57862" -AssociationStatus_Date "2015-02-20T08:31:11Z" -AssociationStatus_Name "Pending" -AssociationStatus_Message "temporary_status_change" -AssociationStatus_AdditionalInfo "Additional-Config-Needed"
```
**Sortie** :
```
Name : AWS-UpdateSSMAgent
InstanceId : i-0000293ffd8c57862
Date : 2/23/2017 6:55:22 PM
Status.Name : Pending
Status.Date : 2/20/2015 8:31:11 AM
Status.Message : temporary_status_change
Status.AdditionalInfo : Additional-Config-Needed
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateAssociationStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-SSMDocument`
L'exemple de code suivant montre comment utiliser`Update-SSMDocument`.
**Outils pour PowerShell V4**
**Exemple 1 : ceci crée une nouvelle version d’un document avec le contenu mis à jour du fichier json que vous spécifiez. Le document doit être au format JSON. Vous pouvez obtenir la version du document à l'aide de l'applet de commande « Get- SSMDocument VersionList ».**
```
Update-SSMDocument -Name RunShellScript -DocumentVersion "1" -Content (Get-Content -Raw "c:\temp\RunShellScript.json")
```
**Sortie** :
```
CreatedDate : 3/1/2017 2:59:17 AM
DefaultVersion : 1
Description : Run an updated script
DocumentType : Command
DocumentVersion : 2
Hash : 1d5ce820e999ff051eb4841ed887593daf77120fd76cae0d18a53cc42e4e22c1
HashType : Sha256
LatestVersion : 2
Name : RunShellScript
Owner : 809632081692
Parameters : {commands}
PlatformTypes : {Linux}
SchemaVersion : 2.0
Sha1 :
Status : Updating
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateDocument](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-SSMDocumentDefaultVersion`
L'exemple de code suivant montre comment utiliser`Update-SSMDocumentDefaultVersion`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour la version par défaut d’un document. Vous pouvez obtenir les versions de document disponibles à l'aide de l'applet de commande « Get- SSMDocument VersionList ».**
```
Update-SSMDocumentDefaultVersion -Name "RunShellScript" -DocumentVersion "2"
```
**Sortie** :
```
DefaultVersion Name
-------------- ----
2 RunShellScript
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateDocumentDefaultVersion](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-SSMMaintenanceWindow`
L'exemple de code suivant montre comment utiliser`Update-SSMMaintenanceWindow`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour le nom d’une fenêtre de maintenance.**
```
Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Name "My-Renamed-MW"
```
**Sortie** :
```
AllowUnassociatedTargets : False
Cutoff : 1
Duration : 2
Enabled : True
Name : My-Renamed-MW
Schedule : cron(0 */30 * * * ? *)
WindowId : mw-03eb9db42890fb82d
```
**Exemple 2 : cet exemple active une fenêtre de maintenance.**
```
Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Enabled $true
```
**Sortie** :
```
AllowUnassociatedTargets : False
Cutoff : 1
Duration : 2
Enabled : True
Name : My-Renamed-MW
Schedule : cron(0 */30 * * * ? *)
WindowId : mw-03eb9db42890fb82d
```
**Exemple 3 : cet exemple désactive une fenêtre de maintenance.**
```
Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Enabled $false
```
**Sortie** :
```
AllowUnassociatedTargets : False
Cutoff : 1
Duration : 2
Enabled : False
Name : My-Renamed-MW
Schedule : cron(0 */30 * * * ? *)
WindowId : mw-03eb9db42890fb82d
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateMaintenanceWindow](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-SSMManagedInstanceRole`
L'exemple de code suivant montre comment utiliser`Update-SSMManagedInstanceRole`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple met à jour le rôle d’une instance gérée. Il n’y a pas de sortie si la commande réussit.**
```
Update-SSMManagedInstanceRole -InstanceId "mi-08ab247cdf1046573" -IamRole "AutomationRole"
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateManagedInstanceRole](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Update-SSMPatchBaseline`
L'exemple de code suivant montre comment utiliser`Update-SSMPatchBaseline`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute deux correctifs comme étant rejetés et un correctif comme étant approuvé à un référentiel de correctifs existant.**
```
Update-SSMPatchBaseline -BaselineId "pb-03da896ca3b68b639" -RejectedPatch "KB2032276","MS10-048" -ApprovedPatch "KB2124261"
```
**Sortie** :
```
ApprovalRules : Amazon.SimpleSystemsManagement.Model.PatchRuleGroup
ApprovedPatches : {KB2124261}
BaselineId : pb-03da896ca3b68b639
CreatedDate : 3/3/2017 5:02:19 PM
Description : Baseline containing all updates approved for production systems
GlobalFilters : Amazon.SimpleSystemsManagement.Model.PatchFilterGroup
ModifiedDate : 3/3/2017 5:22:10 PM
Name : Production-Baseline
RejectedPatches : {KB2032276, MS10-048}
```
+ Pour plus de détails sur l'API, reportez-vous [UpdatePatchBaseline](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-SSMComplianceItem`
L'exemple de code suivant montre comment utiliser`Write-SSMComplianceItem`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple écrit un élément de conformité personnalisé pour l’instance gérée donnée**
```
$item = [Amazon.SimpleSystemsManagement.Model.ComplianceItemEntry]::new()
$item.Id = "07Jun2019-3"
$item.Severity="LOW"
$item.Status="COMPLIANT"
$item.Title="Fin-test-1 - custom"
Write-SSMComplianceItem -ResourceId mi-012dcb3ecea45b678 -ComplianceType Custom:VSSCompliant2 -ResourceType ManagedInstance -Item $item -ExecutionSummary_ExecutionTime "07-Jun-2019"
```
+ Pour plus de détails sur l'API, reportez-vous [PutComplianceItems](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-SSMInventory`
L'exemple de code suivant montre comment utiliser`Write-SSMInventory`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple attribue des informations sur l’emplacement du rack à une instance. Il n’y a pas de sortie si la commande réussit.**
```
$data = New-Object "System.Collections.Generic.Dictionary[System.String,System.String]"
$data.Add("RackLocation", "Bay B/Row C/Rack D/Shelf F")
$items = New-Object "System.Collections.Generic.List[System.Collections.Generic.Dictionary[System.String, System.String]]"
$items.Add($data)
$customInventoryItem = New-Object Amazon.SimpleSystemsManagement.Model.InventoryItem
$customInventoryItem.CaptureTime = "2016-08-22T10:01:01Z"
$customInventoryItem.Content = $items
$customInventoryItem.TypeName = "Custom:TestRackInfo2"
$customInventoryItem.SchemaVersion = "1.0"
$inventoryItems = @($customInventoryItem)
Write-SSMInventory -InstanceId "i-0cb2b964d3e14fd9f" -Item $inventoryItems
```
+ Pour plus de détails sur l'API, reportez-vous [PutInventory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Write-SSMParameter`
L'exemple de code suivant montre comment utiliser`Write-SSMParameter`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un paramètre. Il n’y a pas de sortie si la commande réussit.**
```
Write-SSMParameter -Name "Welcome" -Type "String" -Value "helloWorld"
```
**Exemple 2 : cet exemple modifie un paramètre. Il n’y a pas de sortie si la commande réussit.**
```
Write-SSMParameter -Name "Welcome" -Type "String" -Value "Good day, Sunshine!" -Overwrite $true
```
+ Pour plus de détails sur l'API, reportez-vous [PutParameter](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# Exemples d'Amazon Translate utilisant des outils pour la version PowerShell 4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec Amazon Translate.
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
### `ConvertTo-TRNTargetLanguage`
L'exemple de code suivant montre comment utiliser`ConvertTo-TRNTargetLanguage`.
**Outils pour PowerShell V4**
**Exemple 1 : convertit le texte anglais spécifié en français. Le texte à convertir peut également être transmis en tant que paramètre -Text.**
```
"Hello World" | ConvertTo-TRNTargetLanguage -SourceLanguageCode en -TargetLanguageCode fr
```
+ Pour plus de détails sur l'API, reportez-vous [TranslateText](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# AWS WAFV2 exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec AWS WAFV2.
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
### `New-WAF2WebACL`
L'exemple de code suivant montre comment utiliser`New-WAF2WebACL`.
**Outils pour PowerShell V4**
**Exemple 1 : cette commande crée une nouvelle liste ACL Web nommée « waf-test ». Veuillez noter que selon la documentation de l'API du service, DefaultAction « » est une propriété obligatoire. Par conséquent, la valeur de '- DefaultAction \$1Allow' ' and/or '- DefaultAction \$1Block » doit être spécifiée. Étant donné que «- DefaultAction \$1Allow » et «- DefaultAction \$1Block » ne sont pas les propriétés requises, la valeur « @ \$1\$1 » peut être utilisée comme espace réservé, comme indiqué dans l'exemple ci-dessus.**
```
New-WAF2WebACL -Name "waf-test" -Scope REGIONAL -Region eu-west-1 -VisibilityConfig_CloudWatchMetricsEnabled $true -VisibilityConfig_SampledRequestsEnabled $true -VisibilityConfig_MetricName "waf-test" -Description "Test" -DefaultAction_Allow @{}
```
**Sortie** :
```
ARN : arn:aws:wafv2:eu-west-1:139480602983:regional/webacl/waf-test/19460b3f-db14-4b9a-8e23-a417e1eb007f
Description : Test
Id : 19460b3f-db14-4b9a-8e23-a417e1eb007f
LockToken : 5a0cd5eb-d911-4341-b313-b429e6d6b6ab
Name : waf-test
```
+ Pour plus de détails sur l'API, reportez-vous [CreateWebAcl](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
# WorkSpaces exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec WorkSpaces.
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
### `Approve-WKSIpRule`
L'exemple de code suivant montre comment utiliser`Approve-WKSIpRule`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute des règles à un groupe IP existant**
```
$Rule = @(
@{IPRule = "10.1.0.0/0"; RuleDesc = "First Rule Added"},
@{IPRule = "10.2.0.0/0"; RuleDesc = "Second Rule Added"}
)
Approve-WKSIpRule -GroupId wsipg-abcnx2fcw -UserRule $Rule
```
+ Pour plus de détails sur l'API, reportez-vous [AuthorizeIpRules](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Copy-WKSWorkspaceImage`
L'exemple de code suivant montre comment utiliser`Copy-WKSWorkspaceImage`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple copie l'image de l'espace de travail avec l'ID spécifié de us-west-2 vers la région actuelle avec le nom « » CopiedImageTest**
```
Copy-WKSWorkspaceImage -Name CopiedImageTest -SourceRegion us-west-2 -SourceImageId wsi-djfoedhw6
```
**Sortie** :
```
wsi-456abaqfe
```
+ Pour plus de détails sur l'API, reportez-vous [CopyWorkspaceImage](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-WKSClientProperty`
L'exemple de code suivant montre comment utiliser`Edit-WKSClientProperty`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active la reconnexion pour le client Workspaces**
```
Edit-WKSClientProperty -Region us-west-2 -ClientProperties_ReconnectEnabled "ENABLED" -ResourceId d-123414a369
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyClientProperties](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-WKSSelfServicePermission`
L'exemple de code suivant montre comment utiliser`Edit-WKSSelfServicePermission`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active les autorisations en libre-service pour modifier le type de calcul et augmenter la taille du volume pour le répertoire spécifié**
```
Edit-WKSSelfservicePermission -Region us-west-2 -ResourceId d-123454a369 -SelfservicePermissions_ChangeComputeType ENABLED -SelfservicePermissions_IncreaseVolumeSize ENABLED
```
+ Pour plus de détails sur l'API, reportez-vous [ModifySelfservicePermissions](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-WKSWorkspaceAccessProperty`
L'exemple de code suivant montre comment utiliser`Edit-WKSWorkspaceAccessProperty`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active l’accès à l’espace de travail sur Android et Chrome OS pour le répertoire spécifié**
```
Edit-WKSWorkspaceAccessProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceAccessProperties_DeviceTypeAndroid ALLOW -WorkspaceAccessProperties_DeviceTypeChromeOs ALLOW
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyWorkspaceAccessProperties](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-WKSWorkspaceCreationProperty`
L'exemple de code suivant montre comment utiliser`Edit-WKSWorkspaceCreationProperty`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple active l’accès à Internet et le mode de maintenance sur true comme valeurs par défaut lors de la création d’un espace de travail**
```
Edit-WKSWorkspaceCreationProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceCreationProperties_EnableInternetAccess $true -WorkspaceCreationProperties_EnableMaintenanceMode $true
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyWorkspaceCreationProperties](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-WKSWorkspaceProperty`
L'exemple de code suivant montre comment utiliser`Edit-WKSWorkspaceProperty`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple modifie la propriété Workspace Running Mode sur Auto Stop pour l’espace de travail spécifié**
```
Edit-WKSWorkspaceProperty -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceProperties_RunningMode AUTO_STOP
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyWorkspaceProperties](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Edit-WKSWorkspaceState`
L'exemple de code suivant montre comment utiliser`Edit-WKSWorkspaceState`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple fait passer l’état de l’espace de travail spécifié sur Disponible**
```
Edit-WKSWorkspaceState -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceState AVAILABLE
```
+ Pour plus de détails sur l'API, reportez-vous [ModifyWorkspaceState](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-WKSClientProperty`
L'exemple de code suivant montre comment utiliser`Get-WKSClientProperty`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient les propriétés du client de l’espace de travail pour le répertoire spécifié**
```
Get-WKSClientProperty -ResourceId d-223562a123
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeClientProperties](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-WKSIpGroup`
L'exemple de code suivant montre comment utiliser`Get-WKSIpGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple obtient les détails du groupe IP spécifié dans la région spécifiée**
```
Get-WKSIpGroup -Region us-east-1 -GroupId wsipg-8m1234v45
```
**Sortie** :
```
GroupDesc GroupId GroupName UserRules
--------- ------- --------- ---------
wsipg-8m1234v45 TestGroup {Amazon.WorkSpaces.Model.IpRuleItem, Amazon.WorkSpaces.Model.IpRuleItem}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeIpGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-WKSTag`
L'exemple de code suivant montre comment utiliser`Get-WKSTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple récupère la balise pour l’espace de travail donné**
```
Get-WKSTag -WorkspaceId ws-w361s234r -Region us-west-2
```
**Sortie** :
```
Key Value
--- -----
auto-delete no
purpose Workbench
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-WKSWorkspace`
L'exemple de code suivant montre comment utiliser`Get-WKSWorkspace`.
**Outils pour PowerShell V4**
**Exemple 1 : récupère les détails de toutes vos connexions WorkSpaces au pipeline.**
```
Get-WKSWorkspace
```
**Sortie** :
```
BundleId : wsb-1a2b3c4d
ComputerName :
DirectoryId : d-1a2b3c4d
ErrorCode :
ErrorMessage :
IpAddress :
RootVolumeEncryptionEnabled : False
State : PENDING
SubnetId :
UserName : myuser
UserVolumeEncryptionEnabled : False
VolumeEncryptionKey :
WorkspaceId : ws-1a2b3c4d
WorkspaceProperties : Amazon.WorkSpaces.Model.WorkspaceProperties
```
**Exemple 2 : cette commande affiche les valeurs des propriétés enfant de `WorkSpaceProperties` pour un espace de travail dans la région `us-west-2`. Pour plus d'informations sur les propriétés enfant de`WorkSpaceProperties`, consultez https://docs.aws.amazon.com/workspaces/ latest/api/API \$1 WorkspaceProperties .html.**
```
(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties
```
**Sortie** :
```
ComputeTypeName : STANDARD
RootVolumeSizeGib : 80
RunningMode : AUTO_STOP
RunningModeAutoStopTimeoutInMinutes : 60
UserVolumeSizeGib : 50
```
**Exemple 3 : cette commande indique la valeur de la propriété enfant `RootVolumeSizeGib` de `WorkSpaceProperties` pour un espace de travail dans la région `us-west-2`. La taille du volume racine, en GiO, est de 80.**
```
(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties.RootVolumeSizeGib
```
**Sortie** :
```
80
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-WKSWorkspaceBundle`
L'exemple de code suivant montre comment utiliser`Get-WKSWorkspaceBundle`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple récupère les détails de toutes les offres de l’espace de travail dans la région actuelle**
```
Get-WKSWorkspaceBundle
```
**Sortie** :
```
BundleId : wsb-sfhdgv342
ComputeType : Amazon.WorkSpaces.Model.ComputeType
Description : This bundle is custom
ImageId : wsi-235aeqges
LastUpdatedTime : 12/26/2019 06:44:07
Name : CustomBundleTest
Owner : 233816212345
RootStorage : Amazon.WorkSpaces.Model.RootStorage
UserStorage : Amazon.WorkSpaces.Model.UserStorage
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeWorkspaceBundles](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-WKSWorkspaceDirectory`
L'exemple de code suivant montre comment utiliser`Get-WKSWorkspaceDirectory`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple répertorie les détails des répertoires enregistrés**
```
Get-WKSWorkspaceDirectory
```
**Sortie** :
```
Alias : TestWorkspace
CustomerUserName : Administrator
DirectoryId : d-123414a369
DirectoryName : TestDirectory.com
DirectoryType : MicrosoftAD
DnsIpAddresses : {172.31.43.45, 172.31.2.97}
IamRoleId : arn:aws:iam::761234567801:role/workspaces_RoleDefault
IpGroupIds : {}
RegistrationCode : WSpdx+4RRT43
SelfservicePermissions : Amazon.WorkSpaces.Model.SelfservicePermissions
State : REGISTERED
SubnetIds : {subnet-1m3m7b43, subnet-ard11aba}
Tenancy : SHARED
WorkspaceAccessProperties : Amazon.WorkSpaces.Model.WorkspaceAccessProperties
WorkspaceCreationProperties : Amazon.WorkSpaces.Model.DefaultWorkspaceCreationProperties
WorkspaceSecurityGroupId : sg-0ed2441234a123c43
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeWorkspaceDirectories](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-WKSWorkspaceImage`
L'exemple de code suivant montre comment utiliser`Get-WKSWorkspaceImage`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple récupère tous les détails de toutes les images de la région**
```
Get-WKSWorkspaceImage
```
**Sortie** :
```
Description :This image is copied from another image
ErrorCode :
ErrorMessage :
ImageId : wsi-345ahdjgo
Name : CopiedImageTest
OperatingSystem : Amazon.WorkSpaces.Model.OperatingSystem
RequiredTenancy : DEFAULT
State : AVAILABLE
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeWorkspaceImages](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-WKSWorkspaceSnapshot`
L'exemple de code suivant montre comment utiliser`Get-WKSWorkspaceSnapshot`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple montre l’horodatage du dernier instantané créé pour l’espace de travail spécifié**
```
Get-WKSWorkspaceSnapshot -WorkspaceId ws-w361s100v
```
**Sortie** :
```
RebuildSnapshots RestoreSnapshots
---------------- ----------------
{Amazon.WorkSpaces.Model.Snapshot} {Amazon.WorkSpaces.Model.Snapshot}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeWorkspaceSnapshots](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Get-WKSWorkspacesConnectionStatus`
L'exemple de code suivant montre comment utiliser`Get-WKSWorkspacesConnectionStatus`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple récupère le statut de la connexion pour l’espace de travail spécifié**
```
Get-WKSWorkspacesConnectionStatus -WorkspaceId ws-w123s234r
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeWorkspacesConnectionStatus](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-WKSIpGroup`
L'exemple de code suivant montre comment utiliser`New-WKSIpGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : Cet exemple crée un groupe d'adresses IP vide nommé FreshEmptyIpGroup**
```
New-WKSIpGroup -GroupName "FreshNewIPGroup"
```
**Sortie** :
```
wsipg-w45rty4ty
```
+ Pour plus de détails sur l'API, reportez-vous [CreateIpGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-WKSTag`
L'exemple de code suivant montre comment utiliser`New-WKSTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple ajoute une balise à un espace de travail nommé `ws-wsname`. La balise possède une clé de « Nom » et une valeur de clé de `AWS_Workspace`.**
```
$tag = New-Object Amazon.WorkSpaces.Model.Tag
$tag.Key = "Name"
$tag.Value = "AWS_Workspace"
New-WKSTag -Region us-west-2 -WorkspaceId ws-wsname -Tag $tag
```
**Exemple 2 : cet exemple ajoute plusieurs balises à un espace de travail nommé `ws-wsname`. Une balise possède une clé « Nom » et une valeur clé de `AWS_Workspace` ; l’autre balise a une clé « Stage » et une valeur clé « Test ».**
```
$tag = New-Object Amazon.WorkSpaces.Model.Tag
$tag.Key = "Name"
$tag.Value = "AWS_Workspace"
$tag2 = New-Object Amazon.WorkSpaces.Model.Tag
$tag2.Key = "Stage"
$tag2.Value = "Test"
New-WKSTag -Region us-west-2 -WorkspaceId ws-wsname -Tag $tag,$tag2
```
+ Pour plus de détails sur l'API, reportez-vous [CreateTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `New-WKSWorkspace`
L'exemple de code suivant montre comment utiliser`New-WKSWorkspace`.
**Outils pour PowerShell V4**
**Exemple 1 : créez un WorkSpace pour le bundle, le répertoire et l'utilisateur fournis.**
```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME"}
```
**Exemple 2 : Cet exemple crée plusieurs WorkSpaces**
```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_1"},@{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_2"}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-WKSIpGroup`
L'exemple de code suivant montre comment utiliser`Register-WKSIpGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre le groupe IP spécifié dans le répertoire spécifié**
```
Register-WKSIpGroup -GroupId wsipg-23ahsdres -DirectoryId d-123412e123
```
+ Pour plus de détails sur l'API, reportez-vous [AssociateIpGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Register-WKSWorkspaceDirectory`
L'exemple de code suivant montre comment utiliser`Register-WKSWorkspaceDirectory`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple enregistre le répertoire spécifié pour le service Workspaces**
```
Register-WKSWorkspaceDirectory -DirectoryId d-123412a123 -EnableWorkDoc $false
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterWorkspaceDirectory](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-WKSIpGroup`
L'exemple de code suivant montre comment utiliser`Remove-WKSIpGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime le groupe IP spécifié**
```
Remove-WKSIpGroup -GroupId wsipg-32fhgtred
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-WKSIpGroup (DeleteIpGroup)" on target "wsipg-32fhgtred".
[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 [DeleteIpGroup](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-WKSTag`
L'exemple de code suivant montre comment utiliser`Remove-WKSTag`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple supprime la balise associée à l’espace de travail**
```
Remove-WKSTag -ResourceId ws-w10b3abcd -TagKey "Type"
```
**Sortie** :
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-WKSTag (DeleteTags)" on target "ws-w10b3abcd".
[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 [DeleteTags](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Remove-WKSWorkspace`
L'exemple de code suivant montre comment utiliser`Remove-WKSWorkspace`.
**Outils pour PowerShell V4**
**Exemple 1 : met fin à plusieurs WorkSpaces. L'utilisation du commutateur -Force empêche l'applet de commande de demander une confirmation.**
```
Remove-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0" -Force
```
**Exemple 2 : Récupère la collection de tous vos WorkSpaces et les dirige IDs vers le WorkSpaceId paramètre - de Remove-WKSWorkspace, en mettant fin à tous les. WorkSpaces L'applet de commande affiche un message avant de terminer chacune d'entre elles WorkSpace . Pour supprimer l’invite de confirmation, ajoutez le commutateur -Force.**
```
Get-WKSWorkspaces | Remove-WKSWorkspace
```
**Exemple 3 : Cet exemple montre comment transmettre TerminateRequest des objets définissant le WorkSpaces à terminer. L’applet de commande vous invitera à confirmer avant de poursuivre, à moins que l’option -Force ne soit spécifiée.**
```
$arrRequest = @()
$request1 = New-Object Amazon.WorkSpaces.Model.TerminateRequest
$request1.WorkspaceId = 'ws-12345678'
$arrRequest += $request1
$request2 = New-Object Amazon.WorkSpaces.Model.TerminateRequest
$request2.WorkspaceId = 'ws-abcdefgh'
$arrRequest += $request2
Remove-WKSWorkspace -Request $arrRequest
```
+ Pour plus de détails sur l'API, reportez-vous [TerminateWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Reset-WKSWorkspace`
L'exemple de code suivant montre comment utiliser`Reset-WKSWorkspace`.
**Outils pour PowerShell V4**
**Exemple 1 : reconstruit le fichier spécifié WorkSpace.**
```
Reset-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Exemple 2 : récupère la collection de tous vos fichiers WorkSpaces et les redirige IDs vers le WorkSpaceId paramètre - de Reset-WKSWorkspace, ce qui entraîne WorkSpaces leur reconstruction.**
```
Get-WKSWorkspaces | Reset-WKSWorkspace
```
+ Pour plus de détails sur l'API, reportez-vous [RebuildWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Restart-WKSWorkspace`
L'exemple de code suivant montre comment utiliser`Restart-WKSWorkspace`.
**Outils pour PowerShell V4**
**Exemple 1 : redémarre le paramètre spécifié WorkSpace.**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Exemple 2 : redémarre plusieurs WorkSpaces fois.**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d","ws-5a6b7c8d"
```
**Exemple 3 : récupère la collection de tous vos fichiers WorkSpaces et les redirige IDs vers le WorkSpaceId paramètre - de Restart-WKSWorkspace, provoquant le WorkSpaces redémarrage du.**
```
Get-WKSWorkspaces | Restart-WKSWorkspace
```
+ Pour plus de détails sur l'API, reportez-vous [RebootWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Stop-WKSWorkspace`
L'exemple de code suivant montre comment utiliser`Stop-WKSWorkspace`.
**Outils pour PowerShell V4**
**Exemple 1 : arrête plusieurs WorkSpaces**
```
Stop-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0"
```
**Exemple 2 : récupère la collection de tous vos WorkSpaces fichiers et les dirige IDs vers le WorkSpaceId paramètre - de Stop- WKSWorkspace provoquant WorkSpaces leur arrêt.**
```
Get-WKSWorkspaces | Stop-WKSWorkspace
```
**Exemple 3 : Cet exemple montre comment transmettre StopRequest des objets définissant le WorkSpaces à arrêter.**
```
$arrRequest = @()
$request1 = New-Object Amazon.WorkSpaces.Model.StopRequest
$request1.WorkspaceId = 'ws-12345678'
$arrRequest += $request1
$request2 = New-Object Amazon.WorkSpaces.Model.StopRequest
$request2.WorkspaceId = 'ws-abcdefgh'
$arrRequest += $request2
Stop-WKSWorkspace -Request $arrRequest
```
+ Pour plus de détails sur l'API, reportez-vous [StopWorkspaces](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
### `Unregister-WKSIpGroup`
L'exemple de code suivant montre comment utiliser`Unregister-WKSIpGroup`.
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple annule l’enregistrement du groupe IP spécifié dans le répertoire spécifié**
```
Unregister-WKSIpGroup -GroupId wsipg-12abcdphq -DirectoryId d-123454b123
```
+ Pour plus de détails sur l'API, reportez-vous [DisassociateIpGroups](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.