Version 5 (V5) von AWS -Tools für PowerShell wurde veröffentlicht\$1
Informationen zu wichtigen Änderungen und zur Migration Ihrer Anwendungen finden Sie im [Migrationsthema](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Tools für PowerShell V5-Codebeispiele
Die Codebeispiele in diesem Thema zeigen Ihnen, wie Sie AWS -Tools für PowerShell V5 mit verwenden. AWS
Bei *Grundlagen* handelt es sich um Codebeispiele, die Ihnen zeigen, wie Sie die wesentlichen Vorgänge innerhalb eines Services ausführen.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
*Szenarien* sind Codebeispiele, die Ihnen zeigen, wie Sie bestimmte Aufgaben ausführen, indem Sie mehrere Funktionen innerhalb eines Services aufrufen oder mit anderen AWS-Services kombinieren.
Einige Services enthalten zusätzliche Beispielkategorien, die zeigen, wie Bibliotheken oder dienstspezifische Funktionen genutzt werden können.
**Topics**
+ [ACM](powershell_acm_code_examples.md)
+ [Application Auto Scaling](powershell_application-auto-scaling_code_examples.md)
+ [WorkSpaces Anwendungen](powershell_appstream_code_examples.md)
+ [Aurora](powershell_aurora_code_examples.md)
+ [Auto Scaling](powershell_auto-scaling_code_examples.md)
+ [AWS Budgets](powershell_budgets_code_examples.md)
+ [AWS Cloud9](powershell_cloud9_code_examples.md)
+ [CloudFormation](powershell_cloudformation_code_examples.md)
+ [CloudFront](powershell_cloudfront_code_examples.md)
+ [CloudTrail](powershell_cloudtrail_code_examples.md)
+ [CloudWatch](powershell_cloudwatch_code_examples.md)
+ [CodeCommit](powershell_codecommit_code_examples.md)
+ [CodeDeploy](powershell_codedeploy_code_examples.md)
+ [CodePipeline](powershell_codepipeline_code_examples.md)
+ [Amazon Cognito Identity](powershell_cognito-identity_code_examples.md)
+ [AWS Config](powershell_config-service_code_examples.md)
+ [Device Farm](powershell_device-farm_code_examples.md)
+ [Directory Service](powershell_directory-service_code_examples.md)
+ [AWS DMS](powershell_database-migration-service_code_examples.md)
+ [DynamoDB](powershell_dynamodb_code_examples.md)
+ [Amazon EC2](powershell_ec2_code_examples.md)
+ [Amazon ECR](powershell_ecr_code_examples.md)
+ [Amazon ECS](powershell_ecs_code_examples.md)
+ [Amazon EFS](powershell_efs_code_examples.md)
+ [Amazon EKS](powershell_eks_code_examples.md)
+ [Elastic Load Balancing – Version 1](powershell_elastic-load-balancing_code_examples.md)
+ [Elastic Load Balancing – Version 2](powershell_elastic-load-balancing-v2_code_examples.md)
+ [Amazon FSx](powershell_fsx_code_examples.md)
+ [Amazon Glacier](powershell_glacier_code_examples.md)
+ [AWS Glue](powershell_glue_code_examples.md)
+ [AWS Health](powershell_health_code_examples.md)
+ [IAM](powershell_iam_code_examples.md)
+ [Kinesis](powershell_kinesis_code_examples.md)
+ [Lambda](powershell_lambda_code_examples.md)
+ [Amazon ML](powershell_machine-learning_code_examples.md)
+ [Macie](powershell_macie2_code_examples.md)
+ [AWS-Preisliste](powershell_pricing_code_examples.md)
+ [Resource Groups](powershell_resource-groups_code_examples.md)
+ [Resource Groups Tagging API](powershell_resource-groups-tagging-api_code_examples.md)
+ [Route 53](powershell_route-53_code_examples.md)
+ [Amazon S3](powershell_s3_code_examples.md)
+ [Security Hub CSPM](powershell_securityhub_code_examples.md)
+ [Amazon SES](powershell_ses_code_examples.md)
+ [Amazon SES API v2](powershell_sesv2_code_examples.md)
+ [Amazon SNS](powershell_sns_code_examples.md)
+ [Amazon SQS](powershell_sqs_code_examples.md)
+ [AWS STS](powershell_sts_code_examples.md)
+ [Support](powershell_support_code_examples.md)
+ [Systems Manager](powershell_ssm_code_examples.md)
+ [Amazon Translate](powershell_translate_code_examples.md)
+ [AWS WAFV2](powershell_wafv2_code_examples.md)
+ [WorkSpaces](powershell_workspaces_code_examples.md)
# ACM-Beispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit ACM Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-ACMCertificate`
Das folgende Codebeispiel zeigt die Verwendung von. `Get-ACMCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird gezeigt, wie Sie ein Zertifikat und dessen Zertifikatskette mithilfe des ARN des Zertifikats zurückgeben.**
```
Get-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
+ Einzelheiten zur API finden Sie unter [GetCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ACMCertificateDetail`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ACMCertificateDetail`
**Tools für PowerShell V5**
**Beispiel 1: Gibt Details zum angegebenen Zertifikat zurück.**
```
Get-ACMCertificateDetail -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [DescribeCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ACMCertificateList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ACMCertificateList`
**Tools für PowerShell V5**
**Beispiel 1: Ruft eine Liste aller Ihrer Zertifikate ARNs und deren Domainnamen ab. Das Cmdlet paginiert automatisch, um alle abzurufen. ARNs Um die Paginierung manuell zu steuern, verwenden Sie den MaxItem Parameter -, um zu steuern, wie viele Zertifikate für jeden Serviceaufruf zurückgegeben ARNs werden, und den NextToken Parameter -, um den Startpunkt für jeden Aufruf anzugeben.**
```
Get-ACMCertificateList
```
**Ausgabe:**
```
CertificateArn DomainName
-------------- ----------
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012 www.example.com
```
**Beispiel 2: Ruft eine Liste all Ihrer Zertifikate ab ARNs , deren Zertifikatsstatus den angegebenen Status entspricht.**
```
Get-ACMCertificateList -CertificateStatus "VALIDATION_TIMED_OUT","FAILED"
```
**Beispiel 3: Dieses Beispiel gibt eine Liste aller Zertifikate in der Region us-east-1 zurück, die den Schlüsseltyp RSA\$12048 und die erweiterte Schlüsselverwendung oder den Zweck CODE\$1SIGNING aufweisen. Die Werte für diese Filterparameter finden Sie im Referenzthema ListCertificates Filters API: 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
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListCertificates AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-ACMCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `New-ACMCertificate`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt ein neues Zertifikat. Der Service gibt den ARN des neuen Zertifikats zurück.**
```
New-ACMCertificate -DomainName "www.example.com"
```
**Ausgabe:**
```
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
```
**Beispiel 2: Erstellt ein neues Zertifikat. Der Service gibt den ARN des neuen Zertifikats zurück.**
```
New-ACMCertificate -DomainName "www.example.com" -SubjectAlternativeName "example.com","www.example.net"
```
**Ausgabe:**
```
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
```
+ Einzelheiten zur API finden Sie unter [RequestCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ACMCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ACMCertificate`
**Tools für PowerShell V5**
**Beispiel 1: Löscht das Zertifikat, das durch den angegebenen ARN und den zugehörigen privaten Schlüssel identifiziert wurde. Das Cmdlet fordert vor dem Fortfahren eine Bestätigung an, fügen Sie den Schalter -Force hinzu, um die Prompts zu unterdrücken.**
```
Remove-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
+ Einzelheiten zur API finden Sie unter [DeleteCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Send-ACMValidationEmail`
Das folgende Codebeispiel zeigt die Verwendung. `Send-ACMValidationEmail`
**Tools für PowerShell V5**
**Beispiel 1: Fordert an, dass die E-Mail zur Validierung der Eigentümerschaft der Domain „www.example.com“ gesendet wird. Wenn \$1 Ihrer Shell auf 'Medium' oder niedriger gesetzt ConfirmPreference ist, fordert das Cmdlet zur Bestätigung auf, bevor der Vorgang fortgesetzt wird. Fügen Sie den Schalter -Force hinzu, um Bestätigungsaufforderungen zu unterdrücken.**
```
$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
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([ResendValidationEmail](https://docs.aws.amazon.com/powershell/v5/reference)V5).
# Beispiele für Application Auto Scaling mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Application Auto Scaling Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-AASScalableTarget`
Das folgende Codebeispiel zeigt die Verwendung `Add-AASScalableTarget` von.
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet registriert oder aktualisiert ein skalierbares Ziel. Ein skalierbares Ziel ist eine Ressource, die dank Application Auto Scaling auf- bzw. abskaliert werden kann.**
```
Add-AASScalableTarget -ServiceNamespace AppStream -ResourceId fleet/MyFleet -ScalableDimension appstream:fleet:DesiredCapacity -MinCapacity 2 -MaxCapacity 10
```
+ Einzelheiten zur API finden Sie unter [RegisterScalableTarget AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-AASScalableTarget`
Das folgende Codebeispiel zeigt die Verwendung. `Get-AASScalableTarget`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zu den skalierbaren Zielen von Auto Scaling für Anwendungen im angegebenen Namespace bereitgestellt.**
```
Get-AASScalableTarget -ServiceNamespace "AppStream"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeScalableTargets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-AASScalingActivity`
Das folgende Codebeispiel zeigt die Verwendung. `Get-AASScalingActivity`
**Tools für PowerShell V5**
**Beispiel 1: Liefert beschreibende Informationen zu den Skalierungsaktivitäten im angegebenen Service-Namespace aus den letzten sechs Wochen.**
```
Get-AASScalingActivity -ServiceNamespace AppStream
```
**Ausgabe:**
```
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.
```
+ Einzelheiten zur API finden Sie unter [DescribeScalingActivities AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-AASScalingPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-AASScalingPolicy`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet beschreibt die Richtlinien für Application Auto Scaling für den angegebenen Service-Namespace.**
```
Get-AASScalingPolicy -ServiceNamespace AppStream
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [DescribeScalingPolicies AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-AASScheduledAction`
Das folgende Codebeispiel zeigt die Verwendung. `Get-AASScheduledAction`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet listet die für die Auto-Scaling-Gruppe geplanten Aktionen auf, die noch nicht ausgeführt wurden oder deren Endzeit noch nicht erreicht ist. **
```
Get-AASScheduledAction -ServiceNamespace AppStream
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeScheduledActions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-AASScalableTarget`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-AASScalableTarget`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet hebt die Registrierung eines skalierbaren Ziels von Application Auto Scaling auf. Durch das Aufheben der Registrierung eines skalierbaren Ziels werden die zugehörigen Skalierungsrichtlinien gelöscht.**
```
Remove-AASScalableTarget -ResourceId fleet/MyFleet -ScalableDimension appstream:fleet:DesiredCapacity -ServiceNamespace AppStream
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeregisterScalableTarget AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-AASScalingPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-AASScalingPolicy`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet löscht die angegebene Skalierungsrichtlinie für ein skalierbares Ziel von Application Auto Scaling.**
```
Remove-AASScalingPolicy -ServiceNamespace AppStream -PolicyName "default-scale-out" -ResourceId fleet/Test -ScalableDimension appstream:fleet:DesiredCapacity
```
+ Einzelheiten zur API finden Sie unter [DeleteScalingPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-AASScheduledAction`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-AASScheduledAction`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet löscht die angegebene geplante Aktion für ein skalierbares Ziel von Application Auto Scaling.**
```
Remove-AASScheduledAction -ServiceNamespace AppStream -ScheduledActionName WeekDaysFleetScaling -ResourceId fleet/MyFleet -ScalableDimension appstream:fleet:DesiredCapacity
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteScheduledAction AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-AASScalingPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Set-AASScalingPolicy`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet erstellt oder aktualisiert eine Richtlinie für ein skalierbares Ziel von Application Auto Scaling. Jedes skalierbare Ziel wird durch einen Service-Namespace, eine Ressourcen-ID und eine skalierbare Dimension identifiziert.**
```
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}
```
**Ausgabe:**
```
Alarms PolicyARN
------ ---------
{} arn:aws:autoscaling:us-west-2:012345678912:scalingPolicy:4897ca24-3caa-4bf1-8484-851a089b243c:resource/appstream/fleet/MyFleet:policyName/ASFleetScaleInPolicy
```
+ Einzelheiten zur API finden Sie unter [PutScalingPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-AASScheduledAction`
Das folgende Codebeispiel zeigt die Verwendung. `Set-AASScheduledAction`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet erstellt oder aktualisiert eine geplante Aktion für ein skalierbares Ziel von Application Auto Scaling. Jedes skalierbare Ziel wird durch einen Service-Namespace, eine Ressourcen-ID und eine skalierbare Dimension identifiziert.**
```
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
```
+ Einzelheiten zur API finden Sie unter [PutScheduledAction AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# WorkSpaces Anwendungsbeispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit WorkSpaces Anwendungen Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-APSResourceTag`
Das folgende Codebeispiel zeigt die Verwendung `Add-APSResourceTag` von.
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel fügt der Ressource ein Ressourcen-Tag hinzu AppStream **
```
Add-APSResourceTag -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest -Tag @{StackState='Test'} -Select ^Tag
```
**Ausgabe:**
```
Name Value
---- -----
StackState Test
```
+ Einzelheiten zur API finden Sie unter [TagResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Copy-APSImage`
Das folgende Codebeispiel zeigt die Verwendung. `Copy-APSImage`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Image in eine andere Region kopiert**
```
Copy-APSImage -DestinationImageName TestImageCopy -DestinationRegion us-west-2 -SourceImageName Powershell
```
**Ausgabe:**
```
TestImageCopy
```
+ Einzelheiten zur API finden Sie unter [CopyImage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Disable-APSUSer`
Das folgende Codebeispiel zeigt die Verwendung. `Disable-APSUSer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Benutzer in USERPOOL deaktiviert**
```
Disable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com
```
+ Einzelheiten zur API finden Sie unter [DisableUser AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Enable-APSUser`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-APSUser`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein deaktivierter Benutzer in USERPOOL aktiviert**
```
Enable-APSUser -AuthenticationType USERPOOL -UserName TestUser@lab.com
```
+ Einzelheiten zur API finden Sie unter [EnableUser AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-APSAssociatedFleetList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSAssociatedFleetList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die einem Stack zugeordnete Flotte angezeigt**
```
Get-APSAssociatedFleetList -StackName PowershellStack
```
**Ausgabe:**
```
PowershellFleet
```
+ Einzelheiten zur API finden Sie unter [ListAssociatedFleets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-APSAssociatedStackList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSAssociatedStackList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der einer Flotte zugeordnete Stack angezeigt**
```
Get-APSAssociatedStackList -FleetName PowershellFleet
```
**Ausgabe:**
```
PowershellStack
```
+ Einzelheiten zur API finden Sie unter [ListAssociatedStacks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-APSDirectoryConfigList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSDirectoryConfigList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Verzeichniskonfigurationen angezeigt, die in erstellt wurden AppStream**
```
Get-APSDirectoryConfigList | Select DirectoryName, OrganizationalUnitDistinguishedNames, CreatedTime
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeDirectoryConfigs AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-APSFleetList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSFleetList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details einer Flotte angezeigt**
```
Get-APSFleetList -Name Test
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeFleets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-APSImageBuilderList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSImageBuilderList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel zeigt Details eines ImageBuilder**
```
Get-APSImageBuilderList -Name TestImage
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeImageBuilders AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-APSImageList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSImageList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden private AppStream Bilder angezeigt**
```
Get-APSImageList -Type PRIVATE | select DisplayName, ImageBuilderName, Visibility, arn
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeImages AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-APSImagePermission`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSImagePermission`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Bildberechtigungen für ein geteiltes AppStream Bild angezeigt**
```
Get-APSImagePermission -Name Powershell | select SharedAccountId, @{n="AllowFleet";e={$_.ImagePermissions.AllowFleet}}, @{n="AllowImageBuilder";e={$_.ImagePermissions.AllowImageBuilder}}
```
**Ausgabe:**
```
SharedAccountId AllowFleet AllowImageBuilder
--------------- ---------- -----------------
123456789012 True True
```
+ Einzelheiten zur API finden Sie unter [DescribeImagePermissions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-APSSessionList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSSessionList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste von Sitzungen für eine Flotte angezeigt**
```
Get-APSSessionList -FleetName PowershellFleet -StackName PowershellStack
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeSessions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-APSStackList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSStackList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste von AppStream Stack angezeigt**
```
Get-APSStackList | Select DisplayName, Arn, CreatedTime
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeStacks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-APSTagsForResourceList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSTagsForResourceList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Tags auf einer AppStream Ressource angezeigt**
```
Get-APSTagsForResourceList -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest
```
**Ausgabe:**
```
Key Value
--- -----
StackState Test
```
+ Einzelheiten zur API finden Sie unter [ListTagsForResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-APSUsageReportSubscription`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSUsageReportSubscription`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden AppStreamUsageReport Konfigurationsdetails angezeigt**
```
Get-APSUsageReportSubscription
```
**Ausgabe:**
```
LastGeneratedReportDate S3BucketName Schedule SubscriptionErrors
----------------------- ------------ -------- ------------------
1/1/0001 12:00:00 AM appstream-logs-us-east-1-123456789012-sik1hnxe DAILY {}
```
+ Einzelheiten zur API finden Sie unter [DescribeUsageReportSubscriptions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-APSUser`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSUser`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste von Benutzern mit dem Status „Aktiviert“ angezeigt**
```
Get-APSUser -AuthenticationType USERPOOL | Select-Object UserName, AuthenticationType, Enabled
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeUsers AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-APSUserStackAssociation`
Das folgende Codebeispiel zeigt die Verwendung. `Get-APSUserStackAssociation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste der Benutzer angezeigt, die einem Stack zugewiesen sind**
```
Get-APSUserStackAssociation -StackName PowershellStack
```
**Ausgabe:**
```
AuthenticationType SendEmailNotification StackName UserName
------------------ --------------------- --------- --------
USERPOOL False PowershellStack TestUser1@lab.com
USERPOOL False PowershellStack TestUser2@lab.com
```
+ Einzelheiten zur API finden Sie unter [DescribeUserStackAssociations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-APSDirectoryConfig`
Das folgende Codebeispiel zeigt die Verwendung. `New-APSDirectoryConfig`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel erstellt eine Verzeichniskonfiguration in AppStream**
```
New-APSDirectoryConfig -ServiceAccountCredentials_AccountName contoso\ServiceAccount -ServiceAccountCredentials_AccountPassword MyPass -DirectoryName contoso.com -OrganizationalUnitDistinguishedName "OU=AppStream,OU=Contoso,DC=Contoso,DC=com"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateDirectoryConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-APSFleet`
Das folgende Codebeispiel zeigt die Verwendung. `New-APSFleet`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel erstellt eine neue Flotte AppStream **
```
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
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateFleet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-APSImageBuilder`
Das folgende Codebeispiel zeigt die Verwendung. `New-APSImageBuilder`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel erstellt einen Image Builder in 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
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateImageBuilder AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-APSImageBuilderStreamingURL`
Das folgende Codebeispiel zeigt die Verwendung. `New-APSImageBuilderStreamingURL`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel erstellt eine ImageBuilder Streaming-URL mit einer Gültigkeit von 2 Stunden**
```
New-APSImageBuilderStreamingURL -Name TestIB -Validity 7200 -Region us-west-2
```
**Ausgabe:**
```
Expires StreamingURL
------- ------------
12/27/2019 1:49:13 PM https://appstream2.us-west-2.aws.amazon.com/authenticate?parameters=eyJ0eXBlIjoiQURNSU4iLCJleHBpcmVzIjoiMTU3NzQ1NDU1MyIsImF3c0FjY291bnRJZCI6IjM5MzQwMzgxMTQwNyIsInVzZXJJZCI6ImFkbWluIiwiY2F
```
+ Einzelheiten zur API finden Sie unter [CreateImageBuilderStreamingURL](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5).*
### `New-APSStack`
Das folgende Codebeispiel zeigt die Verwendung. `New-APSStack`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel erstellt einen neuen Stack AppStream **
```
New-APSStack -Name TestStack -DisplayName TestStack -ApplicationSettings_Enabled $True -ApplicationSettings_SettingsGroup TestStack -Region us-west-2
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [CreateStack AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-APSStreamingURL`
Das folgende Codebeispiel zeigt die Verwendung. `New-APSStreamingURL`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Streaming-URL eines Stacks erstellt**
```
New-APSStreamingURL -StackName SessionScriptTest -FleetName SessionScriptNew -UserId TestUser
```
**Ausgabe:**
```
Expires StreamingURL
------- ------------
12/27/2019 12:43:37 PM https://appstream2.us-east-1.aws.amazon.com/authenticate?parameters=eyJ0eXBlIjoiRU5EX1VTRVIiLCJleHBpcmVzIjoiMTU3NzQ1MDYxNyIsImF3c0FjY291bnRJZCI6IjM5MzQwMzgxMTQwNyIsInVzZXJJZCI6IlRlc3RVc2
```
+ Einzelheiten zur API finden Sie unter [CreateStreamingURL](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `New-APSUsageReportSubscription`
Das folgende Codebeispiel zeigt die Verwendung. `New-APSUsageReportSubscription`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden AppStream Nutzungsberichte aktiviert**
```
New-APSUsageReportSubscription
```
**Ausgabe:**
```
S3BucketName Schedule
------------ --------
appstream-logs-us-east-1-123456789012-sik2hnxe DAILY
```
+ Einzelheiten zur API finden Sie unter [CreateUsageReportSubscription AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-APSUser`
Das folgende Codebeispiel zeigt die Verwendung. `New-APSUser`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Benutzer in USERPOOL erstellt**
```
New-APSUser -UserName Test@lab.com -AuthenticationType USERPOOL -FirstName 'kt' -LastName 'aws' -Select ^UserName
```
**Ausgabe:**
```
Test@lab.com
```
+ Einzelheiten zur API finden Sie unter [CreateUser AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-APSFleet`
Das folgende Codebeispiel zeigt die Verwendung. `Register-APSFleet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Flotte bei einem Stack registriert**
```
Register-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2
```
+ Einzelheiten zur API finden Sie unter [AssociateFleet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-APSUserStackBatch`
Das folgende Codebeispiel zeigt die Verwendung. `Register-APSUserStackBatch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird einem Benutzer in USERPOOL ein Stack zugewiesen**
```
Register-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="TestUser1@lab.com"}
```
+ Einzelheiten zur API finden Sie unter [BatchAssociateUserStack AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-APSDirectoryConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-APSDirectoryConfig`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die AppStream Verzeichniskonfiguration entfernt**
```
Remove-APSDirectoryConfig -DirectoryName contoso.com
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteDirectoryConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Remove-APSFleet`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-APSFleet`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel entfernt und löscht eine Flotte AppStream **
```
Remove-APSFleet -Name TestFleet -Region us-west-2
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteFleet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-APSImage`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-APSImage`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Image gelöscht**
```
Remove-APSImage -Name TestImage -Region us-west-2
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteImage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-APSImageBuilder`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-APSImageBuilder`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel löscht ein ImageBuilder**
```
Remove-APSImageBuilder -Name TestIB -Region us-west-2
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteImageBuilder AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-APSImagePermission`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-APSImagePermission`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Berechtigungen eines Images entfernt**
```
Remove-APSImagePermission -Name Powershell -SharedAccountId 123456789012
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteImagePermissions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-APSResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-APSResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel entfernt ein Ressourcen-Tag aus AppStream einer Ressource**
```
Remove-APSResourceTag -ResourceArn arn:aws:appstream:us-east-1:123456789012:stack/SessionScriptTest -TagKey StackState
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UntagResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Remove-APSStack`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-APSStack`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Stack gelöscht**
```
Remove-APSStack -Name TestStack -Region us-west-2
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteStack AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-APSUsageReportSubscription`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-APSUsageReportSubscription`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Abonnement für AppStream Nutzungsberichte deaktiviert**
```
Remove-APSUsageReportSubscription
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteUsageReportSubscription AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-APSUser`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-APSUser`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Benutzer aus USERPOOL gelöscht**
```
Remove-APSUser -UserName TestUser@lab.com -AuthenticationType USERPOOL
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteUser AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Revoke-APSSession`
Das folgende Codebeispiel zeigt die Verwendung. `Revoke-APSSession`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel widerruft eine Sitzung für Fleet AppStream **
```
Revoke-APSSession -SessionId 6cd2f9a3-f948-4aa1-8014-8a7dcde14877
```
+ Einzelheiten zur API finden Sie unter [ExpireSession AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Start-APSFleet`
Das folgende Codebeispiel zeigt die Verwendung. `Start-APSFleet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Flotte gestartet**
```
Start-APSFleet -Name PowershellFleet
```
+ Einzelheiten zur API finden Sie unter [StartFleet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Start-APSImageBuilder`
Das folgende Codebeispiel zeigt die Verwendung. `Start-APSImageBuilder`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel startet ein ImageBuilder**
```
Start-APSImageBuilder -Name TestImage
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [StartImageBuilder AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Stop-APSFleet`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-APSFleet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Flotte gestoppt**
```
Stop-APSFleet -Name PowershellFleet
```
+ Einzelheiten zur API finden Sie unter [StopFleet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Stop-APSImageBuilder`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-APSImageBuilder`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel stoppt einen ImageBuilder**
```
Stop-APSImageBuilder -Name TestImage
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [StopImageBuilder AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Unregister-APSFleet`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-APSFleet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Registrierung einer Flotte vom Stack aufgehoben**
```
Unregister-APSFleet -StackName TestStack -FleetName TestFleet -Region us-west-2
```
+ Einzelheiten zur API finden Sie unter [DisassociateFleet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-APSUserStackBatch`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-APSUserStackBatch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Benutzer aus einem zugewiesenen Stack entfernt**
```
Unregister-APSUserStackBatch -UserStackAssociation @{AuthenticationType="USERPOOL";SendEmailNotification=$False;StackName="PowershellStack";UserName="TestUser1@lab.com"}
```
+ Einzelheiten zur API finden Sie unter [BatchDisassociateUserStack AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-APSDirectoryConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Update-APSDirectoryConfig`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel aktualisiert die Verzeichniskonfiguration, die in erstellt wurde AppStream**
```
Update-APSDirectoryConfig -ServiceAccountCredentials_AccountName contoso\ServiceAccount -ServiceAccountCredentials_AccountPassword MyPass@1$@# -DirectoryName contoso.com -OrganizationalUnitDistinguishedName "OU=AppStreamNew,OU=Contoso,DC=Contoso,DC=com"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UpdateDirectoryConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Update-APSFleet`
Das folgende Codebeispiel zeigt die Verwendung. `Update-APSFleet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Eigenschaften einer Flotte aktualisiert**
```
Update-APSFleet -Name PowershellFleet -EnableDefaultInternetAccess $True -DisconnectTimeoutInSecond 950
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UpdateFleet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-APSImagePermission`
Das folgende Codebeispiel zeigt die Verwendung. `Update-APSImagePermission`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel teilt ein AppStream Bild mit einem anderen Konto**
```
Update-APSImagePermission -Name Powershell -SharedAccountId 123456789012 -ImagePermissions_AllowFleet $True -ImagePermissions_AllowImageBuilder $True
```
+ Einzelheiten zur API finden Sie unter [UpdateImagePermissions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Update-APSStack`
Das folgende Codebeispiel zeigt die Verwendung. `Update-APSStack`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Persistenz der Anwendungseinstellungen und die Basisordner auf einem Stack aktualisiert (aktiviert) **
```
Update-APSStack -Name PowershellStack -ApplicationSettings_Enabled $True -ApplicationSettings_SettingsGroup PowershellStack -StorageConnector @{ConnectorType="HOMEFOLDERS"}
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [UpdateStack AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Aurora-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe der AWS -Tools für PowerShell V5 mit Aurora Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-RDSOrderableDBInstanceOption`
Das folgende Codebeispiel zeigt die Verwendung `Get-RDSOrderableDBInstanceOption` von.
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel listet die DB-Engine-Versionen auf, die eine bestimmte DB-Instance-Klasse in einer AWS-Region unterstützen.**
```
$params = @{
Engine = 'aurora-postgresql'
DBInstanceClass = 'db.r5.large'
Region = 'us-east-1'
}
Get-RDSOrderableDBInstanceOption @params
```
**Beispiel 2: Dieses Beispiel listet die DB-Instance-Klassen auf, die von einer bestimmten DB-Engine-Version in einer AWS-Region unterstützt werden.**
```
$params = @{
Engine = 'aurora-postgresql'
EngineVersion = '13.6'
Region = 'us-east-1'
}
Get-RDSOrderableDBInstanceOption @params
```
+ Einzelheiten zur API finden Sie unter [DescribeOrderableDBInstanceOptionen](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
# Auto Scaling Scaling-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe der AWS -Tools für PowerShell V5 mit Auto Scaling Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-ASLoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung `Add-ASLoadBalancer` von.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Load Balancer an die spezifizierte Auto-Scaling-Gruppe hinzugefügt.**
```
Add-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg
```
+ Einzelheiten zur API finden Sie unter [AttachLoadBalancers AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Complete-ASLifecycleAction`
Das folgende Codebeispiel zeigt die Verwendung. `Complete-ASLifecycleAction`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Lebenszyklusaktion abgeschlossen.**
```
Complete-ASLifecycleAction -LifecycleHookName myLifecycleHook -AutoScalingGroupName my-asg -LifecycleActionResult CONTINUE -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635
```
+ Einzelheiten zur API finden Sie unter [CompleteLifecycleAction AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Disable-ASMetricsCollection`
Das folgende Codebeispiel zeigt die Verwendung. `Disable-ASMetricsCollection`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Überwachung der angegebenen Metriken für die spezifizierten Auto-Scaling-Gruppe deaktiviert.**
```
Disable-ASMetricsCollection -AutoScalingGroupName my-asg -Metric @("GroupMinSize", "GroupMaxSize")
```
**Beispiel 2: In diesem Beispiel wird die Überwachung aller Metriken für die angegebene Auto-Scaling-Gruppe deaktiviert.**
```
Disable-ASMetricsCollection -AutoScalingGroupName my-asg
```
+ Einzelheiten zur API finden Sie unter [DisableMetricsCollection AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Dismount-ASInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Dismount-ASInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Instance von der angegebenen Auto-Scaling-Gruppe getrennt und die gewünschte Kapazität verringert, sodass Auto Scaling keine Ersatz-Instance startet.**
```
Dismount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true
```
**Ausgabe:**
```
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 :
```
**Beispiel 2: In diesem Beispiel wird die angegebene Instance von der angegebenen Auto-Scaling-Gruppe getrennt, ohne die gewünschte Kapazität zu verringern. Auto Scaling startet eine neue Ersatz-Instance.**
```
Dismount-ASInstance -InstanceId i-7bf746a2 -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [DetachInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Dismount-ASLoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `Dismount-ASLoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Load Balancer von der spezifizierten Auto-Scaling-Gruppe getrennt.**
```
Dismount-ASLoadBalancer -LoadBalancerName my-lb -AutoScalingGroupName my-asg
```
+ Einzelheiten zur API finden Sie unter [DetachLoadBalancers AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Enable-ASMetricsCollection`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-ASMetricsCollection`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Überwachung der angegebenen Metriken für die angegebene Auto-Scaling-Gruppe aktiviert.**
```
Enable-ASMetricsCollection -Metric @("GroupMinSize", "GroupMaxSize") -AutoScalingGroupName my-asg -Granularity 1Minute
```
**Beispiel 2: In diesem Beispiel wird eine Überwachung aller Metriken der angegebenen Auto-Scaling-Gruppe aktiviert.**
```
Enable-ASMetricsCollection -AutoScalingGroupName my-asg -Granularity 1Minute
```
+ Einzelheiten zur API finden Sie unter [EnableMetricsCollection AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Enter-ASStandby`
Das folgende Codebeispiel zeigt die Verwendung. `Enter-ASStandby`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Instance in den Standby-Modus versetzt und die gewünschte Kapazität verringert, sodass Auto Scaling keine Ersatz-Instance startet.**
```
Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $true
```
**Ausgabe:**
```
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 :
```
**Beispiel 2: In diesem Beispiel wird die angegebene Instance in den Standby-Modus versetzt, ohne die gewünschte Kapazität zu verringern. Auto Scaling startet eine neue Ersatz-Instance.**
```
Enter-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg -ShouldDecrementDesiredCapacity $false
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [EnterStandby AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Exit-ASStandby`
Das folgende Codebeispiel zeigt die Verwendung. `Exit-ASStandby`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Instance aus dem Standby-Modus verschoben.**
```
Exit-ASStandby -InstanceId i-93633f9b -AutoScalingGroupName my-asg
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [ExitStandby AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASAccountLimit`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASAccountLimit`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Auto Scaling Scaling-Ressourcenlimits für Ihr AWS Konto beschrieben.**
```
Get-ASAccountLimit
```
**Ausgabe:**
```
MaxNumberOfAutoScalingGroups : 20
MaxNumberOfLaunchConfigurations : 100
```
+ Einzelheiten zur API finden Sie unter [DescribeAccountLimits AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-ASAdjustmentType`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASAdjustmentType`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Anpassungstypen beschrieben, die von Auto Scaling unterstützt werden.**
```
Get-ASAdjustmentType
```
**Ausgabe:**
```
Type
----
ChangeInCapacity
ExactCapacity
PercentChangeInCapacity
```
+ Einzelheiten zur API finden Sie unter [DescribeAdjustmentTypes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASAutoScalingGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASAutoScalingGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Namen Ihrer Auto-Scaling-Gruppen aufgeführt.**
```
Get-ASAutoScalingGroup | format-table -property AutoScalingGroupName
```
**Ausgabe:**
```
AutoScalingGroupName
--------------------
my-asg-1
my-asg-2
my-asg-3
my-asg-4
my-asg-5
my-asg-6
```
**Beispiel 2: In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe beschrieben.**
```
Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1
```
**Ausgabe:**
```
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
```
**Beispiel 3: In diesem Beispiel werden die angegebenen zwei Auto-Scaling-Gruppen beschrieben.**
```
Get-ASAutoScalingGroup -AutoScalingGroupName @("my-asg-1", "my-asg-2")
```
**Beispiel 4: Dieses Beispiel beschreibt die Auto Scaling-Instances für die angegebene Auto-Scaling-Gruppe.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-asg-1).Instances
```
**Beispiel 5: In diesem Beispiel werden alle Ihre Auto-Scaling-Gruppen beschrieben.**
```
Get-ASAutoScalingGroup
```
**Beispiel 6: Dieses LaunchTemplate Beispiel beschreibt die angegebene Auto Scaling Scaling-Gruppe. In diesem Beispiel wird davon ausgegangen, dass die Option „Instance-Kaufoptionen“ auf „Startvorlage beachten“ eingestellt ist. Falls diese Option auf „Kaufoptionen und Instanztypen kombinieren“ gesetzt ist, LaunchTemplate kann mit "darauf zugegriffen werdenMixedInstancesPolicy. LaunchTemplate„-Eigenschaft.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-ag-1).LaunchTemplate
```
**Ausgabe:**
```
LaunchTemplateId LaunchTemplateName Version
---------------- ------------------ -------
lt-06095fd619cb40371 test-launch-template $Default
```
+ Einzelheiten zur API finden Sie unter [DescribeAutoScalingGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-ASAutoScalingInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASAutoScalingInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Ihre Auto Scaling Scaling-Instances aufgeführt. IDs **
```
Get-ASAutoScalingInstance | format-table -property InstanceId
```
**Ausgabe:**
```
InstanceId
----------
i-12345678
i-87654321
i-abcd1234
```
**Beispiel 2: In diesem Beispiel wird die angegebene Auto-Scaling-Instance beschrieben.**
```
Get-ASAutoScalingInstance -InstanceId i-12345678
```
**Ausgabe:**
```
AutoScalingGroupName : my-asg
AvailabilityZone : us-west-2b
HealthStatus : HEALTHY
InstanceId : i-12345678
LaunchConfigurationName : my-lc
LifecycleState : InService
```
**Beispiel 3: In diesem Beispiel werden die angegebenen zwei Auto-Scaling-Instances beschrieben.**
```
Get-ASAutoScalingInstance -InstanceId @("i-12345678", "i-87654321")
```
**Beispiel 4: Dieses Beispiel beschreibt die Auto Scaling-Instances für die angegebene Auto-Scaling-Gruppe.**
```
(Get-ASAutoScalingGroup -AutoScalingGroupName my-asg).Instances | Get-ASAutoScalingInstance
```
**Beispiel 5: In diesem Beispiel werden alle Ihre Auto-Scaling-Instances beschrieben.**
```
Get-ASAutoScalingInstance
```
+ Einzelheiten zur API finden Sie unter [DescribeAutoScalingInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-ASAutoScalingNotificationType`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASAutoScalingNotificationType`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Benachrichtigungstypen aufgeführt, die von Auto Scaling unterstützt werden.**
```
Get-ASAutoScalingNotificationType
```
**Ausgabe:**
```
autoscaling:EC2_INSTANCE_LAUNCH
autoscaling:EC2_INSTANCE_LAUNCH_ERROR
autoscaling:EC2_INSTANCE_TERMINATE
autoscaling:EC2_INSTANCE_TERMINATE_ERROR
autoscaling:TEST_NOTIFICATION
```
+ Einzelheiten zur API finden Sie unter [DescribeAutoScalingNotificationTypes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASLaunchConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASLaunchConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Namen Ihrer Startkonfigurationen aufgeführt.**
```
Get-ASLaunchConfiguration | format-table -property LaunchConfigurationName
```
**Ausgabe:**
```
LaunchConfigurationName
-----------------------
my-lc-1
my-lc-2
my-lc-3
my-lc-4
my-lc-5
```
**Beispiel 2: In diesem Beispiel wird die angegebene Startkonfiguration beschrieben.**
```
Get-ASLaunchConfiguration -LaunchConfigurationName my-lc-1
```
**Ausgabe:**
```
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 :
```
**Beispiel 3: In diesem Beispiel werden die beiden angegebenen Startkonfigurationen beschrieben.**
```
Get-ASLaunchConfiguration -LaunchConfigurationName @("my-lc-1", "my-lc-2")
```
**Beispiel 4: In diesem Beispiel werden alle Ihre Startkonfigurationen beschrieben.**
```
Get-ASLaunchConfiguration
```
+ Einzelheiten zur API finden Sie unter [DescribeLaunchConfigurations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASLifecycleHook`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASLifecycleHook`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Lebenszyklus-Hook beschrieben.**
```
Get-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle Lebenszyklus-Hooks für die angegebene Auto-Scaling-Gruppe beschrieben.**
```
Get-ASLifecycleHook -AutoScalingGroupName my-asg
```
**Beispiel 3: In diesem Beispiel werden alle Lebenszyklus-Hooks für alle Ihre Auto-Scaling-Gruppen beschrieben.**
```
Get-ASLifecycleHook
```
+ Einzelheiten zur API finden Sie unter [DescribeLifecycleHooks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASLifecycleHookType`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASLifecycleHookType`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die von Auto Scaling unterstützten Typen von Lebenszyklus-Hooks aufgeführt.**
```
Get-ASLifecycleHookType
```
**Ausgabe:**
```
autoscaling:EC2_INSTANCE_LAUNCHING
auto-scaling:EC2_INSTANCE_TERMINATING
```
+ Einzelheiten zur API finden Sie unter [DescribeLifecycleHookTypes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASLoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASLoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Load Balancers für die angegebene Auto-Scaling-Gruppebeschrieben.**
```
Get-ASLoadBalancer -AutoScalingGroupName my-asg
```
**Ausgabe:**
```
LoadBalancerName State
---------------- -----
my-lb Added
```
+ Einzelheiten zur API finden Sie unter [DescribeLoadBalancers AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASMetricCollectionType`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASMetricCollectionType`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Arten der Metrikerfassung aufgeführt, die von Auto Scaling unterstützt werden.**
```
(Get-ASMetricCollectionType).Metrics
```
**Ausgabe:**
```
Metric
------
GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupTerminatingInstances
GroupStandbyInstances
GroupTotalInstances
```
**Beispiel 2: In diesem Beispiel werden die entsprechenden Granularitäten aufgeführt.**
```
(Get-ASMetricCollectionType).Granularities
```
**Ausgabe:**
```
Granularity
-----------
1Minute
```
+ Einzelheiten zur API finden Sie unter [DescribeMetricCollectionTypes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASNotificationConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASNotificationConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel beschreibt die Benachrichtigungsaktionen, die der angegebenen Auto Scaling-Gruppe zugewiesen sind.**
```
Get-ASNotificationConfiguration -AutoScalingGroupName my-asg | format-list
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden die Benachrichtigungsaktionen beschrieben, die allen Ihren Auto-Scaling-Gruppen zugewiesen sind.**
```
Get-ASNotificationConfiguration
```
+ Einzelheiten zur API finden Sie unter [DescribeNotificationConfigurations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Richtlinien für die angegebene Auto-Scaling-Gruppe beschrieben.**
```
Get-ASPolicy -AutoScalingGroupName my-asg
```
**Ausgabe:**
```
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 : {}
```
**Beispiel 2: In diesem Beispiel werden die angegebenen Richtlinien für die angegebene Auto-Scaling-Gruppe beschrieben.**
```
Get-ASPolicy -AutoScalingGroupName my-asg -PolicyName @("myScaleOutPolicy", "myScaleInPolicy")
```
**Beispiel 3: In diesem Beispiel werden alle Richtlinien für all Ihre Auto-Scaling-Gruppen beschrieben.**
```
Get-ASPolicy
```
+ Einzelheiten zur API finden Sie unter [DescribePolicies AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASScalingActivity`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASScalingActivity`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Skalierungsaktivitäten der letzten sechs Wochen für die angegebene Auto-Scaling-Gruppe beschrieben.**
```
Get-ASScalingActivity -AutoScalingGroupName my-asg
```
**Ausgabe:**
```
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 :
```
**Beispiel 2: In diesem Beispiel wird die angegebene Skalierungsaktivität beschrieben.**
```
Get-ASScalingActivity -ActivityId "063308ae-aa22-4a9b-94f4-9fae4EXAMPLE"
```
**Beispiel 3: In diesem Beispiel werden die Skalierungsaktivitäten der letzten sechs Wochen für all Ihre Auto-Scaling-Gruppen beschrieben.**
```
Get-ASScalingActivity
```
+ Einzelheiten zur API finden Sie unter [DescribeScalingActivities AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASScalingProcessType`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASScalingProcessType`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Prozesstypen aufgelistet, die von Auto Scaling unterstützt werden.**
```
Get-ASScalingProcessType
```
**Ausgabe:**
```
ProcessName
-----------
AZRebalance
AddToLoadBalancer
AlarmNotification
HealthCheck
Launch
ReplaceUnhealthy
ScheduledActions
Terminate
```
+ Einzelheiten zur API finden Sie unter [DescribeScalingProcessTypes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASScheduledAction`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASScheduledAction`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die geplanten Skalierungsaktionen für die angegebene Auto-Scaling-Gruppe beschrieben.**
```
Get-ASScheduledAction -AutoScalingGroupName my-asg
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden die angegebenen geplanten Skalierungsaktionen beschrieben.**
```
Get-ASScheduledAction -ScheduledActionName @("myScheduledScaleOut", "myScheduledScaleIn")
```
**Beispiel 3: In diesem Beispiel werden die geplanten Skalierungsaktionen beschrieben, die zur angegebenen Zeit beginnen.**
```
Get-ASScheduledAction -StartTime "2015-12-01T08:00:00Z"
```
**Beispiel 4: In diesem Beispiel werden die geplanten Skalierungsaktionen beschrieben, die zur angegebenen Zeit enden.**
```
Get-ASScheduledAction -EndTime "2015-12-30T08:00:00Z"
```
**Beispiel 5: In diesem Beispiel werden die geplanten Skalierungsaktionen für alle Ihre Auto-Scaling-Gruppen beschrieben.**
```
Get-ASScheduledAction
```
+ Einzelheiten zur API finden Sie unter [DescribeScheduledActions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASTag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Tags mit dem Schlüsselwert „myTag“ oder „myTag2“ beschrieben. Die möglichen Werte für den Filternamen sind 'auto-scaling-group', 'Schlüssel', 'Wert' und propagate-at-launch '. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
Get-ASTag -Filter @( @{ Name="key"; Values=@("myTag", "myTag2") } )
```
**Ausgabe:**
```
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
```
**Beispiel 2: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um den Filter für den Filter-Parameter zu erstellen.**
```
$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 )
```
**Beispiel 3: In diesem Beispiel werden alle Tags für alle Ihre Auto-Scaling-Gruppen beschrieben.**
```
Get-ASTag
```
+ Einzelheiten zur API finden Sie unter [DescribeTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-ASTerminationPolicyType`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASTerminationPolicyType`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Beendigungsrichtlinien aufgeführt, die von Auto Scaling unterstützt werden.**
```
Get-ASTerminationPolicyType
```
**Ausgabe:**
```
ClosestToNextInstanceHour
Default
NewestInstance
OldestInstance
OldestLaunchConfiguration
```
+ Einzelheiten zur API finden Sie unter [DescribeTerminationPolicyTypes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Mount-ASInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Mount-ASInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Instance an die spezifizierte Auto-Scaling-Gruppe hinzugefügt. Auto Scaling erhöht automatisch die gewünschte Kapazität der Auto-Scaling-Gruppe.**
```
Mount-ASInstance -InstanceId i-93633f9b -AutoScalingGroupName my-asg
```
+ Einzelheiten zur API finden Sie unter [AttachInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ASAutoScalingGroup`
Das folgende Codebeispiel zeigt die Verwendung. `New-ASAutoScalingGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Auto-Scaling-Gruppe mit dem angegebenen Namen und den angegebenen Attributen erstellt. Die standardmäßige gewünschte Kapazität entspricht der minimalen Größe. Daher startet diese Auto-Scaling-Gruppe zwei Instances – jeweils eine in jeder der angegebenen beiden Availability Zones.**
```
New-ASAutoScalingGroup -AutoScalingGroupName my-asg -LaunchConfigurationName my-lc -MinSize 2 -MaxSize 6 -AvailabilityZone @("us-west-2a", "us-west-2b")
```
+ Einzelheiten zur API finden Sie unter [CreateAutoScalingGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ASLaunchConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `New-ASLaunchConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Startkonfiguration mit dem Namen „my-lc“ erstellt. Die von Auto Scaling Scaling-Gruppen gestarteten EC2 Instances, die diese Startkonfiguration verwenden, verwenden den angegebenen Instance-Typ, das angegebene AMI, die Sicherheitsgruppe und die IAM-Rolle.**
```
New-ASLaunchConfiguration -LaunchConfigurationName my-lc -InstanceType "m3.medium" -ImageId "ami-12345678" -SecurityGroup "sg-12345678" -IamInstanceProfile "myIamRole"
```
+ Einzelheiten zur API finden Sie unter [CreateLaunchConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ASAutoScalingGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ASAutoScalingGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe gelöscht, sofern keine Instances ausgeführt werden. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg
```
**Ausgabe:**
```
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"):
```
**Beispiel 2: Wenn Sie den Force-Parameter angeben, werden Sie vor der Ausführung des Vorgangs nicht zur Bestätigung aufgefordert.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -Force
```
**Beispiel 3: In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe gelöscht und alle ausgeführten Instances, die sie enthält, werden beendet.**
```
Remove-ASAutoScalingGroup -AutoScalingGroupName my-asg -ForceDelete $true -Force
```
+ Einzelheiten zur API finden Sie unter [DeleteAutoScalingGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ASLaunchConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ASLaunchConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Startkonfiguration gelöscht, sofern sie nicht einer Auto-Scaling-Gruppe zugewiesen ist. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird.**
```
Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc
```
**Ausgabe:**
```
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"):
```
**Beispiel 2: Wenn Sie den Force-Parameter angeben, werden Sie vor der Ausführung des Vorgangs nicht zur Bestätigung aufgefordert.**
```
Remove-ASLaunchConfiguration -LaunchConfigurationName my-lc -Force
```
+ Einzelheiten zur API finden Sie unter [DeleteLaunchConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ASLifecycleHook`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ASLifecycleHook`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Lebenszyklus-Hook für die spezifizierte Auto-Scaling-Gruppe gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird.**
```
Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook
```
**Ausgabe:**
```
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"):
```
**Beispiel 2: Wenn Sie den Force-Parameter angeben, werden Sie vor der Ausführung des Vorgangs nicht zur Bestätigung aufgefordert.**
```
Remove-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -Force
```
+ Einzelheiten zur API finden Sie unter [DeleteLifecycleHook AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ASNotificationConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ASNotificationConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Benachrichtigungsaktion gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird.**
```
Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
**Ausgabe:**
```
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"):
```
**Beispiel 2: Wenn Sie den Force-Parameter angeben, werden Sie vor der Ausführung des Vorgangs nicht zur Bestätigung aufgefordert.**
```
Remove-ASNotificationConfiguration -AutoScalingGroupName my-asg -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic" -Force
```
+ Einzelheiten zur API finden Sie unter [DeleteNotificationConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ASPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ASPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Richtlinie für die spezifizierte Auto-Scaling-Gruppe gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird.**
```
Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy
```
**Ausgabe:**
```
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"):
```
**Beispiel 2: Wenn Sie den Force-Parameter angeben, werden Sie vor der Ausführung des Vorgangs nicht zur Bestätigung aufgefordert.**
```
Remove-ASPolicy -AutoScalingGroupName my-asg -PolicyName myScaleInPolicy -Force
```
+ Einzelheiten zur API finden Sie unter [DeletePolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ASScheduledAction`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ASScheduledAction`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene geplante Aktion für die spezifizierte Auto-Scaling-Gruppe gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird.**
```
Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction"
```
**Ausgabe:**
```
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"):
```
**Beispiel 2: Wenn Sie den Force-Parameter angeben, werden Sie vor der Ausführung des Vorgangs nicht zur Bestätigung aufgefordert.**
```
Remove-ASScheduledAction -AutoScalingGroupName my-asg -ScheduledAction "myScheduledAction" -Force
```
+ Einzelheiten zur API finden Sie unter [DeleteScheduledAction AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ASTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ASTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Tag der spezifizierten Auto-Scaling-Gruppe entfernt. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } )
```
**Ausgabe:**
```
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"):
```
**Beispiel 2: Wenn Sie den Force-Parameter angeben, werden Sie vor der Ausführung des Vorgangs nicht zur Bestätigung aufgefordert.**
```
Remove-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag" } ) -Force
```
**Beispiel 4: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um das Tag für den Tag-Parameter zu erstellen.**
```
$tag = New-Object Amazon.AutoScaling.Model.Tag
$tag.ResourceType = "auto-scaling-group"
$tag.ResourceId = "my-asg"
$tag.Key = "myTag"
Remove-ASTag -Tag $tag -Force
```
+ Einzelheiten zur API finden Sie unter [DeleteTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Resume-ASProcess`
Das folgende Codebeispiel zeigt die Verwendung. `Resume-ASProcess`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Auto-Scaling-Prozess für die spezifizierte Auto-Scaling-Gruppe fortgesetzt.**
```
Resume-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification"
```
**Beispiel 2: In diesem Beispiel werden alle ausgesetzten Auto-Scaling-Prozesse für die angegebene Auto-Scaling-Gruppe fortgesetzt.**
```
Resume-ASProcess -AutoScalingGroupName my-asg
```
+ Einzelheiten zur API finden Sie unter [ResumeProcesses AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-ASDesiredCapacity`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ASDesiredCapacity`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Größe der angegebenen Auto-Scaling-Gruppe angegeben.**
```
Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2
```
**Beispiel 2: In diesem Beispiel wird die Größe der angegebenen Auto-Scaling-Gruppe angegeben und gewartet, bis die Ruhephase abgeschlossen ist, bevor auf die neue Größe skaliert wird.**
```
Set-ASDesiredCapacity -AutoScalingGroupName my-asg -DesiredCapacity 2 -HonorCooldown $true
```
+ Einzelheiten zur API finden Sie unter [SetDesiredCapacity AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-ASInstanceHealth`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ASInstanceHealth`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Status der angegebenen Instance auf „Fehlerhaft“ gesetzt, wodurch sie außer Betrieb genommen wird. Auto Scaling beendet und ersetzt die Instance.**
```
Set-ASInstanceHealth -HealthStatus Unhealthy -InstanceId i-93633f9b
```
**Beispiel 2: In diesem Beispiel wird der Status der angegebenen Instance auf „Fehlerfrei“ gesetzt, sodass sie weiterhin in Betrieb bleibt. Legen Sie die Wartefrist für die Zustandsprüfung einer Auto-Scaling-Gruppe fest.**
```
Set-ASInstanceHealth -HealthStatus Healthy -InstanceId i-93633f9b -ShouldRespectGracePeriod $false
```
+ Einzelheiten zur API finden Sie unter [SetInstanceHealth AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-ASInstanceProtection`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ASInstanceProtection`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Instance-Schutz für die angegebene Instance aktiviert.**
```
Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $true
```
**Beispiel 2: In diesem Beispiel wird der Instance-Schutz für die angegebene Instanz deaktiviert.**
```
Set-ASInstanceProtection -AutoScalingGroupName my-asg -InstanceId i-12345678 -ProtectedFromScaleIn $false
```
+ Einzelheiten zur API finden Sie unter [SetInstanceProtection AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-ASTag`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ASTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebenen Auto-Scaling-Gruppe ein einzelnes Tag hinzugefügt. Der Tag-Schlüssel ist 'myTag' und der Tag-Wert ist ''myTagValue. Auto Scaling gibt dieses Tag an die nachfolgenden EC2 Instances weiter, die von der Auto Scaling Scaling-Gruppe gestartet werden. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
Set-ASTag -Tag @( @{ResourceType="auto-scaling-group"; ResourceId="my-asg"; Key="myTag"; Value="myTagValue"; PropagateAtLaunch=$true} )
```
**Beispiel 2: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um das Tag für den Tag-Parameter zu erstellen.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [CreateOrUpdateTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Start-ASPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Start-ASPolicy`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel führt die angegebene Richtlinie für die spezifizierte Auto-Scaling-Gruppe aus.**
```
Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy"
```
**Beispiel 2: In diesem Beispiel wird die angegebene Richtlinie für die spezifizierte Auto-Scaling-Gruppe ausgeführt, nachdem die Wartezeit abgelaufen ist.**
```
Start-ASPolicy -AutoScalingGroupName my-asg -PolicyName "myScaleInPolicy" -HonorCooldown $true
```
+ Einzelheiten zur API finden Sie unter [ExecutePolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Stop-ASInstanceInAutoScalingGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-ASInstanceInAutoScalingGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Instance beendet und die gewünschte Kapazität ihrer Auto-Scaling-Gruppe reduziert, sodass Auto Scaling keine Ersatz-Instance startet.**
```
Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $true
```
**Ausgabe:**
```
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 :
```
**Beispiel 2: In diesem Beispiel wird die angegebene Instance beendet, ohne die gewünschte Kapazität ihrer Auto Scaling-Gruppe zu reduzieren. Auto Scaling startet eine neue Ersatz-Instance.**
```
Stop-ASInstanceInAutoScalingGroup -InstanceId i-93633f9b -ShouldDecrementDesiredCapacity $false
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [TerminateInstanceInAutoScalingGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Suspend-ASProcess`
Das folgende Codebeispiel zeigt die Verwendung. `Suspend-ASProcess`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Auto-Scaling-Prozess für die spezifizierte Auto-Scaling-Gruppe ausgesetzt.**
```
Suspend-ASProcess -AutoScalingGroupName my-asg -ScalingProcess "AlarmNotification"
```
**Beispiel 2: In diesem Beispiel werden alle Auto-Scaling-Prozesse für die angegebene Auto-Scaling-Gruppe ausgesetzt.**
```
Suspend-ASProcess -AutoScalingGroupName my-asg
```
+ Einzelheiten zur API finden Sie unter [SuspendProcesses AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-ASAutoScalingGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Update-ASAutoScalingGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die minimale und maximale Größe der angegebenen Auto-Scaling-Gruppe aktualisiert.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -MaxSize 5 -MinSize 1
```
**Beispiel 2: In diesem Beispiel wird die standardmäßige Ruhephase der angegebenen Auto-Scaling-Gruppe aktualisiert.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -DefaultCooldown 10
```
**Beispiel 3: In diesem Beispiel werden die Availability Zones der angegebenen Auto-Scaling-Gruppe aktualisiert.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -AvailabilityZone @("us-west-2a", "us-west-2b")
```
**Beispiel 4: In diesem Beispiel wird die angegebene Auto-Scaling-Gruppe aktualisiert, um Zustandsprüfungen mit Elastic Load Balancing zu verwenden.**
```
Update-ASAutoScalingGroup -AutoScalingGroupName my-asg -HealthCheckType ELB -HealthCheckGracePeriod 60
```
+ Einzelheiten zur API finden Sie unter [UpdateAutoScalingGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-ASLifecycleActionHeartbeat`
Das folgende Codebeispiel zeigt die Verwendung. `Write-ASLifecycleActionHeartbeat`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Heartbeat für die angegebene Lebenszyklusaktion aufgezeichnet. Dadurch bleibt die Instance im Status „Ausstehend“, bis die benutzerdefinierte Aktion abgeschlossen ist.**
```
Write-ASLifecycleActionHeartbeat -AutoScalingGroupName my-asg -LifecycleHookName myLifecycleHook -LifecycleActionToken bcd2f1b8-9a78-44d3-8a7a-4dd07d7cf635
```
+ Einzelheiten zur API finden Sie unter [RecordLifecycleActionHeartbeat AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-ASLifecycleHook`
Das folgende Codebeispiel zeigt die Verwendung. `Write-ASLifecycleHook`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Lebenszyklus-Hook zur spezifizierten Auto-Scaling-Gruppe hinzugefügt.**
```
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"
```
+ Einzelheiten zur API finden Sie unter [PutLifecycleHook AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-ASNotificationConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Write-ASNotificationConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Auto Scaling Scaling-Gruppe so konfiguriert, dass sie beim Starten von Instances eine Benachrichtigung an das angegebene SNS-Thema sendet. EC2 **
```
Write-ASNotificationConfiguration -AutoScalingGroupName my-asg -NotificationType "autoscaling:EC2_INSTANCE_LAUNCH" -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
**Beispiel 2: In diesem Beispiel wird die angegebene Auto Scaling Scaling-Gruppe so konfiguriert, dass sie beim Starten oder Beenden EC2 von Instances eine Benachrichtigung an das angegebene SNS-Thema sendet.**
```
Write-ASNotificationConfiguration -AutoScalingGroupName my-asg -NotificationType @("autoscaling:EC2_INSTANCE_LAUNCH", "autoscaling:EC2_INSTANCE_TERMINATE") -TopicARN "arn:aws:sns:us-west-2:123456789012:my-topic"
```
+ Einzelheiten zur API finden Sie unter [PutNotificationConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Write-ASScalingPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Write-ASScalingPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Richtlinie der spezifizierten Auto-Scaling-Gruppe hinzugefügt. Der angegebene Anpassungstyp bestimmt, wie der ScalingAdjustment Parameter interpretiert wird. Bei 'ChangeInCapacity' erhöht ein positiver Wert die Kapazität um die angegebene Anzahl von Instanzen und ein negativer Wert verringert die Kapazität um die angegebene Anzahl von Instanzen.**
```
Write-ASScalingPolicy -AutoScalingGroupName my-asg -AdjustmentType "ChangeInCapacity" -PolicyName "myScaleInPolicy" -ScalingAdjustment -1
```
**Ausgabe:**
```
arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:aa3836ab-5462-42c7-adab-e1d769fc24ef:autoScalingGroupName/my-asg
:policyName/myScaleInPolicy
```
+ Einzelheiten zur API finden Sie unter [PutScalingPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Write-ASScheduledUpdateGroupAction`
Das folgende Codebeispiel zeigt die Verwendung. `Write-ASScheduledUpdateGroupAction`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine einmalig geplante Aktion erstellt oder aktualisiert, um die gewünschte Kapazität zur angegebenen Startzeit zu ändern.**
```
Write-ASScheduledUpdateGroupAction -AutoScalingGroupName my-asg -ScheduledActionName "myScheduledAction" -StartTime "2015-12-01T00:00:00Z" -DesiredCapacity 10
```
+ Einzelheiten zur API finden Sie unter [PutScheduledUpdateGroupAction AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# AWS Budgets Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. AWS Budgets
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `New-BGTBudget`
Das folgende Codebeispiel zeigt die Verwendung `New-BGTBudget` von.
**Tools für PowerShell V5**
**Beispiel 1: Erstellt ein neues Budget mit den angegebenen Budget- und Zeitvorgaben sowie E-Mail-Benachrichtigungen.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [CreateBudget AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# AWS Cloud9 Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. AWS Cloud9
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-C9EnvironmentData`
Das folgende Codebeispiel zeigt die Verwendung `Get-C9EnvironmentData` von.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zu den angegebenen AWS Cloud9-Entwicklungsumgebungen abgerufen.**
```
Get-C9EnvironmentData -EnvironmentId 685f892f431b45c2b28cb69eadcdb0EX,1980b80e5f584920801c09086667f0EX
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden Informationen über den Lebenszyklusstatus der angegebenen AWS Cloud9-Entwicklungsumgebung abgerufen.**
```
(Get-C9EnvironmentData -EnvironmentId 685f892f431b45c2b28cb69eadcdb0EX).Lifecycle
```
**Ausgabe:**
```
FailureResource Reason Status
--------------- ------ ------
CREATED
```
+ Einzelheiten zur API finden Sie unter [DescribeEnvironments AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-C9EnvironmentList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-C9EnvironmentList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste der verfügbaren Identifikatoren für die AWS Cloud9-Entwicklungsumgebung abgerufen.**
```
Get-C9EnvironmentList
```
**Ausgabe:**
```
685f892f431b45c2b28cb69eadcdb0EX
1980b80e5f584920801c09086667f0EX
```
+ Einzelheiten zur API finden Sie unter [ListEnvironments AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-C9EnvironmentMembershipList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-C9EnvironmentMembershipList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen über Umgebungsmitglieder für die angegebene AWS Cloud9-Entwicklungsumgebung abgerufen.**
```
Get-C9EnvironmentMembershipList -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden Informationen über den Besitzer der angegebenen AWS Cloud9-Entwicklungsumgebung abgerufen.**
```
Get-C9EnvironmentMembershipList -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission owner
```
**Ausgabe:**
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : owner
UserArn : arn:aws:iam::123456789012:user/MyDemoUser
UserId : AIDAJ3LOROMOUXTBSU6EX
```
**Beispiel 3: In diesem Beispiel werden Informationen über das angegebene Umgebungsmitglied für mehrere AWS Cloud9-Entwicklungsumgebungen abgerufen.**
```
Get-C9EnvironmentMembershipList -UserArn arn:aws:iam::123456789012:user/MyDemoUser
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeEnvironmentMemberships AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-C9EnvironmentStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-C9EnvironmentStatus`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Statusinformationen für die angegebene AWS Cloud9-Entwicklungsumgebung abgerufen.**
```
Get-C9EnvironmentStatus -EnvironmentId 349c86d4579e4e7298d500ff57a6b2EX
```
**Ausgabe:**
```
Message Status
------- ------
Environment is ready to use ready
```
+ Einzelheiten zur API finden Sie unter [DescribeEnvironmentStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-C9EnvironmentEC2`
Das folgende Codebeispiel zeigt die Verwendung. `New-C9EnvironmentEC2`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine AWS Cloud9-Entwicklungsumgebung mit den angegebenen Einstellungen erstellt, eine Amazon Elastic Compute Cloud (Amazon EC2) -Instance gestartet und dann eine Verbindung von der Instance zur Umgebung hergestellt.**
```
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
```
**Ausgabe:**
```
ffd88420d4824eeeaeaa8a04bfde8cEX
```
+ Einzelheiten zur API finden Sie unter [CreateEnvironmentEc2](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `New-C9EnvironmentMembership`
Das folgende Codebeispiel zeigt die Verwendung. `New-C9EnvironmentMembership`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Umgebungsmitglied zur angegebenen AWS Cloud9-Entwicklungsumgebung hinzugefügt.**
```
New-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission read-write
```
**Ausgabe:**
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : read-write
UserArn : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId : AIDAJ3BA6O2FMJWCWXHEX
```
+ Einzelheiten zur API finden Sie unter [CreateEnvironmentMembership AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-C9Environment`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-C9Environment`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene AWS Cloud9-Entwicklungsumgebung gelöscht. Wenn eine EC2 Amazon-Instance mit der Umgebung verbunden ist, wird auch die Instance beendet.**
```
Remove-C9Environment -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
+ Einzelheiten zur API finden Sie unter [DeleteEnvironment AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-C9EnvironmentMembership`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-C9EnvironmentMembership`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Umgebungsmitglied aus der angegebenen AWS Cloud9-Entwicklungsumgebung gelöscht.**
```
Remove-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
+ Einzelheiten zur API finden Sie unter [DeleteEnvironmentMembership AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Update-C9Environment`
Das folgende Codebeispiel zeigt die Verwendung. `Update-C9Environment`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die angegebenen Einstellungen der angegebenen vorhandenen AWS Cloud9-Entwicklungsumgebung geändert.**
```
Update-C9Environment -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Description "My changed demonstration development environment." -Name my-changed-demo-env
```
+ Einzelheiten zur API finden Sie unter [UpdateEnvironment AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-C9EnvironmentMembership`
Das folgende Codebeispiel zeigt die Verwendung. `Update-C9EnvironmentMembership`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Einstellungen des angegebenen vorhandenen Umgebungsmitglieds für die angegebene AWS Cloud9-Entwicklungsumgebung geändert.**
```
Update-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission read-only
```
**Ausgabe:**
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : read-only
UserArn : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId : AIDAJ3BA6O2FMJWCWXHEX
```
+ Einzelheiten zur API finden Sie unter [UpdateEnvironmentMembership AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# CloudFormation Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. CloudFormation
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-CFNStack`
Das folgende Codebeispiel zeigt die Verwendung `Get-CFNStack` von.
**Tools für PowerShell V5**
**Beispiel 1: Gibt eine Sammlung von Stack-Instances zurück, die alle Stacks des Benutzers beschreiben.**
```
Get-CFNStack
```
**Beispiel 2: Gibt eine Stack-Instance zurück, die den angegebenen Stack beschreibt**
```
Get-CFNStack -StackName "myStack"
```
+ Einzelheiten zur API finden Sie unter [DescribeStacks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFNStackEvent`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFNStackEvent`
**Tools für PowerShell V5**
**Beispiel 1: Gibt alle stapelbezogenen Ereignisse für den angegebenen Stapel zurück.**
```
Get-CFNStackEvent -StackName "myStack"
```
+ Einzelheiten zur API finden Sie unter [DescribeStackEvents AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFNStackResource`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFNStackResource`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Beschreibung einer Ressource zurück, die in der Vorlage identifiziert wurde, die dem angegebenen Stack durch die logische ID DBInstance „My“ zugeordnet ist.**
```
Get-CFNStackResource -StackName "myStack" -LogicalResourceId "MyDBInstance"
```
+ Einzelheiten zur API finden Sie unter [DescribeStackResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-CFNStackResourceList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFNStackResourceList`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die AWS Ressourcenbeschreibungen für bis zu 100 Ressourcen zurück, die dem angegebenen Stack zugeordnet sind. Um Details zu allen Ressourcen zu erhalten, die einem Stack zugeordnet sind, verwenden Sie Get- CFNStackResourceSummary, das auch manuelles Paging der Ergebnisse unterstützt.**
```
Get-CFNStackResourceList -StackName "myStack"
```
**Beispiel 2: Gibt die Beschreibung der EC2 Amazon-Instance zurück, die in der Vorlage identifiziert wurde, die dem angegebenen Stack durch die logische ID „Ec2Instance“ zugeordnet ist.**
```
Get-CFNStackResourceList -StackName "myStack" -LogicalResourceId "Ec2Instance"
```
**Beispiel 3: Gibt die Beschreibung von bis zu 100 Ressourcen zurück, die dem Stack zugeordnet sind, der eine EC2 Amazon-Instance enthält, die durch die Instance-ID „i-123456“ identifiziert wird. Um Details zu allen Ressourcen zu erhalten, die einem Stack zugeordnet sind, verwenden Sie Get- CFNStackResourceSummary, das auch manuelles Paging der Ergebnisse unterstützt.**
```
Get-CFNStackResourceList -PhysicalResourceId "i-123456"
```
**Beispiel 4: Gibt die Beschreibung der EC2 Amazon-Instance zurück, die durch die logische ID „Ec2Instance“ in der Vorlage für einen Stack identifiziert wird. Der Stack wird anhand der physischen Ressourcen-ID einer darin enthaltenen Ressource identifiziert, in diesem Fall auch einer EC2 Amazon-Instance mit der Instance-ID „i-123456“. Je nach Inhalt der Vorlage könnte auch eine andere physische Ressource zur Identifizierung des Stacks verwendet werden, zum Beispiel ein Amazon S3-Bucket.**
```
Get-CFNStackResourceList -PhysicalResourceId "i-123456" -LogicalResourceId "Ec2Instance"
```
+ Einzelheiten zur API finden Sie unter [DescribeStackResources AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-CFNStackResourceSummary`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFNStackResourceSummary`
**Tools für PowerShell V5**
**Beispiel 1: Gibt Beschreibungen aller Ressourcen zurück, die mit dem angegebenen Stapel verbunden sind.**
```
Get-CFNStackResourceSummary -StackName "myStack"
```
+ Einzelheiten zur API finden Sie unter [ListStackResources AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFNStackSummary`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFNStackSummary`
**Tools für PowerShell V5**
**Beispiel 1: Gibt zusammenfassende Informationen für alle Stapel zurück.**
```
Get-CFNStackSummary
```
**Beispiel 2: Gibt zusammenfassende Informationen für alle Stapel zurück, die gerade erstellt werden.**
```
Get-CFNStackSummary -StackStatusFilter "CREATE_IN_PROGRESS"
```
**Beispiel 3: Gibt zusammenfassende Informationen für alle Stapel zurück, die gerade erstellt oder aktualisiert werden.**
```
Get-CFNStackSummary -StackStatusFilter @("CREATE_IN_PROGRESS", "UPDATE_IN_PROGRESS")
```
+ Einzelheiten zur API finden Sie unter [ListStacks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFNTemplate`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFNTemplate`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Vorlage zurück, die mit dem angegebenen Stapel verbunden ist.**
```
Get-CFNTemplate -StackName "myStack"
```
+ Einzelheiten zur API finden Sie unter [GetTemplate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Measure-CFNTemplateCost`
Das folgende Codebeispiel zeigt die Verwendung. `Measure-CFNTemplateCost`
**Tools für PowerShell V5**
**Beispiel 1: Gibt eine AWS Simple Monthly Calculator-URL mit einer Abfragezeichenfolge zurück, die die Ressourcen beschreibt, die zum Ausführen der Vorlage erforderlich sind. Die Vorlage wird von der angegebenen Amazon-S3-URL abgerufen und der einzelne Anpassungsparameter wird angewendet. Der Parameter kann auch mit 'Key' und 'Value' anstelle von '' und ParameterKey '' angegeben werden. ParameterValue**
```
Measure-CFNTemplateCost -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
-Region us-west-1 `
-Parameter @{ ParameterKey="KeyName"; ParameterValue="myKeyPairName" }
```
**Beispiel 2: Gibt eine AWS Simple Monthly Calculator-URL mit einer Abfragezeichenfolge zurück, die die Ressourcen beschreibt, die zum Ausführen der Vorlage erforderlich sind. Die Vorlage wird anhand des bereitgestellten Inhalts analysiert und die angewendeten Anpassungsparameter angewendet (in diesem Beispiel wird davon ausgegangen, dass der Vorlageninhalt zwei Parameter deklariert hätte, 'KeyName' und 'InstanceType'). Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von '' und 'ParameterKey' angegeben werden. ParameterValue**
```
Measure-CFNTemplateCost -TemplateBody "{TEMPLATE CONTENT HERE}" `
-Parameter @( @{ ParameterKey="KeyName"; ParameterValue="myKeyPairName" },`
@{ ParameterKey="InstanceType"; ParameterValue="m1.large" })
```
**Beispiel 3: Verwendet New-Object, um den Satz von Vorlagenparametern zu erstellen, und gibt eine AWS Simple Monthly Calculator-URL mit einer Abfragezeichenfolge zurück, die die für die Ausführung der Vorlage erforderlichen Ressourcen beschreibt. Die Vorlage wird anhand des bereitgestellten Inhalts mit Anpassungsparametern analysiert (in diesem Beispiel wird davon ausgegangen, dass der Vorlageninhalt zwei Parameter deklariert hätte, '' und KeyName ''). 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 )
```
+ Einzelheiten zur API finden Sie unter [EstimateTemplateCost AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-CFNStack`
Das folgende Codebeispiel zeigt die Verwendung. `New-CFNStack`
**Tools für PowerShell V5**
**Beispiel 1: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird anhand des bereitgestellten Inhalts mit Anpassungsparametern analysiert ('PK1' und 'PK2' stehen für die Namen der im Vorlageninhalt deklarierten Parameter, '' und PV1 'PV2' stehen für die Werte für diese Parameter. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von '' und 'ParameterKey' angegeben werden. ParameterValue Wenn die Erstellung des Stapels fehlschlägt, wird er nicht zurückgesetzt.**
```
New-CFNStack -StackName "myStack" `
-TemplateBody "{TEMPLATE CONTENT HERE}" `
-Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" }) `
-DisableRollback $true
```
**Beispiel 2: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird anhand des bereitgestellten Inhalts mit Anpassungsparametern analysiert ('PK1' und 'PK2' stehen für die Namen der im Vorlageninhalt deklarierten Parameter, 'PV1' und 'PV2' stehen für die Werte für diese Parameter. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von '' und 'ParameterKey' angegeben werden. ParameterValue Wenn die Erstellung des Stapels fehlschlägt, wird er zurückgerollt.**
```
$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"
```
**Beispiel 3: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird von der Amazon S3 S3-URL mit Anpassungsparametern abgerufen ('PK1' steht für den Namen eines Parameters, der im Inhalt der Vorlage deklariert ist, PV1 '' steht für den Wert für den Parameter. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von '' und ParameterKey 'ParameterValue' angegeben werden. Wenn die Erstellung des Stacks fehlschlägt, wird er zurückgesetzt (genauso wie bei der Angabe von - DisableRollback \$1false)**.
```
New-CFNStack -StackName "myStack" `
-TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
-Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }
```
**Beispiel 4: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird von der Amazon S3 S3-URL mit Anpassungsparametern abgerufen ('PK1' steht für den Namen eines Parameters, der im Inhalt der Vorlage deklariert ist, PV1 '' steht für den Wert für den Parameter. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von '' und ParameterKey 'ParameterValue' angegeben werden. Wenn die Erstellung des Stacks fehlschlägt, wird er zurückgesetzt (genauso wie bei der Angabe von - DisableRollback \$1false). Die angegebene Benachrichtigung AENs empfängt veröffentlichte Ereignisse im Zusammenhang mit dem Stack.**
```
New-CFNStack -StackName "myStack" `
-TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
-Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" } `
-NotificationARN @( "arn1", "arn2" )
```
+ Einzelheiten zur API finden Sie unter [CreateStack AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Remove-CFNStack`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CFNStack`
**Tools für PowerShell V5**
**Beispiel 1: Löscht den angegebenen Stapel.**
```
Remove-CFNStack -StackName "myStack"
```
+ Einzelheiten zur API finden Sie unter [DeleteStack AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Resume-CFNUpdateRollback`
Das folgende Codebeispiel zeigt die Verwendung. `Resume-CFNUpdateRollback`
**Tools für PowerShell V5**
**Beispiel 1: Setzt Rollback des benannten Stapels fort, der sich im Zustand 'UPDATE\$1ROLLBACK\$1FAILED' befinden sollte. Wenn das fortgesetzte Rollback erfolgreich ist, geht der Stack in den Zustand 'UPDATE\$1ROLLBACK\$1COMPLETE' über.**
```
Resume-CFNUpdateRollback -StackName "myStack"
```
+ Einzelheiten zur API finden Sie unter [ContinueUpdateRollback AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Stop-CFNUpdateStack`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-CFNUpdateStack`
**Tools für PowerShell V5**
**Beispiel 1: Bricht eine Aktualisierung auf dem angegebenen Stapel ab.**
```
Stop-CFNUpdateStack -StackName "myStack"
```
+ Einzelheiten zur API finden Sie unter [CancelUpdateStack AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Test-CFNStack`
Das folgende Codebeispiel zeigt die Verwendung. `Test-CFNStack`
**Tools für PowerShell V5**
**Beispiel 1: Testet, ob der Stack einen der Status UPDATE\$1ROLLBACK\$1COMPLETE, CREATE\$1COMPLETE, ROLLBACK\$1COMPLETE oder UPDATE\$1COMPLETE erreicht hat.**
```
Test-CFNStack -StackName MyStack
```
**Ausgabe:**
```
False
```
**Beispiel 2: Testet, ob der Stack den Status UPDATE\$1COMPLETE oder UPDATE\$1ROLLBACK\$1COMPLETE erreicht hat.**
```
Test-CFNStack -StackName MyStack -Status UPDATE_COMPLETE,UPDATE_ROLLBACK_COMPLETE
```
**Ausgabe:**
```
True
```
+ Einzelheiten zur API finden Sie unter [CFNStack AWS -Tools für PowerShell Test-In-Cmdlet-Referenz](https://docs.aws.amazon.com/powershell/v5/reference) *(*V5).
### `Test-CFNTemplate`
Das folgende Codebeispiel zeigt die Verwendung. `Test-CFNTemplate`
**Tools für PowerShell V5**
**Beispiel 1: Validiert den angegebenen Vorlageninhalt. Die Ausgabe enthält die Fähigkeiten, Beschreibung und Parameter der Vorlage.**
```
Test-CFNTemplate -TemplateBody "{TEMPLATE CONTENT HERE}"
```
**Beispiel 2: Validiert die angegebene Vorlage, auf die über eine Amazon S3 URL zugegriffen wird. Die Ausgabe enthält die Fähigkeiten, Beschreibung und Parameter der Vorlage.**
```
Test-CFNTemplate -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template
```
+ Einzelheiten zur API finden Sie unter [ValidateTemplate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-CFNStack`
Das folgende Codebeispiel zeigt die Verwendung. `Update-CFNStack`
**Tools für PowerShell V5**
**Beispiel 1: Aktualisiert den Stack 'MyStack' mit den angegebenen Vorlagen- und Anpassungsparametern. 'PK1' steht für den Namen eines in der Vorlage deklarierten Parameters und 'PV1' für seinen Wert. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von '' und ParameterKey 'ParameterValue' angegeben werden.**
```
Update-CFNStack -StackName "myStack" `
-TemplateBody "{Template Content Here}" `
-Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }
```
**Beispiel 2: Aktualisiert den Stack 'MyStack' mit den angegebenen Vorlagen- und Anpassungsparametern. 'PK1' und 'PK2' stehen für die Namen der in der Vorlage deklarierten Parameter, '' und PV1 'PV2' stehen für ihre angeforderten Werte. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von '' und ParameterKey 'ParameterValue' angegeben werden.**
```
Update-CFNStack -StackName "myStack" `
-TemplateBody "{Template Content Here}" `
-Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )
```
**Beispiel 3: Aktualisiert den Stack 'MyStack' mit den angegebenen Vorlagen- und Anpassungsparametern. 'PK1' steht für den Namen eines in der Vorlage deklarierten Parameters und 'PV2' für seinen Wert. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von '' und ParameterKey 'ParameterValue' angegeben werden.**
```
Update-CFNStack -StackName "myStack" -TemplateBody "{Template Content Here}" -Parameters @{ ParameterKey="PK1"; ParameterValue="PV1" }
```
**Beispiel 4: Aktualisiert den Stack 'MyStack' mit der angegebenen Vorlage, die von Amazon S3 abgerufen wurde, und den Anpassungsparametern. 'PK1' und 'PK2' stehen für die Namen der in der Vorlage deklarierten Parameter, '' und PV1 'PV2' stehen für ihre angeforderten Werte. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von '' und ParameterKey 'ParameterValue' angegeben werden.**
```
Update-CFNStack -StackName "myStack" `
-TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template `
-Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )
```
**Beispiel 5: Aktualisiert den Stack 'MyStack', von dem in diesem Beispiel angenommen wird, dass er IAM-Ressourcen enthält, mit der angegebenen Vorlage, die von Amazon S3 abgerufen wurde, und den Anpassungsparametern. 'PK1' und 'PK2' stehen für die Namen der in der Vorlage deklarierten Parameter, '' und PV1 '' stehen für ihre angeforderten Werte. PV2 Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von '' und ParameterKey 'ParameterValue' angegeben werden. Bei Stacks, die IAM-Ressourcen enthalten, müssen Sie den Capability-Parameter „CAPABILITY\$1IAM“ angeben. Andernfalls schlägt das Update mit einem Fehler '' fehl. 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"
```
+ *Einzelheiten zur API finden Sie unter [UpdateStack](https://docs.aws.amazon.com/powershell/v5/reference)Cmdlet-Referenz (V5).AWS -Tools für PowerShell *
### `Wait-CFNStack`
Das folgende Codebeispiel zeigt die Verwendung. `Wait-CFNStack`
**Tools für PowerShell V5**
**Beispiel 1: Testet, ob der Stack einen der Status UPDATE\$1ROLLBACK\$1COMPLETE, CREATE\$1COMPLETE, ROLLBACK\$1COMPLETE oder UPDATE\$1COMPLETE erreicht hat. Wenn sich der Stack nicht in einem der Status befindet, ruht der Befehl zwei Sekunden lang, bevor er den Status erneut testet. Dies wird wiederholt, bis der Stack einen der angeforderten Zustände erreicht hat oder das Standard-Timeout von 60 Sekunden abgelaufen ist. Wird der Timeout-Zeitraum überschritten, wird eine Ausnahme ausgelöst. Wenn der Stack innerhalb des Timeout-Zeitraums einen der angeforderten Zustände erreicht, wird er an die Pipeline zurückgegeben.**
```
$stack = Wait-CFNStack -StackName MyStack
```
**Beispiel 2: In diesem Beispiel wird insgesamt 5 Minuten (300 Sekunden) gewartet, bis der Stack einen der angegebenen Zustände erreicht. In diesem Beispiel wird der Status vor dem Timeout erreicht und das Stack-Objekt wird daher an die Pipeline zurückgegeben.**
```
Wait-CFNStack -StackName MyStack -Timeout 300 -Status CREATE_COMPLETE,ROLLBACK_COMPLETE
```
**Ausgabe:**
```
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
```
**Beispiel 3: Dieses Beispiel zeigt die Fehlerausgabe, wenn ein Stack innerhalb des Timeout-Zeitraums (in diesem Fall der Standardzeitraum von 60 Sekunden) keinen der angeforderten Zustände erreicht.**
```
Wait-CFNStack -StackName MyStack -Status CREATE_COMPLETE,ROLLBACK_COMPLETE
```
**Ausgabe:**
```
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
```
+ API-Einzelheiten finden Sie unter [CFNStack AWS -Tools für PowerShell Wait-in-Cmdlet-Referenz](https://docs.aws.amazon.com/powershell/v5/reference) *(*V5).
# CloudFront Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. CloudFront
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-CFCloudFrontOriginAccessIdentity`
Das folgende Codebeispiel zeigt die Verwendung `Get-CFCloudFrontOriginAccessIdentity` von.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine bestimmte CloudFront Amazon-Ursprungszugriffsidentität zurückgegeben, die durch den Parameter -Id angegeben wird. Obwohl der -Id-Parameter nicht erforderlich ist, werden keine Ergebnisse zurückgegeben, wenn Sie ihn nicht angeben.**
```
Get-CFCloudFrontOriginAccessIdentity -Id E3XXXXXXXXXXRT
```
**Ausgabe:**
```
CloudFrontOriginAccessIdentityConfig Id S3CanonicalUserId
------------------------------------ -- -----------------
Amazon.CloudFront.Model.CloudFrontOr... E3XXXXXXXXXXRT 4b6e...
```
+ Einzelheiten zur API finden Sie unter [GetCloudFrontOriginAccessIdentity AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFCloudFrontOriginAccessIdentityConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFCloudFrontOriginAccessIdentityConfig`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Konfigurationsinformationen zu einer einzelnen CloudFront Amazon-Ursprungszugriffsidentität zurückgegeben, die durch den Parameter -Id angegeben wird. Fehler treten auf, wenn kein -Id-Parameter angegeben ist.**
```
Get-CFCloudFrontOriginAccessIdentityConfig -Id E3XXXXXXXXXXRT
```
**Ausgabe:**
```
CallerReference Comment
--------------- -------
mycallerreference: 2/1/2011 1:16:32 PM Caller reference: 2/1/2011 1:16:32 PM
```
+ Einzelheiten zur API finden Sie unter [GetCloudFrontOriginAccessIdentityConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFCloudFrontOriginAccessIdentityList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFCloudFrontOriginAccessIdentityList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste der CloudFront Amazon-Origin-Zugriffsidentitäten zurückgegeben. Da der MaxItem Parameter - den Wert 2 angibt, enthalten die Ergebnisse zwei Identitäten.**
```
Get-CFCloudFrontOriginAccessIdentityList -MaxItem 2
```
**Ausgabe:**
```
IsTruncated : True
Items : {E326XXXXXXXXXT, E1YWXXXXXXX9B}
Marker :
MaxItems : 2
NextMarker : E1YXXXXXXXXX9B
Quantity : 2
```
+ Einzelheiten zur API finden Sie unter [ListCloudFrontOriginAccessIdentities AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFDistribution`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFDistribution`
**Tools für PowerShell V5**
**Beispiel 1: Ruft die Informationen für eine bestimmte Distribution ab.**
```
Get-CFDistribution -Id EXAMPLE0000ID
```
+ Einzelheiten zur API finden Sie unter [GetDistribution AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFDistributionConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFDistributionConfig`
**Tools für PowerShell V5**
**Beispiel 1: Ruft die Konfiguration für eine bestimmte Distribution ab.**
```
Get-CFDistributionConfig -Id EXAMPLE0000ID
```
+ Einzelheiten zur API finden Sie unter [GetDistributionConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFDistributionList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFDistributionList`
**Tools für PowerShell V5**
**Beispiel 1: Gibt Distributionen zurück.**
```
Get-CFDistributionList
```
+ Einzelheiten zur API finden Sie unter [ListDistributions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-CFDistribution`
Das folgende Codebeispiel zeigt die Verwendung. `New-CFDistribution`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt eine CloudFront Basisdistribution, die mit Protokollierung und Caching konfiguriert ist.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [CreateDistribution AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-CFInvalidation`
Das folgende Codebeispiel zeigt die Verwendung. `New-CFInvalidation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Invalidierung für eine Distribution mit der ID EXAMPLENSTXAXE erstellt. Das CallerReference ist eine vom Benutzer gewählte eindeutige ID. In diesem Fall wird ein Zeitstempel verwendet, der den 15. Mai 2019 um 9:00 Uhr darstellt. Die Variable \$1Paths speichert drei Pfade zu Bild- und Mediendateien, die der Benutzer nicht als Teil des Caches der Distribution haben möchte. Der Parameterwert -Paths\$1Quantity ist die Gesamtzahl der im Parameter -Paths\$1Item angegebenen Pfade.**
```
$Paths = "/images/*.gif", "/images/image1.jpg", "/videos/*.mp4"
New-CFInvalidation -DistributionId "EXAMPLENSTXAXE" -InvalidationBatch_CallerReference 20190515090000 -Paths_Item $Paths -Paths_Quantity 3
```
**Ausgabe:**
```
Invalidation Location
------------ --------
Amazon.CloudFront.Model.Invalidation https://cloudfront.amazonaws.com/2018-11-05/distribution/EXAMPLENSTXAXE/invalidation/EXAMPLE8NOK9H
```
+ Einzelheiten zur API finden Sie unter [CreateInvalidation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-CFSignedCookie`
Das folgende Codebeispiel zeigt die Verwendung. `New-CFSignedCookie`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt mithilfe einer vordefinierten Richtlinie ein signiertes Cookie für die angegebene Ressource. Das Cookie ist ein Jahr lang gültig.**
```
$params = @{
"ResourceUri"="http://xyz.cloudfront.net/image1.jpeg"
"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
"ExpiresOn"=(Get-Date).AddYears(1)
}
New-CFSignedCookie @params
```
**Ausgabe:**
```
Expires
-------
[CloudFront-Expires, 1472227284]
```
**Beispiel 1: Erstellt mithilfe einer vordefinierten Richtlinie ein signiertes Cookie für die angegebenen Ressourcen. Das Cookie ist innerhalb von 24 Stunden gültig und läuft eine Woche danach ab.**
```
$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
```
**Ausgabe:**
```
Policy
------
[CloudFront-Policy, eyJTd...wIjo...
```
**Beispiel 3: Erstellt mithilfe einer vordefinierten Richtlinie ein signiertes Cookie für die angegebenen Ressourcen. Das Cookie ist innerhalb von 24 Stunden gültig und läuft eine Woche danach ab. Der Zugriff auf die Ressourcen ist auf den angegebenen IP-Bereich beschränkt.**
```
$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
```
**Ausgabe:**
```
Policy ------ [CloudFront-Policy, eyJTd...wIjo...
```
+ Einzelheiten zur API finden Sie unter [CFSignedNew-Cookie in AWS -Tools für PowerShell Cmdlet-Referenz](https://docs.aws.amazon.com/powershell/v5/reference) *(*V5).
### `New-CFSignedUrl`
Das folgende Codebeispiel zeigt die Verwendung. `New-CFSignedUrl`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt mithilfe einer vordefinierten Richtlinie eine signierte URL für die angegebene Ressource. Die URL ist eine Stunde lang gültig. Ein System.Uri-Objekt, das die signierte URL enthält, wird an die Pipeline ausgegeben.**
```
$params = @{
"ResourceUri"="https://cdn.example.com/index.html"
"KeyPairId"="AKIAIOSFODNN7EXAMPLE"
"PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem"
"ExpiresOn"=(Get-Date).AddHours(1)
}
New-CFSignedUrl @params
```
**Beispiel 2: Erstellt mithilfe einer vordefinierten Richtlinie eine signierte URL für die angegebene Ressource. Die URL ist nach Ablauf von 24 Stunden gültig und läuft eine Woche später ab.**
```
$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
```
**Beispiel 3: Erstellt mithilfe einer vordefinierten Richtlinie eine signierte URL für die angegebene Ressource. Die URL ist nach Ablauf von 24 Stunden gültig und läuft eine Woche später ab. Der Zugriff auf die Ressource ist auf den angegebenen IP-Bereich beschränkt.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [CFSignedNew-Url in der AWS -Tools für PowerShell Cmdlet-Referenz](https://docs.aws.amazon.com/powershell/v5/reference) *(*V5).
# CloudTrail Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. CloudTrail
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Find-CTEvent`
Das folgende Codebeispiel zeigt die Verwendung `Find-CTEvent` von.
**Tools für PowerShell V5**
**Beispiel 1: Gibt alle Ereignisse zurück, die in den letzten sieben Tagen aufgetreten sind. Das Cmdlet führt standardmäßig automatisch mehrere Aufrufe aus, um alle Ereignisse bereitzustellen, und beendet die Ausführung, wenn der Service angibt, dass keine weiteren Daten verfügbar sind.**
```
Find-CTEvent
```
**Beispiel 2: Gibt alle Ereignisse zurück, die in den letzten sieben Tagen aufgetreten sind, und gibt dabei eine Region an, die nicht dem aktuellen Shell-Standard entspricht.**
```
Find-CTEvent -Region eu-central-1
```
**Beispiel 3: Gibt alle Ereignisse zurück, die mit dem RunInstances API-Aufruf verknüpft sind.**
```
Find-CTEvent -LookupAttribute @{ AttributeKey="EventName"; AttributeValue="RunInstances" }
```
**Beispiel 4: Gibt die ersten 5 verfügbaren Ereignisse zurück.**
```
Find-CTEvent -MaxResult 5
```
+ Einzelheiten zur API finden Sie unter [LookupEvents AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-CTTrail`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CTTrail`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Einstellungen aller Trails zurück, die der aktuellen Region Ihres Kontos zugeordnet sind.**
```
Get-CTTrail
```
**Beispiel 2: Gibt die Einstellungen für die angegebenen Trails zurück.**
```
Get-CTTrail -TrailNameList trail1,trail2
```
**Beispiel 3: Gibt die Einstellungen für die angegebenen Trails zurück, die in einer anderen Region als der aktuellen Shell-Standardregion (in diesem Fall der Region Frankfurt (eu-central-1)) erstellt wurden).**
```
Get-CTTrail -TrailNameList trailABC,trailDEF -Region eu-central-1
```
+ Einzelheiten zur API finden Sie unter [DescribeTrails AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CTTrailStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CTTrailStatus`
**Tools für PowerShell V5**
**Beispiel 1: Gibt Statusinformationen für den Trail mit dem Namen 'myExampleTrail' zurück. Die zurückgegebenen Daten umfassen Informationen zu Zustellungsfehlern, Amazon-SNS- und Amazon-S3-Fehlern sowie Start- und Endzeiten für die Protokollierung des Trails. In diesem Beispiel wird davon ausgegangen, dass der Trail in derselben Region erstellt wurde wie die aktuelle Shell-Standardregion.**
```
Get-CTTrailStatus -Name myExampleTrail
```
**Beispiel 2: Gibt Statusinformationen für einen Trail zurück, der in einer anderen Region als der aktuellen Shell-Standardregion erstellt wurde (in diesem Fall in der Region Frankfurt (eu-central).**
```
Get-CTTrailStatus -Name myExampleTrail -Region eu-central-1
```
+ Einzelheiten zur API finden Sie unter [GetTrailStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-CTTrail`
Das folgende Codebeispiel zeigt die Verwendung. `New-CTTrail`
**Tools für PowerShell V5**
**Beispiel 1: Erzeugt einen Trail, der den Bucket „amzn-s3-demo-bucket“ für die Speicherung von Protokolldateien verwendet.**
```
New-CTTrail -Name "awscloudtrail-example" -S3BucketName "amzn-s3-demo-bucket"
```
**Beispiel 2: Erzeugt einen Trail, der den Bucket „amzn-s3-demo-bucket“ für die Speicherung von Protokolldateien verwendet. Die S3-Objekte, die die Protokolle darstellen, verfügen über das gemeinsame Schlüsselpräfix „mylogs“. Wenn neue Protokolle an den Bucket geliefert werden, wird eine Benachrichtigung an das SNS-Thema „mlog-deliverytopic” gesendet. In diesem Beispiel wird Splatting verwendet, um die Parameterwerte an das Cmdlet zu übergeben.**
```
$params = @{
Name="awscloudtrail-example"
S3BucketName="amzn-s3-demo-bucket"
S3KeyPrefix="mylogs"
SnsTopicName="mlog-deliverytopic"
}
New-CTTrail @params
```
+ Einzelheiten zur API finden Sie unter [CreateTrail AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-CTTrail`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CTTrail`
**Tools für PowerShell V5**
**Beispiel 1: Löscht den angegebenen Trail. Sie werden um eine Bestätigung gebeten, bevor der Befehl ausgeführt wird. Um die Bestätigung zu unterdrücken, fügen Sie den Schalterparameter -Force hinzu.**
```
Remove-CTTrail -Name "awscloudtrail-example"
```
+ Einzelheiten zur API finden Sie unter [DeleteTrail AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Start-CTLogging`
Das folgende Codebeispiel zeigt die Verwendung. `Start-CTLogging`
**Tools für PowerShell V5**
**Beispiel 1: Startet die Aufzeichnung von AWS API-Aufrufen und die Bereitstellung von Protokolldateien für den Trail mit dem Namen 'myExampleTrail'. In diesem Beispiel wird davon ausgegangen, dass der Trail in derselben Region erstellt wurde wie die aktuelle Shell-Standardregion.**
```
Start-CTLogging -Name myExampleTrail
```
**Beispiel 2: Startet die Aufzeichnung von AWS API-Aufrufen und die Bereitstellung von Protokolldateien für einen Trail, der in einer anderen Region als dem aktuellen Shell-Standard erstellt wurde (in diesem Fall der Region Frankfurt (eu-central-1)).**
```
Start-CTLogging -Name myExampleTrail -Region eu-central-1
```
+ Einzelheiten zur API finden Sie unter [StartLogging AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Stop-CTLogging`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-CTLogging`
**Tools für PowerShell V5**
**Beispiel 1: Unterbricht die Aufzeichnung von AWS API-Aufrufen und die Bereitstellung von Protokolldateien für den Trail mit dem Namen ''myExampleTrail. In diesem Beispiel wird davon ausgegangen, dass der Trail in derselben Region erstellt wurde wie die aktuelle Shell-Standardregion.**
```
Stop-CTLogging -Name myExampleTrail
```
**Beispiel 2: Unterbricht die Aufzeichnung von AWS API-Aufrufen und die Bereitstellung von Protokolldateien für einen Trail, der in einer anderen Region als der aktuellen Shell-Standardregion erstellt wurde (in diesem Fall in der Region Frankfurt (eu-central-1)).**
```
Stop-CTLogging -Name myExampleTrail -Region eu-central-1
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([StopLogging](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Update-CTTrail`
Das folgende Codebeispiel zeigt die Verwendung. `Update-CTTrail`
**Tools für PowerShell V5**
**Beispiel 1: Aktualisiert den angegebenen Trail, sodass globale Serviceereignisse (z. B. von IAM) aufgezeichnet werden, und ändert das gemeinsame Schlüsselpräfix der Protokolldateien künftig in „globallogs“.**
```
Update-CTTrail -Name "awscloudtrail-example" -IncludeGlobalServiceEvents $true -S3KeyPrefix "globallogs"
```
**Beispiel 2: Aktualisiert den angegebenen Trail, sodass Benachrichtigungen über neue Protokollbereitstellungen an das angegebene SNS-Thema gesendet werden.**
```
Update-CTTrail -Name "awscloudtrail-example" -SnsTopicName "mlog-deliverytopic2"
```
**Beispiel 3: Aktualisiert den angegebenen Trail, sodass Protokolle in einen anderen Bucket zugestellt werden.**
```
Update-CTTrail -Name "awscloudtrail-example" -S3BucketName "otherlogs"
```
+ Einzelheiten zur API finden Sie unter [UpdateTrail AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# CloudWatch Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. CloudWatch
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-CWDashboard`
Das folgende Codebeispiel zeigt die Verwendung `Get-CWDashboard` von.
**Tools für PowerShell V5**
**Beispiel 1: Gibt den ARN und den Inhalt des angegebenen Dashboards zurück.**
```
Get-CWDashboard -DashboardName Dashboard1
```
**Ausgabe:**
```
DashboardArn DashboardBody
------------ -------------
arn:aws:cloudwatch::123456789012:dashboard/Dashboard1 {...
```
+ Einzelheiten zur API finden Sie unter [GetDashboard AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CWDashboardList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CWDashboardList`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Sammlung von Dashboards für Ihr Konto zurück.**
```
Get-CWDashboardList
```
**Ausgabe:**
```
DashboardArn DashboardName LastModified Size
------------ ------------- ------------ ----
arn:... Dashboard1 7/6/2017 8:14:15 PM 252
```
**Beispiel 2: Gibt die Sammlung von Dashboards für Ihr Konto zurück, deren Namen mit dem Präfix „dev“ beginnen.**
```
Get-CWDashboardList -DashboardNamePrefix dev
```
+ Einzelheiten zur API finden Sie unter [ListDashboards AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-CWDashboard`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CWDashboard`
**Tools für PowerShell V5**
**Beispiel 1: Löscht das angegebene Dashboard und bittet um Bestätigung, bevor der Vorgang fortgesetzt wird. Um die Bestätigung zu umgehen, fügen Sie dem Befehl den Schalter -Force hinzu.**
```
Remove-CWDashboard -DashboardName Dashboard1
```
+ Einzelheiten zur API finden Sie unter [DeleteDashboards AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-CWDashboard`
Das folgende Codebeispiel zeigt die Verwendung. `Write-CWDashboard`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt oder aktualisiert das Dashboard mit dem Namen „Dashboard1“, sodass es zwei Metrik-Widgets nebeneinander enthält.**
```
$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
```
**Beispiel 2: Erstellt oder aktualisiert das Dashboard und leitet den Inhalt, der das Dashboard beschreibt, an das Cmdlet weiter.**
```
$dashBody = @"
{
...
}
"@
$dashBody | Write-CWDashboard -DashboardName Dashboard1
```
+ Einzelheiten zur API finden Sie unter [PutDashboard AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-CWMetricData`
Das folgende Codebeispiel zeigt die Verwendung. `Write-CWMetricData`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt ein neues MetricDatum Objekt und schreibt es in 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
```
+ Einzelheiten zur API finden Sie unter [PutMetricData AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
# CodeCommit Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. CodeCommit
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-CCBranch`
Das folgende Codebeispiel zeigt die Verwendung `Get-CCBranch` von.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen über den angegebenen Branch für das spezifizierte Repository abgerufen.**
```
Get-CCBranch -RepositoryName MyDemoRepo -BranchName MyNewBranch
```
**Ausgabe:**
```
BranchName CommitId
---------- --------
MyNewBranch 7763222d...561fc9c9
```
+ Einzelheiten zur API finden Sie unter [GetBranch AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CCBranchList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CCBranchList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste von Branch-Namen für das angegebene Repository abgerufen.**
```
Get-CCBranchList -RepositoryName MyDemoRepo
```
**Ausgabe:**
```
master
MyNewBranch
```
+ Einzelheiten zur API finden Sie unter [ListBranches AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CCRepository`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CCRepository`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen für das angegebene Repository abgerufen.**
```
Get-CCRepository -RepositoryName MyDemoRepo
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetRepository AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CCRepositoryBatch`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CCRepositoryBatch`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel bestätigt, welche der angegebenen Repositorys gefunden wurden und welche nicht.**
```
Get-CCRepositoryBatch -RepositoryName MyDemoRepo, MyNewRepo, AMissingRepo
```
**Ausgabe:**
```
Repositories RepositoriesNotFound
------------ --------------------
{MyDemoRepo, MyNewRepo} {AMissingRepo}
```
+ Einzelheiten zur API finden Sie unter [BatchGetRepositories AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CCRepositoryList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CCRepositoryList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Repositorys in aufsteigender Reihenfolge nach Repository-Namen aufgelistet.**
```
Get-CCRepositoryList -Order Ascending -SortBy RepositoryName
```
**Ausgabe:**
```
RepositoryId RepositoryName
------------ --------------
c7d0d2b0-ce40-4303-b4c3-38529EXAMPLE MyDemoRepo
05f30c66-e3e3-4f91-a0cd-1c84aEXAMPLE MyNewRepo
```
+ Einzelheiten zur API finden Sie unter [ListRepositories AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-CCBranch`
Das folgende Codebeispiel zeigt die Verwendung. `New-CCBranch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neuer Branch mit dem angegebenen Namen für das angegebene Repository und der angegebenen Commit-ID erstellt.**
```
New-CCBranch -RepositoryName MyDemoRepo -BranchName MyNewBranch -CommitId 7763222d...561fc9c9
```
+ Einzelheiten zur API finden Sie unter [CreateBranch AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-CCRepository`
Das folgende Codebeispiel zeigt die Verwendung. `New-CCRepository`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues Repository mit dem angegebenen Namen und der angegebenen Beschreibung erstellt.**
```
New-CCRepository -RepositoryName MyDemoRepo -RepositoryDescription "This is a repository for demonstration purposes."
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateRepository AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-CCRepository`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CCRepository`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Repository zwangsweise gelöscht. Der Befehl fordert Sie auf, den Vorgang zu bestätigen, bevor er ausgeführt wird. Fügen Sie den Parameter -Force hinzu, um das Repository ohne Prompt zu löschen.**
```
Remove-CCRepository -RepositoryName MyDemoRepo
```
**Ausgabe:**
```
43ef2443-3372-4b12-9e78-65c27EXAMPLE
```
+ Einzelheiten zur API finden Sie unter [DeleteRepository AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-CCDefaultBranch`
Das folgende Codebeispiel zeigt die Verwendung. `Update-CCDefaultBranch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Standard-Branch für das angegebene Repository in den spezifischen Branch geändert.**
```
Update-CCDefaultBranch -RepositoryName MyDemoRepo -DefaultBranchName MyNewBranch
```
+ Einzelheiten zur API finden Sie unter [UpdateDefaultBranch AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-CCRepositoryDescription`
Das folgende Codebeispiel zeigt die Verwendung. `Update-CCRepositoryDescription`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Beschreibung für das angegebene Repository geändert.**
```
Update-CCRepositoryDescription -RepositoryName MyDemoRepo -RepositoryDescription "This is an updated description."
```
+ Einzelheiten zur API finden Sie unter [UpdateRepositoryDescription AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-CCRepositoryName`
Das folgende Codebeispiel zeigt die Verwendung. `Update-CCRepositoryName`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Name des angegebenen Repositorys geändert.**
```
Update-CCRepositoryName -NewName MyDemoRepo2 -OldName MyDemoRepo
```
+ Einzelheiten zur API finden Sie unter [UpdateRepositoryName AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# CodeDeploy Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. CodeDeploy
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-CDOnPremiseInstanceTag`
Das folgende Codebeispiel zeigt die Verwendung `Add-CDOnPremiseInstanceTag` von.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Tag einer On-Premises-Instance mit dem angegebenen Schlüssel und Wert für die angegebene On-Premises-Instance hinzugefügt.**
```
Add-CDOnPremiseInstanceTag -InstanceName AssetTag12010298EX -Tag @{"Key" = "Name"; "Value" = "CodeDeployDemo-OnPrem"}
```
+ Einzelheiten zur API finden Sie unter [AddTagsToOnPremisesInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDApplication`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDApplication`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zur angegebenen Anwendung abgerufen.**
```
Get-CDApplication -ApplicationName CodeDeployDemoApplication
```
**Ausgabe:**
```
ApplicationId ApplicationName CreateTime LinkedToGitHub
------------- --------------- ---------- --------------
e07fb938-091e-4f2f-8963-4d3e8EXAMPLE CodeDeployDemoApplication 7/20/2015 9:49:48 PM False
```
+ Einzelheiten zur API finden Sie unter [GetApplication AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDApplicationBatch`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDApplicationBatch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zu den angegebenen Anwendungen abgerufen.**
```
Get-CDApplicationBatch -ApplicationName CodeDeployDemoApplication, CodePipelineDemoApplication
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [BatchGetApplications AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDApplicationList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDApplicationList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste der verfügbaren Anwendungen abgerufen.**
```
Get-CDApplicationList
```
**Ausgabe:**
```
CodeDeployDemoApplication
CodePipelineDemoApplication
```
+ Einzelheiten zur API finden Sie unter [ListApplications AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDApplicationRevision`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDApplicationRevision`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zur angegebenen Anwendungsrevision abgerufen.**
```
$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)
```
**Ausgabe:**
```
Description = Application revision registered by Deployment ID: d-CX9CHN3EX, RegisterTime = 07/20/2015 23:46:42
```
+ Einzelheiten zur API finden Sie unter [GetApplicationRevision AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDApplicationRevisionList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDApplicationRevisionList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zu den verfügbaren Revisionen für die angegebene Anwendung abgerufen.**
```
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)
>> }
>> }
>>
```
**Ausgabe:**
```
Type = S3, Bucket = amzn-s3-demo-bucket, BundleType = zip, ETag = 4565c1ac97187f190c1a90265EXAMPLE, Key = 5xd27EX.zip
Type = GitHub, CommitId = f48933c3...76405362, Repository = MyGitHubUser/CodeDeployDemoRepo
```
+ Einzelheiten zur API finden Sie unter [ListApplicationRevisions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDDeployment`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDDeployment`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden zusammenfassende Informationen zur angegebenen Bereitstellung abgerufen.**
```
Get-CDDeployment -DeploymentId d-QZMRGSTEX
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden Informationen zum Status der Instances abgerufen, die an der angegebenen Bereitstellung beteiligt sind.**
```
(Get-CDDeployment -DeploymentId d-QZMRGSTEX).DeploymentOverview
```
**Ausgabe:**
```
Failed : 0
InProgress : 0
Pending : 0
Skipped : 0
Succeeded : 3
```
**Beispiel 3: Dieses Beispiel ruft Informationen zur Anwendungsrevision für die angegebene Bereitstellung ab.**
```
(Get-CDDeployment -DeploymentId d-QZMRGSTEX).Revision.S3Location
```
**Ausgabe:**
```
Bucket : amzn-s3-demo-bucket
BundleType : zip
ETag : cfbb81b304ee5e27efc21adaed3EXAMPLE
Key : clzfqEX
Version :
```
+ Einzelheiten zur API finden Sie unter [GetDeployment AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDDeploymentBatch`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDDeploymentBatch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zu den angegebenen Bereitstellungen abgerufen.**
```
Get-CDDeploymentBatch -DeploymentId d-QZMRGSTEX, d-RR0T5KTEX
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [BatchGetDeployments AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDDeploymentConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDDeploymentConfig`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden zusammenfassende Informationen zur angegebenen Bereitstellungskonfiguration abgerufen.**
```
Get-CDDeploymentConfig -DeploymentConfigName ThreeQuartersHealthy
```
**Ausgabe:**
```
CreateTime DeploymentConfigId DeploymentConfigName MinimumHealthyHosts
---------- ------------------ -------------------- -------------------
10/3/2014 4:32:30 PM 518a3950-d034-46a1-9d2c-3c949EXAMPLE ThreeQuartersHealthy Amazon.CodeDeploy.Model.MinimumHealthyHosts
```
**Beispiel 2: In diesem Beispiel werden Informationen zur Definition der angegebenen Bereitstellungskonfiguration abgerufen.**
```
Write-Output ((Get-CDDeploymentConfig -DeploymentConfigName ThreeQuartersHealthy).MinimumHealthyHosts)
```
**Ausgabe:**
```
Type Value
---- -----
FLEET_PERCENT 75
```
+ Einzelheiten zur API finden Sie unter [GetDeploymentConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDDeploymentConfigList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDDeploymentConfigList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste der verfügbaren Bereitstellungskonfigurationen abgerufen.**
```
Get-CDDeploymentConfigList
```
**Ausgabe:**
```
ThreeQuartersHealthy
CodeDeployDefault.OneAtATime
CodeDeployDefault.AllAtOnce
CodeDeployDefault.HalfAtATime
```
+ Einzelheiten zur API finden Sie unter [ListDeploymentConfigs AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDDeploymentGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDDeploymentGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zur angegebenen Bereitstellungsgruppe abgerufen.**
```
Get-CDDeploymentGroup -ApplicationName CodeDeployDemoApplication -DeploymentGroupName CodeDeployDemoFleet
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetDeploymentGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDDeploymentGroupList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDDeploymentGroupList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste von Bereitstellungsgruppen für die angegebene Anwendung abgerufen.**
```
Get-CDDeploymentGroupList -ApplicationName CodeDeployDemoApplication
```
**Ausgabe:**
```
ApplicationName DeploymentGroups NextToken
--------------- ---------------- ---------
CodeDeployDemoApplication {CodeDeployDemoFleet, CodeDeployProductionFleet}
```
+ Einzelheiten zur API finden Sie unter [ListDeploymentGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDDeploymentInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDDeploymentInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen über die angegebene Instance für die spezifizierte Bereitstellung abgerufen.**
```
Get-CDDeploymentInstance -DeploymentId d-QZMRGSTEX -InstanceId i-254e22EX
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetDeploymentInstance AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDDeploymentInstanceList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDDeploymentInstanceList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste von Instanzen IDs für die angegebene Bereitstellung abgerufen.**
```
Get-CDDeploymentInstanceList -DeploymentId d-QZMRGSTEX
```
**Ausgabe:**
```
i-254e22EX
i-274e22EX
i-3b4e22EX
```
+ Einzelheiten zur API finden Sie unter [ListDeploymentInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-CDDeploymentList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDDeploymentList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste der Bereitstellungen IDs für die angegebene Anwendung und Bereitstellungsgruppe abgerufen.**
```
Get-CDDeploymentList -ApplicationName CodeDeployDemoApplication -DeploymentGroupName CodeDeployDemoFleet
```
**Ausgabe:**
```
d-QZMRGSTEX
d-RR0T5KTEX
```
+ Einzelheiten zur API finden Sie unter [ListDeployments AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-CDOnPremiseInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDOnPremiseInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zu den angegebenen On-Premises-Instances abgerufen.**
```
Get-CDOnPremiseInstance -InstanceName AssetTag12010298EX
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [GetOnPremisesInstance AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDOnPremiseInstanceBatch`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDOnPremiseInstanceBatch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zu den angegebenen On-Premises-Instances abgerufen.**
```
Get-CDOnPremiseInstanceBatch -InstanceName AssetTag12010298EX, AssetTag12010298EX-2
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [BatchGetOnPremisesInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CDOnPremiseInstanceList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CDOnPremiseInstanceList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste der verfügbaren On-Premises-Instance-Namen abgerufen.**
```
Get-CDOnPremiseInstanceList
```
**Ausgabe:**
```
AssetTag12010298EX
AssetTag12010298EX-2
```
+ Einzelheiten zur API finden Sie unter [ListOnPremisesInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-CDApplication`
Das folgende Codebeispiel zeigt die Verwendung. `New-CDApplication`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Anwendung mit dem angegebenen Namen erstellt.**
```
New-CDApplication -ApplicationName MyNewApplication
```
**Ausgabe:**
```
f19e4b61-2231-4328-b0fd-e57f5EXAMPLE
```
+ Einzelheiten zur API finden Sie unter [CreateApplication AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-CDDeployment`
Das folgende Codebeispiel zeigt die Verwendung. `New-CDDeployment`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Bereitstellung für die angegebene Anwendung und Bereitstellungsgruppe mit der angegebenen Bereitstellungskonfiguration und Anwendungsversion erstellt.**
```
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
```
**Ausgabe:**
```
d-ZHROG7UEX
```
**Beispiel 2: Dieses Beispiel zeigt, wie Gruppen von EC2 Instanz-Tags angegeben werden, anhand derer eine Instanz identifiziert werden muss, damit sie in die Ersatzumgebung für eine blue/green Bereitstellung aufgenommen wird.**
```
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"})
```
**Ausgabe:**
```
d-ZHROG7UEX
```
+ Einzelheiten zur API finden Sie unter [CreateDeployment AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-CDDeploymentConfig`
Das folgende Codebeispiel zeigt die Verwendung. `New-CDDeploymentConfig`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Bereitstellungskonfiguration mit dem angegebenen Namen und Verhalten erstellt.**
```
New-CDDeploymentConfig -DeploymentConfigName AtLeastTwoHealthyHosts -MinimumHealthyHosts_Type HOST_COUNT -MinimumHealthyHosts_Value 2
```
**Ausgabe:**
```
0f3e8187-44ef-42da-aeed-b6823EXAMPLE
```
+ Einzelheiten zur API finden Sie unter [CreateDeploymentConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-CDDeploymentGroup`
Das folgende Codebeispiel zeigt die Verwendung. `New-CDDeploymentGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Bereitstellungsgruppe mit dem angegebenen Namen, der Auto-Scaling-Gruppe, der Bereitstellungskonfiguration, dem Tag und der Servicerolle für die angegebene Anwendung erstellt.**
```
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
```
**Ausgabe:**
```
16bbf199-95fd-40fc-a909-0bbcfEXAMPLE
```
**Beispiel 2: Dieses Beispiel zeigt, wie Gruppen von EC2 Instanz-Tags angegeben werden, anhand derer eine Instanz identifiziert werden muss, damit sie in die Ersatzumgebung für eine blue/green Bereitstellung aufgenommen wird.**
```
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"})
```
**Ausgabe:**
```
16bbf199-95fd-40fc-a909-0bbcfEXAMPLE
```
+ Einzelheiten zur API finden Sie unter [CreateDeploymentGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Register-CDApplicationRevision`
Das folgende Codebeispiel zeigt die Verwendung. `Register-CDApplicationRevision`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Anwendungsrevision mit dem angegebenen Amazon-S3-Standort für die angegebene Anwendung registriert.**
```
Register-CDApplicationRevision -ApplicationName MyNewApplication -S3Location_Bucket amzn-s3-demo-bucket -S3Location_BundleType zip -S3Location_Key aws-codedeploy_linux-master.zip -Revision_RevisionType S3
```
+ Einzelheiten zur API finden Sie unter [RegisterApplicationRevision AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-CDOnPremiseInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Register-CDOnPremiseInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine On-Premises-Instance mit dem angegebenen Namen und IAM-Benutzer registriert.**
```
Register-CDOnPremiseInstance -IamUserArn arn:aws:iam::80398EXAMPLE:user/CodeDeployDemoUser -InstanceName AssetTag12010298EX
```
+ Einzelheiten zur API finden Sie unter [RegisterOnPremisesInstance AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-CDApplication`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CDApplication`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Anwendung mit dem angegebenen Namen gelöscht. Der Befehl fordert Sie auf, den Vorgang zu bestätigen, bevor er ausgeführt wird. Fügen Sie den Parameter -Force hinzu, um die Anwendung ohne Prompt zu löschen.**
```
Remove-CDApplication -ApplicationName MyNewApplication
```
+ Einzelheiten zur API finden Sie unter [DeleteApplication AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-CDDeploymentConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CDDeploymentConfig`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Bereitstellungskonfiguration mit dem angegebenen Namen gelöscht. Der Befehl fordert Sie auf, den Vorgang zu bestätigen, bevor er ausgeführt wird. Fügen Sie den Parameter -Force hinzu, um die Bereitstellungskonfiguration ohne Prompt zu löschen.**
```
Remove-CDDeploymentConfig -DeploymentConfigName AtLeastTwoHealthyHosts
```
+ Einzelheiten zur API finden Sie unter [DeleteDeploymentConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-CDDeploymentGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CDDeploymentGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Bereitstellungsgruppe mit dem angegebenen Namen für die spezifizierte Anwendung gelöscht. Der Befehl fordert Sie auf, den Vorgang zu bestätigen, bevor er ausgeführt wird. Fügen Sie den Parameter -Force hinzu, um die Bereitstellungsgruppe ohne Prompt zu löschen.**
```
Remove-CDDeploymentGroup -ApplicationName MyNewApplication -DeploymentGroupName MyNewDeploymentGroup
```
+ Einzelheiten zur API finden Sie unter [DeleteDeploymentGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-CDOnPremiseInstanceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CDOnPremiseInstanceTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Tag für die On-Premises-Instance mit dem angegebenen Namen gelöscht. Der Befehl fordert Sie auf, den Vorgang zu bestätigen, bevor er ausgeführt wird. Fügen Sie den Parameter -Force hinzu, um das Tag ohne Prompt zu löschen.**
```
Remove-CDOnPremiseInstanceTag -InstanceName AssetTag12010298EX -Tag @{"Key" = "Name"; "Value" = "CodeDeployDemo-OnPrem"}
```
+ Einzelheiten zur API finden Sie unter [RemoveTagsFromOnPremisesInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Stop-CDDeployment`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-CDDeployment`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird versucht, die Bereitstellung mit der angegebenen Bereitstellungs-ID zu beenden.**
```
Stop-CDDeployment -DeploymentId d-LJQNREYEX
```
**Ausgabe:**
```
Status StatusMessage
------ -------------
Pending Stopping Pending. Stopping to schedule commands in the deployment instances
```
+ Einzelheiten zur API finden Sie unter [StopDeployment AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-CDOnPremiseInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-CDOnPremiseInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Registrierung der On-Premises-Instance mit dem angegebenen Namen aufgehoben.**
```
Unregister-CDOnPremiseInstance -InstanceName AssetTag12010298EX
```
+ Einzelheiten zur API finden Sie unter [DeregisterOnPremisesInstance AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-CDApplication`
Das folgende Codebeispiel zeigt die Verwendung. `Update-CDApplication`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Name der angegebenen Anwendung geändert.**
```
Update-CDApplication -ApplicationName MyNewApplication -NewApplicationName MyNewApplication-2
```
+ Einzelheiten zur API finden Sie unter [UpdateApplication AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-CDDeploymentGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Update-CDDeploymentGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Name der angegebenen Bereitstellungsgruppe für die angegebene Anwendung geändert.**
```
Update-CDDeploymentGroup -ApplicationName MyNewApplication -CurrentDeploymentGroupName MyNewDeploymentGroup -NewDeploymentGroupName MyNewDeploymentGroup-2
```
**Beispiel 2: Dieses Beispiel zeigt, wie Gruppen von EC2 Instanz-Tags angegeben werden, anhand derer eine Instanz identifiziert werden muss, damit sie in die Ersatzumgebung für eine blue/green Bereitstellung aufgenommen wird.**
```
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"})
```
+ Einzelheiten zur API finden Sie unter [UpdateDeploymentGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
# CodePipeline Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. CodePipeline
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Confirm-CPJob`
Das folgende Codebeispiel zeigt die Verwendung `Confirm-CPJob` von.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Status eines bestimmten Auftrags abgerufen.**
```
Confirm-CPJob -JobId f570dc12-5ef3-44bc-945a-6e133EXAMPLE -Nonce 3
```
**Ausgabe:**
```
Value
-----
InProgress
```
+ Einzelheiten zur API finden Sie unter [AcknowledgeJob AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Disable-CPStageTransition`
Das folgende Codebeispiel zeigt die Verwendung. `Disable-CPStageTransition`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der eingehende Übergang für die angegebene Phase in der angegebenen Pipeline deaktiviert.**
```
Disable-CPStageTransition -PipelineName CodePipelineDemo -Reason "Disabling temporarily." -StageName Beta -TransitionType Inbound
```
+ Einzelheiten zur API finden Sie unter [DisableStageTransition AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Enable-CPStageTransition`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-CPStageTransition`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der eingehende Übergang für die angegebene Phase in der angegebenen Pipeline aktiviert.**
```
Enable-CPStageTransition -PipelineName CodePipelineDemo -StageName Beta -TransitionType Inbound
```
+ Einzelheiten zur API finden Sie unter [EnableStageTransition AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CPActionType`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CPActionType`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen über alle verfügbaren Aktionen für den angegebenen Besitzer abgerufen.**
```
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)
}
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [ListActionTypes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CPActionableJobList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CPActionableJobList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen über alle Aufträge abgerufen, die für die angegebene Aktionskategorie, den Besitzer, den Anbieter, die Version und die Abfrageparameter ausgeführt werden können.**
```
Get-CPActionableJobList -ActionTypeId_Category Build -ActionTypeId_Owner Custom -ActionTypeId_Provider MyCustomProviderName -ActionTypeId_Version 1 -QueryParam @{"ProjectName" = "MyProjectName"}
```
**Ausgabe:**
```
AccountId Data Id Nonce
--------- ---- -- -----
80398EXAMPLE Amazon.CodePipeline.Model.JobData 0de392f5-712d-4f41-ace3-f57a0EXAMPLE 3
```
+ Einzelheiten zur API finden Sie unter [PollForJobs AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CPJobDetail`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CPJobDetail`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden allgemeine Informationen zum angegebenen Auftrag abgerufen.**
```
Get-CPJobDetail -JobId f570dc12-5ef3-44bc-945a-6e133EXAMPLE
```
**Ausgabe:**
```
AccountId Data Id
--------- ---- --
80398EXAMPLE Amazon.CodePipeline.Model.JobData f570dc12-5ef3-44bc-945a-6e133EXAMPLE
```
**Beispiel 2: In diesem Beispiel werden detaillierte Informationen zum angegebenen Auftrag abgerufen.**
```
$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)
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetJobDetails AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CPPipeline`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CPPipeline`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden allgemeine Informationen zur angegebenen Pipeline abgerufen.**
```
Get-CPPipeline -Name CodePipelineDemo -Version 1
```
**Ausgabe:**
```
ArtifactStore : Amazon.CodePipeline.Model.ArtifactStore
Name : CodePipelineDemo
RoleArn : arn:aws:iam::80398EXAMPLE:role/CodePipelineServiceRole
Stages : {Source, Build, Beta, TestStage}
Version : 1
```
**Beispiel 2: In diesem Beispiel werden detaillierte Informationen zur angegebenen Pipeline abgerufen.**
```
$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)
}
}
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetPipeline AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CPPipelineList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CPPipelineList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste der verfügbaren Pipelines abgerufen.**
```
Get-CPPipelineList
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListPipelines AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CPPipelineState`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CPPipelineState`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden allgemeine Informationen zu den Phasen der angegebenen Pipeline abgerufen.**
```
Get-CPPipelineState -Name CodePipelineDemo
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden detaillierte Informationen über den Status der angegebenen Pipeline abgerufen.**
```
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)
}
}
```
**Ausgabe:**
```
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 =
```
+ Einzelheiten zur API finden Sie unter [GetPipelineState AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-CPCustomActionType`
Das folgende Codebeispiel zeigt die Verwendung. `New-CPCustomActionType`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue benutzerdefinierte Aktion mit den angegebenen Eigenschaften erstellt.**
```
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
```
**Ausgabe:**
```
ActionConfigurationProperties : {ProjectName}
Id : Amazon.CodePipeline.Model.ActionTypeId
InputArtifactDetails : Amazon.CodePipeline.Model.ArtifactDetails
OutputArtifactDetails : Amazon.CodePipeline.Model.ArtifactDetails
Settings : Amazon.CodePipeline.Model.ActionTypeSettings
```
+ Einzelheiten zur API finden Sie unter [CreateCustomActionType AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-CPPipeline`
Das folgende Codebeispiel zeigt die Verwendung. `New-CPPipeline`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Pipeline mit den angegebenen Einstellungen erstellt.**
```
$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
```
**Ausgabe:**
```
ArtifactStore : Amazon.CodePipeline.Model.ArtifactStore
Name : CodePipelineDemo
RoleArn : arn:aws:iam::80398EXAMPLE:role/CodePipelineServiceRole
Stages : {Source, Beta}
Version : 1
```
+ Einzelheiten zur API finden Sie unter [CreatePipeline AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-CPCustomActionType`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CPCustomActionType`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene benutzerdefinierte Aktion gelöscht. Der Befehl fordert Sie auf, den Vorgang zu bestätigen, bevor er ausgeführt wird. Fügen Sie den Parameter -Force hinzu, um die benutzerdefinierte Aktion ohne Prompt zu löschen.**
```
Remove-CPCustomActionType -Category Build -Provider MyBuildProviderName -Version 1
```
+ Einzelheiten zur API finden Sie unter [DeleteCustomActionType AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-CPPipeline`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CPPipeline`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Pipeline gelöscht. Der Befehl fordert Sie auf, den Vorgang zu bestätigen, bevor er ausgeführt wird. Fügen Sie den Parameter -Force hinzu, um die Pipeline ohne Prompt zu löschen.**
```
Remove-CPPipeline -Name CodePipelineDemo
```
+ Einzelheiten zur API finden Sie unter [DeletePipeline AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Start-CPPipelineExecution`
Das folgende Codebeispiel zeigt die Verwendung. `Start-CPPipelineExecution`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird mit der Ausführung der angegebenen Pipeline begonnen.**
```
Start-CPPipelineExecution -Name CodePipelineDemo
```
+ Einzelheiten zur API finden Sie unter [StartPipelineExecution AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-CPPipeline`
Das folgende Codebeispiel zeigt die Verwendung. `Update-CPPipeline`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene vorhandene Pipeline mit den angegebenen Einstellungen aktualisiert.**
```
$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
```
**Ausgabe:**
```
ArtifactStore : Amazon.CodePipeline.Model.ArtifactStore
Name : CodePipelineDemo
RoleArn : arn:aws:iam::80398EXAMPLE:role/CodePipelineServiceRole
Stages : {InputFiles, TestDeployment}
Version : 2
```
+ Einzelheiten zur API finden Sie unter [UpdatePipeline AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Beispiele für Amazon Cognito Identity mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon Cognito Identity Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-CGIIdentityPool`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CGIIdentityPool`
**Tools für PowerShell V5**
**Beispiel 1: Ruft Informationen über einen bestimmten Identitätspool anhand seiner ID ab.**
```
Get-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeIdentityPool AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CGIIdentityPoolList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CGIIdentityPoolList`
**Tools für PowerShell V5**
**Beispiel 1: Ruft eine Liste vorhandener Identitätspools ab.**
```
Get-CGIIdentityPoolList
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListIdentityPools AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CGIIdentityPoolRole`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CGIIdentityPoolRole`
**Tools für PowerShell V5**
**Beispiel 1: Ruft die Informationen über Rollen für einen bestimmten Identitätspool ab.**
```
Get-CGIIdentityPoolRole -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetIdentityPoolRoles AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-CGIIdentityPool`
Das folgende Codebeispiel zeigt die Verwendung. `New-CGIIdentityPool`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt einen neuen Identitätspool, der nicht authentifizierte Identitäten zulässt.**
```
New-CGIIdentityPool -AllowUnauthenticatedIdentities $true -IdentityPoolName CommonTests13
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateIdentityPool AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-CGIIdentityPool`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CGIIdentityPool`
**Tools für PowerShell V5**
**Beispiel 1: Löscht einen bestimmten Identitätspool.**
```
Remove-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
+ Einzelheiten zur API finden Sie unter [DeleteIdentityPool AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-CGIIdentityPoolRole`
Das folgende Codebeispiel zeigt die Verwendung. `Set-CGIIdentityPoolRole`
**Tools für PowerShell V5**
**Beispiel 1: Konfiguriert den spezifischen Identitätspool so, dass er über eine nicht authentifizierte IAM-Rolle verfügt.**
```
Set-CGIIdentityPoolRole -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1 -Role @{ "unauthenticated" = "arn:aws:iam::123456789012:role/CommonTests1Role" }
```
+ Einzelheiten zur API finden Sie unter [SetIdentityPoolRoles AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-CGIIdentityPool`
Das folgende Codebeispiel zeigt die Verwendung. `Update-CGIIdentityPool`
**Tools für PowerShell V5**
**Beispiel 1: Aktualisiert einige Eigenschaften des Identitätspools, in diesem Fall den Namen des Identitätspools.**
```
Update-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1 -IdentityPoolName NewPoolName
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UpdateIdentityPool AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# AWS Config Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. AWS Config
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-CFGResourceTag`
Das folgende Codebeispiel zeigt die Verwendung `Add-CFGResourceTag` von.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Tag dem Ressourcen-ARN zugeordnet, in diesem Fall config-rule/config-rule-16iyn0. **
```
Add-CFGResourceTag -ResourceArn arn:aws:config:eu-west-1:123456789012:config-rule/config-rule-16iyn0 -Tag @{Key="Release";Value="Beta"}
```
+ Einzelheiten zur API finden Sie unter [TagResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGAggregateComplianceByConfigRuleList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGAggregateComplianceByConfigRuleList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Details aus der ConfigurationAggregator „Kaju“ -Filterung für die angegebene Konfigurationsregel und die „Einhaltung“ expands/returns der Regel abgerufen.**
```
Get-CFGAggregateComplianceByConfigRuleList -ConfigurationAggregatorName kaju -Filters_ConfigRuleName ALB_HTTP_TO_HTTPS_REDIRECTION_CHECK | Select-Object -ExpandProperty Compliance
```
**Ausgabe:**
```
ComplianceContributorCount ComplianceType
-------------------------- --------------
Amazon.ConfigService.Model.ComplianceContributorCount NON_COMPLIANT
```
**Beispiel 2: In diesem Beispiel werden Details aus der angegebenen Datei abgerufen ConfigurationAggregator, nach dem angegebenen Konto für alle im Aggregator abgedeckten Regionen gefiltert und anschließend die Konformität für alle Regeln zurückgegeben.**
```
Get-CFGAggregateComplianceByConfigRuleList -ConfigurationAggregatorName kaju -Filters_AccountId 123456789012 | Select-Object ConfigRuleName, @{N="Compliance";E={$_.Compliance.ComplianceType}}
```
**Ausgabe:**
```
ConfigRuleName Compliance
-------------- ----------
ALB_HTTP_TO_HTTPS_REDIRECTION_CHECK NON_COMPLIANT
ec2-instance-no-public-ip NON_COMPLIANT
desired-instance-type NON_COMPLIANT
```
+ Einzelheiten zur API finden Sie unter [DescribeAggregateComplianceByConfigRules AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-CFGAggregateComplianceDetailsByConfigRule`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGAggregateComplianceDetailsByConfigRule`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt die Auswertungsergebnisse zurück und wählt die Ausgabe mit der Ressourcen-ID und dem Ressourcentyp für die AWS Konfigurationsregel 'desired-instance-type' aus, die sich für das angegebene Konto, den Aggregator, die Region und die Konfigurationsregel im Status 'COMPLIANT' befinden**
```
Get-CFGAggregateComplianceDetailsByConfigRule -AccountId 123456789012 -AwsRegion eu-west-1 -ComplianceType COMPLIANT -ConfigRuleName desired-instance-type -ConfigurationAggregatorName raju | Select-Object -ExpandProperty EvaluationResultIdentifier | Select-Object -ExpandProperty EvaluationResultQualifier
```
**Ausgabe:**
```
ConfigRuleName ResourceId ResourceType
-------------- ---------- ------------
desired-instance-type i-0f1bf2f34c5678d12 AWS::EC2::Instance
desired-instance-type i-0fd12dd3456789123 AWS::EC2::Instance
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([GetAggregateComplianceDetailsByConfigRule](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Get-CFGAggregateConfigRuleComplianceSummary`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGAggregateConfigRuleComplianceSummary`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Anzahl der nicht konformen Regeln für den bestimmten Aggregator zurückgegeben.**
```
(Get-CFGAggregateConfigRuleComplianceSummary -ConfigurationAggregatorName raju).AggregateComplianceCounts.ComplianceSummary.NonCompliantResourceCount
```
**Ausgabe:**
```
CapExceeded CappedCount
----------- -----------
False 5
```
+ Einzelheiten zur API finden Sie unter [GetAggregateConfigRuleComplianceSummary AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGAggregateDiscoveredResourceCount`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGAggregateDiscoveredResourceCount`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Ressourcenanzahl für den bestimmten Aggregator zurückgegeben, gefiltert nach der Region us-east-1.**
```
Get-CFGAggregateDiscoveredResourceCount -ConfigurationAggregatorName Master -Filters_Region us-east-1
```
**Ausgabe:**
```
GroupByKey GroupedResourceCounts NextToken TotalDiscoveredResources
---------- --------------------- --------- ------------------------
{} 455
```
**Beispiel 2: In diesem Beispiel wird die Ressourcenanzahl gruppiert nach RESOURCE\$1TYPE für die gefilterte Region für den bestimmten Aggregator zurückgegeben.**
```
Get-CFGAggregateDiscoveredResourceCount -ConfigurationAggregatorName Master -Filters_Region us-east-1 -GroupByKey RESOURCE_TYPE |
Select-Object -ExpandProperty GroupedResourceCounts
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetAggregateDiscoveredResourceCounts AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGAggregateDiscoveredResourceList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGAggregateDiscoveredResourceList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Ressourcen-IDs für den angegebenen Ressourcentyp zurückgegeben, aggregiert im Aggregator „Irland“. Eine Liste der Ressourcentypen finden Sie unter https://docs.aws.amazon.com/sdkfornet/ v4/ .html&tocid=Amazon\$1 \$1apidocs/index.html?page=ConfigService/TConfigServiceResourceType. ConfigService ResourceType**
```
Get-CFGAggregateDiscoveredResourceList -ConfigurationAggregatorName Ireland -ResourceType ([Amazon.ConfigService.ResourceType]::AWSAutoScalingAutoScalingGroup)
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel wird der Ressourcentyp `AwsEC2SecurityGroup` namens „default“ für den bestimmten Aggregator zurückgegeben, gefiltert nach der Region us-east-1.**
```
Get-CFGAggregateDiscoveredResourceList -ConfigurationAggregatorName raju -ResourceType ([Amazon.ConfigService.ResourceType]::AWSEC2SecurityGroup) -Filters_Region us-east-1 -Filters_ResourceName default
```
**Ausgabe:**
```
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
```
+ *Einzelheiten zur API finden Sie unter Cmdlet-Referenz (V5). [ListAggregateDiscoveredResources](https://docs.aws.amazon.com/powershell/v5/reference)AWS -Tools für PowerShell *
### `Get-CFGAggregateResourceConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGAggregateResourceConfig`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Konfigurationselement für die angegebene Ressource zusammengefasst zurückgegeben und die Konfiguration erweitert.**
```
(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
```
**Ausgabe:**
```
{"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"}
```
+ Einzelheiten zur API finden Sie unter [GetAggregateResourceconfig-service](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz* (V5).
### `Get-CFGAggregateResourceConfigBatch`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGAggregateResourceConfigBatch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das aktuelle Konfigurationselement für die Ressource (identifiziert) abgerufen, die im angegebenen Aggregator vorhanden ist.**
```
$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
```
**Ausgabe:**
```
BaseConfigurationItems UnprocessedResourceIdentifiers
---------------------- ------------------------------
{} {arn:aws:ec2:eu-west-1:123456789012:instance/i-012e3cb4df567e8aa}
```
+ Einzelheiten zur API finden Sie unter [BatchGetAggregateResourceconfig-service](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz* (V5).
### `Get-CFGAggregationAuthorizationList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGAggregationAuthorizationList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Autorisierungen abgerufen, die Aggregatoren erteilt wurden.**
```
Get-CFGAggregationAuthorizationList
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeAggregationAuthorizations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGComplianceByConfigRule`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGComplianceByConfigRule`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Konformitätsdetails für die Regel abgerufen ebs-optimized-instance, für die es keine aktuellen Bewertungsergebnisse für die Regel gibt. Daher wird INSUFFICIENT\$1DATA zurückgegeben**
```
(Get-CFGComplianceByConfigRule -ConfigRuleName ebs-optimized-instance).Compliance
```
**Ausgabe:**
```
ComplianceContributorCount ComplianceType
-------------------------- --------------
INSUFFICIENT_DATA
```
**Beispiel 2: In diesem Beispiel wird die Anzahl der nicht konformen Ressourcen für die Regel „ALB\$1HTTP\$1TO\$1HTTPS\$1REDIRECTION\$1CHECK“ zurückgegeben.**
```
(Get-CFGComplianceByConfigRule -ConfigRuleName ALB_HTTP_TO_HTTPS_REDIRECTION_CHECK -ComplianceType NON_COMPLIANT).Compliance.ComplianceContributorCount
```
**Ausgabe:**
```
CapExceeded CappedCount
----------- -----------
False 2
```
+ *Einzelheiten zur API finden Sie unter [DescribeComplianceByConfigRule](https://docs.aws.amazon.com/powershell/v5/reference)Cmdlet-Referenz (V5).AWS -Tools für PowerShell *
### `Get-CFGComplianceByResource`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGComplianceByResource`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Ressourcentyp `AWS::SSM::ManagedInstanceInventory` auf den Konformitätstyp „COMPLIANT“ überprüft.**
```
Get-CFGComplianceByResource -ComplianceType COMPLIANT -ResourceType AWS::SSM::ManagedInstanceInventory
```
**Ausgabe:**
```
Compliance ResourceId ResourceType
---------- ---------- ------------
Amazon.ConfigService.Model.Compliance i-0123bcf4b567890e3 AWS::SSM::ManagedInstanceInventory
Amazon.ConfigService.Model.Compliance i-0a1234f6f5d6b78f7 AWS::SSM::ManagedInstanceInventory
```
+ Einzelheiten zur API finden Sie unter [DescribeComplianceByResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGComplianceDetailsByConfigRule`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGComplianceDetailsByConfigRule`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Auswertungsergebnisse für die Regel abgerufen access-keys-rotated und die Ausgabe nach Konformitätstyp gruppiert zurückgegeben**
```
Get-CFGComplianceDetailsByConfigRule -ConfigRuleName access-keys-rotated | Group-Object ComplianceType
```
**Ausgabe:**
```
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...
```
**Beispiel 2: In diesem Beispiel werden Konformitätsdetails für die Regel access-keys-rotated für COMPLIANT-Ressourcen abgefragt.**
```
Get-CFGComplianceDetailsByConfigRule -ConfigRuleName access-keys-rotated -ComplianceType COMPLIANT | ForEach-Object {$_.EvaluationResultIdentifier.EvaluationResultQualifier}
```
**Ausgabe:**
```
ConfigRuleName ResourceId ResourceType
-------------- ---------- ------------
access-keys-rotated BCAB1CDJ2LITAPVEW3JAH AWS::IAM::User
access-keys-rotated BCAB1CDJ2LITL3EHREM4Q AWS::IAM::User
```
+ Einzelheiten zur API finden Sie unter [GetComplianceDetailsByConfigRule AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-CFGComplianceDetailsByResource`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGComplianceDetailsByResource`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel für die Auswertungsergebnisse für die angegebene Ressource.**
```
Get-CFGComplianceDetailsByResource -ResourceId ABCD5STJ4EFGHIVEW6JAH -ResourceType 'AWS::IAM::User'
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [GetComplianceDetailsByResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGComplianceSummaryByConfigRule`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGComplianceSummaryByConfigRule`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt die Anzahl der Config-Regeln zurück, die nicht konform sind.**
```
Get-CFGComplianceSummaryByConfigRule -Select ComplianceSummary.NonCompliantResourceCount
```
**Ausgabe:**
```
CapExceeded CappedCount
----------- -----------
False 9
```
+ Einzelheiten zur API finden Sie unter [GetComplianceSummaryByConfigRule AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGComplianceSummaryByResourceType`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGComplianceSummaryByResourceType`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt die Anzahl der Ressourcen zurück, die konform oder nicht konform sind, und konvertiert die Ausgabe in 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
}
}
```
+ Einzelheiten zur API finden Sie unter [GetComplianceSummaryByResourceType AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGConfigRule`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGConfigRule`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Konfigurationsregeln für das Konto mit ausgewählten Eigenschaften aufgeführt.**
```
Get-CFGConfigRule | Select-Object ConfigRuleName, ConfigRuleId, ConfigRuleArn, ConfigRuleState
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeConfigRules AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGConfigRuleEvaluationStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGConfigRuleEvaluationStatus`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Statusinformationen für die angegebenen Konfigurationsregeln zurückgegeben. **
```
Get-CFGConfigRuleEvaluationStatus -ConfigRuleName root-account-mfa-enabled, vpc-flow-logs-enabled
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeConfigRuleEvaluationStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGConfigurationAggregatorList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGConfigurationAggregatorList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt alle Aggregatoren für die Region/das Konto zurück.**
```
Get-CFGConfigurationAggregatorList
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeConfigurationAggregators AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGConfigurationAggregatorSourcesStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGConfigurationAggregatorSourcesStatus`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden angeforderte Felder für die Quellen im angegebenen Aggregator angezeigt.**
```
Get-CFGConfigurationAggregatorSourcesStatus -ConfigurationAggregatorName raju | select SourceType, LastUpdateStatus, LastUpdateTime, SourceId
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeConfigurationAggregatorSourcesStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGConfigurationRecorder`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGConfigurationRecorder`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Details von Konfigurations-Recorders zurückgegeben.**
```
Get-CFGConfigurationRecorder | Format-List
```
**Ausgabe:**
```
Name : default
RecordingGroup : Amazon.ConfigService.Model.RecordingGroup
RoleARN : arn:aws:iam::123456789012:role/aws-service-role/config.amazonaws.com/AWSServiceRoleForConfig
```
+ Einzelheiten zur API finden Sie unter [DescribeConfigurationRecorders AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGConfigurationRecorderStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGConfigurationRecorderStatus`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt den Status der Konfigurations-Recorder zurück. **
```
Get-CFGConfigurationRecorderStatus
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeConfigurationRecorderStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGConformancePack`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGConformancePack`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Conformance Packs aufgeführt.**
```
Get-CFGConformancePack
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeConformancePacks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGDeliveryChannel`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGDeliveryChannel`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Lieferkanal für die Region abgerufen und Details angezeigt.**
```
Get-CFGDeliveryChannel -Region eu-west-1 | Select-Object Name, S3BucketName, S3KeyPrefix, @{N="DeliveryFrequency";E={$_.ConfigSnapshotDeliveryProperties.DeliveryFrequency}}
```
**Ausgabe:**
```
Name S3BucketName S3KeyPrefix DeliveryFrequency
---- ------------ ----------- -----------------
default config-bucket-NA my TwentyFour_Hours
```
+ Einzelheiten zur API finden Sie unter [DescribeDeliveryChannels AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-CFGResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-CFGResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die zugehörigen Tags für die angegebene Ressource aufgelistet**
```
Get-CFGResourceTag -ResourceArn $rules[0].ConfigRuleArn
```
**Ausgabe:**
```
Key Value
--- -----
Version 1.3
```
+ Einzelheiten zur API finden Sie unter [ListTagsForResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-CFGConformancePack`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-CFGConformancePack`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Konformitätspaket zusammen mit allen Regeln, Behebungsmaßnahmen und Bewertungsergebnissen für das Paket entfernt.**
```
Remove-CFGConformancePack -ConformancePackName dono
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteConformancePack AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-CFGConformancePack`
Das folgende Codebeispiel zeigt die Verwendung. `Write-CFGConformancePack`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Konformitätspaket erstellt, wobei die Vorlage aus der angegebenen Yaml-Datei abgerufen wird.**
```
Write-CFGConformancePack -ConformancePackName dono -DeliveryS3Bucket amzn-s3-demo-bucket -TemplateBody (Get-Content C:\windows\temp\template.yaml -Raw)
```
+ Einzelheiten zur API finden Sie unter [PutConformancePack AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-CFGDeliveryChannel`
Das folgende Codebeispiel zeigt die Verwendung. `Write-CFGDeliveryChannel`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die deliveryFrequency-Eigenschaft eines vorhandenen Lieferkanals geändert.**
```
Write-CFGDeliveryChannel -ConfigSnapshotDeliveryProperties_DeliveryFrequency TwentyFour_Hours -DeliveryChannelName default -DeliveryChannel_S3BucketName amzn-s3-demo-bucket -DeliveryChannel_S3KeyPrefix my
```
+ Einzelheiten zur API finden Sie unter [PutDeliveryChannel AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Beispiele für Device Farm mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Device Farm Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `New-DFUpload`
Das folgende Codebeispiel zeigt die Verwendung`New-DFUpload`.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein AWS Device Farm Farm-Upload für eine Android-App erstellt. Sie können den Projekt-ARN aus der Ausgabe von New- DFProject oder Get- DFProject List abrufen. Verwenden Sie die signierte URL in der DFUpload Ausgabe New-, um eine Datei auf Device Farm hochzuladen.**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateUpload AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
# Directory Service Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. Directory Service
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-DSIpRoute`
Das folgende Codebeispiel zeigt die Verwendung `Add-DSIpRoute` von.
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl entfernt das Ressourcen-Tag, das der angegebenen Directory-id zugewiesen ist**
```
Add-DSIpRoute -DirectoryId d-123456ijkl -IpRoute @{CidrIp ="203.0.113.5/32"} -UpdateSecurityGroupForDirectoryController $true
```
+ Einzelheiten zur API finden Sie unter [AddIpRoutes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Add-DSResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Add-DSResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl fügt das Ressourcen-Tag zur angegebenen Directory-id hinzu**
```
Add-DSResourceTag -ResourceId d-123456ijkl -Tag @{Key="myTag"; Value="mytgValue"}
```
+ Einzelheiten zur API finden Sie unter [AddTagsToResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Approve-DSTrust`
Das folgende Codebeispiel zeigt die Verwendung. `Approve-DSTrust`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der AWS Directory Service VerifyTrust API-Vorgang für die angegebene Trustid aufgerufen.**
```
Approve-DSTrust -TrustId t-9067157123
```
+ Einzelheiten zur API finden Sie unter [VerifyTrust AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Confirm-DSSharedDirectory`
Das folgende Codebeispiel zeigt die Verwendung. `Confirm-DSSharedDirectory`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel akzeptiert eine vom Verzeichnisbesitzer AWS-Konto gesendete Anfrage zur gemeinsamen Nutzung von Verzeichnissen.**
```
Confirm-DSSharedDirectory -SharedDirectoryId d-9067012345
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [AcceptSharedDirectory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Connect-DSDirectory`
Das folgende Codebeispiel zeigt die Verwendung. `Connect-DSDirectory`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein AD Connector für die Verbindung zu einem lokalen Verzeichnis erstellt.**
```
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
```
+ Einzelheiten zur API finden Sie unter [ConnectDirectory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Deny-DSSharedDirectory`
Das folgende Codebeispiel zeigt die Verwendung. `Deny-DSSharedDirectory`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Verzeichnisfreigabeanforderung, die vom Konto des Verzeichniseigentümers gesendet wurde, abgelehnt. **
```
Deny-DSSharedDirectory -SharedDirectoryId d-9067012345
```
**Ausgabe:**
```
d-9067012345
```
+ Einzelheiten zur API finden Sie unter [RejectSharedDirectory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Disable-DSDirectoryShare`
Das folgende Codebeispiel zeigt die Verwendung. `Disable-DSDirectoryShare`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Verzeichnisfreigabe für das Verzeichniseigentümer- und -verbraucherkonto gestoppt. **
```
Disable-DSDirectoryShare -DirectoryId d-123456ijkl -UnshareTarget_Id 123456784321 -UnshareTarget_Type ACCOUNT
```
**Ausgabe:**
```
d-9067012345
```
+ Einzelheiten zur API finden Sie unter [UnshareDirectory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Disable-DSLDAPS`
Das folgende Codebeispiel zeigt die Verwendung. `Disable-DSLDAPS`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden sichere LDAP-Aufrufe für das angegebene Verzeichnis deaktiviert.**
```
Disable-DSLDAPS -DirectoryId d-123456ijkl -Type Client
```
+ Weitere API-Informationen finden Sie unter [DisableLDAPS](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*.
### `Disable-DSRadius`
Das folgende Codebeispiel zeigt, wie man es benutzt`Disable-DSRadius`.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der RADIUS-Server deaktiviert, der für einen AD Connector oder ein Microsoft AD-Verzeichnis konfiguriert ist.**
```
Disable-DSRadius -DirectoryId d-123456ijkl
```
+ Einzelheiten zur API finden Sie unter [DisableRadius AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Disable-DSSso`
Das folgende Codebeispiel zeigt die Verwendung. `Disable-DSSso`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird Single Sign-On für ein Verzeichnis deaktiviert.**
```
Disable-DSSso -DirectoryId d-123456ijkl
```
+ Einzelheiten zur API finden Sie unter [DisableSso AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Enable-DSDirectoryShare`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-DSDirectoryShare`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein bestimmtes Verzeichnis in Ihrem AWS Konto mithilfe der Handshake-Methode mit einem anderen AWS Konto geteilt.**
```
Enable-DSDirectoryShare -DirectoryId d-123456ijkl -ShareTarget_Id 123456784321 -ShareMethod HANDSHAKE -ShareTarget_Type ACCOUNT
```
**Ausgabe:**
```
d-9067012345
```
+ Einzelheiten zur API finden Sie unter [ShareDirectory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Enable-DSLDAPS`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-DSLDAPS`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Schalter für das jeweilige Verzeichnis aktiviert, um immer sichere LDAP-Aufrufe zu verwenden.**
```
Enable-DSLDAPS -DirectoryId d-123456ijkl -Type Client
```
+ Weitere API-Informationen finden Sie unter [EnableLDAPS](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*.
### `Enable-DSRadius`
Das folgende Codebeispiel zeigt, wie man es benutzt`Enable-DSRadius`.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Multi-Faktor-Authentifizierung (MFA) mit der bereitgestellten RADIUS-Serverkonfiguration für einen AD Connector oder ein Microsoft AD-Verzeichnis aktiviert.**
```
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
```
+ Einzelheiten zur API finden Sie unter [EnableRadius AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Enable-DSSso`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-DSSso`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird Single Sign-On für ein Verzeichnis aktiviert. **
```
Enable-DSSso -DirectoryId d-123456ijkl
```
+ Einzelheiten zur API finden Sie unter [EnableSso AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen über das Zertifikat angezeigt, das für eine gesicherte LDAP-Verbindung registriert ist.**
```
Get-DSCertificate -DirectoryId d-123456ijkl -CertificateId c-906731e34f
```
**Ausgabe:**
```
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.
```
+ Einzelheiten zur API finden Sie unter [DescribeCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSCertificateList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSCertificateList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Zertifikate aufgelistet, die für eine gesicherte LDAP-Verbindung für ein angegebenes Verzeichnis registriert sind.**
```
Get-DSCertificateList -DirectoryId d-123456ijkl
```
**Ausgabe:**
```
CertificateId CommonName ExpiryDateTime State
------------- ---------- -------------- -----
c-906731e34f contoso-EC2AMAZ-CTGG2NM-CA 4/15/2025 6:34:15 PM Registered
```
+ Einzelheiten zur API finden Sie unter [ListCertificates AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSConditionalForwarder`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSConditionalForwarder`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl werden alle konfigurierten bedingten Weiterleitungen der angegebenen Directory-id abgerufen. **
```
Get-DSConditionalForwarder -DirectoryId d-123456ijkl
```
**Ausgabe:**
```
DnsIpAddrs RemoteDomainName ReplicationScope
---------- ---------------- ----------------
{172.31.77.239} contoso.com Domain
```
+ Einzelheiten zur API finden Sie unter [DescribeConditionalForwarders AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSDirectory`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSDirectory`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl ruft Informationen über die Verzeichnisse ab, die zu diesem Konto gehören.**
```
Get-DSDirectory | Select-Object DirectoryId, Name, DnsIpAddrs, Type
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeDirectories AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSDirectoryLimit`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSDirectoryLimit`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Informationen über das Verzeichnislimit für die Region us-east-1 angezeigt. **
```
Get-DSDirectoryLimit -Region us-east-1
```
**Ausgabe:**
```
CloudOnlyDirectoriesCurrentCount : 1
CloudOnlyDirectoriesLimit : 10
CloudOnlyDirectoriesLimitReached : False
CloudOnlyMicrosoftADCurrentCount : 1
CloudOnlyMicrosoftADLimit : 20
CloudOnlyMicrosoftADLimitReached : False
ConnectedDirectoriesCurrentCount : 1
ConnectedDirectoriesLimit : 10
```
+ Einzelheiten zur API finden Sie unter [GetDirectoryLimits AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSDomainControllerList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSDomainControllerList`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl wird die detaillierte Liste der Domaincontroller abgerufen, die für die angegebene directory-id gestartet wurden**
```
Get-DSDomainControllerList -DirectoryId d-123456ijkl
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeDomainControllers AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSEventTopic`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSEventTopic`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl zeigt Informationen zum konfigurierten SNS-Thema als Benachrichtigung an, wenn sich der Verzeichnisstatus ändert.**
```
Get-DSEventTopic -DirectoryId d-123456ijkl
```
**Ausgabe:**
```
CreatedDateTime : 12/13/2019 11:15:32 AM
DirectoryId : d-123456ijkl
Status : Registered
TopicArn : arn:aws:sns:us-east-1:123456781234:snstopicname
TopicName : snstopicname
```
+ Einzelheiten zur API finden Sie unter [DescribeEventTopics AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSIpRouteList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSIpRouteList`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl werden die im Verzeichnis-IP-Routing konfigurierten öffentlichen IP-Adressblöcke abgerufen**
```
Get-DSIpRouteList -DirectoryId d-123456ijkl
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [ListIpRoutes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSLDAPSSetting`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSLDAPSSetting`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Status der LDAP-Sicherheit für das angegebene Verzeichnis beschrieben.**
```
Get-DSLDAPSSetting -DirectoryId d-123456ijkl
```
**Ausgabe:**
```
LastUpdatedDateTime LDAPSStatus LDAPSStatusReason
------------------- ----------- -----------------
4/15/2020 6:51:03 PM Enabled LDAPS is enabled successfully.
```
+ Einzelheiten zur API finden Sie unter [Describe LDAPSSettings](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `Get-DSLogSubscriptionList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSLogSubscriptionList`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl werden die Protokollabonnementinformationen der angegebenen directory-id abgerufen **
```
Get-DSLogSubscriptionList -DirectoryId d-123456ijkl
```
**Ausgabe:**
```
DirectoryId LogGroupName SubscriptionCreatedDateTime
----------- ------------ ---------------------------
d-123456ijkl /aws/directoryservice/d-123456ijkl-lan2.example.com 12/14/2019 9:05:23 AM
```
+ Einzelheiten zur API finden Sie unter [ListLogSubscriptions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl werden alle Tags des angegebenen Verzeichnisses abgerufen.**
```
Get-DSResourceTag -ResourceId d-123456ijkl
```
**Ausgabe:**
```
Key Value
--- -----
myTag myTagValue
```
+ Einzelheiten zur API finden Sie unter [ListTagsForResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSSchemaExtension`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSSchemaExtension`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Schemaerweiterungen, die auf ein Microsoft AD-Verzeichnis angewendet werden, aufgelistet.**
```
Get-DSSchemaExtension -DirectoryId d-123456ijkl
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListSchemaExtensions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSSharedDirectory`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSSharedDirectory`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die geteilten Verzeichnisse Ihres Kontos abgerufen AWS **
```
Get-DSSharedDirectory -OwnerDirectoryId d-123456ijkl -SharedDirectoryId d-9067012345
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeSharedDirectories AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-DSSnapshot`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSSnapshot`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl ruft Informationen über die angegebenen Verzeichnis-Snapshots ab, die zu diesem Konto gehören.**
```
Get-DSSnapshot -DirectoryId d-123456ijkl
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeSnapshots AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSSnapshotLimit`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSSnapshotLimit`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl werden die manuellen Snapshot-Limits für ein angegebenes Verzeichnis abgerufen.**
```
Get-DSSnapshotLimit -DirectoryId d-123456ijkl
```
**Ausgabe:**
```
ManualSnapshotsCurrentCount ManualSnapshotsLimit ManualSnapshotsLimitReached
--------------------------- -------------------- ---------------------------
0 5 False
```
+ Einzelheiten zur API finden Sie unter [GetSnapshotLimits AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DSTrust`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DSTrust`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl ruft die Informationen zu den Vertrauensbeziehungen ab, die für die angegebene directory-id erstellt wurden.**
```
Get-DSTrust -DirectoryId d-123456abcd
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeTrusts AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-DSAlias`
Das folgende Codebeispiel zeigt die Verwendung. `New-DSAlias`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Alias für ein Verzeichnis erstellt und der Alias der angegebenen directory-id zugewiesen.**
```
New-DSAlias -DirectoryId d-123456ijkl -Alias MyOrgName
```
**Ausgabe:**
```
Alias DirectoryId
----- -----------
myorgname d-123456ijkl
```
+ Einzelheiten zur API finden Sie unter [CreateAlias AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-DSComputer`
Das folgende Codebeispiel zeigt die Verwendung. `New-DSComputer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues Active-Directory-Computerobjekt erstellt.**
```
New-DSComputer -DirectoryId d-123456ijkl -ComputerName ADMemberServer -Password $Password
```
**Ausgabe:**
```
ComputerAttributes ComputerId ComputerName
------------------ ---------- ------------
{WindowsSamName, DistinguishedName} S-1-5-21-1191241402-978882507-2717148213-1662 ADMemberServer
```
+ Einzelheiten zur API finden Sie unter [CreateComputer AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-DSConditionalForwarder`
Das folgende Codebeispiel zeigt die Verwendung. `New-DSConditionalForwarder`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel erstellt einen Conditional Forwarder in der angegebenen AWS Directory-ID.**
```
New-DSConditionalForwarder -DirectoryId d-123456ijkl -DnsIpAddr 172.31.36.96,172.31.10.56 -RemoteDomainName contoso.com
```
+ Einzelheiten zur API finden Sie unter [CreateConditionalForwarder AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `New-DSDirectory`
Das folgende Codebeispiel zeigt die Verwendung. `New-DSDirectory`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues Simple-AD-Verzeichnis erstellt.**
```
New-DSDirectory -Name corp.example.com -Password $Password -Size Small -VpcSettings_VpcId vpc-123459d -VpcSettings_SubnetIds subnet-1234kkaa,subnet-5678ffbb
```
+ Einzelheiten zur API finden Sie unter [CreateDirectory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-DSLogSubscription`
Das folgende Codebeispiel zeigt die Verwendung. `New-DSLogSubscription`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Abonnement für die Weiterleitung von Directory-Service-Domänencontroller-Sicherheitsprotokollen in Echtzeit an die angegebene CloudWatch Amazon-Protokollgruppe in Ihrem erstellt AWS-Konto.**
```
New-DSLogSubscription -DirectoryId d-123456ijkl -LogGroupName /aws/directoryservice/d-123456ijkl-lan2.example.com
```
+ Einzelheiten zur API finden Sie unter [CreateLogSubscription AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-DSMicrosoftAD`
Das folgende Codebeispiel zeigt die Verwendung. `New-DSMicrosoftAD`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues Microsoft AD-Verzeichnis in erstellt AWS Cloud.**
```
New-DSMicrosoftAD -Name corp.example.com -Password $Password -edition Standard -VpcSettings_VpcId vpc-123459d -VpcSettings_SubnetIds subnet-1234kkaa,subnet-5678ffbb
```
+ API-Einzelheiten finden Sie unter [CreateMicrosoftAD](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5).*
### `New-DSSnapshot`
Das folgende Codebeispiel zeigt die Verwendung. `New-DSSnapshot`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Verzeichnis-Snapshot erstellt**
```
New-DSSnapshot -DirectoryId d-123456ijkl
```
+ Einzelheiten zur API finden Sie unter [CreateSnapshot AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-DSTrust`
Das folgende Codebeispiel zeigt die Verwendung. `New-DSTrust`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine bidirektionale Forestweite Vertrauensstellung zwischen Ihrem AWS verwalteten Microsoft AD-Verzeichnis und dem vorhandenen lokalen Microsoft Active Directory hergestellt.**
```
New-DSTrust -DirectoryId d-123456ijkl -RemoteDomainName contoso.com -TrustDirection Two-Way -TrustType Forest -TrustPassword $Password -ConditionalForwarderIpAddr 172.31.36.96
```
**Ausgabe:**
```
t-9067157123
```
+ Einzelheiten zur API finden Sie unter [CreateTrust AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Register-DSCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Register-DSCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Zertifikat für eine gesicherte LDAP-Verbindung registriert.**
```
$Certificate = Get-Content contoso.cer -Raw
Register-DSCertificate -DirectoryId d-123456ijkl -CertificateData $Certificate
```
**Ausgabe:**
```
c-906731e350
```
+ Einzelheiten zur API finden Sie unter [RegisterCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-DSEventTopic`
Das folgende Codebeispiel zeigt die Verwendung. `Register-DSEventTopic`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Verzeichnis als Publisher einem SNS-Thema zugeordnet.**
```
Register-DSEventTopic -DirectoryId d-123456ijkl -TopicName snstopicname
```
+ Einzelheiten zur API finden Sie unter [RegisterEventTopic AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-DSConditionalForwarder`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-DSConditionalForwarder`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die bedingte Weiterleitung entfernt, die für Ihr AWS Verzeichnis eingerichtet wurde.**
```
Remove-DSConditionalForwarder -DirectoryId d-123456ijkl -RemoteDomainName contoso.com
```
+ Einzelheiten zur API finden Sie unter [DeleteConditionalForwarder AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Remove-DSDirectory`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-DSDirectory`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein AWS Verzeichnisdienstverzeichnis gelöscht (Simple AD/Microsoft AD/AD Connector)**
```
Remove-DSDirectory -DirectoryId d-123456ijkl
```
+ Einzelheiten zur API finden Sie unter [DeleteDirectory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Remove-DSIpRoute`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-DSIpRoute`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl entfernt die angegebene IP aus den konfigurierten IP-Routen von Directory-id. **
```
Remove-DSIpRoute -DirectoryId d-123456ijkl -CidrIp 203.0.113.5/32
```
+ Einzelheiten zur API finden Sie unter [RemoveIpRoutes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-DSLogSubscription`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-DSLogSubscription`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl wird das Protokollabonnemen der angegebenen Directory-id abgerufen**
```
Remove-DSLogSubscription -DirectoryId d-123456ijkl
```
+ Einzelheiten zur API finden Sie unter [DeleteLogSubscription AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-DSResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-DSResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl entfernt das Ressourcen-Tag, das der angegebenen Directory-id zugewiesen ist**
```
Remove-DSResourceTag -ResourceId d-123456ijkl -TagKey myTag
```
+ Einzelheiten zur API finden Sie unter [RemoveTagsFromResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-DSSnapshot`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-DSSnapshot`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der manuell erstellte Snapshot entfernt.**
```
Remove-DSSnapshot -SnapshotId s-9068b488kc
```
+ Einzelheiten zur API finden Sie unter [DeleteSnapshot AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-DSTrust`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-DSTrust`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die bestehende Vertrauensstellung zwischen Ihrem AWS Managed AD-Verzeichnis und einer externen Domain entfernt.**
```
Get-DSTrust -DirectoryId d-123456ijkl -Select Trusts.TrustId | Remove-DSTrust
```
**Ausgabe:**
```
t-9067157123
```
+ Einzelheiten zur API finden Sie unter [DeleteTrust AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Reset-DSUserPassword`
Das folgende Codebeispiel zeigt die Verwendung. `Reset-DSUserPassword`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Passwort eines Active Directory-Benutzers zurückgesetzt, der ADUser in AWS Managed Microsoft AD oder Simple AD Directory benannt ist**
```
Reset-DSUserPassword -UserName ADuser -DirectoryId d-123456ijkl -NewPassword $Password
```
+ Einzelheiten zur API finden Sie unter [ResetUserPassword AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Restore-DSFromSnapshot`
Das folgende Codebeispiel zeigt die Verwendung. `Restore-DSFromSnapshot`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Verzeichnis mithilfe eines vorhandenen Verzeichnis-Snapshots wiederhergestellt.**
```
Restore-DSFromSnapshot -SnapshotId s-9068b488kc
```
+ Einzelheiten zur API finden Sie unter [RestoreFromSnapshot AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-DSDomainControllerCount`
Das folgende Codebeispiel zeigt die Verwendung. `Set-DSDomainControllerCount`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Anzahl der Domaincontroller für die angegebene directory-id auf 3 gesetzt.**
```
Set-DSDomainControllerCount -DirectoryId d-123456ijkl -DesiredNumber 3
```
+ Einzelheiten zur API finden Sie unter [UpdateNumberOfDomainControllers AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Start-DSSchemaExtension`
Das folgende Codebeispiel zeigt die Verwendung. `Start-DSSchemaExtension`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Schemaerweiterung auf ein Microsoft AD-Verzeichnis angewendet.**
```
$ldif = Get-Content D:\Users\Username\Downloads\ExtendedSchema.ldf -Raw
Start-DSSchemaExtension -DirectoryId d-123456ijkl -CreateSnapshotBeforeSchemaExtension $true -Description ManagedADSchemaExtension -LdifContent $ldif
```
**Ausgabe:**
```
e-9067306643
```
+ Einzelheiten zur API finden Sie unter [StartSchemaExtension AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Stop-DSSchemaExtension`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-DSSchemaExtension`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine aktive Schemaerweiterung zu einem Microsoft AD-Verzeichnis abgebrochen.**
```
Stop-DSSchemaExtension -DirectoryId d-123456ijkl -SchemaExtensionId e-9067306643
```
+ Einzelheiten zur API finden Sie unter [CancelSchemaExtension AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-DSCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-DSCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Zertifikat gelöscht, das für eine gesicherte LDAP-Verbindung registriert wurde, aus dem System gelöscht.**
```
Unregister-DSCertificate -DirectoryId d-123456ijkl -CertificateId c-906731e34f
```
+ Einzelheiten zur API finden Sie unter [DeregisterCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-DSEventTopic`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-DSEventTopic`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Verzeichnis als Herausgeber für das angegebene SNS-Thema entfernt. **
```
Unregister-DSEventTopic -DirectoryId d-123456ijkl -TopicName snstopicname
```
+ Einzelheiten zur API finden Sie unter [DeregisterEventTopic AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-DSConditionalForwarder`
Das folgende Codebeispiel zeigt die Verwendung. `Update-DSConditionalForwarder`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine bedingte Weiterleitung aktualisiert, die für Ihr AWS Verzeichnis eingerichtet wurde.**
```
Update-DSConditionalForwarder -DirectoryId d-123456ijkl -DnsIpAddr 172.31.36.96,172.31.16.108 -RemoteDomainName contoso.com
```
+ Einzelheiten zur API finden Sie unter [UpdateConditionalForwarder AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-DSRadius`
Das folgende Codebeispiel zeigt die Verwendung. `Update-DSRadius`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Informationen des RADIUS-Servers für einen AD Connector oder ein Microsoft AD-Verzeichnis aktualisiert.**
```
Update-DSRadius -DirectoryId d-123456ijkl -RadiusSettings_RadiusRetry 3
```
+ Einzelheiten zur API finden Sie unter [UpdateRadius AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-DSTrust`
Das folgende Codebeispiel zeigt die Verwendung. `Update-DSTrust`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der SelectiveAuth Parameter der angegebenen Trust-ID von Disabled auf Enabled aktualisiert.**
```
Update-DSTrust -TrustId t-9067157123 -SelectiveAuth Enabled
```
**Ausgabe:**
```
RequestId TrustId
--------- -------
138864a7-c9a8-4ad1-a828-eae479e85b45 t-9067157123
```
+ Einzelheiten zur API finden Sie unter [UpdateTrust AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
# AWS DMS Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. AWS DMS
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `New-DMSReplicationTask`
Das folgende Codebeispiel zeigt die Verwendung `New-DMSReplicationTask` von.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Replikationsaufgabe des AWS Datenbankmigrationsdienstes erstellt, die CdcStartTime anstelle von verwendet CdcStartPosition. Der MigrationType ist auf "full-load-and-cdc" gesetzt, was bedeutet, dass die Zieltabelle leer sein muss. Die neue Aufgabe wird mit einem Tag versehen, dessen Schlüssel „Stufe“ lautet und dessen Schlüsselwert „Test“ ist. Weitere Informationen zu den von diesem Cmdlet verwendeten Werten finden Sie unter Creating a Task (https://docs.aws.amazon.com/dms/latest/userguide/CHAP\$1Tasks.Creating.html) im Database Migration Service User Guide. 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"
```
+ *Einzelheiten zur API finden Sie unter [CreateReplicationTask](https://docs.aws.amazon.com/powershell/v5/reference)Cmdlet-Referenz (V5).AWS -Tools für PowerShell *
# DynamoDB-Beispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit DynamoDB Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-DDBIndexSchema`
Das folgende Codebeispiel zeigt, wie Sie. `Add-DDBIndexSchema`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt ein leeres TableSchema Objekt und fügt ihm eine neue Definition für den lokalen sekundären Index hinzu, bevor das TableSchema Objekt in die Pipeline geschrieben wird.**
```
$schema | Add-DDBIndexSchema -IndexName "LastPostIndex" -RangeKeyName "LastPostDateTime" -RangeKeyDataType "S" -ProjectionType "keys_only"
$schema = New-DDBTableSchema
```
**Ausgabe:**
```
AttributeSchema KeySchema LocalSecondaryIndexSchema
--------------- --------- -------------------------
{LastPostDateTime} {} {LastPostIndex}
```
**Beispiel 2: Fügt dem bereitgestellten TableSchema Objekt eine neue lokale sekundäre Indexdefinition hinzu, bevor das TableSchema Objekt wieder in die Pipeline geschrieben wird. Das TableSchema Objekt kann auch mit dem Parameter -Schema bereitgestellt werden.**
```
New-DDBTableSchema | Add-DDBIndexSchema -IndexName "LastPostIndex" -RangeKeyName "LastPostDateTime" -RangeKeyDataType "S" -ProjectionType "keys_only"
```
**Ausgabe:**
```
AttributeSchema KeySchema LocalSecondaryIndexSchema
--------------- --------- -------------------------
{LastPostDateTime} {} {LastPostIndex}
```
+ Einzelheiten zur API finden [Sie unter Add- DDBIndex Schema](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `Add-DDBKeySchema`
Das folgende Codebeispiel zeigt die Verwendung. `Add-DDBKeySchema`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt ein leeres TableSchema Objekt und fügt ihm Schlüssel- und Attributdefinitionseinträge unter Verwendung der angegebenen Schlüsseldaten hinzu, bevor das TableSchema Objekt in die Pipeline geschrieben wird. Der Schlüsseltyp ist standardmäßig als 'HASH' deklariert. Verwenden Sie den KeyType Parameter - mit dem Wert 'RANGE', um einen Bereichsschlüssel zu deklarieren.**
```
$schema = New-DDBTableSchema
$schema | Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S"
```
**Ausgabe:**
```
AttributeSchema KeySchema LocalSecondaryIndexSchema
--------------- --------- -------------------------
{ForumName} {ForumName} {}
```
**Beispiel 2: Fügt dem bereitgestellten TableSchema Objekt neue Schlüssel- und Attributdefinitionseinträge hinzu, bevor das Objekt in die TableSchema Pipeline geschrieben wird. Der Schlüsseltyp ist standardmäßig als 'HASH' deklariert. Verwenden Sie den KeyType Parameter - mit dem Wert 'RANGE', um einen Bereichsschlüssel zu deklarieren. Das TableSchema Objekt kann auch mit dem Parameter -Schema angegeben werden.**
```
New-DDBTableSchema | Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S"
```
**Ausgabe:**
```
AttributeSchema KeySchema LocalSecondaryIndexSchema
--------------- --------- -------------------------
{ForumName} {ForumName} {}
```
+ Einzelheiten zur API finden [Sie unter Add- DDBKey Schema](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `ConvertFrom-DDBItem`
Das folgende Codebeispiel zeigt die Verwendung. `ConvertFrom-DDBItem`
**Tools für PowerShell V5**
**Beispiel 1: ConvertFrom - DDBItem wird verwendet, um das Ergebnis einer Hashtabelle Get-DDBItem von DynamoDB in eine Hashtabelle mit gängigen Typen wie string und double AttributeValues zu konvertieren.**
```
@{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
} | ConvertTo-DDBItem
Get-DDBItem -TableName 'Music' -Key $key | ConvertFrom-DDBItem
```
**Ausgabe:**
```
Name Value
---- -----
Genre Country
Artist No One You Know
Price 1.94
CriticRating 9
SongTitle Somewhere Down The Road
AlbumTitle Somewhat Famous
```
+ Einzelheiten zur API finden Sie unter [ConvertFrom- DDBItem](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz* (V5).
### `ConvertTo-DDBItem`
Das folgende Codebeispiel zeigt die Verwendung. `ConvertTo-DDBItem`
**Tools für PowerShell V5**
**Beispiel 1: Ein Beispiel für die Konvertierung einer Hash-Tabelle in ein Wörterbuch mit DynamoDB-Attributwerten.**
```
@{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
} | ConvertTo-DDBItem
Key Value
--- -----
SongTitle Amazon.DynamoDBv2.Model.AttributeValue
Artist Amazon.DynamoDBv2.Model.AttributeValue
```
**Beispiel 2: Ein Beispiel für die Konvertierung einer Hash-Tabelle in ein Wörterbuch mit DynamoDB-Attributwerten.**
```
@{
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
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ConvertTo- DDBItem](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `Get-DDBBatchItem`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DDBBatchItem`
**Tools für PowerShell V5**
**Beispiel 1: Ruft das Element mit dem Namen SongTitle „Somewhere Down The Road“ aus den DynamoDB-Tabellen „Music“ und „Songs“ ab.**
```
$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
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([BatchGetItem](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Get-DDBItem`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DDBItem`
**Tools für PowerShell V5**
**Beispiel 1: Gibt das DynamoDB-Element mit dem Partitionsschlüssel SongTitle und dem Sortierschlüssel Artist zurück.**
```
$key = @{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
} | ConvertTo-DDBItem
Get-DDBItem -TableName 'Music' -Key $key | ConvertFrom-DDBItem
```
**Ausgabe:**
```
Name Value
---- -----
Genre Country
SongTitle Somewhere Down The Road
Price 1.94
Artist No One You Know
CriticRating 9
AlbumTitle Somewhat Famous
```
+ Einzelheiten zur API finden Sie unter [GetItem AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-DDBTable`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DDBTable`
**Tools für PowerShell V5**
**Beispiel 1: Gibt Details der angegebenen Tabelle zurück.**
```
Get-DDBTable -TableName "myTable"
```
+ Einzelheiten zur API finden Sie unter [DescribeTable AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-DDBTableList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-DDBTableList`
**Tools für PowerShell V5**
**Beispiel 1: Gibt Details aller Tabellen zurück und iteriert automatisch, bis der Service anzeigt, dass keine weiteren Tabellen vorhanden sind.**
```
Get-DDBTableList
```
+ Einzelheiten zur API finden Sie unter [ListTables AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Invoke-DDBQuery`
Das folgende Codebeispiel zeigt die Verwendung. `Invoke-DDBQuery`
**Tools für PowerShell V5**
**Beispiel 1: Ruft eine Abfrage auf, die DynamoDB-Elemente mit dem angegebenen SongTitle Wert und Artist zurückgibt.**
```
$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
```
**Ausgabe:**
```
Name Value
---- -----
Genre Country
Artist No One You Know
Price 1.94
CriticRating 9
SongTitle Somewhere Down The Road
AlbumTitle Somewhat Famous
```
+ Weitere API-Informationen finden Sie unter [Abfragen](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*.
### `Invoke-DDBScan`
Das folgende Codebeispiel zeigt, wie man. `Invoke-DDBScan`
**Tools für PowerShell V5**
**Beispiel 1: Gibt alle Elemente in der Tabelle „Music“ zurück.**
```
Invoke-DDBScan -TableName 'Music' | ConvertFrom-DDBItem
```
**Ausgabe:**
```
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
```
**Beispiel 2: Gibt Elemente in der Tabelle Musik zurück, deren Wert CriticRating größer oder gleich neun ist.**
```
$scanFilter = @{
CriticRating = [Amazon.DynamoDBv2.Model.Condition]@{
AttributeValueList = @(@{N = '9'})
ComparisonOperator = 'GE'
}
}
Invoke-DDBScan -TableName 'Music' -ScanFilter $scanFilter | ConvertFrom-DDBItem
```
**Ausgabe:**
```
Name Value
---- -----
Genre Country
Artist No One You Know
Price 1.94
CriticRating 9
SongTitle Somewhere Down The Road
AlbumTitle Somewhat Famous
```
+ Weitere API-Informationen finden Sie unter [Scan](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*.
### `New-DDBTable`
Das folgende Codebeispiel zeigt die Verwendung von`New-DDBTable`.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Tabelle mit dem Namen Thread erstellt, deren Primärschlüssel aus 'ForumName' (Schlüsseltyp-Hash) und 'Subject' (Schlüsseltypbereich) besteht. Das zur Erstellung der Tabelle verwendete Schema kann wie gezeigt an jedes Cmdlet übergeben oder mit dem Parameter „-Schema“ angegeben werden.**
```
$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
```
**Ausgabe:**
```
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 : {}
```
**Beispiel 2: In diesem Beispiel wird eine Tabelle mit dem Namen Thread erstellt, deren Primärschlüssel aus 'ForumName' (Schlüsseltyp-Hash) und 'Subject' (Schlüsseltypbereich) besteht. Ein lokaler sekundärer Index wird ebenfalls definiert. Der Schlüssel des lokalen sekundären Indexes wird automatisch anhand des primären Hashschlüssels in der Tabelle (ForumName) festgelegt. Das zur Erstellung der Tabelle verwendete Schema kann wie gezeigt an jedes Cmdlet übergeben oder mit dem Parameter „-Schema“ angegeben werden.**
```
$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
```
**Ausgabe:**
```
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}
```
**Beispiel 3: Dieses Beispiel zeigt, wie eine einzelne Pipeline verwendet wird, um eine Tabelle mit dem Namen Thread zu erstellen, deren Primärschlüssel aus 'ForumName' (Schlüsseltyp Hash) und 'Subject' (Schlüsseltypbereich) und einem lokalen sekundären Index besteht. Mit den Optionen „Add- DDBKey Schema“ und DDBIndex „Add- Schema“ wird ein neues TableSchema Objekt für Sie erstellt, falls keines über die Pipeline oder den Parameter -Schema bereitgestellt wird.**
```
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
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [CreateTable AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-DDBTableSchema`
Das folgende Codebeispiel zeigt die Verwendung. `New-DDBTableSchema`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt ein leeres TableSchema Objekt, das bereit ist, Schlüssel- und Indexdefinitionen für die Erstellung einer neuen Amazon DynamoDB-Tabelle zu akzeptieren. Das zurückgegebene Objekt kann über die Pipeline an die DDBTable Cmdlets Add- DDBKey Schema, Add- DDBIndex Schema und New- übergeben werden oder mithilfe des -Schema-Parameters für jedes Cmdlet an sie übergeben werden.**
```
New-DDBTableSchema
```
**Ausgabe:**
```
AttributeSchema KeySchema LocalSecondaryIndexSchema
--------------- --------- -------------------------
{} {} {}
```
+ *Einzelheiten zur API finden Sie unter [DDBTableNew-Schema in AWS -Tools für PowerShell der Cmdlet-Referenz](https://docs.aws.amazon.com/powershell/v5/reference) (V5).*
### `Remove-DDBItem`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-DDBItem`
**Tools für PowerShell V5**
**Beispiel 1: Entfernt das DynamoDB-Element, das dem angegebenen Schlüssel entspricht.**
```
$key = @{
SongTitle = 'Somewhere Down The Road'
Artist = 'No One You Know'
} | ConvertTo-DDBItem
Remove-DDBItem -TableName 'Music' -Key $key -Confirm:$false
```
+ Einzelheiten zur API finden Sie unter [DeleteItem AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-DDBTable`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-DDBTable`
**Tools für PowerShell V5**
**Beispiel 1: Löscht die angegebene Tabelle. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird.**
```
Remove-DDBTable -TableName "myTable"
```
**Beispiel 2: Löscht die angegebene Tabelle. Sie werden nicht zum Bestätigen aufgefordert, bevor der Vorgang fortgesetzt wird.**
```
Remove-DDBTable -TableName "myTable" -Force
```
+ Einzelheiten zur API finden Sie unter [DeleteTable AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-DDBBatchItem`
Das folgende Codebeispiel zeigt die Verwendung. `Set-DDBBatchItem`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt ein neues Element oder ersetzt ein vorhandenes durch ein neues Element in den DynamoDB-Tabellen „Music“ und „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
```
+ Einzelheiten zur API finden Sie unter [BatchWriteItem AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-DDBItem`
Das folgende Codebeispiel zeigt die Verwendung. `Set-DDBItem`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt ein neues Element oder ersetzt ein vorhandenes Element durch ein neues.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [PutItem AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-DDBItem`
Das folgende Codebeispiel zeigt die Verwendung. `Update-DDBItem`
**Tools für PowerShell V5**
**Beispiel 1: Setzt das Genre-Attribut auf 'Rap' für das DynamoDB-Element mit dem Partitionsschlüssel SongTitle und dem Sortierschlüssel 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
```
**Ausgabe:**
```
Name Value
---- -----
Genre Rap
```
+ Einzelheiten zur API finden Sie unter [UpdateItem AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Update-DDBTable`
Das folgende Codebeispiel zeigt die Verwendung. `Update-DDBTable`
**Tools für PowerShell V5**
**Beispiel 1: Aktualisiert den bereitgestellten Durchsatz für die angegebene Tabelle.**
```
Update-DDBTable -TableName "myTable" -ReadCapacity 10 -WriteCapacity 5
```
+ Einzelheiten zur API finden Sie unter [UpdateTable AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# EC2 Amazon-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe der AWS -Tools für PowerShell V5 mit Amazon EC2 Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-EC2CapacityReservation`
Das folgende Codebeispiel zeigt die Verwendung`Add-EC2CapacityReservation`.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Kapazitätsreservierung mit den angegebenen Attributen erstellt**
```
Add-EC2CapacityReservation -InstanceType m4.xlarge -InstanceCount 2 -AvailabilityZone eu-west-1b -EbsOptimized True -InstancePlatform Windows
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateCapacityReservation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Add-EC2InternetGateway`
Das folgende Codebeispiel zeigt die Verwendung. `Add-EC2InternetGateway`
**Tools für PowerShell V5**
**Beispiel 1: Im folgenden Beispiel wird der spezifischen VPC das angegebene Internet-Gateway angehängt.**
```
Add-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d -VpcId vpc-12345678
```
**Beispiel 2: In diesem Beispiel werden eine VPC und ein Internet-Gateway erstellt und anschließend das Internet-Gateway mit der VPC verbunden.**
```
$vpc = New-EC2Vpc -CidrBlock 10.0.0.0/16
New-EC2InternetGateway | Add-EC2InternetGateway -VpcId $vpc.VpcId
```
+ Einzelheiten zur API finden Sie unter [AttachInternetGateway AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Add-EC2NetworkInterface`
Das folgende Codebeispiel zeigt die Verwendung. `Add-EC2NetworkInterface`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Netzwerkschnittstelle an die spezifizierte Instance angehängt.**
```
Add-EC2NetworkInterface -NetworkInterfaceId eni-12345678 -InstanceId i-1a2b3c4d -DeviceIndex 1
```
**Ausgabe:**
```
eni-attach-1a2b3c4d
```
+ Einzelheiten zur API finden Sie unter [AttachNetworkInterface AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Add-EC2Volume`
Das folgende Codebeispiel zeigt die Verwendung. `Add-EC2Volume`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Volume an die spezifizierte Instance angehängt und mit dem angegebenen Gerätenamen verfügbar gemacht.**
```
Add-EC2Volume -VolumeId vol-12345678 -InstanceId i-1a2b3c4d -Device /dev/sdh
```
**Ausgabe:**
```
AttachTime : 12/22/2015 1:53:58 AM
DeleteOnTermination : False
Device : /dev/sdh
InstanceId : i-1a2b3c4d
State : attaching
VolumeId : vol-12345678
```
+ Einzelheiten zur API finden Sie unter [AttachVolume AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Add-EC2VpnGateway`
Das folgende Codebeispiel zeigt die Verwendung. `Add-EC2VpnGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Virtual Private Gateway an die spezifizierte VPC angehängt.**
```
Add-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d -VpcId vpc-12345678
```
**Ausgabe:**
```
State VpcId
----- -----
attaching vpc-12345678
```
+ Einzelheiten zur API finden Sie unter [AttachVpnGateway AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Approve-EC2VpcPeeringConnection`
Das folgende Codebeispiel zeigt die Verwendung. `Approve-EC2VpcPeeringConnection`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel genehmigt die angeforderte Datei pcx-1dfad234b56ff78be VpcPeeringConnectionId **
```
Approve-EC2VpcPeeringConnection -VpcPeeringConnectionId pcx-1dfad234b56ff78be
```
**Ausgabe:**
```
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
```
+ *Einzelheiten zur API finden Sie unter Cmdlet-Referenz (V5). [AcceptVpcPeeringConnection](https://docs.aws.amazon.com/powershell/v5/reference)AWS -Tools für PowerShell *
### `Confirm-EC2ProductInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Confirm-EC2ProductInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ermittelt, ob der angegebene Produktcode der spezifischen Instance zugeordnet ist.**
```
Confirm-EC2ProductInstance -ProductCode 774F4FF8 -InstanceId i-12345678
```
+ Einzelheiten zur API finden Sie unter [ConfirmProductInstance AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Copy-EC2Image`
Das folgende Codebeispiel zeigt die Verwendung. `Copy-EC2Image`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene AMI in der Region „EU (Irland)“ in die Region „USA West (Oregon)“ kopiert. Wenn -Region nicht angegeben ist, wird die aktuelle Standardregion als Zielregion verwendet.**
```
Copy-EC2Image -SourceRegion eu-west-1 -SourceImageId ami-12345678 -Region us-west-2 -Name "Copy of ami-12345678"
```
**Ausgabe:**
```
ami-87654321
```
+ Einzelheiten zur API finden Sie unter [CopyImage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Copy-EC2Snapshot`
Das folgende Codebeispiel zeigt die Verwendung. `Copy-EC2Snapshot`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Snapshot von der Region EU (Irland) in die Region USA West (Oregon) kopiert.**
```
Copy-EC2Snapshot -SourceRegion eu-west-1 -SourceSnapshotId snap-12345678 -Region us-west-2
```
**Beispiel 2: Wenn Sie eine Standardregion festlegen und den Parameter Region weglassen, ist die Standardzielregion die Standardregion.**
```
Set-DefaultAWSRegion us-west-2
Copy-EC2Snapshot -SourceRegion eu-west-1 -SourceSnapshotId snap-12345678
```
+ Einzelheiten zur API finden Sie unter [CopySnapshot AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Deny-EC2VpcPeeringConnection`
Das folgende Codebeispiel zeigt die Verwendung. `Deny-EC2VpcPeeringConnection`
**Tools für PowerShell V5**
**Beispiel 1: Das obige Beispiel lehnt die Anfrage nach der Anforderungs-ID VpcPeering pcx-01a2b3ce45fe67eb8 ab**
```
Deny-EC2VpcPeeringConnection -VpcPeeringConnectionId pcx-01a2b3ce45fe67eb8
```
+ *Einzelheiten zur API finden Sie unter Cmdlet-Referenz (V5). [RejectVpcPeeringConnection](https://docs.aws.amazon.com/powershell/v5/reference)AWS -Tools für PowerShell *
### `Disable-EC2VgwRoutePropagation`
Das folgende Codebeispiel zeigt die Verwendung. `Disable-EC2VgwRoutePropagation`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel deaktiviert das VGW, damit es Routen nicht automatisch an die angegebene Routing-Tabelle weitergibt.**
```
Disable-EC2VgwRoutePropagation -RouteTableId rtb-12345678 -GatewayId vgw-1a2b3c4d
```
+ Einzelheiten zur API finden Sie unter [DisableVgwRoutePropagation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Disable-EC2VpcClassicLink`
Das folgende Codebeispiel zeigt die Verwendung. `Disable-EC2VpcClassicLink`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel deaktiviert EC2 VpcClassicLink für vpc-01e23c4a5d6db78e9. Es wird entweder „True“ oder „False“ zurückgegeben**
```
Disable-EC2VpcClassicLink -VpcId vpc-01e23c4a5d6db78e9
```
+ Einzelheiten *AWS -Tools für PowerShell zur API [DisableVpcClassicLink](https://docs.aws.amazon.com/powershell/v5/reference)finden Sie unter Cmdlet-Referenz (V5)*.
### `Disable-EC2VpcClassicLinkDnsSupport`
Das folgende Codebeispiel zeigt die Verwendung. `Disable-EC2VpcClassicLinkDnsSupport`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die ClassicLink DNS-Unterstützung für die Datei vpc-0b12d3456a7e8910d deaktiviert**
```
Disable-EC2VpcClassicLinkDnsSupport -VpcId vpc-0b12d3456a7e8910d
```
+ Einzelheiten *zur API [DisableVpcClassicLinkDnsSupport](https://docs.aws.amazon.com/powershell/v5/reference)finden AWS -Tools für PowerShell Sie unter Cmdlet-Referenz (V5).*
### `Dismount-EC2InternetGateway`
Das folgende Codebeispiel zeigt die Verwendung. `Dismount-EC2InternetGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Internet-Gateway von der angegebenen VPC getrennt.**
```
Dismount-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d -VpcId vpc-12345678
```
+ Einzelheiten zur API finden Sie unter [DetachInternetGateway AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Dismount-EC2NetworkInterface`
Das folgende Codebeispiel zeigt die Verwendung. `Dismount-EC2NetworkInterface`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Verbindung zwischen einer Netzwerkschnittstelle und einer Instance entfernt.**
```
Dismount-EC2NetworkInterface -AttachmentId eni-attach-1a2b3c4d -Force
```
+ Einzelheiten zur API finden Sie unter [DetachNetworkInterface AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Dismount-EC2Volume`
Das folgende Codebeispiel zeigt die Verwendung. `Dismount-EC2Volume`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Volume getrennt.**
```
Dismount-EC2Volume -VolumeId vol-12345678
```
**Ausgabe:**
```
AttachTime : 12/22/2015 1:53:58 AM
DeleteOnTermination : False
Device : /dev/sdh
InstanceId : i-1a2b3c4d
State : detaching
VolumeId : vol-12345678
```
**Beispiel 2: Sie können auch die Instance-ID und den Gerätenamen angeben, um sicherzustellen, dass Sie das richtige Volume trennen.**
```
Dismount-EC2Volume -VolumeId vol-12345678 -InstanceId i-1a2b3c4d -Device /dev/sdh
```
+ Einzelheiten zur API finden Sie unter [DetachVolume AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Dismount-EC2VpnGateway`
Das folgende Codebeispiel zeigt die Verwendung. `Dismount-EC2VpnGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Virtual Private Gateway von der angegebenen VPC getrennt.**
```
Dismount-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d -VpcId vpc-12345678
```
+ Einzelheiten zur API finden Sie unter [DetachVpnGateway AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-EC2CapacityReservation`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2CapacityReservation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird CapacityReservationId cr-0c1f2345db6f7cdba geändert, indem die Anzahl der Instanzen auf 1 geändert wird**
```
Edit-EC2CapacityReservation -CapacityReservationId cr-0c1f2345db6f7cdba -InstanceCount 1
```
**Ausgabe:**
```
True
```
+ Einzelheiten zur [ModifyCapacityReservation](https://docs.aws.amazon.com/powershell/v5/reference)API finden AWS -Tools für PowerShell Sie *unter Cmdlet-Referenz (V5*).
### `Edit-EC2Host`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2Host`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die AutoPlacement Einstellungen für den dedizierten Host h-01e23f4cd567890f3 auf Aus geändert**
```
Edit-EC2Host -HostId h-03e09f8cd681609f3 -AutoPlacement off
```
**Ausgabe:**
```
Successful Unsuccessful
---------- ------------
{h-01e23f4cd567890f3} {}
```
+ Einzelheiten *zur [ModifyHosts](https://docs.aws.amazon.com/powershell/v5/reference)API finden AWS -Tools für PowerShell Sie unter* Cmdlet-Referenz (V5).
### `Edit-EC2IdFormat`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2IdFormat`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das längere ID-Format für den angegebenen Ressourcentyp aktiviert.**
```
Edit-EC2IdFormat -Resource instance -UseLongId $true
```
**Beispiel 2: In diesem Beispiel wird das längere ID-Format für den angegebenen Ressourcentyp deaktiviert.**
```
Edit-EC2IdFormat -Resource instance -UseLongId $false
```
+ Einzelheiten zur API finden Sie unter [ModifyIdFormat AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-EC2ImageAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2ImageAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Beschreibung für das angegebene AMI aktualisiert.**
```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Description "New description"
```
**Beispiel 2: In diesem Beispiel wird das AMI öffentlich gemacht (damit es beispielsweise von jedem verwendet AWS-Konto werden kann).**
```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup all
```
**Beispiel 3: In diesem Beispiel wird das AMI privat gemacht (beispielsweise, damit nur Sie als Besitzer es verwenden können).**
```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserGroup all
```
**Beispiel 4: In diesem Beispiel wird dem angegebenen Benutzer die Startberechtigung erteilt AWS-Konto.**
```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333
```
**Beispiel 5: In diesem Beispiel wird die Startberechtigung für das angegebene Objekt entfernt AWS-Konto.**
```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333
```
+ Einzelheiten zur API finden Sie unter [ModifyImageAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Edit-EC2InstanceAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2InstanceAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Instance-Typ der angegebenen Instance geändert.**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.medium
```
**Beispiel 2: In diesem Beispiel wird Enhanced Networking für die angegebene Instanz aktiviert, indem „simple“ als Wert für den Netzwerkunterstützungsparameter Single Root I/O Virtualization (SR-IOV) angegeben wird, -.. SriovNetSupport**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SriovNetSupport "simple"
```
**Beispiel 3: In diesem Beispiel werden die Sicherheitsgruppen für die angegebene Instance geändert. Die Instance muss sich in einer VPC befinden. Sie müssen die ID jeder Sicherheitsgruppe angeben, nicht den Namen.**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -Group @( "sg-12345678", "sg-45678901" )
```
**Beispiel 4: Dieses Beispiel aktiviert die I/O EBS-Optimierung für die angegebene Instance. Diese Feature ist nicht für alle Instance-Typen verfügbar. Bei Verwendung einer EBS-optimierten Instance fallen zusätzliche Nutzungsgebühren an.**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $true
```
**Beispiel 5: In diesem Beispiel wird die Suche source/destination nach der angegebenen Instance aktiviert. Damit eine NAT-Instance NAT ausführen kann, muss der Wert „False“ sein.**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $true
```
**Beispiel 6: In diesem Beispiel wird die Beendigung für die angegebene Instance deaktiviert.**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $true
```
**Beispiel 7: In diesem Beispiel wird die angegebene Instance so geändert, dass sie beendet wird, wenn der Shutdown von der Instance aus initiiert wird.**
```
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate
```
+ Einzelheiten zur API finden Sie unter [ModifyInstanceAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Edit-EC2InstanceCreditSpecification`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2InstanceCreditSpecification`
**Tools für PowerShell V5**
**Beispiel 1: Dadurch werden unbegrenzte T2-Gutschriften für die Instance i-01234567890abcdef aktiviert.**
```
$Credit = New-Object -TypeName Amazon.EC2.Model.InstanceCreditSpecificationRequest
$Credit.InstanceId = "i-01234567890abcdef"
$Credit.CpuCredits = "unlimited"
Edit-EC2InstanceCreditSpecification -InstanceCreditSpecification $Credit
```
+ Einzelheiten zur API finden Sie unter [ModifyInstanceCreditSpecification AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-EC2NetworkInterfaceAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2NetworkInterfaceAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Netzwerkschnittstelle so geändert, dass die spezifizierte Anlage beim Beenden gelöscht wird.**
```
Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -Attachment_AttachmentId eni-attach-1a2b3c4d -Attachment_DeleteOnTermination $true
```
**Beispiel 2: In diesem Beispiel wird die Beschreibung der angegebenen Netzwerkschnittstelle geändert.**
```
Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -Description "my description"
```
**Beispiel 3: In diesem Beispiel wird die Sicherheitsgruppe für die angegebene Netzwerkschnittstelle geändert.**
```
Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -Groups sg-1a2b3c4d
```
**Beispiel 4: In diesem Beispiel wird die source/destination Überprüfung der angegebenen Netzwerkschnittstelle deaktiviert.**
```
Edit-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -SourceDestCheck $false
```
+ Einzelheiten zur API finden Sie unter [ModifyNetworkInterfaceAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-EC2ReservedInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2ReservedInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Availability Zone, die Anzahl der Instances und die Plattform für die angegebenen Reserved Instances geändert.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [ModifyReservedInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-EC2SnapshotAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2SnapshotAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Snapshot öffentlich gemacht, indem es sein CreateVolumePermission Attribut festlegt.**
```
Edit-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission -OperationType Add -GroupName all
```
+ Einzelheiten zur API finden Sie unter [ModifySnapshotAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Edit-EC2SpotFleetRequest`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2SpotFleetRequest`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Zielkapazität der angegebenen Spot-Flottenanforderung aktualisiert.**
```
Edit-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -TargetCapacity 10
```
**Ausgabe:**
```
True
```
+ Einzelheiten zur API finden Sie unter [ModifySpotFleetRequest AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-EC2SubnetAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2SubnetAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die öffentliche IP-Adressierung für das angegebene Subnetz aktiviert.**
```
Edit-EC2SubnetAttribute -SubnetId subnet-1a2b3c4d -MapPublicIpOnLaunch $true
```
**Beispiel 2: In diesem Beispiel wird die öffentliche IP-Adressierung für das angegebene Subnetz deaktiviert.**
```
Edit-EC2SubnetAttribute -SubnetId subnet-1a2b3c4d -MapPublicIpOnLaunch $false
```
+ Einzelheiten zur API finden Sie unter [ModifySubnetAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-EC2VolumeAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2VolumeAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Attribut des angegebenen Volumes geändert. I/O Operationen für das Volume werden automatisch wieder aufgenommen, nachdem sie aufgrund potenziell inkonsistenter Daten unterbrochen wurden**.
```
Edit-EC2VolumeAttribute -VolumeId vol-12345678 -AutoEnableIO $true
```
+ Einzelheiten zur API finden Sie unter [ModifyVolumeAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Edit-EC2VpcAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-EC2VpcAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wirdt die Unterstützung von DNS-Hostnamen für die angegebene VPC aktiviert.**
```
Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsHostnames $true
```
**Beispiel 2: In diesem Beispiel wird die Unterstützung für DNS-Hostnamen für die angegebene VPC deaktiviert.**
```
Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsHostnames $false
```
**Beispiel 3: In diesem Beispiel wird die Unterstützung für die DNS-Auflösung für die angegebene VPC aktiviert.**
```
Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsSupport $true
```
**Beispiel 4: In diesem Beispiel wird die Unterstützung für die DNS-Auflösung für die angegebene VPC deaktiviert.**
```
Edit-EC2VpcAttribute -VpcId vpc-12345678 -EnableDnsSupport $false
```
+ Einzelheiten zur API finden Sie unter [ModifyVpcAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Enable-EC2VgwRoutePropagation`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-EC2VgwRoutePropagation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die automatische Weitergabe von Routen durch die angegebene VGW an die angegebene Routing-Tabelle aktiviert.**
```
Enable-EC2VgwRoutePropagation -RouteTableId rtb-12345678 -GatewayId vgw-1a2b3c4d
```
+ Einzelheiten zur API finden Sie unter [EnableVgwRoutePropagation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Enable-EC2VolumeIO`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-EC2VolumeIO`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden I/O Operationen für das angegebene Volume aktiviert, wenn I/O Operationen deaktiviert wurden.**
```
Enable-EC2VolumeIO -VolumeId vol-12345678
```
+ Einzelheiten zur API finden Sie unter [EnableVolumeIo AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Enable-EC2VpcClassicLink`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-EC2VpcClassicLink`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel aktiviert VPC vpc-0123456b789b0d12f für ClassicLink**
```
Enable-EC2VpcClassicLink -VpcId vpc-0123456b789b0d12f
```
**Ausgabe:**
```
True
```
+ Einzelheiten zur API [EnableVpcClassicLink](https://docs.aws.amazon.com/powershell/v5/reference)finden Sie *AWS -Tools für PowerShell unter Cmdlet-Referenz (V5)*.
### `Enable-EC2VpcClassicLinkDnsSupport`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-EC2VpcClassicLinkDnsSupport`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel ermöglicht vpc-0b12d3456a7e8910d die Unterstützung der DNS-Hostnamenauflösung für ClassicLink**
```
Enable-EC2VpcClassicLinkDnsSupport -VpcId vpc-0b12d3456a7e8910d -Region eu-west-1
```
+ Einzelheiten zur API [EnableVpcClassicLinkDnsSupport](https://docs.aws.amazon.com/powershell/v5/reference)finden *AWS -Tools für PowerShell Sie unter Cmdlet-Referenz (V5).*
### `Get-EC2AccountAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2AccountAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird beschrieben, ob Sie Instances in EC2 -Classic und EC2 VPC in der Region oder nur in VPC können. EC2**
```
(Get-EC2AccountAttribute -AttributeName supported-platforms).AttributeValues
```
**Ausgabe:**
```
AttributeValue
--------------
EC2
VPC
```
**Beispiel 2: In diesem Beispiel Ihre Standard-VPC beschrieben oder es zeigt „none“, wenn Sie in der Region keine Standard-VPC haben.**
```
(Get-EC2AccountAttribute -AttributeName default-vpc).AttributeValues
```
**Ausgabe:**
```
AttributeValue
--------------
vpc-12345678
```
**Beispiel 3: Dieses Beispiel beschreibt die maximale Anzahl von On-Demand-Instances, die Sie ausführen können.**
```
(Get-EC2AccountAttribute -AttributeName max-instances).AttributeValues
```
**Ausgabe:**
```
AttributeValue
--------------
20
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([DescribeAccountAttributes](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Get-EC2Address`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2Address`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel beschreibt die angegebene Elastic IP-Adresse für Instances in EC2 -Classic.**
```
Get-EC2Address -AllocationId eipalloc-12345678
```
**Ausgabe:**
```
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
```
**Beispiel 2: Dieses Beispiel beschreibt Ihre Elastic-IP-Adressen für Instances in einer VPC. Für diese Syntax ist PowerShell Version 3 oder höher erforderlich.**
```
Get-EC2Address -Filter @{ Name="domain";Values="vpc" }
```
**Beispiel 3: Dieses Beispiel beschreibt die angegebene Elastic IP-Adresse für Instances in EC2 -Classic.**
```
Get-EC2Address -PublicIp 203.0.113.17
```
**Ausgabe:**
```
AllocationId :
AssociationId :
Domain : standard
InstanceId : i-12345678
NetworkInterfaceId :
NetworkInterfaceOwnerId :
PrivateIpAddress :
PublicIp : 203.0.113.17
```
**Beispiel 4: Dieses Beispiel beschreibt Ihre Elastic IP-Adressen für Instances in EC2 -Classic. Für diese Syntax ist PowerShell Version 3 oder höher erforderlich.**
```
Get-EC2Address -Filter @{ Name="domain";Values="standard" }
```
**Beispiel 5: In diesem Beispiel werden alle Ihre Elastic IP-Adressen beschrieben.**
```
Get-EC2Address
```
**Beispiel 6: Dieses Beispiel gibt die öffentliche und private IP für die im Filter angegebene Instance-ID zurück**
```
Get-EC2Address -Region eu-west-1 -Filter @{Name="instance-id";Values="i-0c12d3f4f567ffb89"} | Select-Object PrivateIpAddress, PublicIp
```
**Ausgabe:**
```
PrivateIpAddress PublicIp
---------------- --------
10.0.0.99 63.36.5.227
```
**Beispiel 7: In diesem Beispiel werden alle Elastic-Dateien IPs mit ihrer Zuordnungs-ID, Assoziations-ID und Instanz-IDs abgerufen**
```
Get-EC2Address -Region eu-west-1 | Select-Object InstanceId, AssociationId, AllocationId, PublicIp
```
**Ausgabe:**
```
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
```
**Beispiel 8: In diesem Beispiel wird eine Liste von EC2 IP-Adressen abgerufen, die dem Tag-Schlüssel 'Category' mit dem Wert 'Prod' entsprechen**
```
Get-EC2Address -Filter @{Name="tag:Category";Values="Prod"}
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [DescribeAddresses AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EC2AvailabilityZone`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2AvailabilityZone`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Availability Zones für die aktuelle Region beschrieben, die Ihnen zur Verfügung stehen.**
```
Get-EC2AvailabilityZone
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle Availability Zones beschrieben, die sich in einem beeinträchtigten Zustand befinden. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
Get-EC2AvailabilityZone -Filter @{ Name="state";Values="impaired" }
```
**Beispiel 3: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um den Filter zu erstellen.**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "state"
$filter.Values = "impaired"
Get-EC2AvailabilityZone -Filter $filter
```
+ Einzelheiten zur API finden Sie unter [DescribeAvailabilityZones AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EC2BundleTask`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2BundleTask`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Bündelungsaufgabe beschrieben.**
```
Get-EC2BundleTask -BundleId bun-12345678
```
**Beispiel 2: In diesem Beispiel werden die Bündelungsaufgaben beschrieben, deren Status entweder „Abgeschlossen“ oder „Fehlgeschlagen“ lautet.**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "state"
$filter.Values = @( "complete", "failed" )
Get-EC2BundleTask -Filter $filter
```
+ Einzelheiten zur API finden Sie unter [DescribeBundleTasks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2CapacityReservation`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2CapacityReservation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden eine oder mehrere Ihrer Kapazitätsreservierungen für die Region beschrieben**
```
Get-EC2CapacityReservation -Region eu-west-1
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeCapacityReservations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2ConsoleOutput`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2ConsoleOutput`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Konsolenausgabe für die angegebene Linux-Instance abgerufen. Die Konsolenausgabe ist verschlüsselt.**
```
Get-EC2ConsoleOutput -InstanceId i-0e19abcd47c123456
```
**Ausgabe:**
```
InstanceId Output
---------- ------
i-0e194d3c47c123637 WyAgICAwLjAwMDAwMF0gQ29tbW...bGU9dHR5UzAgc2Vs
```
**Beispiel 2: In diesem Beispiel wird die verschlüsselte Konsolenausgabe in einer Variablen gespeichert und anschließend entschlüsselt.**
```
$Output_encoded = (Get-EC2ConsoleOutput -InstanceId i-0e19abcd47c123456).Output
[System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String($Output_encoded))
```
+ Einzelheiten zur API finden Sie unter [GetConsoleOutput AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2CustomerGateway`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2CustomerGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Kunden-Gateway beschrieben.**
```
Get-EC2CustomerGateway -CustomerGatewayId cgw-1a2b3c4d
```
**Ausgabe:**
```
BgpAsn : 65534
CustomerGatewayId : cgw-1a2b3c4d
IpAddress : 203.0.113.12
State : available
Tags : {}
Type : ipsec.1
```
**Beispiel 2: In diesem Beispiel wird jedes Kunden-Gateway beschrieben, dessen Status entweder „Ausstehend“ oder „Verfügbar“ ist.**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "state"
$filter.Values = @( "pending", "available" )
Get-EC2CustomerGateway -Filter $filter
```
**Beispiel 3: In diesem Beispiel werden alle Ihre Kunden-Gateways beschrieben.**
```
Get-EC2CustomerGateway
```
+ Einzelheiten zur API finden Sie unter [DescribeCustomerGateways AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2DhcpOption`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2DhcpOption`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Ihre DHCP-Optionssätze aufgelistet.**
```
Get-EC2DhcpOption
```
**Ausgabe:**
```
DhcpConfigurations DhcpOptionsId Tag
------------------ ------------- ---
{domain-name, domain-name-servers} dopt-1a2b3c4d {}
{domain-name, domain-name-servers} dopt-2a3b4c5d {}
{domain-name-servers} dopt-3a4b5c6d {}
```
**Beispiel 2: In diesem Beispiel werden Konfigurationsdetails für den angegebenen DHCP-Optionssatz abgerufen.**
```
(Get-EC2DhcpOption -DhcpOptionsId dopt-1a2b3c4d).DhcpConfigurations
```
**Ausgabe:**
```
Key Values
--- ------
domain-name {abc.local}
domain-name-servers {10.0.0.101, 10.0.0.102}
```
+ Einzelheiten zur API finden Sie unter [DescribeDhcpOptions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2FlowLog`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2FlowLog`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden ein oder mehrere Flow-Protokolle mit dem Protokollzieltyp „s3“ beschrieben.**
```
Get-EC2FlowLog -Filter @{Name="log-destination-type";Values="s3"}
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeFlowLogs AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2Host`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2Host`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt die EC2 Host-Details zurück**
```
Get-EC2Host
```
**Ausgabe:**
```
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 : {}
```
**Beispiel 2: In diesem Beispiel wird nach dem Host AvailableInstanceCapacity h-01e23f4cd567899f1 abgefragt**
```
Get-EC2Host -HostId h-01e23f4cd567899f1 | Select-Object -ExpandProperty AvailableCapacity | Select-Object -expand AvailableInstanceCapacity
```
**Ausgabe:**
```
AvailableCapacity InstanceType TotalCapacity
----------------- ------------ -------------
11 m4.xlarge 11
```
+ *Einzelheiten zur API finden Sie unter Cmdlet-Referenz (V5). [DescribeHosts](https://docs.aws.amazon.com/powershell/v5/reference)AWS -Tools für PowerShell *
### `Get-EC2HostReservationOffering`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2HostReservationOffering`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Dedicated Host-Reservierungen beschrieben, die für den angegebenen Filter 'Instance-Family' erworben werden können, wobei PaymentOption '' NoUpfront**
```
Get-EC2HostReservationOffering -Filter @{Name="instance-family";Values="m4"} | Where-Object PaymentOption -eq NoUpfront
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeHostReservationOfferings AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EC2HostReservationPurchasePreview`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2HostReservationPurchasePreview`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel zeigt eine Vorschau einer Reservierung mit Konfigurationen, die denen Ihres Dedicated Host h-01e23f4cd567890f1 entsprechen**
```
Get-EC2HostReservationPurchasePreview -OfferingId hro-0c1f23456789d0ab -HostIdSet h-01e23f4cd567890f1
```
**Ausgabe:**
```
CurrencyCode Purchase TotalHourlyPrice TotalUpfrontPrice
------------ -------- ---------------- -----------------
{} 1.307 0.000
```
+ Einzelheiten zur API finden Sie unter [GetHostReservationPurchasePreview AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2IdFormat`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2IdFormat`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das ID-Format für den angegebenen Ressourcentyp beschrieben.**
```
Get-EC2IdFormat -Resource instance
```
**Ausgabe:**
```
Resource UseLongIds
-------- ----------
instance False
```
**Beispiel 2: Dieses Beispiel beschreibt die ID-Formate für alle Ressourcentypen, die Longer IDs unterstützen.**
```
Get-EC2IdFormat
```
**Ausgabe:**
```
Resource UseLongIds
-------- ----------
reservation False
instance False
```
+ Einzelheiten zur API finden Sie unter [DescribeIdFormat AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-EC2IdentityIdFormat`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2IdentityIdFormat`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt das ID-Format für die Ressource „image“ für die angegebene Rolle zurück**
```
Get-EC2IdentityIdFormat -PrincipalArn arn:aws:iam::123456789511:role/JDBC -Resource image
```
**Ausgabe:**
```
Deadline Resource UseLongIds
-------- -------- ----------
8/2/2018 11:30:00 PM image True
```
+ Einzelheiten zur API finden Sie unter [DescribeIdentityIdFormat AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2Image`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2Image`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene AMI beschrieben.**
```
Get-EC2Image -ImageId ami-12345678
```
**Ausgabe:**
```
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
```
**Beispiel 2: Dieses Beispiel beschreibt die AMIs , die Sie besitzen.**
```
Get-EC2Image -owner self
```
**Beispiel 3: Dieses Beispiel beschreibt die Öffentlichkeit AMIs , die Microsoft Windows Server ausführt.**
```
Get-EC2Image -Filter @{ Name="platform"; Values="windows" }
```
**Beispiel 4: Dieses Beispiel beschreibt alle Besucher AMIs in der Region „us-west-2“.**
```
Get-EC2Image -Region us-west-2
```
+ Einzelheiten zur API finden Sie unter [DescribeImages AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EC2ImageAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2ImageAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Beschreibung für das angegebene AMI abgerufen.**
```
Get-EC2ImageAttribute -ImageId ami-12345678 -Attribute description
```
**Ausgabe:**
```
BlockDeviceMappings : {}
Description : My image description
ImageId : ami-12345678
KernelId :
LaunchPermissions : {}
ProductCodes : {}
RamdiskId :
SriovNetSupport :
```
**Beispiel 2: In diesem Beispiel werden die Startberechtigungen für das angegebene AMI abgerufen.**
```
Get-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission
```
**Ausgabe:**
```
BlockDeviceMappings : {}
Description :
ImageId : ami-12345678
KernelId :
LaunchPermissions : {all}
ProductCodes : {}
RamdiskId :
SriovNetSupport :
```
**Beispiel 3: In diesem Beispiel wird überprüft, ob Enhanced Networking aktiviert ist.**
```
Get-EC2ImageAttribute -ImageId ami-12345678 -Attribute sriovNetSupport
```
**Ausgabe:**
```
BlockDeviceMappings : {}
Description :
ImageId : ami-12345678
KernelId :
LaunchPermissions : {}
ProductCodes : {}
RamdiskId :
SriovNetSupport : simple
```
+ Einzelheiten zur API finden Sie unter [DescribeImageAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2ImportImageTask`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2ImportImageTask`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Aufgabe zum Importieren von Images beschrieben.**
```
Get-EC2ImportImageTask -ImportTaskId import-ami-hgfedcba
```
**Ausgabe:**
```
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 :
```
**Beispiel 2: In diesem Beispiel werden alle Ihre Aufgaben zum Importieren von Images beschrieben.**
```
Get-EC2ImportImageTask
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [DescribeImportImageTasks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2ImportSnapshotTask`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2ImportSnapshotTask`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Aufgabe zum Importieren eines Snapshots beschrieben.**
```
Get-EC2ImportSnapshotTask -ImportTaskId import-snap-abcdefgh
```
**Ausgabe:**
```
Description ImportTaskId SnapshotTaskDetail
----------------- -------------------- ------------------
Disk Image Import 1 import-snap-abcdefgh Amazon.EC2.Model.SnapshotTaskDetail
```
**Beispiel 2: In diesem Beispiel werden alle Ihre Aufgaben zum Importieren von Snapshops beschrieben.**
```
Get-EC2ImportSnapshotTask
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeImportSnapshotTasks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2Instance`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2Instance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Instance beschrieben.**
```
(Get-EC2Instance -InstanceId i-12345678).Instances
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle Ihre Instances in der aktuellen Region beschrieben, gruppiert nach Reservierungen. Um die Instance-Details anzuzeigen, erweitern Sie die Sammlung der Instances innerhalb jedes Reservierungsobjekts.**
```
Get-EC2Instance
```
**Ausgabe:**
```
GroupNames : {}
Groups : {}
Instances : {}
OwnerId : 123456789012
RequesterId : 226008221399
ReservationId : r-c5df370c
GroupNames : {}
Groups : {}
Instances : {}
OwnerId : 123456789012
RequesterId : 854251627541
ReservationId : r-63e65bab
...
```
**Beispiel 3: Dieses Beispiel veranschaulicht die Verwendung eines Filters zur Abfrage von EC2 Instances in einem bestimmten Subnetz einer VPC.**
```
(Get-EC2Instance -Filter @{Name="vpc-id";Values="vpc-1a2bc34d"},@{Name="subnet-id";Values="subnet-1a2b3c4d"}).Instances
```
**Ausgabe:**
```
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
```
**Beispiel 4: Dieses Beispiel veranschaulicht die Verwendung eines Filters mit mehreren Werten zur Abfrage von EC2 Instances, die sowohl ausgeführt als auch gestoppt sind**
```
$InstanceParams = @{
Filter = @(
@{'Name' = 'instance-state-name';'Values' = @("running","stopped")}
)
}
(Get-EC2Instance @InstanceParams).Instances
```
**Ausgabe:**
```
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
```
**Beispiel 5: Dieses Beispiel veranschaulicht die Verwendung eines Filters mit mehreren Werten für die Abfrage von EC2 Instances, die sowohl ausgeführt als auch gestoppt wurden, und die Verwendung des Cmdlets Select-Object zur Auswahl bestimmter Werte für die Ausgabe.**
```
$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
```
**Ausgabe:**
```
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
```
**Beispiel 6: In diesem Beispiel werden Berechtigungen zum Abrufen von EC2 Instanzen mithilfe des DryRun Parameters überprüft, ohne sie tatsächlich abzurufen. Hinweis: Im Erfolgsfall wird eine Ausnahme ausgelöst, was das erwartete Verhalten ist.**
```
Get-EC2Tag -DryRun $true
```
**Ausgabe:**
```
Get-EC2Instance: Request would have succeeded, but DryRun flag is set.
```
+ Einzelheiten zur API finden Sie unter [DescribeInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EC2InstanceAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2InstanceAttribute`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel beschreibt den Instance-Typ der angegebenen Instance.**
```
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceType
```
**Ausgabe:**
```
InstanceType : t2.micro
```
**Beispiel 2: In diesem Beispiel wird beschrieben, ob Enhanced Networking für die angegebene Instance aktiviert ist.**
```
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute sriovNetSupport
```
**Ausgabe:**
```
SriovNetSupport : simple
```
**Beispiel 3: In diesem Beispiel werden die Sicherheitsgruppen für die angegebene Instance beschrieben.**
```
(Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute groupSet).Groups
```
**Ausgabe:**
```
GroupId
-------
sg-12345678
sg-45678901
```
**Beispiel 4: In diesem Beispiel wird beschrieben, ob die EBS-Optimierung für die angegebene Instance aktiviert ist.**
```
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute ebsOptimized
```
**Ausgabe:**
```
EbsOptimized : False
```
**Beispiel 5: Dieses Beispiel beschreibt das Attribut disableApiTermination '' der angegebenen Instanz.**
```
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute disableApiTermination
```
**Ausgabe:**
```
DisableApiTermination : False
```
**Beispiel 6: Dieses Beispiel beschreibt das instanceInitiatedShutdown 'Behavior'-Attribut der angegebenen Instanz.**
```
Get-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceInitiatedShutdownBehavior
```
**Ausgabe:**
```
InstanceInitiatedShutdownBehavior : stop
```
+ Einzelheiten zur API finden Sie unter [DescribeInstanceAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EC2InstanceMetadata`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2InstanceMetadata`
**Tools für PowerShell V5**
**Beispiel 1: Listet die verfügbaren Kategorien von Instance-Metadaten auf, die abgefragt werden können.**
```
Get-EC2InstanceMetadata -ListCategory
```
**Ausgabe:**
```
AmiId
LaunchIndex
ManifestPath
AncestorAmiId
BlockDeviceMapping
InstanceId
InstanceType
LocalHostname
LocalIpv4
KernelId
AvailabilityZone
ProductCode
PublicHostname
PublicIpv4
PublicKey
RamdiskId
Region
ReservationId
SecurityGroup
UserData
InstanceMonitoring
IdentityDocument
IdentitySignature
IdentityPkcs7
```
**Beispiel 2: Gibt die ID des Amazon Machine Image (AMI) zurück, das zum Starten der Instance verwendet wurde.**
```
Get-EC2InstanceMetadata -Category AmiId
```
**Ausgabe:**
```
ami-b2e756ca
```
**Beispiel 3: In diesem Beispiel wird das JSON-formatierte Identitätsdokument für die Instance abgefragt.**
```
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"
}
```
**Beispiel 4: In diesem Beispiel werden mithilfe einer Pfadabfrage die MAC-Adressen der Netzwerkschnittstellen für die Instance abgerufen.**
```
Get-EC2InstanceMetadata -Path "/network/interfaces/macs"
```
**Ausgabe:**
```
02:80:7f:ef:4c:e0/
```
**Beispiel 5: Wenn der Instance eine IAM-Rolle zugeordnet ist, werden Informationen darüber zurückgegeben, wann das Instanzprofil zuletzt aktualisiert wurde, einschließlich des LastUpdated Datums der Instanz InstanceProfileArn, und. InstanceProfileId**
```
Get-EC2InstanceMetadata -Path "/iam/info"
```
**Ausgabe:**
```
{
"Code" : "Success",
"LastUpdated" : "2018-03-08T03:38:40Z",
"InstanceProfileArn" : "arn:aws:iam::111122223333:instance-profile/MyLaunchRole_Profile",
"InstanceProfileId" : "AIPAI4...WVK2RW"
}
```
+ Einzelheiten zur API finden Sie unter [Get-EC2InstanceMetadata AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2InstanceStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2InstanceStatus`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Status der angegebenen Instance beschrieben.**
```
Get-EC2InstanceStatus -InstanceId i-12345678
```
**Ausgabe:**
```
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
```
**Ausgabe:**
```
Code Name
---- ----
16 running
```
```
$status.Status
```
**Ausgabe:**
```
Details Status
------- ------
{reachability} ok
```
```
$status.SystemStatus
```
**Ausgabe:**
```
Details Status
------- ------
{reachability} ok
```
+ Einzelheiten zur API finden Sie unter [DescribeInstanceStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2InternetGateway`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2InternetGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Internet-Gateway beschrieben.**
```
Get-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d
```
**Ausgabe:**
```
Attachments InternetGatewayId Tags
----------- ----------------- ----
{vpc-1a2b3c4d} igw-1a2b3c4d {}
```
**Beispiel 2: In diesem Beispiel werden alle Ihre Internet-Gateways beschrieben.**
```
Get-EC2InternetGateway
```
**Ausgabe:**
```
Attachments InternetGatewayId Tags
----------- ----------------- ----
{vpc-1a2b3c4d} igw-1a2b3c4d {}
{} igw-2a3b4c5d {}
```
+ Einzelheiten zur API finden Sie unter [DescribeInternetGateways AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2KeyPair`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2KeyPair`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Schlüsselpaar beschrieben.**
```
Get-EC2KeyPair -KeyName my-key-pair
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle Ihre Schlüsselpaare beschrieben.**
```
Get-EC2KeyPair
```
+ Einzelheiten zur API finden Sie unter [DescribeKeyPairs AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2NetworkAcl`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2NetworkAcl`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Netzwerk-ACL beschrieben.**
```
Get-EC2NetworkAcl -NetworkAclId acl-12345678
```
**Ausgabe:**
```
Associations : {aclassoc-1a2b3c4d}
Entries : {Amazon.EC2.Model.NetworkAclEntry, Amazon.EC2.Model.NetworkAclEntry}
IsDefault : False
NetworkAclId : acl-12345678
Tags : {Name}
VpcId : vpc-12345678
```
**Beispiel 2: In diesem Beispiel werden die Regeln für die angegebene Netzwerk-ACL beschrieben.**
```
(Get-EC2NetworkAcl -NetworkAclId acl-12345678).Entries
```
**Ausgabe:**
```
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
```
**Beispiel 3: Dieses Beispiel beschreibt Ihr gesamtes Netzwerk ACLs.**
```
Get-EC2NetworkAcl
```
+ Einzelheiten zur API finden Sie unter [DescribeNetworkAcls AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-EC2NetworkInterface`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2NetworkInterface`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Netzwerkschnittstelle beschrieben.**
```
Get-EC2NetworkInterface -NetworkInterfaceId eni-12345678
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle Ihre Netzwerkschnittstellen beschrieben.**
```
Get-EC2NetworkInterface
```
+ Einzelheiten zur API finden Sie unter [DescribeNetworkInterfaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2NetworkInterfaceAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2NetworkInterfaceAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Netzwerkschnittstelle beschrieben.**
```
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute Attachment
```
**Ausgabe:**
```
Attachment : Amazon.EC2.Model.NetworkInterfaceAttachment
```
**Beispiel 2: In diesem Beispiel wird die angegebene Netzwerkschnittstelle beschrieben.**
```
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute Description
```
**Ausgabe:**
```
Description : My description
```
**Beispiel 3: In diesem Beispiel wird die angegebene Netzwerkschnittstelle beschrieben.**
```
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute GroupSet
```
**Ausgabe:**
```
Groups : {my-security-group}
```
**Beispiel 4: In diesem Beispiel wird die angegebene Netzwerkschnittstelle beschrieben.**
```
Get-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-12345678 -Attribute SourceDestCheck
```
**Ausgabe:**
```
SourceDestCheck : True
```
+ Einzelheiten zur API finden Sie unter [DescribeNetworkInterfaceAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2PasswordData`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2PasswordData`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Passwort entschlüsselt, das Amazon dem Administratorkonto für die angegebene Windows-Instance EC2 zugewiesen hat. Da eine PEM-Datei angegeben wurde, wird automatisch die Einstellung des Schalters -Decrypt übernommen.**
```
Get-EC2PasswordData -InstanceId i-12345678 -PemFile C:\path\my-key-pair.pem
```
**Ausgabe:**
```
mYZ(PA9?C)Q
```
**Beispiel 2: ( PowerShell nur Windows) Überprüft die Instanz, um den Namen des Schlüsselpaars zu ermitteln, das zum Starten der Instanz verwendet wurde, und versucht dann, die entsprechenden Schlüsselpaardaten im Konfigurationsspeicher des AWS Toolkit for Visual Studio zu finden. Wenn die Schlüsselpaardaten gefunden werden, wird das Passwort entschlüsselt.**
```
Get-EC2PasswordData -InstanceId i-12345678 -Decrypt
```
**Ausgabe:**
```
mYZ(PA9?C)Q
```
**Beispiel 3: Gibt die verschlüsselten Passwortdaten für die Instance zurück.**
```
Get-EC2PasswordData -InstanceId i-12345678
```
**Ausgabe:**
```
iVz3BAK/WAXV.....dqt8WeMA==
```
+ *Einzelheiten zur API finden Sie unter [GetPasswordData](https://docs.aws.amazon.com/powershell/v5/reference)Cmdlet-Referenz (V5).AWS -Tools für PowerShell *
### `Get-EC2PlacementGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2PlacementGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Platzierungsgruppe beschrieben.**
```
Get-EC2PlacementGroup -GroupName my-placement-group
```
**Ausgabe:**
```
GroupName State Strategy
--------- ----- --------
my-placement-group available cluster
```
+ Einzelheiten zur API finden Sie unter [DescribePlacementGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2PrefixList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2PrefixList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das AWS-Services in einer Präfixliste verfügbare Format für die Region abgerufen**
```
Get-EC2PrefixList
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribePrefixLists AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2Region`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2Region`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Regionen beschrieben, die Ihnen zur Verfügung stehen.**
```
Get-EC2Region
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeRegions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2RouteTable`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2RouteTable`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Ihre Routing-Tabellen beschrieben.**
```
Get-EC2RouteTable
```
**Ausgabe:**
```
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 :
```
**Beispiel 2: In diesem Beispiel werden Details für die angegebene Routing-Tabelle zurückgegeben.**
```
Get-EC2RouteTable -RouteTableId rtb-1a2b3c4d
```
**Beispiel 3: In diesem Beispiel werden die Routing-Tabellen für die angegebene VPC beschrieben.**
```
Get-EC2RouteTable -Filter @{ Name="vpc-id"; Values="vpc-1a2b3c4d" }
```
**Ausgabe:**
```
Associations : {rtbassoc-12345678}
PropagatingVgws : {}
Routes : {, }
RouteTableId : rtb-1a2b3c4d
Tags : {}
VpcId : vpc-1a2b3c4d
```
+ Einzelheiten zur API finden Sie unter [DescribeRouteTables AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2ScheduledInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2ScheduledInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene geplante Instance beschrieben.**
```
Get-EC2ScheduledInstance -ScheduledInstanceId sci-1234-1234-1234-1234-123456789012
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle Ihre geplanten Instances beschrieben.**
```
Get-EC2ScheduledInstance
```
+ Einzelheiten zur API finden Sie unter [DescribeScheduledInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2ScheduledInstanceAvailability`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2ScheduledInstanceAvailability`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Zeitplan beschrieben, der jede Woche am Sonntag beginnt und am angegebenen Datum startet.**
```
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
```
**Ausgabe:**
```
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
...
```
**Beispiel 2: Um die Ergebnisse einzugrenzen, können Sie Filter für Kriterien wie Betriebssystem, Netzwerk und Instance-Typ hinzufügen.**
```
-Filter @{ Name="platform";Values="Linux/UNIX" },@{ Name="network-platform";Values="EC2-VPC" },@{ Name="instance-type";Values="c4.large" }
```
+ Einzelheiten zur API finden Sie unter [DescribeScheduledInstanceAvailability AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2SecurityGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2SecurityGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Sicherheitsgruppe für eine VPC beschrieben. Wenn Sie mit Sicherheitsgruppen arbeiten, die zu einer VPC gehören, müssen Sie die Sicherheitsgruppen-ID (- GroupId Parameter) und nicht den Namen (- GroupName Parameter) verwenden, um auf die Gruppe zu verweisen.**
```
Get-EC2SecurityGroup -GroupId sg-12345678
```
**Ausgabe:**
```
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
```
**Beispiel 2: Dieses Beispiel beschreibt die angegebene Sicherheitsgruppe für EC2 -Classic. Wenn Sie mit Sicherheitsgruppen für EC2 -Classic arbeiten, können Sie entweder den Gruppennamen (- GroupName Parameter) oder die Gruppen-ID (- GroupId Parameter) verwenden, um auf die Sicherheitsgruppe zu verweisen.**
```
Get-EC2SecurityGroup -GroupName my-security-group
```
**Ausgabe:**
```
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 :
```
**Beispiel 3: In diesem Beispiel werden alle Sicherheitsgruppen für die Datei vpc-0fc1ff23456b789eb abgerufen**
```
Get-EC2SecurityGroup -Filter @{Name="vpc-id";Values="vpc-0fc1ff23456b789eb"}
```
+ Einzelheiten zur API finden Sie unter [DescribeSecurityGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2Snapshot`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2Snapshot`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Snapshot beschrieben.**
```
Get-EC2Snapshot -SnapshotId snap-12345678
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden die Snapshots beschrieben, die ein „Name”-Tag enthalten.**
```
Get-EC2Snapshot | ? { $_.Tags.Count -gt 0 -and $_.Tags.Key -eq "Name" }
```
**Beispiel 3: Dieses Beispiel beschreibt die Schnappschüsse, die ein 'Name'-Tag mit dem Wert '' TestValue haben.**
```
Get-EC2Snapshot | ? { $_.Tags.Count -gt 0 -and $_.Tags.Key -eq "Name" -and $_.Tags.Value -eq "TestValue" }
```
**Beispiel 4: In diesem Beispiel werden alle Ihre Snapshots beschrieben.**
```
Get-EC2Snapshot -Owner self
```
+ Einzelheiten zur API finden Sie unter [DescribeSnapshots AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2SnapshotAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2SnapshotAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Attribut des spezifizierten Snapshots beschrieben.**
```
Get-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute ProductCodes
```
**Ausgabe:**
```
CreateVolumePermissions ProductCodes SnapshotId
----------------------- ------------ ----------
{} {} snap-12345678
```
**Beispiel 2: In diesem Beispiel wird das angegebene Attribut des spezifizierten Snapshots beschrieben.**
```
(Get-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission).CreateVolumePermissions
```
**Ausgabe:**
```
Group UserId
----- ------
all
```
+ Einzelheiten zur API finden Sie unter [DescribeSnapshotAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2SpotDatafeedSubscription`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2SpotDatafeedSubscription`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Daten-Feed für Ihre Spot-Instance beschrieben.**
```
Get-EC2SpotDatafeedSubscription
```
**Ausgabe:**
```
Bucket : amzn-s3-demo-bucket
Fault :
OwnerId : 123456789012
Prefix : spotdata
State : Active
```
+ Einzelheiten zur API finden Sie unter [DescribeSpotDatafeedSubscription AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2SpotFleetInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2SpotFleetInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Instances beschrieben, die der angegebenen Spot-Flottenanforderung zugeordnet sind.**
```
Get-EC2SpotFleetInstance -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE
```
**Ausgabe:**
```
InstanceId InstanceType SpotInstanceRequestId
---------- ------------ ---------------------
i-f089262a c3.large sir-12345678
i-7e8b24a4 c3.large sir-87654321
```
+ Einzelheiten zur API finden Sie unter [DescribeSpotFleetInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2SpotFleetRequest`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2SpotFleetRequest`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Spot-Flottenanforderung beschrieben.**
```
Get-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE | format-list
```
**Ausgabe:**
```
ConfigData : Amazon.EC2.Model.SpotFleetRequestConfigData
CreateTime : 12/26/2015 8:23:33 AM
SpotFleetRequestId : sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE
SpotFleetRequestState : active
```
**Beispiel 2: In diesem Beispiel werden alle Ihre Spot-Flottenanforderungen beschrieben.**
```
Get-EC2SpotFleetRequest
```
+ Einzelheiten zur API finden Sie unter [DescribeSpotFleetRequests AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2SpotFleetRequestHistory`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2SpotFleetRequestHistory`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Verlauf der angegebenen Spot-Flottenanforderung beschrieben.**
```
Get-EC2SpotFleetRequestHistory -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -StartTime 2015-12-26T00:00:00Z
```
**Ausgabe:**
```
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
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeSpotFleetRequestHistory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2SpotInstanceRequest`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2SpotInstanceRequest`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Spot-Instance-Anforderung beschrieben.**
```
Get-EC2SpotInstanceRequest -SpotInstanceRequestId sir-12345678
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle Ihre Spot-Instance-Anforderungen beschrieben.**
```
Get-EC2SpotInstanceRequest
```
+ Einzelheiten zur API finden Sie unter [DescribeSpotInstanceRequests AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2SpotPriceHistory`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2SpotPriceHistory`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel ruft die letzten 10 Einträge im Spot-Preisverlauf für den angegebenen Instance-Typ und die angegebene Availability Zone ab. Beachten Sie, dass der für den AvailabilityZone Parameter - angegebene Wert für den Regionswert gültig sein muss, der entweder an den Parameter -Region des Cmdlets übergeben wurde (im Beispiel nicht gezeigt) oder als Standard in der Shell festgelegt wurde. Bei diesem Beispielbefehl wird davon ausgegangen, dass die Standardregion „us-west-2“ in der Umgebung festgelegt wurde.**
```
Get-EC2SpotPriceHistory -InstanceType c3.large -AvailabilityZone us-west-2a -MaxResult 10
```
**Ausgabe:**
```
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
...
```
+ Einzelheiten zur API finden Sie unter [DescribeSpotPriceHistory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EC2Subnet`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2Subnet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Subnetz beschrieben.**
```
Get-EC2Subnet -SubnetId subnet-1a2b3c4d
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle Ihre Subnetze beschrieben.**
```
Get-EC2Subnet
```
+ Einzelheiten zur API finden Sie unter [DescribeSubnets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2Tag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2Tag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Tags für den Ressourcentyp „image“ abgerufen**
```
Get-EC2Tag -Filter @{Name="resource-type";Values="image"}
```
**Ausgabe:**
```
Key ResourceId ResourceType Value
--- ---------- ------------ -----
Name ami-0a123b4ccb567a8ea image Win7-Imported
auto-delete ami-0a123b4ccb567a8ea image never
```
**Beispiel 2: In diesem Beispiel werden alle Tags für alle Ressourcen abgerufen und nach Ressourcentyp gruppiert**
```
Get-EC2Tag | Group-Object resourcetype
```
**Ausgabe:**
```
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}
```
**Beispiel 3: In diesem Beispiel werden alle Ressourcen mit dem Tag „auto-delete“ und dem Wert „no“ für die angegebene Region angezeigt**
```
Get-EC2Tag -Region eu-west-1 -Filter @{Name="tag:auto-delete";Values="no"}
```
**Ausgabe:**
```
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
```
**Beispiel 4: In diesem Beispiel werden alle Ressourcen mit dem Tag 'auto-delete' mit dem Wert 'no' und weitere Filter in der nächsten Pipe abgerufen, um nur die Ressourcentypen 'Instanz' zu analysieren, und erstellt schließlich das Tag 'ThisInstance' für jede Instanzressource, wobei der Wert die Instanz-ID selbst ist**
```
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}}
```
**Beispiel 5: In diesem Beispiel werden Tags für alle Instance-Ressourcen sowie „Name“-Schlüssel abgerufen und in Tabellenform angezeigt**
```
Get-EC2Tag -Filter @{Name="resource-type";Values="instance"},@{Name="key";Values="Name"} | Select-Object ResourceId, @{Name="Name-Tag";Expression={$PSItem.Value}} | Format-Table -AutoSize
```
**Ausgabe:**
```
ResourceId Name-Tag
---------- --------
i-012e3cb4df567e1aa jump1
i-01c23a45d6fc7a89f repro-3
```
**Beispiel 6: In diesem Beispiel werden die Berechtigungen für das Abrufen von EC2 Tags mithilfe des DryRun Parameters validiert, ohne sie tatsächlich abzurufen. Hinweis: Im Erfolgsfall wird eine Ausnahme ausgelöst, was das erwartete Verhalten ist.**
```
Get-EC2Tag -DryRun $true
```
**Ausgabe:**
```
Get-EC2Tag: Request would have succeeded, but DryRun flag is set.
```
+ Einzelheiten zur API finden Sie unter [DescribeTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EC2Volume`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2Volume`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene EBS-Volume beschrieben.**
```
Get-EC2Volume -VolumeId vol-12345678
```
**Ausgabe:**
```
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
```
**Beispiel 2: Dieses Beispiel beschreibt Ihre EBS-Volumes, die den Status „Verfügbar” aufweisen.**
```
Get-EC2Volume -Filter @{ Name="status"; Values="available" }
```
**Ausgabe:**
```
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
...
```
**Beispiel 3: In diesem Beispiel werden alle Ihre EBS-Volumes beschrieben.**
```
Get-EC2Volume
```
+ Einzelheiten zur API finden Sie unter [DescribeVolumes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2VolumeAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2VolumeAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Attribut des spezifizierten Volumes beschrieben.**
```
Get-EC2VolumeAttribute -VolumeId vol-12345678 -Attribute AutoEnableIO
```
**Ausgabe:**
```
AutoEnableIO ProductCodes VolumeId
------------ ------------ --------
False {} vol-12345678
```
+ Einzelheiten zur API finden Sie unter [DescribeVolumeAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2VolumeStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2VolumeStatus`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Status des angegebenen Volumes beschrieben.**
```
Get-EC2VolumeStatus -VolumeId vol-12345678
```
**Ausgabe:**
```
Actions : {}
AvailabilityZone : us-west-2a
Events : {}
VolumeId : vol-12345678
VolumeStatus : Amazon.EC2.Model.VolumeStatusInfo
```
```
(Get-EC2VolumeStatus -VolumeId vol-12345678).VolumeStatus
```
**Ausgabe:**
```
Details Status
------- ------
{io-enabled, io-performance} ok
```
```
(Get-EC2VolumeStatus -VolumeId vol-12345678).VolumeStatus.Details
```
**Ausgabe:**
```
Name Status
---- ------
io-enabled passed
io-performance not-applicable
```
+ Einzelheiten zur API finden Sie unter [DescribeVolumeStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2Vpc`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2Vpc`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene VPC beschrieben.**
```
Get-EC2Vpc -VpcId vpc-12345678
```
**Ausgabe:**
```
CidrBlock : 10.0.0.0/16
DhcpOptionsId : dopt-1a2b3c4d
InstanceTenancy : default
IsDefault : False
State : available
Tags : {Name}
VpcId : vpc-12345678
```
**Beispiel 2: In diesem Beispiel wird die Standard-VPC beschrieben (es kann nur eine pro Region geben). Wenn Ihr Konto EC2 -Classic in dieser Region unterstützt, gibt es keine Standard-VPC.**
```
Get-EC2Vpc -Filter @{Name="isDefault"; Values="true"}
```
**Ausgabe:**
```
CidrBlock : 172.31.0.0/16
DhcpOptionsId : dopt-12345678
InstanceTenancy : default
IsDefault : True
State : available
Tags : {}
VpcId : vpc-45678901
```
**Beispiel 3: Dieses Beispiel beschreibt die VPCs , die dem angegebenen Filter entsprechen (d. h. über einen CIDR verfügen, der dem Wert '10.0.0.0/16' entspricht und sich im Status 'verfügbar' befinden).**
```
Get-EC2Vpc -Filter @{Name="cidr"; Values="10.0.0.0/16"},@{Name="state";Values="available"}
```
**Beispiel 4: Dieses Beispiel beschreibt alle Ihre. VPCs**
```
Get-EC2Vpc
```
+ Einzelheiten zur API finden Sie unter [DescribeVpcs AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-EC2VpcAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2VpcAttribute`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel beschreibt das Attribut 'enableDnsSupport'.**
```
Get-EC2VpcAttribute -VpcId vpc-12345678 -Attribute enableDnsSupport
```
**Ausgabe:**
```
EnableDnsSupport
----------------
True
```
**Beispiel 2: Dieses Beispiel beschreibt das Attribut enableDnsHostnames ''.**
```
Get-EC2VpcAttribute -VpcId vpc-12345678 -Attribute enableDnsHostnames
```
**Ausgabe:**
```
EnableDnsHostnames
------------------
True
```
+ Einzelheiten zur API finden Sie unter [DescribeVpcAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-EC2VpcClassicLink`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2VpcClassicLink`
**Tools für PowerShell V5**
**Beispiel 1: Das obige Beispiel gibt alle VPCs mit ihrem ClassicLinkEnabled Status für die Region zurück**
```
Get-EC2VpcClassicLink -Region eu-west-1
```
**Ausgabe:**
```
ClassicLinkEnabled Tags VpcId
------------------ ---- -----
False {Name} vpc-0fc1ff23f45b678eb
False {} vpc-01e23c4a5d6db78e9
False {Name} vpc-0123456b078b9d01f
False {} vpc-12cf3b4f
False {Name} vpc-0b12d3456a7e8901d
```
+ Einzelheiten zur API finden Sie unter [DescribeVpcClassicLink AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-EC2VpcClassicLinkDnsSupport`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2VpcClassicLinkDnsSupport`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel beschreibt den ClassicLink DNS-Unterstützungsstatus von VPCs für die Region eu-west-1**
```
Get-EC2VpcClassicLinkDnsSupport -VpcId vpc-0b12d3456a7e8910d -Region eu-west-1
```
**Ausgabe:**
```
ClassicLinkDnsSupported VpcId
----------------------- -----
False vpc-0b12d3456a7e8910d
False vpc-12cf3b4f
```
+ Einzelheiten zur API finden Sie unter [DescribeVpcClassicLinkDnsSupport AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EC2VpcEndpoint`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2VpcEndpoint`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden ein oder mehrere Ihrer VPC-Endpunkte für die Region eu-west-1 beschrieben. Anschließend leitet es die Ausgabe an den nächsten Befehl weiter, der die VpcEndpointId Eigenschaft auswählt und die Array-VPC-ID als String-Array zurückgibt**
```
Get-EC2VpcEndpoint -Region eu-west-1 | Select-Object -ExpandProperty VpcEndpointId
```
**Ausgabe:**
```
vpce-01a2ab3f4f5cc6f7d
vpce-01d2b345a6787890b
vpce-0012e34d567890e12
vpce-0c123db4567890123
```
**Beispiel 2: Dieses Beispiel beschreibt alle VPC-Endpunkte für die Region eu-west-1 und wählt VpcEndpointId,, ServiceName und PrivateDnsEnabled Eigenschaften aus VpcId, um sie in einem tabellarischen Format darzustellen**
```
Get-EC2VpcEndpoint -Region eu-west-1 | Select-Object VpcEndpointId, VpcId, ServiceName, PrivateDnsEnabled | Format-Table -AutoSize
```
**Ausgabe:**
```
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
```
**Beispiel 3: Dieses Beispiel exportiert das Richtliniendokument für den VPC-Endpunkt vpce-01a2ab3f4f5cc6f7d in eine JSON-Datei**
```
Get-EC2VpcEndpoint -Region eu-west-1 -VpcEndpointId vpce-01a2ab3f4f5cc6f7d | Select-Object -expand PolicyDocument | Out-File vpce_policyDocument.json
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([DescribeVpcEndpoints](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Get-EC2VpcEndpointService`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2VpcEndpointService`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel beschreibt den EC2 VPC-Endpunktservice mit dem angegebenen Filter, in diesem Fall com.amazonaws.eu-west-1.ecs. Außerdem wird die Eigenschaft erweitert und die Details werden angezeigt ServiceDetails **
```
Get-EC2VpcEndpointService -Region eu-west-1 -MaxResult 5 -Filter @{Name="service-name";Values="com.amazonaws.eu-west-1.ecs"} | Select-Object -ExpandProperty ServiceDetails
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle EC2 VPC-Endpunktdienste abgerufen und das ServiceNames passende „ssm“ zurückgegeben**
```
Get-EC2VpcEndpointService -Region eu-west-1 | Select-Object -ExpandProperty Servicenames | Where-Object { -match "ssm"}
```
**Ausgabe:**
```
com.amazonaws.eu-west-1.ssm
com.amazonaws.eu-west-1.ssmmessages
```
+ Einzelheiten zur API finden Sie unter [DescribeVpcEndpointServices AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EC2VpnConnection`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2VpnConnection`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene VPN-Verbindung beschrieben.**
```
Get-EC2VpnConnection -VpnConnectionId vpn-12345678
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle VPN-Verbindungen beschrieben, dessen Status entweder „Ausstehend“ oder „Verfügbar“ ist.**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "state"
$filter.Values = @( "pending", "available" )
Get-EC2VpnConnection -Filter $filter
```
**Beispiel 4: In diesem Beispiel werden alle Ihre VPN-Verbindungen beschrieben.**
```
Get-EC2VpnConnection
```
+ Einzelheiten zur API finden Sie unter [DescribeVpnConnections AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EC2VpnGateway`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EC2VpnGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Virtual Private Gateway gelöscht.**
```
Get-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d
```
**Ausgabe:**
```
AvailabilityZone :
State : available
Tags : {}
Type : ipsec.1
VpcAttachments : {vpc-12345678}
VpnGatewayId : vgw-1a2b3c4d
```
**Beispiel 2: In diesem Beispiel wird jedes Virtual Private Gateway beschrieben, dessen Status entweder „Ausstehend“ oder „Verfügbar“ ist.**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "state"
$filter.Values = @( "pending", "available" )
Get-EC2VpnGateway -Filter $filter
```
**Beispiel 3: In diesem Beispiel werden alle Ihre Virtual Private Gateways beschrieben.**
```
Get-EC2VpnGateway
```
+ Einzelheiten zur API finden Sie unter [DescribeVpnGateways AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Grant-EC2SecurityGroupEgress`
Das folgende Codebeispiel zeigt die Verwendung. `Grant-EC2SecurityGroupEgress`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel definiert eine Ausgangsregel für die angegebene Sicherheitsgruppe für VPC EC2. Die Regel gewährt Zugriff auf den angegebenen IP-Adressbereich über den TCP-Port 80. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$ip = @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; IpRanges="203.0.113.0/24" }
Grant-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ip
```
**Beispiel 2: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um das Objekt zu erstellen. IpPermission **
```
$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
```
**Beispiel 3: In diesem Beispiel wird der angegebenen Quellsicherheitsgruppe Zugriff über den TCP-Port 80 gewährt 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 } )
```
+ Einzelheiten zur API finden Sie unter [AuthorizeSecurityGroupEgress AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Grant-EC2SecurityGroupIngress`
Das folgende Codebeispiel zeigt die Verwendung. `Grant-EC2SecurityGroupIngress`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel definiert Eingangsregeln für eine Sicherheitsgruppe für VPC EC2. Diese Regeln gewähren Zugriff auf eine bestimmte IP-Adresse für SSH (Port 22) und RDC (Port 3389). Beachten Sie, dass Sie Sicherheitsgruppen für EC2 VPC anhand der Sicherheitsgruppen-ID und nicht anhand des Sicherheitsgruppennamens identifizieren müssen. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$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 )
```
**Beispiel 2: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um die IpPermission Objekte zu erstellen.**
```
$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 )
```
**Beispiel 3: In diesem Beispiel werden Eingangsregeln für eine Sicherheitsgruppe für -Classic definiert. EC2 Diese Regeln gewähren Zugriff auf eine bestimmte IP-Adresse für SSH (Port 22) und RDC (Port 3389). Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$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 )
```
**Beispiel 4: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um die IpPermission Objekte zu erstellen.**
```
$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 )
```
**Beispiel 5: Dieses Beispiel gewährt TCP-Port 8081 Zugriff von der angegebenen Quellsicherheitsgruppe (sg-1a2b3c4d) auf die angegebene Sicherheitsgruppe (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 } )
```
**Beispiel 6: Dieses Beispiel fügt CIDR 5.5.5.5/32 zu den Eingangsregeln der Sicherheitsgruppe sg-1234abcd für den TCP-Port-22-Datenverkehr mit einer Beschreibung hinzu.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [AuthorizeSecurityGroupIngress AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Import-EC2Image`
Das folgende Codebeispiel zeigt die Verwendung. `Import-EC2Image`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Image einer virtuellen Maschine mit einer Festplatte aus dem angegebenen Amazon S3 S3-Bucket EC2 mit einem Idempotenz-Token nach Amazon importiert. Das Beispiel erfordert, dass eine VM-Import-Servicerolle mit dem Standardnamen „vmimport“ vorhanden ist, mit einer Richtlinie, die Amazon EC2 Zugriff auf den angegebenen Bucket gewährt, wie im Thema VM-Importvoraussetzungen erklärt. Um eine benutzerdefinierte Rolle zu verwenden, geben Sie den Rollennamen mithilfe des Parameters `-RoleName` an.**
```
$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
```
**Ausgabe:**
```
Architecture :
Description : Windows 2008 Standard Image
Hypervisor :
ImageId :
ImportTaskId : import-ami-abcdefgh
LicenseType : AWS
Platform : Windows
Progress : 2
SnapshotDetails : {}
Status : active
StatusMessage : pending
```
+ Einzelheiten zur API finden Sie unter [ImportImage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Import-EC2KeyPair`
Das folgende Codebeispiel zeigt die Verwendung. `Import-EC2KeyPair`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein öffentlicher Schlüssel in importiert. EC2 Die erste Zeile speichert den Inhalt der öffentlichen Schlüsseldatei (\$1.pub) in der Variablen `$publickey`. Als Nächstes konvertiert das Beispiel das UTF8 Format der Datei mit dem öffentlichen Schlüssel in eine Base64-kodierte Zeichenfolge und speichert die konvertierte Zeichenfolge in der Variablen. `$pkbase64` In der letzten Zeile wird der konvertierte öffentliche Schlüssel importiert. EC2 Das Cmdlet gibt den Fingerabdruck und den Namen des Schlüssels als Ergebnisse zurück.**
```
$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
```
**Ausgabe:**
```
KeyFingerprint KeyName
-------------- -------
do:d0:15:8f:79:97:12:be:00:fd:df:31:z3:b1:42:z1 Example-user-key
```
+ Einzelheiten zur API finden Sie unter [ImportKeyPair AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Import-EC2Snapshot`
Das folgende Codebeispiel zeigt die Verwendung. `Import-EC2Snapshot`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein VM-Datenträger-Image im Format „VMDK“ in einen Amazon EBS-Snapshot importiert. Das Beispiel erfordert eine VM-Import-Servicerolle mit dem Standardnamen „vmimport“ und einer Richtlinie, die Amazon den EC2 Zugriff auf den angegebenen Bucket ermöglicht, wie im `VM Import Prequisites` Thema unter http://docs.aws.amazon erklärt. com/AWSEC2/latest/WindowsGuide/VMImportPrerequisites.html. Um eine benutzerdefinierte Rolle zu verwenden, geben Sie den Rollennamen mithilfe des Parameters `-RoleName` an.**
```
$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
```
**Ausgabe:**
```
Description ImportTaskId SnapshotTaskDetail
----------------- -------------------- ------------------
Disk Image Import import-snap-abcdefgh Amazon.EC2.Model.SnapshotTaskDetail
```
+ Einzelheiten zur API finden Sie unter [ImportSnapshot AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Move-EC2AddressToVpc`
Das folgende Codebeispiel zeigt die Verwendung. `Move-EC2AddressToVpc`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine EC2 Instance mit der öffentlichen IP-Adresse 12.345.67.89 auf die EC2 -VPC-Plattform in der Region USA Ost (Nord-Virginia) verschoben.**
```
Move-EC2AddressToVpc -PublicIp 12.345.67.89 -Region us-east-1
```
**Beispiel 2: In diesem Beispiel werden die Ergebnisse eines Befehls über die Pipeline an das Cmdlet übergeben. Get-EC2Instance Move-EC2AddressToVpc Der Get-EC2Instance Befehl ruft eine Instanz ab, die durch die Instanz-ID angegeben ist, und gibt dann die öffentliche IP-Adresseigenschaft der Instanz zurück.**
```
(Get-EC2Instance -Instance i-12345678).Instances.PublicIpAddress | Move-EC2AddressToVpc
```
+ Einzelheiten zur API finden Sie unter [MoveAddressToVpc AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-EC2Address`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2Address`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird einer Instance in einer VPC eine Elastic-IP-Adresse zugewiesen.**
```
New-EC2Address -Domain Vpc
```
**Ausgabe:**
```
AllocationId Domain PublicIp
------------ ------ --------
eipalloc-12345678 vpc 198.51.100.2
```
**Beispiel 2: In diesem Beispiel wird eine Elastic IP-Adresse zur Verwendung mit einer Instanz in -Classic zugewiesen. EC2**
```
New-EC2Address
```
**Ausgabe:**
```
AllocationId Domain PublicIp
------------ ------ --------
standard 203.0.113.17
```
+ Einzelheiten zur API finden Sie unter [AllocateAddress AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `New-EC2CustomerGateway`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2CustomerGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Kunden-Gateway erstellt.**
```
New-EC2CustomerGateway -Type ipsec.1 -PublicIp 203.0.113.12 -BgpAsn 65534
```
**Ausgabe:**
```
BgpAsn : 65534
CustomerGatewayId : cgw-1a2b3c4d
IpAddress : 203.0.113.12
State : available
Tags : {}
Type : ipsec.1
```
+ Einzelheiten zur API finden Sie unter [CreateCustomerGateway AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2DhcpOption`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2DhcpOption`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene DHCP-Satz erstellt. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$options = @( @{Key="domain-name";Values=@("abc.local")}, @{Key="domain-name-servers";Values=@("10.0.0.101","10.0.0.102")})
New-EC2DhcpOption -DhcpConfiguration $options
```
**Ausgabe:**
```
DhcpConfigurations DhcpOptionsId Tags
------------------ ------------- ----
{domain-name, domain-name-servers} dopt-1a2b3c4d {}
```
**Beispiel 2: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um jede DHCP-Option zu erstellen.**
```
$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)
```
**Ausgabe:**
```
DhcpConfigurations DhcpOptionsId Tags
------------------ ------------- ----
{domain-name, domain-name-servers} dopt-2a3b4c5d {}
```
+ Einzelheiten zur API finden Sie unter [CreateDhcpOptions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `New-EC2FlowLog`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2FlowLog`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein EC2 Flowlog für das Subnetz Subnetz-1d234567 zum cloud-watch-log benannten Subnet1-Log für den gesamten REJECT-Traffic mit den Berechtigungen der Rolle „Admin“ erstellt**
```
New-EC2FlowLog -ResourceId "subnet-1d234567" -LogDestinationType cloud-watch-logs -LogGroupName subnet1-log -TrafficType "REJECT" -ResourceType Subnet -DeliverLogsPermissionArn "arn:aws:iam::98765432109:role/Admin"
```
**Ausgabe:**
```
ClientToken FlowLogIds Unsuccessful
----------- ---------- ------------
m1VN2cxP3iB4qo//VUKl5EU6cF7gQLOxcqNefvjeTGw= {fl-012fc34eed5678c9d} {}
```
+ Einzelheiten [CreateFlowLogs AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*zur API finden Sie unter Cmdlet-Referenz* (V5).
### `New-EC2Host`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2Host`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird Ihrem Konto ein Dedicated Host für den angegebenen Instance-Typ und die angegebene Availability Zone zugewiesen**
```
New-EC2Host -AutoPlacement on -AvailabilityZone eu-west-1b -InstanceType m4.xlarge -Quantity 1
```
**Ausgabe:**
```
h-01e23f4cd567890f3
```
+ Einzelheiten zur API finden Sie unter [AllocateHosts AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2HostReservation`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2HostReservation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Reservierung mit der Nummer hro-0c1f23456789d0ab erworben, deren Konfigurationen mit denen Ihres Dedicated Hosts h-01e23f4cd567890f1 übereinstimmen**
```
New-EC2HostReservation -OfferingId hro-0c1f23456789d0ab HostIdSet h-01e23f4cd567890f1
```
**Ausgabe:**
```
ClientToken :
CurrencyCode :
Purchase : {hr-0123f4b5d67bedc89}
TotalHourlyPrice : 1.307
TotalUpfrontPrice : 0.000
```
+ Einzelheiten zur API finden Sie unter [PurchaseHostReservation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2Image`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2Image`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird aus der angegebenen Instance ein AMI mit dem spezifizierten Namen und der Beschreibung erstellt. Amazon EC2 versucht, die Instance sauber herunterzufahren, bevor das Image erstellt wird, und startet die Instance nach Abschluss neu.**
```
New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI"
```
**Beispiel 2: In diesem Beispiel wird aus der angegebenen Instance ein AMI mit dem spezifizierten Namen und der Beschreibung erstellt. Amazon EC2 erstellt das Image, ohne die Instance herunterzufahren und neu zu starten. Daher kann die Dateisystemintegrität des erstellten Images nicht garantiert werden.**
```
New-EC2Image -InstanceId i-12345678 -Name "my-web-server" -Description "My web server AMI" -NoReboot $true
```
**Beispiel 3: In diesem Beispiel wird ein AMI mit drei Volumes erstellt. Das erste Volume basiert auf einem Amazon-EBS-Snapshot. Bei dem zweiten Volume handelt es sich um ein leeres 100-GiB-Amazon-EBS-Volume. Das dritte Volume ist ein Instance-Speicher-Volume. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$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"})
```
+ Einzelheiten zur API finden Sie unter [CreateImage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-EC2Instance`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2Instance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine einzelne Instance des angegebenen AMI in EC2 -Classic oder einer Standard-VPC gestartet.**
```
New-EC2Instance -ImageId ami-12345678 -MinCount 1 -MaxCount 1 -InstanceType m3.medium -KeyName my-key-pair -SecurityGroup my-security-group
```
**Beispiel 2: In diesem Beispiel wird eine einzelne Instance des angegebenen AMI in einer VPC gestartet.**
```
New-EC2Instance -ImageId ami-12345678 -MinCount 1 -MaxCount 1 -SubnetId subnet-12345678 -InstanceType t2.micro -KeyName my-key-pair -SecurityGroupId sg-12345678
```
**Beispiel 3: Um ein EBS-Volume oder ein Instance-Speicher-Volume hinzuzufügen, definieren Sie eine Blockgerät-Zuweisung und fügen Sie diese dem Befehl hinzu. In diesem Beispiel wird als Instance-Speicher-Volume hinzugefügt.**
```
$bdm = New-Object Amazon.EC2.Model.BlockDeviceMapping
$bdm.VirtualName = "ephemeral0"
$bdm.DeviceName = "/dev/sdf"
New-EC2Instance -ImageId ami-12345678 -BlockDeviceMapping $bdm ...
```
**Beispiel 4: Um eines der aktuellen Windows-Betriebssysteme anzugeben AMIs, rufen Sie dessen AMI-ID mit SSMLatest EC2 Get-Image ab. In diesem Beispiel wird eine Instance aus dem aktuellen Basis-AMI für Windows Server 2016 gestartet 2016.**
```
$ami = (Get-SSMLatestEC2Image -Path 'ami-windows-latest' -ImageName 'WINDOWS*2016*English*Core*BASE').Value
New-EC2Instance -ImageId $ami ...
```
**Beispiel 5: Startet eine Instance in der angegebenen Dedicated-Host-Umgebung.**
```
New-EC2Instance -ImageId ami-1a2b3c4d -InstanceType m4.large -KeyName my-key-pair -SecurityGroupId sg-1a2b3c4d -AvailabilityZone us-west-1a -Tenancy host -HostID h-1a2b3c4d5e6f1a2b3
```
**Beispiel 6: Diese Anforderung startet zwei Instances und weist diesen Instances ein Tag mit dem Schlüssel „webserver” und dem Wert „production” zu. Die Anfrage wendet außerdem ein Tag mit dem Schlüssel „cost-center“ und dem Wert „cc123“ auf die erstellten Volumes an (in diesem Fall das Stammvolume für jede 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
```
**Beispiel 7: In diesem Beispiel werden die Berechtigungen zum Starten einer EC2 Instance mithilfe des DryRun Parameters validiert, ohne die Instance tatsächlich zu erstellen. Hinweis: Im Erfolgsfall wird eine Ausnahme ausgelöst, was das erwartete Verhalten ist. **
```
New-EC2Instance -ImageId 'ami-12345678' -InstanceType 't2.micro' -KeyName 'my-key-pair' -Region 'us-west-2' -DryRun $true
```
+ Einzelheiten zur API finden Sie unter [RunInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2InstanceExportTask`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2InstanceExportTask`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine angehaltene Instance, `i-0800b00a00EXAMPLE`, als virtuelle Festplatte (VHD) in den S3-Bucket `testbucket-export-instances-2019` exportiert. Die Zielumgebung ist`Microsoft`, und der Regionsparameter wird hinzugefügt, weil sich die Instanz in der `us-east-1` Region befindet, während die AWS Standardregion des Benutzers nicht us-east-1 ist. Um den Status der Exportaufgabe abzurufen, kopieren Sie den `ExportTaskId`-Wert aus den Ergebnissen dieses Befehls und führen Sie anschließend `Get-EC2ExportTask -ExportTaskId export_task_ID_from_results.` aus.**
```
New-EC2InstanceExportTask -InstanceId i-0800b00a00EXAMPLE -ExportToS3Task_DiskImageFormat VHD -ExportToS3Task_S3Bucket "amzn-s3-demo-bucket" -TargetEnvironment Microsoft -Region us-east-1
```
**Ausgabe:**
```
Description :
ExportTaskId : export-i-077c73108aEXAMPLE
ExportToS3Task : Amazon.EC2.Model.ExportToS3Task
InstanceExportDetails : Amazon.EC2.Model.InstanceExportDetails
State : active
StatusMessage :
```
+ Einzelheiten zur API finden Sie unter [CreateInstanceExportTask AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `New-EC2InternetGateway`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2InternetGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Internet-Gateway erstellt.**
```
New-EC2InternetGateway
```
**Ausgabe:**
```
Attachments InternetGatewayId Tags
----------- ----------------- ----
{} igw-1a2b3c4d {}
```
+ Einzelheiten zur API finden Sie unter [CreateInternetGateway AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2KeyPair`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2KeyPair`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Schlüsselpaar erstellt und der PEM-kodierte private RSA-Schlüssel in einer Datei mit dem angegebenen Namen erfasst. Wenn Sie verwenden PowerShell, muss die Kodierung auf ASCII eingestellt sein, um einen gültigen Schlüssel zu generieren. Weitere Informationen finden Sie unter EC2 Amazon-Schlüsselpaare (https://docs.aws.amazon.com/cli/latest/userguide/cli-services-ec2-keypairs.html) erstellen, anzeigen und löschen im Benutzerhandbuch für die AWS Befehlszeilenschnittstelle.**
```
(New-EC2KeyPair -KeyName "my-key-pair").KeyMaterial | Out-File -Encoding ascii -FilePath C:\path\my-key-pair.pem
```
+ Einzelheiten zur API finden Sie unter [CreateKeyPair AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-EC2NetworkAcl`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2NetworkAcl`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Netzwerk-ACL für die angegebene VPC erstellt.**
```
New-EC2NetworkAcl -VpcId vpc-12345678
```
**Ausgabe:**
```
Associations : {}
Entries : {Amazon.EC2.Model.NetworkAclEntry, Amazon.EC2.Model.NetworkAclEntry}
IsDefault : False
NetworkAclId : acl-12345678
Tags : {}
VpcId : vpc-12345678
```
+ Einzelheiten zur API finden Sie unter [CreateNetworkAcl AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2NetworkAclEntry`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2NetworkAclEntry`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Eintrag für die angegebene Netzwerk-ACL erstellt. Die Regel erlaubt eingehenden Datenverkehr von überall (0.0.0.0/0) auf UDP-Port 53 (DNS) in jedes zugeordnete Subnetz.**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateNetworkAclEntry AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2NetworkInterface`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2NetworkInterface`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Netzwerkschnittstelle erstellt.**
```
New-EC2NetworkInterface -SubnetId subnet-1a2b3c4d -Description "my network interface" -Group sg-12345678 -PrivateIpAddress 10.0.0.17
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateNetworkInterface AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2PlacementGroup`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2PlacementGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Platzierungsgruppe mit dem angegebenen Namen erstellt.**
```
New-EC2PlacementGroup -GroupName my-placement-group -Strategy cluster
```
+ Einzelheiten zur API finden Sie unter [CreatePlacementGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2Route`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2Route`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Route für die spezifizierte Routing-Tabelle erstellt. Die Route entspricht dem gesamten Datenverkehr und leitet ihn an das angegebene Internet-Gateway weiter.**
```
New-EC2Route -RouteTableId rtb-1a2b3c4d -DestinationCidrBlock 0.0.0.0/0 -GatewayId igw-1a2b3c4d
```
**Ausgabe:**
```
True
```
+ Einzelheiten zur API finden Sie unter [CreateRoute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2RouteTable`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2RouteTable`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Routing-Tabelle für die angegebene VPC erstellt.**
```
New-EC2RouteTable -VpcId vpc-12345678
```
**Ausgabe:**
```
Associations : {}
PropagatingVgws : {}
Routes : {}
RouteTableId : rtb-1a2b3c4d
Tags : {}
VpcId : vpc-12345678
```
+ Einzelheiten zur API finden Sie unter [CreateRouteTable AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2ScheduledInstance`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2ScheduledInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene geplante Instance gestartet.**
```
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
```
+ Einzelheiten zur API finden Sie unter [RunScheduledInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2ScheduledInstancePurchase`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2ScheduledInstancePurchase`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine geplante Instance gekauft.**
```
$request = New-Object Amazon.EC2.Model.PurchaseRequest
$request.InstanceCount = 1
$request.PurchaseToken = "eyJ2IjoiMSIsInMiOjEsImMiOi..."
New-EC2ScheduledInstancePurchase -PurchaseRequest $request
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [PurchaseScheduledInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2SecurityGroup`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2SecurityGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Sicherheitsgruppe für die angegebene VPC erstellt.**
```
New-EC2SecurityGroup -GroupName my-security-group -Description "my security group" -VpcId vpc-12345678
```
**Ausgabe:**
```
sg-12345678
```
**Beispiel 2: In diesem Beispiel wird eine Sicherheitsgruppe für EC2 -Classic erstellt.**
```
New-EC2SecurityGroup -GroupName my-security-group -Description "my security group"
```
**Ausgabe:**
```
sg-45678901
```
+ Einzelheiten zur API finden Sie unter [CreateSecurityGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2Snapshot`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2Snapshot`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Snapshot des angegebenen Volumes erstellt.**
```
New-EC2Snapshot -VolumeId vol-12345678 -Description "This is a test"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateSnapshot AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2SpotDatafeedSubscription`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2SpotDatafeedSubscription`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Daten-Feed für eine Spot Instance erstellt.**
```
New-EC2SpotDatafeedSubscription -Bucket amzn-s3-demo-bucket -Prefix spotdata
```
**Ausgabe:**
```
Bucket : amzn-s3-demo-bucket
Fault :
OwnerId : 123456789012
Prefix : spotdata
State : Active
```
+ Einzelheiten zur API finden Sie unter [CreateSpotDatafeedSubscription AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2Subnet`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2Subnet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Subnetz mit dem angegebenen CIDR erstellt.**
```
New-EC2Subnet -VpcId vpc-12345678 -CidrBlock 10.0.0.0/24
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateSubnet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2Tag`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2Tag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebenen Ressource ein einzelnes Tag hinzugefügt. Der Tag-Schlüssel ist 'myTag' und der Tag-Wert ist ''myTagValue. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
New-EC2Tag -Resource i-12345678 -Tag @{ Key="myTag"; Value="myTagValue" }
```
**Beispiel 2: In diesem Beispiel werden die angegebenen Tags aktualisiert oder der angegebenen Ressource hinzugefügt. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
New-EC2Tag -Resource i-12345678 -Tag @( @{ Key="myTag"; Value="newTagValue" }, @{ Key="test"; Value="anotherTagValue" } )
```
**Beispiel 3: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um das Tag für den Tag-Parameter zu erstellen.**
```
$tag = New-Object Amazon.EC2.Model.Tag
$tag.Key = "myTag"
$tag.Value = "myTagValue"
New-EC2Tag -Resource i-12345678 -Tag $tag
```
+ Einzelheiten zur API finden Sie unter [CreateTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `New-EC2Volume`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2Volume`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Volume erstellt.**
```
New-EC2Volume -Size 50 -AvailabilityZone us-west-2a -VolumeType gp2
```
**Ausgabe:**
```
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
```
**Beispiel 2: Diese Beispielanforderung erstellt ein Volume und versieht es mit einem Tag mit dem Schlüssel „stack“ und dem Wert „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
```
+ Einzelheiten zur API finden Sie unter [CreateVolume AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2Vpc`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2Vpc`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine VPC mit dem angegebenen CIDR erstellt. Amazon VPC erstellt für die VPC außerdem Folgendes: einen standardmäßigen DHCP-Optionssatz, eine Haupt-Routing-Tabelle und eine Standard-Netzwerk-ACL.**
```
New-EC2VPC -CidrBlock 10.0.0.0/16
```
**Ausgabe:**
```
CidrBlock : 10.0.0.0/16
DhcpOptionsId : dopt-1a2b3c4d
InstanceTenancy : default
IsDefault : False
State : pending
Tags : {}
VpcId : vpc-12345678
```
+ Einzelheiten zur API finden Sie unter [CreateVpc AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2VpcEndpoint`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2VpcEndpoint`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neuer VPC-Endpunkt für den Service com.amazonaws.eu-west-1.s3 in der VPC vpc-0fc1ff23f45b678eb erstellt**
```
New-EC2VpcEndpoint -ServiceName com.amazonaws.eu-west-1.s3 -VpcId vpc-0fc1ff23f45b678eb
```
**Ausgabe:**
```
ClientToken VpcEndpoint
----------- -----------
Amazon.EC2.Model.VpcEndpoint
```
+ Einzelheiten zur API finden Sie unter [CreateVpcEndpoint AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2VpnConnection`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2VpnConnection`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine VPN-Verbindung zwischen dem angegebenen Virtual Private Gateway und dem angegebenen Kunden-Gateway erstellt. Die Ausgabe enthält die Konfigurationsinformationen, die Ihr Netzwerkadministrator benötigt, im XML-Format.**
```
New-EC2VpnConnection -Type ipsec.1 -CustomerGatewayId cgw-1a2b3c4d -VpnGatewayId vgw-1a2b3c4d
```
**Ausgabe:**
```
CustomerGatewayConfiguration : [XML document]
CustomerGatewayId : cgw-1a2b3c4d
Options :
Routes : {}
State : pending
Tags : {}
Type :
VgwTelemetry : {}
VpnConnectionId : vpn-12345678
VpnGatewayId : vgw-1a2b3c4d
```
**Beispiel 2: In diesem Beispiel wird die VPN-Verbindung hergestellt und die Konfiguration in einer Datei mit dem angegebenen Namen erfasst.**
```
(New-EC2VpnConnection -CustomerGatewayId cgw-1a2b3c4d -VpnGatewayId vgw-1a2b3c4d).CustomerGatewayConfiguration | Out-File C:\path\vpn-configuration.xml
```
**Beispiel 3: In diesem Beispiel wird eine VPN-Verbindung mit statischem Routing zwischen dem angegebenen Virtual Private Gateway und dem angegebenen Kunden-Gateway erstellt.**
```
New-EC2VpnConnection -Type ipsec.1 -CustomerGatewayId cgw-1a2b3c4d -VpnGatewayId vgw-1a2b3c4d -Options_StaticRoutesOnly $true
```
+ Einzelheiten zur API finden Sie unter [CreateVpnConnection AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2VpnConnectionRoute`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2VpnConnectionRoute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene statische Route für die angegebene VPN-Verbindung erstellt.**
```
New-EC2VpnConnectionRoute -VpnConnectionId vpn-12345678 -DestinationCidrBlock 11.12.0.0/16
```
+ Einzelheiten zur API finden Sie unter [CreateVpnConnectionRoute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EC2VpnGateway`
Das folgende Codebeispiel zeigt die Verwendung. `New-EC2VpnGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Virtual Private Gateway erstellt.**
```
New-EC2VpnGateway -Type ipsec.1
```
**Ausgabe:**
```
AvailabilityZone :
State : available
Tags : {}
Type : ipsec.1
VpcAttachments : {}
VpnGatewayId : vgw-1a2b3c4d
```
+ Einzelheiten zur API finden Sie unter [CreateVpnGateway AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-EC2Address`
Das folgende Codebeispiel zeigt die Verwendung. `Register-EC2Address`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Elastic IP-Adresse der spezifizierten Instance in einer VPC zugeordnet.**
```
C:\> Register-EC2Address -InstanceId i-12345678 -AllocationId eipalloc-12345678
```
**Ausgabe:**
```
eipassoc-12345678
```
**Beispiel 2: In diesem Beispiel wird die angegebene Elastic IP-Adresse der angegebenen Instance in EC2 -Classic zugeordnet.**
```
C:\> Register-EC2Address -InstanceId i-12345678 -PublicIp 203.0.113.17
```
+ Einzelheiten zur API finden Sie unter [AssociateAddress AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-EC2DhcpOption`
Das folgende Codebeispiel zeigt die Verwendung. `Register-EC2DhcpOption`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebenen VPC der genannte DHCP-Optionssatz zugeordnet.**
```
Register-EC2DhcpOption -DhcpOptionsId dopt-1a2b3c4d -VpcId vpc-12345678
```
**Beispiel 2: In diesem Beispiel wird der angegebenen VPC der standardmäßige DHCP-Optionssatz zugeordnet.**
```
Register-EC2DhcpOption -DhcpOptionsId default -VpcId vpc-12345678
```
+ Einzelheiten zur API finden Sie unter [AssociateDhcpOptions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-EC2Image`
Das folgende Codebeispiel zeigt die Verwendung. `Register-EC2Image`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein AMI mithilfe der angegebenen Manifestdatei in Amazon S3 registriert.**
```
Register-EC2Image -ImageLocation amzn-s3-demo-bucket/my-web-server-ami/image.manifest.xml -Name my-web-server-ami
```
+ Einzelheiten zur API finden Sie unter [RegisterImage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-EC2PrivateIpAddress`
Das folgende Codebeispiel zeigt die Verwendung. `Register-EC2PrivateIpAddress`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die genannten sekundären privaten IP-Adressen der angegebenen Netzwerkschnittstelle zugewiesen.**
```
Register-EC2PrivateIpAddress -NetworkInterfaceId eni-1a2b3c4d -PrivateIpAddress 10.0.0.82
```
**Beispiel 2: In diesem Beispiel werden zwei sekundäre private IP-Adressen erstellt und der angegebenen Netzwerkschnittstelle zugewiesen.**
```
Register-EC2PrivateIpAddress -NetworkInterfaceId eni-1a2b3c4d -SecondaryPrivateIpAddressCount 2
```
+ Einzelheiten zur API finden Sie unter [AssignPrivateIpAddresses AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-EC2RouteTable`
Das folgende Codebeispiel zeigt die Verwendung. `Register-EC2RouteTable`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Routing-Tabelle dem festgelegten Subnetz zugeordnet.**
```
Register-EC2RouteTable -RouteTableId rtb-1a2b3c4d -SubnetId subnet-1a2b3c4d
```
**Ausgabe:**
```
rtbassoc-12345678
```
+ Einzelheiten zur API finden Sie unter [AssociateRouteTable AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2Address`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2Address`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Elastic-IP-Adresse für Instances in einer VPC freigegeben.**
```
Remove-EC2Address -AllocationId eipalloc-12345678 -Force
```
**Beispiel 2: In diesem Beispiel wird die angegebene Elastic IP-Adresse für Instances in EC2 -Classic veröffentlicht.**
```
Remove-EC2Address -PublicIp 198.51.100.2 -Force
```
+ Einzelheiten zur API finden Sie unter [ReleaseAddress AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2CapacityReservation`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2CapacityReservation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Kapazitätsreservierung cr-0c1f2345db6f7cdba storniert**
```
Remove-EC2CapacityReservation -CapacityReservationId cr-0c1f2345db6f7cdba
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CancelCapacityReservation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2CustomerGateway`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2CustomerGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Kunden-Gateway gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2CustomerGateway -CustomerGatewayId cgw-1a2b3c4d
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteCustomerGateway AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2DhcpOption`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2DhcpOption`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene DHCP-Optionssatz gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2DhcpOption -DhcpOptionsId dopt-1a2b3c4d
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteDhcpOptions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2FlowLog`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2FlowLog`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel entfernt den angegebenen FlowLogId Wert fl-01a2b3456a789c01**
```
Remove-EC2FlowLog -FlowLogId fl-01a2b3456a789c01
```
**Ausgabe:**
```
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
```
+ *Einzelheiten zur API finden Sie unter Cmdlet-Referenz (V5). [DeleteFlowLogs](https://docs.aws.amazon.com/powershell/v5/reference)AWS -Tools für PowerShell *
### `Remove-EC2Host`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2Host`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Host-ID h-0badafd1dcb2f3456 freigegeben**
```
Remove-EC2Host -HostId h-0badafd1dcb2f3456
```
**Ausgabe:**
```
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} {}
```
+ Einzelheiten zur API finden Sie unter [ReleaseHosts AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2Instance`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2Instance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Instance beendet (die Instance kann sich im laufenden oder im angehaltenen Status befinden). Das Cmdlet fordert vor dem Fortfahren eine Bestätigung an, verwenden Sie den Schalter -Force, um den Prompt zu unterdrücken.**
```
Remove-EC2Instance -InstanceId i-12345678
```
**Ausgabe:**
```
CurrentState InstanceId PreviousState
------------ ---------- -------------
Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceState
```
+ Einzelheiten zur API finden Sie unter [TerminateInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2InternetGateway`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2InternetGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Internet-Gateway gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2InternetGateway -InternetGatewayId igw-1a2b3c4d
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteInternetGateway AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2KeyPair`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2KeyPair`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Schlüsselpaar gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2KeyPair -KeyName my-key-pair
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteKeyPair AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2NetworkAcl`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2NetworkAcl`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Netzwerk-ACL gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2NetworkAcl -NetworkAclId acl-12345678
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteNetworkAcl AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2NetworkAclEntry`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2NetworkAclEntry`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Regel aus der spezifizierten Netzwerk-ACL entfernt. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2NetworkAclEntry -NetworkAclId acl-12345678 -Egress $false -RuleNumber 100
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteNetworkAclEntry AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2NetworkInterface`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2NetworkInterface`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Netzwerkschnittstelle gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2NetworkInterface -NetworkInterfaceId eni-12345678
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteNetworkInterface AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2PlacementGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2PlacementGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Platzierungsgruppe gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2PlacementGroup -GroupName my-placement-group
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeletePlacementGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2Route`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2Route`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Route aus der spezifizierten Routing-Tabelle gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2Route -RouteTableId rtb-1a2b3c4d -DestinationCidrBlock 0.0.0.0/0
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteRoute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2RouteTable`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2RouteTable`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Routing-Tabelle gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2RouteTable -RouteTableId rtb-1a2b3c4d
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteRouteTable AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2SecurityGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2SecurityGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Sicherheitsgruppe für VPC gelöscht EC2. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2SecurityGroup -GroupId sg-12345678
```
**Ausgabe:**
```
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"):
```
**Beispiel 2: In diesem Beispiel wird die angegebene Sicherheitsgruppe für -Classic gelöscht. EC2**
```
Remove-EC2SecurityGroup -GroupName my-security-group -Force
```
+ Einzelheiten zur API finden Sie unter [DeleteSecurityGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Remove-EC2Snapshot`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2Snapshot`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Snapshot gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2Snapshot -SnapshotId snap-12345678
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteSnapshot AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2SpotDatafeedSubscription`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2SpotDatafeedSubscription`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Daten-Feed für die Spot Instance gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2SpotDatafeedSubscription
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteSpotDatafeedSubscription AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2Subnet`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2Subnet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Subnetz gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2Subnet -SubnetId subnet-1a2b3c4d
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteSubnet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2Tag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2Tag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Tag unabhängig vom Tag-Wert aus der angegebenen Ressource gelöscht. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
Remove-EC2Tag -Resource i-12345678 -Tag @{ Key="myTag" } -Force
```
**Beispiel 2: In diesem Beispiel wird das angegebene Tag aus der angegebenen Ressource gelöscht, aber nur, wenn der Tag-Wert übereinstimmt. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
Remove-EC2Tag -Resource i-12345678 -Tag @{ Key="myTag";Value="myTagValue" } -Force
```
**Beispiel 3: In diesem Beispiel wird das angegebene Tag unabhängig vom Tag-Wert aus der angegebenen Ressource gelöscht.**
```
$tag = New-Object Amazon.EC2.Model.Tag
$tag.Key = "myTag"
Remove-EC2Tag -Resource i-12345678 -Tag $tag -Force
```
**Beispiel 4: In diesem Beispiel wird das angegebene Tag aus der angegebenen Ressource gelöscht, aber nur, wenn der Tag-Wert übereinstimmt.**
```
$tag = New-Object Amazon.EC2.Model.Tag
$tag.Key = "myTag"
$tag.Value = "myTagValue"
Remove-EC2Tag -Resource i-12345678 -Tag $tag -Force
```
+ Einzelheiten zur API finden Sie unter [DeleteTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Remove-EC2Volume`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2Volume`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Volume getrennt. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2Volume -VolumeId vol-12345678
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteVolume AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2Vpc`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2Vpc`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene VPC gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2Vpc -VpcId vpc-12345678
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteVpc AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2VpnConnection`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2VpnConnection`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene VPN-Verbindung gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2VpnConnection -VpnConnectionId vpn-12345678
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteVpnConnection AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2VpnConnectionRoute`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2VpnConnectionRoute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene statische Route aus der angegebenen VPN-Verbindung entfernt. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2VpnConnectionRoute -VpnConnectionId vpn-12345678 -DestinationCidrBlock 11.12.0.0/16
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteVpnConnectionRoute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EC2VpnGateway`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EC2VpnGateway`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Virtual Private Gateway gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-EC2VpnGateway -VpnGatewayId vgw-1a2b3c4d
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteVpnGateway AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Request-EC2SpotFleet`
Das folgende Codebeispiel zeigt die Verwendung. `Request-EC2SpotFleet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Spot-Flottenanforderung in der Availability Zone mit dem niedrigsten Preis für den angegebenen Instance-Typ erstellt. Wenn Ihr Konto nur EC2 VPC unterstützt, startet die Spot-Flotte die Instances in der Availability Zone mit dem niedrigsten Preis, die über ein Standardsubnetz verfügt. Wenn Ihr Konto EC2 -Classic unterstützt, startet die Spot-Flotte die Instances in EC2 -Classic in der Availability Zone mit dem niedrigsten Preis. Beachten Sie, dass der von Ihnen gezahlte Preis den angegebenen Spot-Preis für die Anforderung nicht überschreitet.**
```
$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
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([RequestSpotFleet](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Request-EC2SpotInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Request-EC2SpotInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine einmalige Spot Instance im angegebenen Subnetz angefordert. Beachten Sie, dass die Sicherheitsgruppe für die VPC erstellt werden muss, die das angegebene Subnetz enthält, und dass sie über die Netzwerkschnittstelle anhand der ID angegeben werden muss. Wenn Sie eine Netzwerkschnittstelle angeben, müssen Sie die Subnetz-ID unter Verwendung der Netzwerkschnittstelle angeben.**
```
$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
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [RequestSpotInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Reset-EC2ImageAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Reset-EC2ImageAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Attribut „LaunchPermission“ auf seinen Standardwert zurückgesetzt. Standardmäßig AMIs sind sie privat.**
```
Reset-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission
```
+ Einzelheiten zur API finden Sie unter [ResetImageAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Reset-EC2InstanceAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Reset-EC2InstanceAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Attribut 'sriovNetSupport' für die angegebene Instanz zurückgesetzt.**
```
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute sriovNetSupport
```
**Beispiel 2: In diesem Beispiel wird das Attribut „ebsOptimized“ für die angegebene Instance zurückgesetzt.**
```
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute ebsOptimized
```
**Beispiel 3: In diesem Beispiel wird das Attribut 'sourceDestCheck' für die angegebene Instanz zurückgesetzt.**
```
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute sourceDestCheck
```
**Beispiel 4: In diesem Beispiel wird das Attribut 'disableApiTermination' für die angegebene Instanz zurückgesetzt.**
```
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute disableApiTermination
```
**Beispiel 5: In diesem Beispiel wird das Attribut 'instanceInitiatedShutdownBehavior' für die angegebene Instanz zurückgesetzt.**
```
Reset-EC2InstanceAttribute -InstanceId i-12345678 -Attribute instanceInitiatedShutdownBehavior
```
+ Einzelheiten zur API finden Sie unter [ResetInstanceAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Reset-EC2NetworkInterfaceAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Reset-EC2NetworkInterfaceAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die source/destination Überprüfung für die angegebene Netzwerkschnittstelle zurückgesetzt.**
```
Reset-EC2NetworkInterfaceAttribute -NetworkInterfaceId eni-1a2b3c4d -SourceDestCheck
```
+ Einzelheiten zur API finden Sie unter [ResetNetworkInterfaceAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Reset-EC2SnapshotAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Reset-EC2SnapshotAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Attribut des spezifizierten Snapshots zurückgesetzt.**
```
Reset-EC2SnapshotAttribute -SnapshotId snap-12345678 -Attribute CreateVolumePermission
```
+ Einzelheiten zur API finden Sie unter [ResetSnapshotAttribute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Restart-EC2Instance`
Das folgende Codebeispiel zeigt die Verwendung. `Restart-EC2Instance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Instance neu gestartet.**
```
Restart-EC2Instance -InstanceId i-12345678
```
+ Einzelheiten zur API finden Sie unter [RebootInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Revoke-EC2SecurityGroupEgress`
Das folgende Codebeispiel zeigt die Verwendung. `Revoke-EC2SecurityGroupEgress`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Regel für die angegebene Sicherheitsgruppe für EC2 VPC entfernt. Dadurch wird der Zugriff auf den angegebenen IP-Adressbereich am TCP-Port 80 aufgehoben. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$ip = @{ IpProtocol="tcp"; FromPort="80"; ToPort="80"; IpRanges="203.0.113.0/24" }
Revoke-EC2SecurityGroupEgress -GroupId sg-12345678 -IpPermission $ip
```
**Beispiel 2: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um das Objekt zu erstellen. IpPermission **
```
$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
```
**Beispiel 3: In diesem Beispiel wird der Zugriff auf die angegebene Quellsicherheitsgruppe auf TCP-Port 80 widerrufen.**
```
$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 } )
```
+ Einzelheiten zur API finden Sie unter [RevokeSecurityGroupEgress AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Revoke-EC2SecurityGroupIngress`
Das folgende Codebeispiel zeigt die Verwendung. `Revoke-EC2SecurityGroupIngress`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Zugriff auf TCP-Port 22 aus dem angegebenen Adressbereich für die angegebene Sicherheitsgruppe für EC2 VPC. Beachten Sie, dass Sie Sicherheitsgruppen für EC2 VPC anhand der Sicherheitsgruppen-ID und nicht anhand des Sicherheitsgruppennamens identifizieren müssen. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$ip = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.0/24" }
Revoke-EC2SecurityGroupIngress -GroupId sg-12345678 -IpPermission $ip
```
**Beispiel 2: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um das Objekt zu erstellen. IpPermission **
```
$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
```
**Beispiel 3: In diesem Beispiel wird der Zugriff auf TCP-Port 22 aus dem angegebenen Adressbereich für die angegebene Sicherheitsgruppe für -Classic gesperrt. EC2 Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$ip = @{ IpProtocol="tcp"; FromPort="22"; ToPort="22"; IpRanges="203.0.113.0/24" }
Revoke-EC2SecurityGroupIngress -GroupName "my-security-group" -IpPermission $ip
```
**Beispiel 4: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um das Objekt zu erstellen. IpPermission **
```
$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
```
+ Einzelheiten zur API finden Sie unter [RevokeSecurityGroupIngress AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Send-EC2InstanceStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Send-EC2InstanceStatus`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird Feedback zum Status der angegebenen Instance gegeben.**
```
Send-EC2InstanceStatus -Instance i-12345678 -Status impaired -ReasonCode unresponsive
```
+ Einzelheiten zur API finden Sie unter [ReportInstanceStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-EC2NetworkAclAssociation`
Das folgende Codebeispiel zeigt die Verwendung. `Set-EC2NetworkAclAssociation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Netzwerk-ACL dem Subnetz für die angegebene Netzwerk-ACL-Zuordnung zugeordnet.**
```
Set-EC2NetworkAclAssociation -NetworkAclId acl-12345678 -AssociationId aclassoc-1a2b3c4d
```
**Ausgabe:**
```
aclassoc-87654321
```
+ Einzelheiten zur API finden Sie unter [ReplaceNetworkAclAssociation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-EC2NetworkAclEntry`
Das folgende Codebeispiel zeigt die Verwendung. `Set-EC2NetworkAclEntry`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Eintrag für die spezifizierte Netzwerk-ACL ersetzt. Die neue Regel erlaubt eingehenden Verkehr von der angegebenen Adresse zu jedem zugehörigen Subnetz.**
```
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
```
+ Einzelheiten zur API finden Sie unter [ReplaceNetworkAclEntry AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-EC2Route`
Das folgende Codebeispiel zeigt die Verwendung. `Set-EC2Route`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Route für die spezifizierte Routing-Tabelle ersetzt. Die neue Route leitet den angegebenen Datenverkehr an das spezifizierte Virtual Private Gateway.**
```
Set-EC2Route -RouteTableId rtb-1a2b3c4d -DestinationCidrBlock 10.0.0.0/24 -GatewayId vgw-1a2b3c4d
```
+ Einzelheiten zur API finden Sie unter [ReplaceRoute AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-EC2RouteTableAssociation`
Das folgende Codebeispiel zeigt die Verwendung. `Set-EC2RouteTableAssociation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Routing-Tabelle dem Subnetz für die angegebene Routing-Tabelle zugeordnet.**
```
Set-EC2RouteTableAssociation -RouteTableId rtb-1a2b3c4d -AssociationId rtbassoc-12345678
```
**Ausgabe:**
```
rtbassoc-87654321
```
+ Einzelheiten zur API finden Sie unter [ReplaceRouteTableAssociation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Start-EC2Instance`
Das folgende Codebeispiel zeigt die Verwendung. `Start-EC2Instance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Instance gestartet.**
```
Start-EC2Instance -InstanceId i-12345678
```
**Ausgabe:**
```
CurrentState InstanceId PreviousState
------------ ---------- -------------
Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceState
```
**Beispiel 2: In diesem Beispiel werden die angegebenen Instances gestartet.**
```
@("i-12345678", "i-76543210") | Start-EC2Instance
```
**Beispiel 3: In diesem Beispiel wird die Gruppe der Instances gestartet, die derzeit angehalten sind. Die von zurückgegebenen Instance-Objekte Get-EC2Instance werden über die Pipeline an übergeben. Start-EC2Instance Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
(Get-EC2Instance -Filter @{ Name="instance-state-name"; Values="stopped"}).Instances | Start-EC2Instance
```
**Beispiel 4: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um den Filter für den Filter-Parameter zu erstellen.**
```
$filter = New-Object Amazon.EC2.Model.Filter
$filter.Name = "instance-state-name"
$filter.Values = "stopped"
(Get-EC2Instance -Filter $filter).Instances | Start-EC2Instance
```
**Beispiel 5: In diesem Beispiel werden die Berechtigungen für das Starten einer EC2 Instanz mithilfe des DryRun Parameters validiert, ohne die Instanz tatsächlich zu starten. Hinweis: Im Erfolgsfall wird eine Ausnahme ausgelöst, was das erwartete Verhalten ist.**
```
Start-EC2Instance -InstanceId 'i-0abcdef123456' -Region 'us-west-1' -DryRun $true
```
+ Einzelheiten zur API finden Sie unter [StartInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Start-EC2InstanceMonitoring`
Das folgende Codebeispiel zeigt die Verwendung. `Start-EC2InstanceMonitoring`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die detaillierte Überwachung für die angegebene Instance aktiviert.**
```
Start-EC2InstanceMonitoring -InstanceId i-12345678
```
**Ausgabe:**
```
InstanceId Monitoring
---------- ----------
i-12345678 Amazon.EC2.Model.Monitoring
```
+ Einzelheiten zur API finden Sie unter [MonitorInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Stop-EC2ImportTask`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-EC2ImportTask`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Importaufgabe (entweder Snapshot- oder Bildimport) abgebrochen. Gegebenenfalls kann über den `-CancelReason`-Parameter ein Grund angegeben werden.**
```
Stop-EC2ImportTask -ImportTaskId import-ami-abcdefgh
```
+ Einzelheiten zur API finden Sie unter [CancelImportTask AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Stop-EC2Instance`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-EC2Instance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Instance angehalten.**
```
Stop-EC2Instance -InstanceId i-12345678
```
**Ausgabe:**
```
CurrentState InstanceId PreviousState
------------ ---------- -------------
Amazon.EC2.Model.InstanceState i-12345678 Amazon.EC2.Model.InstanceState
```
+ Einzelheiten zur API finden Sie unter [StopInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Stop-EC2InstanceMonitoring`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-EC2InstanceMonitoring`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die detaillierte Überwachung für die angegebene Instance deaktiviert.**
```
Stop-EC2InstanceMonitoring -InstanceId i-12345678
```
**Ausgabe:**
```
InstanceId Monitoring
---------- ----------
i-12345678 Amazon.EC2.Model.Monitoring
```
+ Einzelheiten zur API finden Sie unter [UnmonitorInstances AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Stop-EC2SpotFleetRequest`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-EC2SpotFleetRequest`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Spot-Flottenanforderung abgebrochen und die zugehörigen Spot Instances beendet.**
```
Stop-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -TerminateInstance $true
```
**Beispiel 2: In diesem Beispiel wird die angegebene Spot-Flottenanforderung abgebrochen, ohne die zugehörigen Spot Instances zu beenden.**
```
Stop-EC2SpotFleetRequest -SpotFleetRequestId sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE -TerminateInstance $false
```
+ Einzelheiten zur API finden Sie unter [CancelSpotFleetRequests AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Stop-EC2SpotInstanceRequest`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-EC2SpotInstanceRequest`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Spot-Instance-Anforderung abgebrochen.**
```
Stop-EC2SpotInstanceRequest -SpotInstanceRequestId sir-12345678
```
**Ausgabe:**
```
SpotInstanceRequestId State
--------------------- -----
sir-12345678 cancelled
```
+ Einzelheiten zur API finden Sie unter [CancelSpotInstanceRequests AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-EC2Address`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-EC2Address`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Elastic-IP-Adresse von der angegebenen Instance in einer VPC getrennt.**
```
Unregister-EC2Address -AssociationId eipassoc-12345678
```
**Beispiel 2: In diesem Beispiel wird die Verbindung zwischen der angegebenen Elastic IP-Adresse und der angegebenen Instance in EC2 -Classic getrennt.**
```
Unregister-EC2Address -PublicIp 203.0.113.17
```
+ Einzelheiten zur API finden Sie unter [DisassociateAddress AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Unregister-EC2Image`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-EC2Image`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Registrierung des angegebenen AMI aufgehoben.**
```
Unregister-EC2Image -ImageId ami-12345678
```
+ Einzelheiten zur API finden Sie unter [DeregisterImage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-EC2PrivateIpAddress`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-EC2PrivateIpAddress`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Zuweisung der angegebenen privaten IP-Adresse zur angegebenen Netzwerkschnittstelle aufgehoben.**
```
Unregister-EC2PrivateIpAddress -NetworkInterfaceId eni-1a2b3c4d -PrivateIpAddress 10.0.0.82
```
+ Einzelheiten zur API finden Sie unter [UnassignPrivateIpAddresses AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-EC2RouteTable`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-EC2RouteTable`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Zuordnung zwischen einer Routing-Tabelle und einem Subnetz entfernt.**
```
Unregister-EC2RouteTable -AssociationId rtbassoc-1a2b3c4d
```
+ Einzelheiten zur API finden Sie unter [DisassociateRouteTable AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-EC2SecurityGroupRuleIngressDescription`
Das folgende Codebeispiel zeigt die Verwendung. `Update-EC2SecurityGroupRuleIngressDescription`
**Tools für PowerShell V5**
**Beispiel 1: Aktualisiert die Beschreibung einer vorhandenen eingehenden Sicherheitsgruppenregel.**
```
$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
```
**Beispiel 2: Entfernt die Beschreibung einer vorhandenen eingehenden Sicherheitsgruppenregel (indem der Parameter in der Anforderung weggelassen wird).**
```
$existingInboundRule = Get-EC2SecurityGroupRule -SecurityGroupRuleId "sgr-1234567890"
$ruleWithoutDescription = [Amazon.EC2.Model.SecurityGroupRuleDescription]@{
"SecurityGroupRuleId" = $existingInboundRule.SecurityGroupRuleId
}
Update-EC2SecurityGroupRuleIngressDescription -GroupId $existingInboundRule.GroupId -SecurityGroupRuleDescription $ruleWithoutDescription
```
+ Einzelheiten zur API finden Sie unter [UpdateSecurityGroupRuleDescriptionsIngress AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Amazon ECR-Beispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon ECR Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-ECRLoginCommand`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ECRLoginCommand`
**Tools für PowerShell V5**
**Beispiel 1: Gibt eine PSObject mit Anmeldeinformationen zurück, die zur Authentifizierung bei jeder Amazon ECR-Registrierung verwendet werden können, auf die Ihr IAM-Principal Zugriff hat. Die für den Aufruf zum Abrufen des Autorisierungstokens erforderlichen Anmeldeinformationen und der Regionsendpunkt werden aus den Shell-Standardeinstellungen (die mit den Cmdlets `Set-AWSCredential/Set-DefaultAWSRegion` oder `Initialize-AWSDefaultConfiguration` eingerichtet wurden) abgerufen. Sie können die Eigenschaft „Command“ mit „Invoke-Expression“ verwenden, um sich bei der angegebenen Registrierung anzumelden, oder die zurückgegebenen Anmeldeinformationen in anderen Tools verwenden, die eine Anmeldung erfordern.**
```
Get-ECRLoginCommand
```
**Ausgabe:**
```
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
```
**Beispiel 2: Ruft eine PSObject enthaltende Login-Information ab, die Sie als Eingabe für einen Docker-Login-Befehl verwenden. Sie können jede beliebige Registrierungs-URI von Amazon ECR für die Authentifizierung angeben, solange Ihr IAM-Prinzipal Zugriff auf diese Registrierung hat.**
```
(Get-ECRLoginCommand).Password | docker login --username AWS --password-stdin 012345678910.dkr.ecr.us-east-1.amazonaws.com
```
+ API-Einzelheiten finden Sie unter [ECRLoginGet-Command in der *AWS -Tools für PowerShell Cmdlet-Referenz*](https://docs.aws.amazon.com/powershell/v5/reference) (V5).
# Amazon ECS-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon ECS Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-ECSClusterDetail`
Das folgende Codebeispiel zeigt die Verwendung`Get-ECSClusterDetail`.
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet beschreibt einen oder mehrere Ihrer ECS-Cluster.**
```
Get-ECSClusterDetail -Cluster "LAB-ECS-CL" -Include SETTINGS | Select-Object *
```
**Ausgabe:**
```
LoggedAt : 12/27/2019 9:27:41 PM
Clusters : {LAB-ECS-CL}
Failures : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 396
HttpStatusCode : OK
```
+ Einzelheiten zur API finden Sie unter [DescribeClusters AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ECSClusterList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ECSClusterList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet gibt eine Liste vorhandener ECS-Cluster zurück.**
```
Get-ECSClusterList
```
**Ausgabe:**
```
arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS-CL
arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS
```
+ Einzelheiten zur API finden Sie unter [ListClusters AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ECSClusterService`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ECSClusterService`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Services aufgeführt, die in Ihrem Standard-Cluster ausgeführt werden.**
```
Get-ECSClusterService
```
**Beispiel 2: In diesem Beispiel werden alle Services aufgeführt, die im angegebenen Cluster ausgeführt werden.**
```
Get-ECSClusterService -Cluster myCluster
```
+ Einzelheiten zur API finden Sie unter [ListServices AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ECSService`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ECSService`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel zeigt, wie Sie Details zu einem bestimmten Service aus Ihrem Standard-Cluster abrufen können.**
```
Get-ECSService -Service my-hhtp-service
```
**Beispiel 2: Dieses Beispiel zeigt, wie Sie Details zu einem bestimmten Service abrufen können, der in dem genannten Cluster ausgeführt wird.**
```
Get-ECSService -Cluster myCluster -Service my-hhtp-service
```
+ Einzelheiten zur API finden Sie unter [DescribeServices AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ECSCluster`
Das folgende Codebeispiel zeigt die Verwendung. `New-ECSCluster`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet erstellt einen Amazon-ECS-Cluster. **
```
New-ECSCluster -ClusterName "LAB-ECS-CL" -Setting @{Name="containerInsights"; Value="enabled"}
```
**Ausgabe:**
```
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 : {}
```
+ Einzelheiten zur API finden Sie unter [CreateCluster AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ECSService`
Das folgende Codebeispiel zeigt die Verwendung. `New-ECSService`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Beispielbefehl erstellt in Ihrem Standardcluster einen Dienst namens `ecs-simple-service`. Der Service verwendet die Aufgabendefinition „ecs-demo“ und verwaltet zehn Instanziierungen dieser Aufgabe.**
```
New-ECSService -ServiceName ecs-simple-service -TaskDefinition ecs-demo -DesiredCount 10
```
**Beispiel 2: Dieser Beispielbefehl erstellt einen Dienst hinter einem Load Balancer in Ihrem Standardcluster namens `ecs-simple-service`. Der Service verwendet die Aufgabendefinition „ecs-demo“ und verwaltet zehn Instanziierungen dieser Aufgabe.**
```
$lb = @{
LoadBalancerName = "EC2Contai-EcsElast-S06278JGSJCM"
ContainerName = "simple-demo"
ContainerPort = 80
}
New-ECSService -ServiceName ecs-simple-service -TaskDefinition ecs-demo -DesiredCount 10 -LoadBalancer $lb
```
+ Einzelheiten zur API finden Sie unter [CreateService AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ECSCluster`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ECSCluster`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet löscht den angegebenen ECS-Cluster. Sie müssen die Registrierung aller Container-Instances aus diesem Cluster aufheben, bevor Sie ihn löschen können. **
```
Remove-ECSCluster -Cluster "LAB-ECS"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteCluster AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ECSService`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ECSService`
**Tools für PowerShell V5**
**Beispiel 1: Löscht den Dienst mit dem Namen 'my-http-service' im Standardcluster. Der Service muss eine gewünschte Anzahl und eine laufende Anzahl von 0 aufweisen, bevor Sie ihn löschen können. Sie werden um eine Bestätigung gebeten, bevor der Befehl ausgeführt wird. Um die Bestätigungsaufforderung zu umgehen, fügen Sie den Schalter -Force hinzu.**
```
Remove-ECSService -Service my-http-service
```
**Beispiel 2: Löscht den Dienst mit dem Namen 'my-http-service' im benannten Cluster.**
```
Remove-ECSService -Cluster myCluster -Service my-http-service
```
+ Einzelheiten zur API finden Sie unter [DeleteService AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-ECSClusterSetting`
Das folgende Codebeispiel zeigt die Verwendung. `Update-ECSClusterSetting`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet ändert die Einstellungen, die für einen ECS-Cluster verwendet werden.**
```
Update-ECSClusterSetting -Cluster "LAB-ECS-CL" -Setting @{Name="containerInsights"; Value="disabled"}
```
**Ausgabe:**
```
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 : {}
```
+ Einzelheiten zur API finden Sie unter [UpdateClusterSettings AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-ECSService`
Das folgende Codebeispiel zeigt die Verwendung. `Update-ECSService`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Beispielbefehl aktualisiert den Dienst `my-http-service` so, dass er die amazon-ecs-sample ``Aufgabendefinition verwendet.**
```
Update-ECSService -Service my-http-service -TaskDefinition amazon-ecs-sample
```
**Beispiel 2: Mit diesem Beispielbefehl wird die gewünschte Anzahl des my-http-service ``-Dienstes auf 10 aktualisiert.**
```
Update-ECSService -Service my-http-service -DesiredCount 10
```
+ Einzelheiten zur API finden Sie unter [UpdateService AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
# Amazon EFS-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon EFS Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Edit-EFSMountTargetSecurityGroup`
Das folgende Codebeispiel zeigt die Verwendung`Edit-EFSMountTargetSecurityGroup`.
**Tools für PowerShell V5**
**Beispiel 1: Aktualisiert die Sicherheitsgruppen, die für das angegebene Mounting-Ziel aktiv sind Es können bis zu 5 im Format „sg-xxxxxxxx“ angegeben werden.**
```
Edit-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d -SecurityGroup sg-group1,sg-group3
```
+ Einzelheiten zur API finden Sie unter [ModifyMountTargetSecurityGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EFSFileSystem`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EFSFileSystem`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Sammlung aller Dateisysteme zurück, die sich im Besitz des Kontos des Anrufers in der Region befinden.**
```
Get-EFSFileSystem
```
**Ausgabe:**
```
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
...
```
**Beispiel 2: Gibt die Details des angegebenen Dateisystems zurück.**
```
Get-EFSFileSystem -FileSystemId fs-1a2b3c4d
```
**Beispiel 3: Gibt die Details eines Dateisystems unter Verwendung des bei der Erstellung des Dateisystems angegebenen Idempotenz-Erstellungstokens zurück.**
```
Get-EFSFileSystem -CreationToken 1a2bff54-85e0-4747-bd95-7bc172c4f555
```
+ Einzelheiten zur API finden Sie unter [DescribeFileSystems AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EFSMountTarget`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EFSMountTarget`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Sammlung von Mount-Zielen zurück, die dem angegebenen Dateisystem zugeordnet sind.**
```
Get-EFSMountTarget -FileSystemId fs-1a2b3c4d
```
**Ausgabe:**
```
FileSystemId : fs-1a2b3c4d
IpAddress : 10.0.0.131
LifeCycleState : available
MountTargetId : fsmt-1a2b3c4d
NetworkInterfaceId : eni-1a2b3c4d
OwnerId : 123456789012
SubnetId : subnet-1a2b3c4d
```
+ Einzelheiten zur API finden Sie unter [DescribeMountTargets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EFSMountTargetSecurityGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EFSMountTargetSecurityGroup`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die IDs der Sicherheitsgruppen zurück, die derzeit der Netzwerkschnittstelle zugewiesen sind, welche dem Mount-Ziel zugeordnet ist.**
```
Get-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d
```
**Ausgabe:**
```
sg-1a2b3c4d
```
+ Einzelheiten zur API finden Sie unter [DescribeMountTargetSecurityGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EFSTag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EFSTag`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Sammlung von Tags zurück, die derzeit dem angegebenen Dateisystem zugeordnet sind.**
```
Get-EFSTag -FileSystemId fs-1a2b3c4d
```
**Ausgabe:**
```
Key Value
--- -----
Name My File System
tagkey1 tagvalue1
tagkey2 tagvalue2
```
+ Einzelheiten zur API finden Sie unter [DescribeTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EFSFileSystem`
Das folgende Codebeispiel zeigt die Verwendung. `New-EFSFileSystem`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt ein neues, leeres Dateisystem. Das Token, das zur Gewährleistung einer idempotenten Erstellung verwendet wird, wird automatisch generiert und kann über das `CreationToken`-Element des zurückgegebenen Objekts abgerufen werden.**
```
New-EFSFileSystem
```
**Ausgabe:**
```
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
```
**Beispiel 2: Erstellt ein neues, leeres Dateisystem unter Verwendung eines benutzerdefinierten Tokens, um eine idempotente Erstellung sicherzustellen.**
```
New-EFSFileSystem -CreationToken "MyUniqueToken"
```
+ Einzelheiten zur API finden Sie unter [CreateFileSystem AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EFSMountTarget`
Das folgende Codebeispiel zeigt die Verwendung. `New-EFSMountTarget`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt ein neues Mounting-Ziel für ein Dateisystem. Das angegebene Subnetz wird verwendet, um die Virtual Private Cloud (VPC) zu bestimmen, in der das Mount-Ziel erstellt wird, und die IP-Adresse, die automatisch zugewiesen wird (aus dem Adressbereich des Subnetzes). Die zugewiesene IP-Adresse kann verwendet werden, um dieses Dateisystem dann auf einer EC2 Amazon-Instance zu mounten. Da keine Sicherheitsgruppen angegeben wurden, ist die für das Ziel erstellte Netzwerkschnittstelle der Standardsicherheitsgruppe für die VPC des Subnetzes zugeordnet.**
```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d
```
**Ausgabe:**
```
FileSystemId : fs-1a2b3c4d
IpAddress : 10.0.0.131
LifeCycleState : creating
MountTargetId : fsmt-1a2b3c4d
NetworkInterfaceId : eni-1a2b3c4d
OwnerId : 123456789012
SubnetId : subnet-1a2b3c4d
```
**Beispiel 2: Erzeugt ein neues Mount-Ziel für das angegebene Dateisystem mit automatisch zugewiesener IP-Adresse. Die für das Mount-Ziel erstellte Netzwerkschnittstelle ist den angegebenen Sicherheitsgruppen zugeordnet (es können bis zu 5 im Format „sg-xxxxxxxx“ angegeben werden).**
```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -SecurityGroup sg-group1,sg-group2,sg-group3
```
**Beispiel 3: Erstellt ein neues Mount-Ziel für das angegebene Dateisystem mit der angegebenen IP-Adresse.**
```
New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -IpAddress 10.0.0.131
```
+ Einzelheiten zur API finden Sie unter [CreateMountTarget AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-EFSTag`
Das folgende Codebeispiel zeigt die Verwendung. `New-EFSTag`
**Tools für PowerShell V5**
**Beispiel 1: Wendet die Sammlung von Tags auf das angegebene Dateisystem an. Wenn ein Tag mit dem angegebenen Schlüssel bereits im Dateisystem vorhanden ist, wird der Wert des Tags aktualisiert.**
```
New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="tagkey1";Value="tagvalue1"},@{Key="tagkey2";Value="tagvalue2"}
```
**Beispiel 2: Legt das Name-Tag für das angegebene Dateisystem fest. Dieser Wert wird zusammen mit anderen Dateisystemdetails zurückgegeben, wenn das Get-EFSFileSystem Cmdlet verwendet wird.**
```
New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="Name";Value="My File System"}
```
+ Einzelheiten zur API finden Sie unter [CreateTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Remove-EFSFileSystem`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EFSFileSystem`
**Tools für PowerShell V5**
**Beispiel 1: Löscht das angegebene Dateisystem, das nicht mehr verwendet wird (wenn das Dateisystem Mount-Ziele hat, müssen diese zuerst entfernt werden). Sie werden um eine Bestätigung gebeten, bevor das Cmdlet fortfährt. Um die Bestätigung zu unterdrücken, verwenden Sie den `-Force`-Schalter.**
```
Remove-EFSFileSystem -FileSystemId fs-1a2b3c4d
```
+ Einzelheiten zur API finden Sie unter [DeleteFileSystem AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EFSMountTarget`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EFSMountTarget`
**Tools für PowerShell V5**
**Beispiel 1: Löscht das angegebene Mount-Ziel. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird. Verwenden Sie den `-Force`-Schalter, um das Prompt zu unterdrücken. Beachten Sie, dass dieser Vorgang alle Mounts des Dateisystems über das Ziel zwangsweise beendet. Sie sollten daher in Erwägung ziehen, den Mount des Dateisystems aufzuheben, bevor Sie diesen Befehl ausführen, sofern dies möglich ist.**
```
Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d
```
+ Einzelheiten zur API finden Sie unter [DeleteMountTarget AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EFSTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EFSTag`
**Tools für PowerShell V5**
**Beispiel 1: Löscht die Sammlung eines oder mehrerer Tags aus einem Dateisystem. Sie werden um eine Bestätigung gebeten, bevor das Cmdlet fortfährt. Um die Bestätigung zu unterdrücken, verwenden Sie den `-Force`-Schalter.**
```
Remove-EFSTag -FileSystemId fs-1a2b3c4d -TagKey "tagkey1","tagkey2"
```
+ Einzelheiten zur API finden Sie unter [DeleteTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Amazon EKS-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon EKS Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-EKSResourceTag`
Das folgende Codebeispiel zeigt die Verwendung`Add-EKSResourceTag`.
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet ordnet die angegebenen Tags einer Ressource mit dem angegebenen resourceArn zu. **
```
Add-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD" -Tag @{Name = "EKSPRODCLUSTER"}
```
+ Einzelheiten zur API finden Sie unter [TagResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EKSCluster`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EKSCluster`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet gibt beschreibende Informationen zu einem Amazon-EKS-Cluster zurück.**
```
Get-EKSCluster -Name "PROD"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeCluster AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EKSClusterList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EKSClusterList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet listet die Amazon EKS-Cluster in Ihrem AWS-Konto in der angegebenen Region auf.**
```
Get-EKSClusterList
```
**Ausgabe:**
```
PROD
```
+ Einzelheiten zur API finden Sie unter [ListClusters AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EKSFargateProfile`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EKSFargateProfile`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet gibt beschreibende Informationen zu einem AWS Fargate-Profil zurück.**
```
Get-EKSFargateProfile -FargateProfileName "EKSFargate" -ClusterName "TEST"
```
**Ausgabe:**
```
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 : {}
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([DescribeFargateProfile](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Get-EKSFargateProfileList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EKSFargateProfileList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet listet die AWS Fargate-Profile auf, die dem angegebenen Cluster in Ihrem AWS-Konto in der angegebenen Region zugeordnet sind.**
```
Get-EKSFargateProfileList -ClusterName "TEST"
```
**Ausgabe:**
```
EKSFargate
EKSFargateProfile
```
+ Einzelheiten zur API finden Sie unter [ListFargateProfiles AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EKSNodegroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EKSNodegroup`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet gibt beschreibende Informationen über eine Amazon-EKS-Knotengruppe zurück.**
```
Get-EKSNodegroup -NodegroupName "ProdEKSNodeGroup" -ClusterName "PROD"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeNodegroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EKSNodegroupList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EKSNodegroupList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet listet die Amazon EKS-Knotengruppen auf, die dem angegebenen Cluster in Ihrem AWS-Konto in der angegebenen Region zugeordnet sind.**
```
Get-EKSNodegroupList -ClusterName PROD
```
**Ausgabe:**
```
ProdEKSNodeGroup
```
+ Einzelheiten zur API finden Sie unter [ListNodegroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-EKSResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EKSResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet listet die Tags für eine Amazon-EKS-Ressource auf. **
```
Get-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD"
```
**Ausgabe:**
```
Key Value
--- -----
Name EKSPRODCLUSTER
```
+ Einzelheiten zur API finden Sie unter [ListTagsForResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EKSUpdate`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EKSUpdate`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet gibt beschreibende Informationen über ein Update für Ihren Amazon-EKS-Cluster oder die zugewiesene verwaltete Knotengruppe zurück. **
```
Get-EKSUpdate -Name "PROD" -UpdateId "ee708232-7d2e-4ed7-9270-d0b5176f0726"
```
**Ausgabe:**
```
CreatedAt : 12/25/2019 5:03:07 PM
Errors : {}
Id : ee708232-7d2e-4ed7-9270-d0b5176f0726
Params : {Amazon.EKS.Model.UpdateParam}
Status : Successful
Type : LoggingUpdate
```
+ Einzelheiten zur API finden Sie unter [DescribeUpdate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-EKSUpdateList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-EKSUpdateList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet listet die Updates auf, die einem Amazon EKS-Cluster oder einer verwalteten Knotengruppe in Ihrer AWS-Konto Region zugeordnet sind.**
```
Get-EKSUpdateList -Name "PROD"
```
**Ausgabe:**
```
ee708232-7d2e-4ed7-9270-d0b5176f0726
```
+ Einzelheiten zur API finden Sie unter [ListUpdates AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `New-EKSCluster`
Das folgende Codebeispiel zeigt die Verwendung. `New-EKSCluster`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neuer Cluster namens „prod“ erstellt.**
```
New-EKSCluster -Name prod -ResourcesVpcConfig @{SubnetIds=@("subnet-0a1b2c3d","subnet-3a2b1c0d");SecurityGroupIds="sg-6979fe18"} -RoleArn "arn:aws:iam::012345678901:role/eks-service-role"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateCluster AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-EKSFargateProfile`
Das folgende Codebeispiel zeigt die Verwendung. `New-EKSFargateProfile`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet erstellt ein AWS Fargate-Profil für Ihren Amazon EKS-Cluster. Sie müssen mindestens ein Fargate-Profil in einem Cluster haben, um Pods auf der Fargate-Infrastruktur planen zu können. **
```
New-EKSFargateProfile -FargateProfileName EKSFargateProfile -ClusterName TEST -Subnet "subnet-02f6ff500ff2067a0", "subnet-0cd976f08d5fbfaae" -PodExecutionRoleArn arn:aws:iam::012345678912:role/AmazonEKSFargatePodExecutionRole -Selector @{Namespace="default"}
```
**Ausgabe:**
```
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 : {}
```
+ Einzelheiten zur API finden Sie unter [CreateFargateProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `New-EKSNodeGroup`
Das folgende Codebeispiel zeigt die Verwendung. `New-EKSNodeGroup`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet erstellt eine verwaltete Worker-Kknotengruppe für einen Amazon EKS-Cluster. Sie können nur eine Knotengruppe für Ihren Cluster erstellen, die der aktuellen Kubernetes-Version für den Cluster entspricht. Alle Knotengruppen werden mit der neuesten AMI-Release-Version für die jeweilige Kubernetes-Unterversion des Clusters erstellt.**
```
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"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateNodegroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Remove-EKSCluster`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EKSCluster`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet löscht die Steuerebene des Amazon-EKS-Clusters.**
```
Remove-EKSCluster -Name "DEV-KUBE-CL"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteCluster AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EKSFargateProfile`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EKSFargateProfile`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet löscht ein AWS Fargate-Profil. Wenn Sie ein Fargate-Profil löschen, werden alle Pods, die auf Fargate ausgeführt werden und mit diesem Profil erstellt wurden, ebenfalls gelöscht. **
```
Remove-EKSFargateProfile -FargateProfileName "EKSFargate" -ClusterName "TEST"
```
**Ausgabe:**
```
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 : {}
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([DeleteFargateProfile](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Remove-EKSNodegroup`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EKSNodegroup`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet löscht eine Amazon-EKS-Knotengruppe für einen Cluster.**
```
Remove-EKSNodegroup -NodegroupName "ProdEKSNodeGroup" -ClusterName "PROD"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteNodegroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-EKSResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-EKSResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet löscht angegebene Tags aus einer EKS-Ressource.**
```
Remove-EKSResourceTag -ResourceArn "arn:aws:eks:us-west-2:012345678912:cluster/PROD" -TagKey "Name"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UntagResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-EKSClusterConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Update-EKSClusterConfig`
**Tools für PowerShell V5**
**Beispiel 1: Aktualisiert eine Konfiguration von Amazon EKS Cluster. Ihr Cluster funktioniert während des Updates weiterhin.**
```
Update-EKSClusterConfig -Name "PROD" -Logging_ClusterLogging @{Types="api","audit","authenticator","controllerManager","scheduler",Enabled="True"}
```
**Ausgabe:**
```
CreatedAt : 12/25/2019 5:03:07 PM
Errors : {}
Id : ee708232-7d2e-4ed7-9270-d0b5176f0726
Params : {Amazon.EKS.Model.UpdateParam}
Status : InProgress
Type : LoggingUpdate
```
+ Einzelheiten zur API finden Sie unter [UpdateClusterConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-EKSClusterVersion`
Das folgende Codebeispiel zeigt die Verwendung. `Update-EKSClusterVersion`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Cmdlet aktualisiert einen Amazon-EKS-Cluster auf die angegebene Kubernetes-Version. Ihr Cluster funktioniert während des Updates weiterhin.**
```
Update-EKSClusterVersion -Name "PROD-KUBE-CL" -Version 1.14
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UpdateClusterVersion AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Elastic Load Balancing — Beispiele für Version 1 mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Elastic Load Balancing — Version 1 Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-ELBLoadBalancerToSubnet`
Das folgende Codebeispiel zeigt, wie Sie`Add-ELBLoadBalancerToSubnet`.
**Tools für PowerShell V5**
**Beispiel 1: Hier wird das angegebene Subnetz zu den Subnetzen hinzugefügt, die für den spezifizierten Load Balancer konfiguriert sind. Die Ausgabe enthält die vollständige Liste der Subnetze.**
```
Add-ELBLoadBalancerToSubnet -LoadBalancerName my-load-balancer -Subnet subnet-12345678
```
**Ausgabe:**
```
subnet-12345678
subnet-87654321
```
+ Einzelheiten zur API finden Sie unter [AttachLoadBalancerToSubnets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Add-ELBResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Add-ELBResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Hier werden die angegebenen Tags zum spezifizierten Load Balancer hinzugefügt. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
Add-ELBResourceTag -LoadBalancerName my-load-balancer -Tag @{ Key="project";Value="lima" },@{ Key="department";Value="digital-media" }
```
**Beispiel 2: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um ein Tag für den Tag-Parameter zu erstellen.**
```
$tag = New-Object Amazon.ElasticLoadBalancing.Model.Tag
$tag.Key = "project"
$tag.Value = "lima"
Add-ELBResourceTag -LoadBalancerName my-load-balancer -Tag $tag
```
+ Einzelheiten zur API finden Sie unter [AddTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Disable-ELBAvailabilityZoneForLoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `Disable-ELBAvailabilityZoneForLoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Availability Zone aus dem spezifizierten Load Balancer entfernt. Die Ausgabe umfasst die verbleibenden Availability Zones.**
```
Disable-ELBAvailabilityZoneForLoadBalancer -LoadBalancerName my-load-balancer -AvailabilityZone us-west-2a
```
**Ausgabe:**
```
us-west-2b
```
+ Einzelheiten zur API finden Sie unter [DisableAvailabilityZonesForLoadBalancer AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Dismount-ELBLoadBalancerFromSubnet`
Das folgende Codebeispiel zeigt die Verwendung. `Dismount-ELBLoadBalancerFromSubnet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Subnetz aus den Subnetzen entfernt, die für den spezifizierten Load Balancer konfiguriert sind. Die Ausgabe umfasst die verbleibenden Subnetze.**
```
Dismount-ELBLoadBalancerFromSubnet -LoadBalancerName my-load-balancer -Subnet subnet-12345678
```
**Ausgabe:**
```
subnet-87654321
```
+ Einzelheiten zur API finden Sie unter [DetachLoadBalancerFromSubnets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-ELBLoadBalancerAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-ELBLoadBalancerAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das zonenübergreifende Load Balancing für den angegebenen Load Balancer aktiviert.**
```
Edit-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer -CrossZoneLoadBalancing_Enabled $true
```
**Beispiel 2: In diesem Beispiel wird das Connection Draining für den angegebenen Load Balancer deaktiviert.**
```
Edit-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer -ConnectionDraining_Enabled $false
```
**Beispiel 3: In diesem Beispiel wird die Zugriffsprotokollierung für den angegebenen Load Balancer aktiviert.**
```
Edit-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer `
>> -AccessLog_Enabled $true `
>> -AccessLog_S3BucketName amzn-s3-demo-logging-bucket `
>> -AccessLog_S3BucketPrefix my-app/prod `
>> -AccessLog_EmitInterval 60
```
+ Einzelheiten zur API finden Sie unter [ModifyLoadBalancerAttributes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Enable-ELBAvailabilityZoneForLoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-ELBAvailabilityZoneForLoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Availability Zone zum angegebenen Load Balancer hinzugefügt. Die Ausgabe enthält die vollständige Liste der Availability Zones.**
```
Enable-ELBAvailabilityZoneForLoadBalancer -LoadBalancerName my-load-balancer -AvailabilityZone us-west-2a
```
**Ausgabe:**
```
us-west-2a
us-west-2b
```
+ Einzelheiten zur API finden Sie unter [EnableAvailabilityZonesForLoadBalancer AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELBInstanceHealth`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELBInstanceHealth`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Status der Instance beschrieben, die beim angegebenen Load Balancer registriert ist.**
```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer
```
**Ausgabe:**
```
Description InstanceId ReasonCode State
----------- ---------- ---------- -----
N/A i-87654321 N/A InService
Instance has failed at lea... i-12345678 Instance OutOfService
```
**Beispiel 2: In diesem Beispiel wird der Status der angegebenen Instance beschrieben, die beim angegebenen Load Balancer registriert ist.**
```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Beispiel 3: In diesem Beispiel wird die vollständige Beschreibung des Status der angegebenen Instance angezeigt.**
```
(Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678).Description
```
**Ausgabe:**
```
Instance has failed at least the UnhealthyThreshold number of health checks consecutively.
```
+ Einzelheiten zur API finden Sie unter [DescribeInstanceHealth AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELBLoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELBLoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Namen Ihrer Load Balancer aufgelistet.**
```
Get-ELBLoadBalancer | format-table -property LoadBalancerName
```
**Ausgabe:**
```
LoadBalancerName
----------------
my-load-balancer
my-other-load-balancer
my-internal-load-balancer
```
**Beispiel 2: In diesem Beispiel wird der angegebene Load Balancer beschrieben.**
```
Get-ELBLoadBalancer -LoadBalancerName my-load-balancer
```
**Ausgabe:**
```
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
```
**Beispiel 3: Dieses Beispiel beschreibt alle Ihre Load Balancer in der aktuellen AWS Region.**
```
Get-ELBLoadBalancer
```
**Beispiel 4: In diesem Beispiel werden alle Ihre Load Balancer in allen verfügbaren AWS-Regionen beschrieben.**
```
Get-AWSRegion | % { Get-ELBLoadBalancer -Region $_ }
```
+ Einzelheiten zur API finden Sie unter [DescribeLoadBalancers AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELBLoadBalancerAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELBLoadBalancerAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Attribute für den angegebenen Load Balancer beschrieben.**
```
Get-ELBLoadBalancerAttribute -LoadBalancerName my-load-balancer
```
**Ausgabe:**
```
AccessLog : Amazon.ElasticLoadBalancing.Model.AccessLog
AdditionalAttributes : {}
ConnectionDraining : Amazon.ElasticLoadBalancing.Model.ConnectionDraining
ConnectionSettings : Amazon.ElasticLoadBalancing.Model.ConnectionSettings
CrossZoneLoadBalancing : Amazon.ElasticLoadBalancing.Model.CrossZoneLoadBalancing
```
+ Einzelheiten zur API finden Sie unter [DescribeLoadBalancerAttributes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELBLoadBalancerPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELBLoadBalancerPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Richtlinien beschrieben, die dem angegebenen Load Balancer zugeordnet sind.**
```
Get-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer
```
**Ausgabe:**
```
PolicyAttributeDescriptions PolicyName PolicyTypeName
--------------------------- ---------- --------------
{ProxyProtocol} my-ProxyProtocol-policy ProxyProtocolPolicyType
{CookieName} my-app-cookie-policy AppCookieStickinessPolicyType
```
**Beispiel 2: In diesem Beispiel werden die Attribute der angegebenen Richtlinie beschrieben.**
```
(Get-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer -PolicyName my-ProxyProtocol-policy).PolicyAttributeDescriptions
```
**Ausgabe:**
```
AttributeName AttributeValue
------------- --------------
ProxyProtocol true
```
**Beispiel 3: In diesem Beispiel werden die vordefinierten Richtlinien beschrieben, einschließlich der Beispielrichtlinien. Die Namen der Beispielrichtlinien haben das Präfix ELBSample -.**
```
Get-ELBLoadBalancerPolicy
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeLoadBalancerPolicies AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-ELBLoadBalancerPolicyType`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELBLoadBalancerPolicyType`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Richtlinientypen abgerufen, die von Elastic Load Balancing unterstützt werden.**
```
Get-ELBLoadBalancerPolicyType
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel wird der angegebene Richtlinientyp beschrieben.**
```
Get-ELBLoadBalancerPolicyType -PolicyTypeName ProxyProtocolPolicyType
```
**Ausgabe:**
```
Description PolicyAttributeTypeDescriptions PolicyTypeName
----------- ------------------------------- --------------
Policy that controls whether to incl... {ProxyProtocol} ProxyProtocolPolicyType
```
**Beispiel 3: In diesem Beispiel wird die vollständige Beschreibung des angegebenen Richtlinientyps angezeigt.**
```
(Get-ELBLoadBalancerPolicyType -PolicyTypeName).Description
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeLoadBalancerPolicyTypes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELBResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELBResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Tags für die angegebenen Load Balancers aufgelistet.**
```
Get-ELBResourceTag -LoadBalancerName @("my-load-balancer","my-internal-load-balancer")
```
**Ausgabe:**
```
LoadBalancerName Tags
---------------- ----
my-load-balancer {project, department}
my-internal-load-balancer {project, department}
```
**Beispiel 2: In diesem Beispiel werden die Tags für den angegebenen Load Balancers beschrieben.**
```
(Get-ELBResourceTag -LoadBalancerName my-load-balancer).Tags
```
**Ausgabe:**
```
Key Value
--- -----
project lima
department digital-media
```
+ Einzelheiten zur API finden Sie unter [DescribeTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Join-ELBSecurityGroupToLoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `Join-ELBSecurityGroupToLoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die aktuelle Sicherheitsgruppe für den angegebenen Load Balancer durch die spezifizierte Sicherheitsgruppe ersetzt.**
```
Join-ELBSecurityGroupToLoadBalancer -LoadBalancerName my-load-balancer -SecurityGroup sg-87654321
```
**Ausgabe:**
```
sg-87654321
```
**Beispiel 2: Um die aktuelle Sicherheitsgruppe beizubehalten und eine zusätzliche Sicherheitsgruppe anzugeben, geben Sie sowohl die vorhandene als auch die neue Sicherheitsgruppe an.**
```
Join-ELBSecurityGroupToLoadBalancer -LoadBalancerName my-load-balancer -SecurityGroup @("sg-12345678", "sg-87654321")
```
**Ausgabe:**
```
sg-12345678
sg-87654321
```
+ Einzelheiten zur API finden Sie unter [ApplySecurityGroupsToLoadBalancer AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ELBAppCookieStickinessPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `New-ELBAppCookieStickinessPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Stickiness-Richtlinie erstellt, die sich an die Lebensdauer des angegebenen, von der Anwendung generierten Cookies für Sticky Sessions hält.**
```
New-ELBAppCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-app-cookie-policy -CookieName my-app-cookie
```
+ Einzelheiten zur API finden Sie unter [CreateAppCookieStickinessPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ELBLBCookieStickinessPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `New-ELBLBCookieStickinessPolicy`
**Tools für PowerShell V5**
**Beispiel 1: Hier wird eine Stickiness-Richtlinie erstellt, bei der die Dauer der Sticky Sessions durch die festgelegte Ablaufzeit (in Sekunden) bestimmt wird).**
```
New-ELBLBCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy -CookieExpirationPeriod 60
```
**Beispiel 2: Hier wird eine Stickiness-Richtlinie erstellt, bei der die Dauer der Sticky Sessions von der Lebensdauer des Browsers (User-Agent) abhängt).**
```
New-ELBLBCookieStickinessPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy
```
+ Einzelheiten zur API finden Sie unter [CreateLbCookieStickinessPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ELBLoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `New-ELBLoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Load Balancer mit einem HTTP-Listener in einer VPC erstellt.**
```
$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
```
**Beispiel 2: In diesem Beispiel wird ein Load Balancer mit einem HTTP-Listener in -Classic erstellt. EC2**
```
New-ELBLoadBalancer -LoadBalancerName my-classic-load-balancer -AvailabilityZone us-west-2a` -Listener $httpListener
```
**Ausgabe:**
```
my-classic-load-balancer-123456789.us-west-2.elb.amazonaws.com
```
**Beispiel 3: In diesem Beispiel wird ein Load Balancer mit einem HTTPS-Listener erstellt.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [CreateLoadBalancer AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `New-ELBLoadBalancerListener`
Das folgende Codebeispiel zeigt die Verwendung. `New-ELBLoadBalancerListener`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird dem angegebenen Load Balancer ein HTTPS-Listener hinzugefügt.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [CreateLoadBalancerListeners AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ELBLoadBalancerPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `New-ELBLoadBalancerPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Proxyprotokollrichtlinie für einen angegebenen Load Balancer erstellt.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [CreateLoadBalancerPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-ELBInstanceWithLoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `Register-ELBInstanceWithLoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene EC2 Instanz beim angegebenen Load Balancer registriert.**
```
Register-ELBInstanceWithLoadBalancer -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Ausgabe:**
```
InstanceId
----------
i-12345678
i-87654321
```
+ Einzelheiten zur API finden Sie unter [RegisterInstancesWithLoadBalancer AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ELBInstanceFromLoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ELBInstanceFromLoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene EC2 Instanz aus dem angegebenen Load Balancer entfernt. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-ELBInstanceFromLoadBalancer -LoadBalancerName my-load-balancer -Instance i-12345678
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeregisterInstancesFromLoadBalancer AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ELBLoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ELBLoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Load Balancer gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-ELBLoadBalancer -LoadBalancerName my-load-balancer
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteLoadBalancer AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ELBLoadBalancerListener`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ELBLoadBalancerListener`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Listener auf Port 80 für den angegebenen Load Balancer gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-ELBLoadBalancerListener -LoadBalancerName my-load-balancer -LoadBalancerPort 80
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteLoadBalancerListeners AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ELBLoadBalancerPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ELBLoadBalancerPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Richtlinie aus dem angegebenen Load Balancer gelöscht. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an.**
```
Remove-ELBLoadBalancerPolicy -LoadBalancerName my-load-balancer -PolicyName my-duration-cookie-policy
```
**Ausgabe:**
```
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"):
```
+ Einzelheiten zur API finden Sie unter [DeleteLoadBalancerPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ELBResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ELBResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Tag aus dem spezifizierten Load Balancer entfernt. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird, es sei denn, Sie geben zusätzlich den Force-Parameter an. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
Remove-ELBResourceTag -LoadBalancerName my-load-balancer -Tag @{ Key="project" }
```
**Ausgabe:**
```
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"):
```
**Beispiel 2: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um das Tag für den Tag-Parameter zu erstellen.**
```
$tag = New-Object Amazon.ElasticLoadBalancing.Model.TagKeyOnly
$tag.Key = "project"
Remove-ELBResourceTag -Tag $tag -Force
```
+ Einzelheiten zur API finden Sie unter [RemoveTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Set-ELBHealthCheck`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ELBHealthCheck`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Einstellungen für die Zustandsprüfung für den angegebenen Load Balancer konfiguriert.**
```
Set-ELBHealthCheck -LoadBalancerName my-load-balancer `
>> -HealthCheck_HealthyThreshold 2 `
>> -HealthCheck_UnhealthyThreshold 2 `
>> -HealthCheck_Target "HTTP:80/ping" `
>> -HealthCheck_Interval 30 `
>> -HealthCheck_Timeout 3
```
**Ausgabe:**
```
HealthyThreshold : 2
Interval : 30
Target : HTTP:80/ping
Timeout : 3
UnhealthyThreshold : 2
```
+ Einzelheiten zur API finden Sie unter [ConfigureHealthCheck AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-ELBLoadBalancerListenerSSLCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ELBLoadBalancerListenerSSLCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Zertifikat ersetzt, das die SSL-Verbindungen für den angegebenen Listener beendet.**
```
Set-ELBLoadBalancerListenerSSLCertificate -LoadBalancerName my-load-balancer `
>> -LoadBalancerPort 443 `
>> -SSLCertificateId "arn:aws:iam::123456789012:server-certificate/new-server-cert"
```
+ Einzelheiten zur API finden Sie unter [SetLoadBalancerListenerSslCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-ELBLoadBalancerPolicyForBackendServer`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ELBLoadBalancerPolicyForBackendServer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Richtlinien für den angegebenen Port durch die spezifizierte Richtlinie ersetzt.**
```
Set-ELBLoadBalancerPolicyForBackendServer -LoadBalancerName my-load-balancer -InstancePort 80 -PolicyName my-ProxyProtocol-policy
```
**Beispiel 2: In diesem Beispiel werden alle Richtlinien entfernt, die dem angegebenen Port zugeordnet sind.**
```
Set-ELBLoadBalancerPolicyForBackendServer -LoadBalancerName my-load-balancer -InstancePort 80
```
+ Einzelheiten zur API finden Sie unter [SetLoadBalancerPoliciesForBackendServer AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-ELBLoadBalancerPolicyOfListener`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ELBLoadBalancerPolicyOfListener`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Richtlinien für den angegebenen Listener durch die angegebene Richtlinie ersetzt.**
```
Set-ELBLoadBalancerPolicyOfListener -LoadBalancerName my-load-balancer -LoadBalancerPort 443 -PolicyName my-SSLNegotiation-policy
```
**Beispiel 2: In diesem Beispiel werden alle Richtlinien entfernt, die dem angegebenen Listener zugeordnet sind.**
```
Set-ELBLoadBalancerPolicyOfListener -LoadBalancerName my-load-balancer -LoadBalancerPort 443
```
+ Einzelheiten zur API finden Sie unter [SetLoadBalancerPoliciesOfListener AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Elastic Load Balancing — Beispiele für Version 2 mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Elastic Load Balancing — Version 2 Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-ELB2ListenerCertificate`
Das folgende Codebeispiel zeigt, wie Sie`Add-ELB2ListenerCertificate`.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird dem angegebenen Listener ein zusätzliches Zertifikat hinzugefügt.**
```
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'}
```
**Ausgabe:**
```
CertificateArn IsDefault
-------------- ---------
arn:aws:acm:us-east-1:123456789012:certificate/19478bd5-491d-47d4-b1d7-5217feba1d97 False
```
+ Einzelheiten zur API finden Sie unter [AddListenerCertificates AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Add-ELB2Tag`
Das folgende Codebeispiel zeigt die Verwendung. `Add-ELB2Tag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues Tag zur angegebenen Ressource `AWS.Tools.ElasticLoadBalancingV2` hinzugefügt.**
```
Add-ELB2Tag -ResourceArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -Tag @{Key = 'productVersion'; Value = '1.0.0'}
```
+ Einzelheiten zur API finden Sie unter [AddTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-ELB2Listener`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-ELB2Listener`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel ändert die Standardaktion des angegebenen Listeners in eine feststehende Antwort.**
```
$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
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [ModifyListener AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-ELB2LoadBalancerAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-ELB2LoadBalancerAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Attribute des angegebenen Load Balancers geändert.**
```
Edit-ELB2LoadBalancerAttribute -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -Attribute @{Key = 'deletion_protection.enabled'; Value = 'true'}
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ModifyLoadBalancerAttributes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-ELB2Rule`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-ELB2Rule`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die angegebenen Listener-Regelkonfigurationen geändert.**
```
$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
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ModifyRule AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-ELB2TargetGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-ELB2TargetGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Eigenschaften der angegebenen Zielgruppe geändert.**
```
Edit-ELB2TargetGroup -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970' -HealthCheckIntervalSecond 60 -HealthCheckPath '/index.html' -HealthCheckPort 8080
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ModifyTargetGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-ELB2TargetGroupAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-ELB2TargetGroupAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Attribut deregistration\$1delay der angegebenen Zielgruppe geändert.**
```
Edit-ELB2TargetGroupAttribute -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970' -Attribute @{Key = 'deregistration_delay.timeout_seconds'; Value = 600}
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ModifyTargetGroupAttributes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELB2AccountLimit`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELB2AccountLimit`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl listet die ELB2 Kontolimits für eine bestimmte Region auf.**
```
Get-ELB2AccountLimit
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeAccountLimits AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-ELB2Listener`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELB2Listener`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Listener des angegebenen ALB/NLB beschrieben.**
```
Get-ELB2Listener -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeListeners AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELB2ListenerCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELB2ListenerCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Zertifikat für den angegebenen Listener beschrieben.**
```
Get-ELB2ListenerCertificate -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/66e10e3aaf5b6d9b'
```
**Ausgabe:**
```
CertificateArn IsDefault
-------------- ---------
arn:aws:acm:us-east-1:123456789012:certificate/5fc7c092-68bf-4862-969c-22fd48b6e17c True
```
+ Einzelheiten zur API finden Sie unter [DescribeListenerCertificates AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELB2LoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELB2LoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Load Balancer für die angegebene Region angezeigt.**
```
Get-ELB2LoadBalancer
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeLoadBalancers AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELB2LoadBalancerAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELB2LoadBalancerAttribute`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl beschreibt die Attribute eines bestimmten Load Balancers.**
```
Get-ELB2LoadBalancerAttribute -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/test-elb/238d34ad8d94bc2e'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeLoadBalancerAttributes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELB2Rule`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELB2Rule`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Listener-Regeln für den angegebenen Listener-ARN beschrieben.**
```
Get-ELB2Rule -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/66e10e3aaf5b6d9b'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeRules AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELB2SSLPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELB2SSLPolicy`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel listet alle verfügbaren Listener-Richtlinien für ElasticLoadBalancing V2 auf.**
```
Get-ELB2SSLPolicy
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [DescribeSslPolicies AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELB2Tag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELB2Tag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Tags für die angegebene Ressource aufgelistet.**
```
Get-ELB2Tag -ResourceArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f'
```
**Ausgabe:**
```
ResourceArn Tags
----------- ----
arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f {stage, internalName, version}
```
+ Einzelheiten zur API finden Sie unter [DescribeTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELB2TargetGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELB2TargetGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Zielgruppe beschrieben.**
```
Get-ELB2TargetGroup -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeTargetGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELB2TargetGroupAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELB2TargetGroupAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Attribute der angegebenen Zielgruppe beschrieben.**
```
Get-ELB2TargetGroupAttribute -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeTargetGroupAttributes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ELB2TargetHealth`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ELB2TargetHealth`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Zustand der in der angegebenen Zielgruppe vorhandenen Ziele zurückgegeben.**
```
Get-ELB2TargetHealth -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970'
```
**Ausgabe:**
```
HealthCheckPort Target TargetHealth
--------------- ------ ------------
80 Amazon.ElasticLoadBalancingV2.Model.TargetDescription Amazon.ElasticLoadBalancingV2.Model.TargetHealth
```
+ Einzelheiten zur API finden Sie unter [DescribeTargetHealth AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ELB2Listener`
Das folgende Codebeispiel zeigt die Verwendung. `New-ELB2Listener`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neuer ALB-Listener mit der Standardaktion „Weiterleiten“ erstellt, um Datenverkehr an die angegebene Zielgruppe zu senden.**
```
$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
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [CreateListener AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ELB2LoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `New-ELB2LoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neuer, mit dem Internet verbundener Application Load Balancer mit zwei Subnetzen erstellt.**
```
New-ELB2LoadBalancer -Type application -Scheme internet-facing -IpAddressType ipv4 -Name 'New-Test-ALB' -SecurityGroup 'sg-07c3414abb8811cbd' -subnet 'subnet-c37a67a6','subnet-fc02eea0'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateLoadBalancer AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ELB2Rule`
Das folgende Codebeispiel zeigt die Verwendung. `New-ELB2Rule`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Listener-Regel mit einer Aktion mit fester Antwort erstellt, die auf dem Kunden-Header-Wert für den angegebenen Listener basiert.**
```
$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
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateRule AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ELB2TargetGroup`
Das folgende Codebeispiel zeigt die Verwendung. `New-ELB2TargetGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Zielgruppe mit den angegebenen Parametern erstellt.**
```
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'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateTargetGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-ELB2Target`
Das folgende Codebeispiel zeigt die Verwendung. `Register-ELB2Target`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Instance „i-0672a4c4cdeae3111” bei der angegebenen Zielgruppe registriert.**
```
Register-ELB2Target -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/test-tg/a4e04b3688be1970' -Target @{Port = 80; Id = 'i-0672a4c4cdeae3111'}
```
+ Einzelheiten zur API finden Sie unter [RegisterTargets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ELB2Listener`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ELB2Listener`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Listener gelöscht.**
```
Remove-ELB2Listener -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/66e10e3aaf5b6d9b'
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel wird der angegebene Listener aus dem Load Balancer entfernt.**
```
Remove-ELB2Listener -ListenerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/test-alb/3651b4394dd9a24f/3873f123b98f7618'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteListener AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ELB2ListenerCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ELB2ListenerCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Zertifikat aus der spezifizierten Zielgruppe entfernt.**
```
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'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [RemoveListenerCertificates AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ELB2LoadBalancer`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ELB2LoadBalancer`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene Load Balancer gelöscht.**
```
Remove-ELB2LoadBalancer -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteLoadBalancer AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ELB2Rule`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ELB2Rule`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Regel aus dem Listener entfernt**
```
Remove-ELB2Rule -RuleArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/test-alb/3651b4394dd9a24f/3873f123b98f7618/4b25eb10a42e33ab'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteRule AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ELB2Tag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ELB2Tag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Tag für den angegebenen Schlüssel entfernt. **
```
Remove-ELB2Tag -ResourceArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -TagKey 'productVersion'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [RemoveTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-ELB2TargetGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-ELB2TargetGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Zielgruppe entfernt.**
```
Remove-ELB2TargetGroup -TargetGroupArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:targetgroup/testsssss/4e0b6076bc6483a7'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteTargetGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-ELB2IpAddressType`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ELB2IpAddressType`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der IP-Adresstyp des Load Balancers von '' auf IPv4 '' geändert. DualStack**
```
Set-ELB2IpAddressType -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -IpAddressType dualstack
```
**Ausgabe:**
```
Value
-----
dualstack
```
+ Einzelheiten zur API finden Sie unter [SetIpAddressType AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-ELB2RulePriority`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ELB2RulePriority`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Priorität der angegebenen Listener-Regel geändert.**
```
Set-ELB2RulePriority -RulePriority -RulePriority @{Priority = 11; RuleArn = 'arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/test-alb/3651b4394dd9a24f/a4eb199fa5046f80/dbf4c6dcef3ec6f8'}
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [SetRulePriorities AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-ELB2SecurityGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ELB2SecurityGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird dem angegebenen Load Balancer die Sicherheitsgruppe „sg-07c3414abb8811cbd” hinzugefügt.**
```
Set-ELB2SecurityGroup -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -SecurityGroup 'sg-07c3414abb8811cbd'
```
**Ausgabe:**
```
sg-07c3414abb8811cbd
```
+ Einzelheiten zur API finden Sie unter [SetSecurityGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-ELB2Subnet`
Das folgende Codebeispiel zeigt die Verwendung. `Set-ELB2Subnet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Subnetze des angegebenen Load Balancers geändert.**
```
Set-ELB2Subnet -LoadBalancerArn 'arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/test-alb/3651b4394dd9a24f' -Subnet 'subnet-7d8a0a51','subnet-c37a67a6'
```
**Ausgabe:**
```
LoadBalancerAddresses SubnetId ZoneName
--------------------- -------- --------
{} subnet-7d8a0a51 us-east-1c
{} subnet-c37a67a6 us-east-1b
```
+ Einzelheiten zur API finden Sie unter [SetSubnets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-ELB2Target`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-ELB2Target`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Registrierung der Instance „i-0672a4c4cdeae3111” aus der angegebenen Zielgruppe aufgehoben.**
```
$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'
```
+ Einzelheiten zur API finden Sie unter [DeregisterTargets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# FSx Amazon-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe der AWS -Tools für PowerShell V5 mit Amazon FSx Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-FSXResourceTag`
Das folgende Codebeispiel zeigt die Verwendung`Add-FSXResourceTag`.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden der angegebenen Ressource Tags hinzugefügt.**
```
Add-FSXResourceTag -ResourceARN "arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a" -Tag @{Key="Users";Value="Test"}
```
**Ausgabe:**
```
arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a
```
+ Einzelheiten zur API finden Sie unter [TagResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-FSXBackup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-FSXBackup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Backups abgerufen, die seit gestern für die angegebene Dateisystem-ID erstellt wurden.**
```
Get-FSXBackup -Filter @{Name="file-system-id";Values=$fsx.FileSystemId} | Where-Object CreationTime -gt (Get-Date).AddDays(-1)
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeBackups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-FSXFileSystem`
Das folgende Codebeispiel zeigt die Verwendung. `Get-FSXFileSystem`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Beschreibung der angegebenen filesystemId zurückgegeben.**
```
Get-FSXFileSystem -FileSystemId fs-01cd23bc4bdf5678a
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeFileSystems AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-FSXResourceTagList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-FSXResourceTagList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Tags für die bereitgestellte Ressource arn aufgelistet.**
```
Get-FSXResourceTagList -ResourceARN $fsx.ResourceARN
```
**Ausgabe:**
```
Key Value
--- -----
FSx-Service Windows
Users Dev
```
+ Einzelheiten zur API finden Sie unter [ListTagsForResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-FSXBackup`
Das folgende Codebeispiel zeigt die Verwendung. `New-FSXBackup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Sicherung des angegebenen Dateisystems erstellt.**
```
New-FSXBackup -FileSystemId fs-0b1fac2345623456ba
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateBackup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-FSXFileSystem`
Das folgende Codebeispiel zeigt die Verwendung. `New-FSXFileSystem`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues Windows-Dateisystem mit einer Größe von 300 GB erstellt, auf das von dem angegebenen Subnetz aus zugegriffen werden kann und das einen Durchsatz von bis zu 8 Megabyte pro Sekunde unterstützt. Das neue Dateisystem wird automatisch mit dem angegebenen Microsoft Active Directory verbunden.**
```
New-FSXFileSystem -FileSystemType WINDOWS -StorageCapacity 300 -SubnetId subnet-1a2b3c4d5e6f -WindowsConfiguration @{ThroughputCapacity=8;ActiveDirectoryId='d-1a2b3c4d'}
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateFileSystem AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-FSXFileSystemFromBackup`
Das folgende Codebeispiel zeigt die Verwendung. `New-FSXFileSystemFromBackup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues FSx Amazon-Dateisystem aus einem vorhandenen Amazon FSx for Windows File Server-Backup erstellt.**
```
New-FSXFileSystemFromBackup -BackupId $backupID -Tag @{Key="tag:Name";Value="from-manual-backup"} -SubnetId $SubnetID -SecurityGroupId $SG_ID -WindowsConfiguration @{ThroughputCapacity=8;ActiveDirectoryId=$DirectoryID}
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateFileSystemFromBackup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-FSXBackup`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-FSXBackup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Sicherungs-ID entfernt.**
```
Remove-FSXBackup -BackupId $backupID
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteBackup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-FSXFileSystem`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-FSXFileSystem`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene FSX-Dateisystem-ID entfernt.**
```
Remove-FSXFileSystem -FileSystemId fs-012ff34e567890120
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteFileSystem AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-FSXResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-FSXResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Ressourcen-Tag für die angegebene FSX-Dateisystemressource ARN entfernt.**
```
Remove-FSXResourceTag -ResourceARN $FSX.ResourceARN -TagKey Users
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UntagResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-FSXFileSystem`
Das folgende Codebeispiel zeigt die Verwendung. `Update-FSXFileSystem`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die automatische Aufbewahrungsdauer von Backups im FSX-Dateisystem über aktualisiert. UpdateFileSystemWindowsConfiguration**
```
$UpdateFSXWinConfig = [Amazon.FSx.Model.UpdateFileSystemWindowsConfiguration]::new()
$UpdateFSXWinConfig.AutomaticBackupRetentionDays = 35
Update-FSXFileSystem -FileSystemId $FSX.FileSystemId -WindowsConfiguration $UpdateFSXWinConfig
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UpdateFileSystem AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Amazon Glacier-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon Glacier Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-GLCJob`
Das folgende Codebeispiel zeigt die Verwendung`Get-GLCJob`.
**Tools für PowerShell V5**
**Beispiel 1: Gibt Details des angegebenen Auftrags zurück. Wenn der Auftrag erfolgreich abgeschlossen wurde, kann das Cmdlet GCJob Read-Output verwendet werden, um den Inhalt des Auftrags (ein Archiv oder eine Inventarliste) in das lokale Dateisystem abzurufen.**
```
Get-GLCJob -VaultName myvault -JobId "op1x...JSbthM"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeJob AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `New-GLCVault`
Das folgende Codebeispiel zeigt die Verwendung. `New-GLCVault`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt einen neuen Tresor für das Benutzerkonto. Da für den AccountId Parameter - kein Wert angegeben wurde, verwenden die Cmdlets den Standardwert „-“, der das aktuelle Konto angibt.**
```
New-GLCVault -VaultName myvault
```
**Ausgabe:**
```
/01234567812/vaults/myvault
```
+ Einzelheiten zur API finden Sie unter [CreateVault AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Read-GLCJobOutput`
Das folgende Codebeispiel zeigt die Verwendung. `Read-GLCJobOutput`
**Tools für PowerShell V5**
**Beispiel 1: Lädt den Archivinhalt herunter, dessen Abruf im angegebenen Auftrag geplant war, und speichert den Inhalt in einer Datei auf der Festplatte. Der Download überprüft für Sie die Prüfsumme, sofern eine verfügbar ist. Auf Wunsch kann die gesamte Antwort einschließlich der Prüfsumme durch Angabe von `-Select '*'` zurückgegeben werden.**
```
Read-GLCJobOutput -VaultName myvault -JobId "HSWjArc...Zq2XLiW" -FilePath "c:\temp\blue.bin"
```
+ Einzelheiten zur API finden Sie unter [GetJobOutput AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Start-GLCJob`
Das folgende Codebeispiel zeigt die Verwendung. `Start-GLCJob`
**Tools für PowerShell V5**
**Beispiel 1: Startet einen Auftrag zum Abrufen eines Archivs aus dem angegebenen Tresor, dessen Eigentümer der Benutzer ist. Der Status des Jobs kann mit dem GLCJob Cmdlet Get- überprüft werden. Wenn der Auftrag erfolgreich abgeschlossen wurde, kann das Cmdlet GCJob Read-Output verwendet werden, um den Inhalt des Archivs in das lokale Dateisystem abzurufen.**
```
Start-GLCJob -VaultName myvault -JobType "archive-retrieval" -JobDescription "archive retrieval" -ArchiveId "o9O9j...TX-TpIhQJw"
```
**Ausgabe:**
```
JobId JobOutputPath Location
----- ------------- --------
op1x...JSbthM /012345678912/vaults/test/jobs/op1xe...I4HqCHkSJSbthM
```
+ Einzelheiten zur API finden Sie unter [InitiateJob AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Write-GLCArchive`
Das folgende Codebeispiel zeigt die Verwendung. `Write-GLCArchive`
**Tools für PowerShell V5**
**Beispiel 1: Lädt eine einzelne Datei in den angegebenen Tresor hoch und gibt die Archiv-ID und die berechnete Prüfsumme zurück.**
```
Write-GLCArchive -VaultName myvault -FilePath c:\temp\blue.bin
```
**Ausgabe:**
```
FilePath ArchiveId Checksum
-------- --------- --------
C:\temp\blue.bin o9O9jUUs...TTX-TpIhQJw 79f3e...f4395b
```
**Beispiel 2: Lädt den Inhalt einer Ordnerhierarchie in den angegebenen Tresor im Benutzerkonto hoch. Für jede hochgeladene Datei gibt das Cmdlet den Dateinamen, die entsprechende Archiv-ID und die berechnete Prüfsumme des Archivs aus.**
```
Write-GLCArchive -VaultName myvault -FolderPath . -Recurse
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UploadArchive AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# AWS Glue Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. AWS Glue
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `New-GLUEJob`
Das folgende Codebeispiel zeigt die Verwendung `New-GLUEJob` von.
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel erstellt einen neuen Job in AWS Glue. Der Wert des Befehlsnamens ist immer`glueetl`. AWS Glue unterstützt das Ausführen von Jobskripten, die in Python oder Scala geschrieben wurden. In diesem Beispiel ist das Jobskript (MyTestGlueJob.py) in Python geschrieben. Python-Parameter werden in der `$DefArgs` Variablen angegeben und dann an den PowerShell Befehl im `DefaultArguments` Parameter übergeben, der eine Hashtabelle akzeptiert. Die Parameter in der `$JobParams` Variablen stammen aus der CreateJob API, die im Thema Jobs (https://docs.aws.amazon.com/glue/latest/dg/aws- glue-api-jobs-job .html) der AWS Glue-API-Referenz dokumentiert ist.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [CreateJob AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
# AWS Health Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. AWS Health
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-HLTHEvent`
Das folgende Codebeispiel zeigt die Verwendung `Get-HLTHEvent` von.
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt Ereignisse aus dem AWS Personal Health Dashboard zurück. Der Benutzer fügt den Parameter „-Region“ hinzu, um die für den Service in der Region USA Ost (Nord-Virginia) verfügbaren Ereignisse anzuzeigen. Der Parameter „-Filter\$1Region“ filtert jedoch Ereignisse, die in den Regionen EU (London) und USA West (Oregon) (eu-west-2 und us-west-2) protokolliert werden. Der StartTime Parameter -Filter\$1 filtert nach einem bestimmten Zeitbereich, zu dem Ereignisse beginnen können, während der EndTime Parameter -Filter\$1 nach einem bestimmten Zeitraum filtert, zu dem Ereignisse enden können. Das Ergebnis ist ein geplantes Wartungsereignis für RDS, das innerhalb des angegebenen -Filter\$1-Bereichs beginnt und innerhalb des geplanten StartTime -Filter\$1-Bereichs endet. 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"}
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([DescribeEvents](https://docs.aws.amazon.com/powershell/v5/reference)V5).
# IAM-Beispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit IAM Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-IAMClientIDToOpenIDConnectProvider`
Das folgende Codebeispiel zeigt die Verwendung von. `Add-IAMClientIDToOpenIDConnectProvider`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl wird die Client-ID (oder Zielgruppe) `my-application-ID` zum vorhandenen OIDC-Anbieter mit dem Namen `server.example.com` hinzugefügt.**
```
Add-IAMClientIDToOpenIDConnectProvider -ClientID "my-application-ID" -OpenIDConnectProviderARN "arn:aws:iam::123456789012:oidc-provider/server.example.com"
```
+ Einzelheiten zur API finden Sie unter [AddClientIdToOpenIdConnectProvider AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Add-IAMRoleTag`
Das folgende Codebeispiel zeigt die Verwendung. `Add-IAMRoleTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Rolle im Identity Management Service ein Tag hinzugefügt**
```
Add-IAMRoleTag -RoleName AdminRoleacess -Tag @{ Key = 'abac'; Value = 'testing'}
```
+ Einzelheiten zur API finden Sie unter [TagRole AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Add-IAMRoleToInstanceProfile`
Das folgende Codebeispiel zeigt die Verwendung. `Add-IAMRoleToInstanceProfile`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl wird die Rolle mit dem Namen `S3Access` einem vorhandenen Instance-Profil mit dem Namen `webserver` hinzugefügt. Verwenden Sie den `New-IAMInstanceProfile`-Befehl, um das Instance-Profil zu erstellen. Nachdem Sie das Instanzprofil erstellt und es mit diesem Befehl einer Rolle zugeordnet haben, können Sie es an eine EC2 Instanz anhängen. Verwenden Sie dazu das `New-EC2Instance` Cmdlet mit dem Parameter `InstanceProfile_Arn` oder `InstanceProfile-Name`, um die neue Instance zu starten.**
```
Add-IAMRoleToInstanceProfile -RoleName "S3Access" -InstanceProfileName "webserver"
```
+ Einzelheiten zur API finden Sie unter [AddRoleToInstanceProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Add-IAMUserTag`
Das folgende Codebeispiel zeigt die Verwendung. `Add-IAMUserTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird dem Benutzer im Identity Management Service ein Tag hinzugefügt**
```
Add-IAMUserTag -UserName joe -Tag @{ Key = 'abac'; Value = 'testing'}
```
+ Einzelheiten zur API finden Sie unter [TagUser AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Add-IAMUserToGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Add-IAMUserToGroup`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl wird der Benutzer mit dem Namen `Bob` der Gruppe mit dem Namen `Admins` hinzugefügt.**
```
Add-IAMUserToGroup -UserName "Bob" -GroupName "Admins"
```
+ Einzelheiten zur API finden Sie unter [AddUserToGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Disable-IAMMFADevice`
Das folgende Codebeispiel zeigt die Verwendung. `Disable-IAMMFADevice`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl wird das Hardware-MFA-Gerät deaktiviert, das dem Benutzer `Bob` mit der Seriennummer `123456789012` zugeordnet ist.**
```
Disable-IAMMFADevice -UserName "Bob" -SerialNumber "123456789012"
```
**Beispiel 2: Mit diesem Befehl wird das virtuelle MFA-Gerät deaktiviert, das dem Benutzer `David` mit der ARN `arn:aws:iam::210987654321:mfa/David` zugeordnet ist. Beachten Sie, dass das virtuelle MFA-Gerät nicht aus dem Konto gelöscht wird. Das virtuelle Gerät ist noch vorhanden und wird in der Ausgabe des Befehls `Get-IAMVirtualMFADevice` angezeigt. Bevor Sie ein neues virtuelles MFA-Gerät für denselben Benutzer erstellen können, müssen Sie das alte mit dem Befehl `Remove-IAMVirtualMFADevice` löschen.**
```
Disable-IAMMFADevice -UserName "David" -SerialNumber "arn:aws:iam::210987654321:mfa/David"
```
+ Einzelheiten zur API finden Sie unter [DeactivateMfaDevice AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-IAMPassword`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-IAMPassword`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl wird das Passwort des Benutzers geändert, der den Befehl ausführt. Dieser Befehl kann nur von IAM-Benutzern aufgerufen werden. Wenn dieser Befehl aufgerufen wird, während Sie mit AWS Kontoanmeldeinformationen (Root) angemeldet sind, gibt der Befehl einen Fehler zurück. `InvalidUserType`**
```
Edit-IAMPassword -OldPassword "MyOldP@ssw0rd" -NewPassword "MyNewP@ssw0rd"
```
+ Einzelheiten zur API finden Sie unter [ChangePassword AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Enable-IAMMFADevice`
Das folgende Codebeispiel zeigt die Verwendung. `Enable-IAMMFADevice`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Befehl wird das Hardware-MFA-Gerät mit der Seriennummer `987654321098` aktiviert und das Gerät dem Benutzer `Bob` zugeordnet. Er enthält nacheinander die ersten beiden Codes des Geräts.**
```
Enable-IAMMFADevice -UserName "Bob" -SerialNumber "987654321098" -AuthenticationCode1 "12345678" -AuthenticationCode2 "87654321"
```
**Beispiel 2: In diesem Beispiel wird ein virtuelles MFA-Gerät erstellt und aktiviert. Mit dem ersten Befehl wird das virtuelle Gerät erstellt und die Objektdarstellung des Geräts in der Variablen `$MFADevice` zurückgegeben. Sie können die Eigenschaften `.Base32StringSeed` oder `QRCodePng` verwenden, um die Softwar-Aanwendung des Benutzers zu konfigurieren. Mit dem letzten Befehl wird das Gerät dem Benutzer `David` zugewiesen und das Gerät anhand seiner Seriennummer identifiziert. Der Befehl synchronisiert das Gerät auch mit, AWS indem er die ersten beiden Codes nacheinander vom virtuellen MFA-Gerät einfügt.**
```
$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"
```
+ Einzelheiten zur API finden Sie unter [EnableMfaDevice AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-IAMAccessKey`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMAccessKey`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl werden die Zugriffsschlüssel für den IAM-Benutzer namens `Bob` aufgelistet. Beachten Sie, dass Sie die geheimen Zugriffsschlüssel für IAM-Benutzer nicht auflisten können. Bei Verlust der geheimen Zugriffsschlüssel müssen mit dem `New-IAMAccessKey` Cmdlet neue Zugriffsschlüssel erstellt werden.**
```
Get-IAMAccessKey -UserName "Bob"
```
**Ausgabe:**
```
AccessKeyId CreateDate Status UserName
----------- ---------- ------ --------
AKIAIOSFODNN7EXAMPLE 12/3/2014 10:53:41 AM Active Bob
AKIAI44QH8DHBEXAMPLE 6/6/2013 8:42:26 PM Inactive Bob
```
+ Einzelheiten zur API finden Sie unter [ListAccessKeys AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMAccessKeyLastUsed`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMAccessKeyLastUsed`
**Tools für PowerShell V5**
**Beispiel 1: Gibt den Benutzernamen des Besitzers und die Informationen zur letzten Verwendung für den angegebenen Zugriffsschlüssel zurück.**
```
Get-IAMAccessKeyLastUsed -AccessKeyId ABCDEXAMPLE
```
+ Einzelheiten zur API finden Sie unter [GetAccessKeyLastUsed AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMAccountAlias`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMAccountAlias`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt den Kontoalias für das AWS-Konto zurück.**
```
Get-IAMAccountAlias
```
**Ausgabe:**
```
ExampleCo
```
+ Einzelheiten zur API finden Sie unter [ListAccountAliases AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMAccountAuthorizationDetail`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMAccountAuthorizationDetail`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Autorisierungsdetails zu den Identitäten im AWS Konto abgerufen und die Elementliste des zurückgegebenen Objekts angezeigt, einschließlich Benutzer, Gruppen und Rollen. Beispielsweise zeigt die `UserDetailList`-Eigenschaft Details zu den Benutzern an. Ähnliche Informationen sind in den `RoleDetailList`- und `GroupDetailList`-Eigenschaften verfügbar.**
```
$Details=Get-IAMAccountAuthorizationDetail
$Details
```
**Ausgabe:**
```
GroupDetailList : {Administrators, Developers, Testers, Backup}
IsTruncated : False
Marker :
RoleDetailList : {TestRole1, AdminRole, TesterRole, clirole...}
UserDetailList : {Administrator, Bob, BackupToS3, }
```
```
$Details.UserDetailList
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [GetAccountAuthorizationDetails AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMAccountPasswordPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMAccountPasswordPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zur Passwortrichtlinie für das aktuelle Konto zurückgegeben. Wenn keine Passwortrichtlinie für das Konto definiert ist, gibt der Befehl einen `NoSuchEntity`-Fehler zurück.**
```
Get-IAMAccountPasswordPolicy
```
**Ausgabe:**
```
AllowUsersToChangePassword : True
ExpirePasswords : True
HardExpiry : False
MaxPasswordAge : 90
MinimumPasswordLength : 8
PasswordReusePrevention : 20
RequireLowercaseCharacters : True
RequireNumbers : True
RequireSymbols : False
RequireUppercaseCharacters : True
```
+ Einzelheiten zur API finden Sie unter [GetAccountPasswordPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMAccountSummary`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMAccountSummary`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen über die aktuelle Nutzung der IAM-Entität und die aktuellen Kontingente der IAM-Entität im AWS-Konto zurückgegeben.**
```
Get-IAMAccountSummary
```
**Ausgabe:**
```
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
...
```
+ Einzelheiten zur API finden Sie unter [GetAccountSummary AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMAttachedGroupPolicyList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMAttachedGroupPolicyList`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Namen und die Namen ARNs der verwalteten Richtlinien zurück, die der `Admins` im Konto genannten IAM-Gruppe zugeordnet sind. AWS Verwenden Sie den Befehl `Get-IAMGroupPolicyList`, um die Liste der in der Gruppe eingebetteten Inline-Richtlinien anzuzeigen.**
```
Get-IAMAttachedGroupPolicyList -GroupName "Admins"
```
**Ausgabe:**
```
PolicyArn PolicyName
--------- ----------
arn:aws:iam::aws:policy/SecurityAudit SecurityAudit
arn:aws:iam::aws:policy/AdministratorAccess AdministratorAccess
```
+ Einzelheiten zur API finden Sie unter [ListAttachedGroupPolicies AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMAttachedRolePolicyList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMAttachedRolePolicyList`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Namen und die Namen ARNs der verwalteten Richtlinien zurück, die der `SecurityAuditRole` im Konto angegebenen IAM-Rolle zugeordnet sind. AWS Verwenden Sie den `Get-IAMRolePolicyList`-Befehl, um die Liste der in die Rolle eingebetteten Inline-Richtlinien anzuzeigen.**
```
Get-IAMAttachedRolePolicyList -RoleName "SecurityAuditRole"
```
**Ausgabe:**
```
PolicyArn PolicyName
--------- ----------
arn:aws:iam::aws:policy/SecurityAudit SecurityAudit
```
+ Einzelheiten zur API finden Sie unter [ListAttachedRolePolicies AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMAttachedUserPolicyList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMAttachedUserPolicyList`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Namen und ARNs die verwalteten Richtlinien für den IAM-Benutzer zurück, der `Bob` AWS im Konto angegeben ist. Verwenden Sie den `Get-IAMUserPolicyList`-Befehl, um die Liste der im IAM-Benutzer eingebetteten Inline-Richtlinien anzuzeigen.**
```
Get-IAMAttachedUserPolicyList -UserName "Bob"
```
**Ausgabe:**
```
PolicyArn PolicyName
--------- ----------
arn:aws:iam::aws:policy/TesterPolicy TesterPolicy
```
+ Einzelheiten zur API finden Sie unter [ListAttachedUserPolicies AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMContextKeysForCustomPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMContextKeysForCustomPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Kontextschlüssel abgerufen, die im bereitgestellten Richtlinien-JSON vorhanden sind. Um mehrere Richtlinien bereitzustellen, können Sie eine durch Kommas getrennte Werteliste bereitstellen.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [GetContextKeysForCustomPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMContextKeysForPrincipalPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMContextKeysForPrincipalPolicy`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel ruft alle Kontextschlüssel ab, die in der bereitgestellten Richtlinien-JSON vorhanden sind, und die Richtlinien, die der IAM-Entität (Benutzer/Rolle usw.) zugeordnet sind. Für — PolicyInputList Sie können eine Liste mit mehreren Werten als durch Kommas getrennte Werte angeben.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [GetContextKeysForPrincipalPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMCredentialReport`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMCredentialReport`
**Tools für PowerShell V5**
**Example 1: In diesem Beispiel wird der zurückgegebene Bericht geöffnet und als Array von Textzeilen an die Pipeline ausgegeben. Die erste Zeile ist die Kopfzeile mit durch Kommas getrennten Spaltennamen. Jede nachfolgende Zeile ist die Detailzeile für einen Benutzer, wobei jedes Feld durch Kommas getrennt ist. Bevor Sie den Bericht anzeigen können, müssen Sie ihn mit dem `Request-IAMCredentialReport` Cmdlet generieren. Um den Bericht als einzelne Zeichenfolge abzurufen, verwenden Sie `-Raw` anstelle von `-AsTextArray`. Der Alias `-SplitLines` wird auch für den `-AsTextArray` Switch akzeptiert. Die vollständige Liste der Spalten in der Ausgabe finden Sie in der Service-API-Referenz. Beachten Sie, dass Sie, wenn Sie `-AsTextArray` oder `-SplitLines` nicht verwenden, Sie den Text mithilfe der Klasse .NET `StreamReader` aus der `.Content`-Eigenschaft extrahieren müssen.**
```
Request-IAMCredentialReport
```
**Ausgabe:**
```
Description State
----------- -----
No report exists. Starting a new report generation task STARTED
```
```
Get-IAMCredentialReport -AsTextArray
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetCredentialReport AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMEntitiesForPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMEntitiesForPolicy`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt eine Liste der IAM-Gruppen, Rollen und Benutzer zurück, denen die Richtlinie `arn:aws:iam::123456789012:policy/TestPolicy` zugeordnet ist.**
```
Get-IAMEntitiesForPolicy -PolicyArn "arn:aws:iam::123456789012:policy/TestPolicy"
```
**Ausgabe:**
```
IsTruncated : False
Marker :
PolicyGroups : {}
PolicyRoles : {testRole}
PolicyUsers : {Bob, Theresa}
```
+ Einzelheiten zur API finden Sie unter [ListEntitiesForPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zur IAM-Gruppe `Testers` zurückgegeben, einschließlich einer Sammlung aller IAM-Benutzer, die zur Gruppe gehören.**
```
$results = Get-IAMGroup -GroupName "Testers"
$results
```
**Ausgabe:**
```
Group IsTruncated Marker Users
----- ----------- ------ -----
Amazon.IdentityManagement.Model.Group False {Theresa, David}
```
```
$results.Group
```
**Ausgabe:**
```
Arn : arn:aws:iam::123456789012:group/Testers
CreateDate : 12/10/2014 3:39:11 PM
GroupId : 3RHNZZGQJ7QHMAEXAMPLE1
GroupName : Testers
Path : /
```
```
$results.Users
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMGroupForUser`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMGroupForUser`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Liste der IAM-Gruppen zurückgegeben, zu denen der IAM-Benutzer `David` angehört.**
```
Get-IAMGroupForUser -UserName David
```
**Ausgabe:**
```
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 : /
```
+ Einzelheiten zur API finden Sie unter [ListGroupsForUser AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMGroupList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMGroupList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt eine Sammlung aller in der aktuellen Version definierten IAM-Gruppen zurück. AWS-Konto**
```
Get-IAMGroupList
```
**Ausgabe:**
```
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 : /
```
+ Einzelheiten zur API finden Sie unter [ListGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMGroupPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMGroupPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zur eingebetteten Inline-Richtlinie mit dem Namen `PowerUserAccess-Testers` für die Gruppe `Testers` zurückgegeben. Die `PolicyDocument`-Eigenschaft ist URL-codiert. Die Decodierung erfolgt in diesem Beispiel mit der .NET-Methode `UrlDecode`.**
```
$results = Get-IAMGroupPolicy -GroupName Testers -PolicyName PowerUserAccess-Testers
$results
```
**Ausgabe:**
```
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"
]
}
]
}
```
+ Einzelheiten zur API finden Sie unter [GetGroupPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMGroupPolicyList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMGroupPolicyList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste der Inline-Richtlinien zurückgegeben, die in der Gruppe `Testers` eingebettet sind. Verwenden Sie den Befehl `Get-IAMAttachedGroupPolicyList`, um die verwalteten Richtlinien abzurufen, die der Gruppe zugeordnet sind.**
```
Get-IAMGroupPolicyList -GroupName Testers
```
**Ausgabe:**
```
Deny-Assume-S3-Role-In-Production
PowerUserAccess-Testers
```
+ Einzelheiten zur API finden Sie unter [ListGroupPolicies AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMInstanceProfile`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMInstanceProfile`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details des genannten Instanzprofils zurückgegeben`ec2instancerole`, das im aktuellen AWS Konto definiert ist.**
```
Get-IAMInstanceProfile -InstanceProfileName ec2instancerole
```
**Ausgabe:**
```
Arn : arn:aws:iam::123456789012:instance-profile/ec2instancerole
CreateDate : 2/17/2015 2:49:04 PM
InstanceProfileId : HH36PTZQJUR32EXAMPLE1
InstanceProfileName : ec2instancerole
Path : /
Roles : {ec2instancerole}
```
+ Einzelheiten zur API finden Sie unter [GetInstanceProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-IAMInstanceProfileForRole`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMInstanceProfileForRole`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details des Instance-Profils zurückgegeben, das der Rolle `ec2instancerole` zugeordnet ist.**
```
Get-IAMInstanceProfileForRole -RoleName ec2instancerole
```
**Ausgabe:**
```
Arn : arn:aws:iam::123456789012:instance-profile/ec2instancerole
CreateDate : 2/17/2015 2:49:04 PM
InstanceProfileId : HH36PTZQJUR32EXAMPLE1
InstanceProfileName : ec2instancerole
Path : /
Roles : {ec2instancerole}
```
+ Einzelheiten zur API finden Sie unter [ListInstanceProfilesForRole AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMInstanceProfileList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMInstanceProfileList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt eine Sammlung der in der aktuellen AWS-Konto Version definierten Instanzprofile zurück.**
```
Get-IAMInstanceProfileList
```
**Ausgabe:**
```
Arn : arn:aws:iam::123456789012:instance-profile/ec2instancerole
CreateDate : 2/17/2015 2:49:04 PM
InstanceProfileId : HH36PTZQJUR32EXAMPLE1
InstanceProfileName : ec2instancerole
Path : /
Roles : {ec2instancerole}
```
+ Einzelheiten zur API finden Sie unter [ListInstanceProfiles AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-IAMLoginProfile`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMLoginProfile`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Erstellungsdatum des Passworts zurückgegeben und ob für den IAM-Benutzer `David` ein Passwortzurücksetzung erforderlich ist.**
```
Get-IAMLoginProfile -UserName David
```
**Ausgabe:**
```
CreateDate PasswordResetRequired UserName
---------- --------------------- --------
12/10/2014 3:39:44 PM False David
```
+ Einzelheiten zur API finden Sie unter [GetLoginProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMMFADevice`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMMFADevice`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zum MFA-Gerät zurückgegeben, das dem IAM-Benutzer `David` zugewiesen ist. In diesem Beispiel können Sie erkennen, dass es sich um ein virtuelles Gerät handelt, da die `SerialNumber` eine ARN und nicht die tatsächliche Seriennummer eines physischen Geräts ist.**
```
Get-IAMMFADevice -UserName David
```
**Ausgabe:**
```
EnableDate SerialNumber UserName
---------- ------------ --------
4/8/2015 9:41:10 AM arn:aws:iam::123456789012:mfa/David David
```
+ Einzelheiten zur API finden Sie unter [ListMfaDevices AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMOpenIDConnectProvider`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMOpenIDConnectProvider`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zum OpenID-Connect-Anbieter zurückgegeben, dessen ARN `arn:aws:iam::123456789012:oidc-provider/accounts.google.com` lautet. Die `ClientIDList` Eigenschaft ist eine Sammlung, die alle für diesen Anbieter IDs definierten Clients enthält.**
```
Get-IAMOpenIDConnectProvider -OpenIDConnectProviderArn arn:aws:iam::123456789012:oidc-provider/oidc.example.com
```
**Ausgabe:**
```
ClientIDList CreateDate ThumbprintList Url
------------ ---------- -------------- ---
{MyOIDCApp} 2/3/2015 3:00:30 PM {12345abcdefghijk67890lmnopqrst98765uvwxy} oidc.example.com
```
+ Einzelheiten zur API finden Sie unter [GetOpenIdConnectProvider AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-IAMOpenIDConnectProviderList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMOpenIDConnectProviderList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste von ARNs aller OpenID Connect-Anbieter zurückgegeben, die im aktuellen AWS-Konto definiert sind.**
```
Get-IAMOpenIDConnectProviderList
```
**Ausgabe:**
```
Arn
---
arn:aws:iam::123456789012:oidc-provider/server.example.com
arn:aws:iam::123456789012:oidc-provider/another.provider.com
```
+ Einzelheiten zur API finden Sie unter [ListOpenIdConnectProviders AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zur verwalteten Richtlinie zurückgegeben, deren ARN `arn:aws:iam::123456789012:policy/MySamplePolicy` lautet.**
```
Get-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMPolicyList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMPolicyList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Sammlung der ersten drei verwalteten Richtlinien zurückgegeben, die im aktuellen AWS Konto verfügbar sind. Da nicht angegeben `-scope` ist, werden standardmäßig sowohl AWS verwaltete als auch vom `all` Kunden verwaltete Richtlinien verwendet und diese sind auch enthalten.**
```
Get-IAMPolicyList -MaxItem 3
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel wird eine Sammlung der ersten beiden vom Kunden verwalteten Policen zurückgegeben, die im AWS Girokonto verfügbar sind. Es wird verwendet `-Scope local`, um die Ausgabe nur auf vom Kunden verwaltete Richtlinien zu beschränken.**
```
Get-IAMPolicyList -Scope local -MaxItem 2
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListPolicies AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-IAMPolicyVersion`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMPolicyVersion`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt das Richtliniendokument für die `v2`-Version der Richtlinie zurück, deren ARN `arn:aws:iam::123456789012:policy/MyManagedPolicy` lautet. Das Richtliniendokument in der `Document`-Eigenschaft ist URL-codiert und wird in diesem Beispiel mit der .NET-Methode `UrlDecode` decodiert.**
```
$results = Get-IAMPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MyManagedPolicy -VersionId v2
$results
```
**Ausgabe:**
```
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"
]
}
}
```
+ Einzelheiten zur API finden Sie unter [GetPolicyVersion AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMPolicyVersionList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMPolicyVersionList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Liste der verfügbaren Versionen der Richtlinie zurückgegeben, deren ARN `arn:aws:iam::123456789012:policy/MyManagedPolicy` lautet. Um das Richtliniendokument für eine bestimmte Version abzurufen, verwenden Sie den Befehl `Get-IAMPolicyVersion` und geben Sie die `VersionId` der gewünschten Version an.**
```
Get-IAMPolicyVersionList -PolicyArn arn:aws:iam::123456789012:policy/MyManagedPolicy
```
**Ausgabe:**
```
CreateDate Document IsDefaultVersion VersionId
---------- -------- ---------------- ---------
2/12/2015 9:39:53 AM True v2
2/12/2015 9:39:09 AM False v1
```
+ Einzelheiten zur API finden Sie unter [ListPolicyVersions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMRole`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMRole`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt die Details von `lamda_exec_role` zurück. Es enthält das Vertrauensrichtlinien-Dokument, das angibt, wer diese Rolle übernehmen kann. Das Richtliniendokument ist URL-codiert und kann mit der .NET-Methode `UrlDecode`decodiert werden. In diesem Beispiel wurden aus der ursprünglichen Richtlinie sämtliche Leerzeichen entfernt, bevor sie in die Richtlinie hochgeladen wurden. Um die Berechtigungsrichtliniendokumente anzuzeigen, die bestimmen, was jemand, der die Rolle übernimmt, tun kann, verwenden Sie `Get-IAMRolePolicy` für Inline-Richtlinien und `Get-IAMPolicyVersion` für angefügte verwaltete Richtlinien**.
```
$results = Get-IamRole -RoleName lambda_exec_role
$results | Format-List
```
**Ausgabe:**
```
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
```
**Ausgabe:**
```
{"Version":"2012-10-17", "Statement":[{"Sid":"","Effect":"Allow","Principal":{"Service":"lambda.amazonaws.com"},"Action":"sts:AssumeRole"}]}
```
+ Einzelheiten zur API finden Sie unter [GetRole AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMRoleList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMRoleList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste aller IAM-Rollen im AWS-Konto abgerufen.**
```
Get-IAMRoleList
```
+ Einzelheiten zur API finden Sie unter [ListRoles AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMRolePolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMRolePolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Berechtigungs-Richtliniendokument für die Richtlinie mit dem Namen `oneClick_lambda_exec_role_policy` zurückgegeben, die in die IAM-Rolle `lamda_exec_role` eingebettet ist. Das resultierende Richtliniendokument ist URL-codiert. Die Decodierung erfolgt in diesem Beispiel mit der .NET-Methode `UrlDecode`.**
```
$results = Get-IAMRolePolicy -RoleName lambda_exec_role -PolicyName oneClick_lambda_exec_role_policy
$results
```
**Ausgabe:**
```
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)
```
**Ausgabe:**
```
{
"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/*"
]
}
]
}
```
+ Einzelheiten zur API finden Sie unter [GetRolePolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMRolePolicyList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMRolePolicyList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Liste der Namen von Inline-Richtlinien zurückgegeben, die in die IAM-Rolle `lamda_exec_role` eingebettet sind. Um die Details einer Inline-Richtlinie anzuzeigen, verwenden Sie den Befehl `Get-IAMRolePolicy`.**
```
Get-IAMRolePolicyList -RoleName lambda_exec_role
```
**Ausgabe:**
```
oneClick_lambda_exec_role_policy
```
+ Einzelheiten zur API finden Sie unter [ListRolePolicies AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMRoleTagList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMRoleTagList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das der Rolle zugeordnete Tag abgerufen.**
```
Get-IAMRoleTagList -RoleName MyRoleName
```
+ Einzelheiten zur API finden Sie unter [ListRoleTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMSAMLProvider`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMSAMLProvider`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Details zum SAML 2.0-Anbieter abgerufen, dessen ARN arn:aws:iam::123456789012:saml-provider/SAMLADFS. Die Antwort enthält das Metadatendokument, das Sie vom Identitätsanbieter zur Erstellung der AWS SAML-Provider-Entität erhalten haben, sowie die Erstellungs- und Ablaufdaten.**
```
Get-IAMSAMLProvider -SAMLProviderArn arn:aws:iam::123456789012:saml-provider/SAMLADFS
```
**Ausgabe:**
```
CreateDate SAMLMetadataDocument ValidUntil
---------- -------------------- ----------
12/23/2014 12:16:55 PM
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMSAMLProviderList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Liste der im aktuellen AWS-Konto erstellten SAML 2.0-Anbieter abgerufen. Es gibt den ARN, das Erstellungs- und das Ablaufdatum für jeden SAML-Anbieter zurück.**
```
Get-IAMSAMLProviderList
```
**Ausgabe:**
```
Arn CreateDate ValidUntil
--- ---------- ----------
arn:aws:iam::123456789012:saml-provider/SAMLADFS 12/23/2014 12:16:55 PM 12/23/2114 12:16:54 PM
```
+ Einzelheiten zur API finden Sie unter [Liste SAMLProviders in der AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference) *Cmdlet-Referenz (*V5).
### `Get-IAMServerCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMServerCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zum Serverzertifikat mit dem Namen `MyServerCertificate` abgerufen. Sie finden die Zertifikatsdetails in den Eigenschaften `CertificateBody` und `ServerCertificateMetadata`.**
```
$result = Get-IAMServerCertificate -ServerCertificateName MyServerCertificate
$result | format-list
```
**Ausgabe:**
```
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
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetServerCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMServerCertificateList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMServerCertificateList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Liste der Serverzertifikate abgerufen, die in das aktuelle AWS-Konto hochgeladen wurden.**
```
Get-IAMServerCertificateList
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListServerCertificates AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMServiceLastAccessedDetail`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMServiceLastAccessedDetail`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zum Service bereitgestellt, auf den die im Anforderungsaufruf zugeordnete IAM-Entität (Benutzer, Gruppe, Rolle oder Richtlinie) zuletzt zugegriffen hat.**
```
Request-IAMServiceLastAccessedDetail -Arn arn:aws:iam::123456789012:user/TestUser
```
**Ausgabe:**
```
f0b7a819-eab0-929b-dc26-ca598911cb9f
```
```
Get-IAMServiceLastAccessedDetail -JobId f0b7a819-eab0-929b-dc26-ca598911cb9f
```
+ Einzelheiten zur API finden Sie unter [GetServiceLastAccessedDetails AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMServiceLastAccessedDetailWithEntity`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMServiceLastAccessedDetailWithEntity`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel stellt den Zeitstempel des letzten Zugriffs für den Service in der Anfrage durch die entsprechende IAM-Entität bereit.**
```
$results = Get-IAMServiceLastAccessedDetailWithEntity -JobId f0b7a819-eab0-929b-dc26-ca598911cb9f -ServiceNamespace ec2
$results
```
**Ausgabe:**
```
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
```
**Ausgabe:**
```
EntityInfo LastAuthenticated
---------- -----------------
Amazon.IdentityManagement.Model.EntityInfo 11/16/19 3:47:00 PM
```
```
$results.EntityInfo
```
**Ausgabe:**
```
Arn : arn:aws:iam::123456789012:user/TestUser
Id : AIDA4NBK5CXF5TZHU1234
Name : TestUser
Path : /
Type : USER
```
+ Einzelheiten zur API finden Sie unter [GetServiceLastAccessedDetailsWithEntities AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMSigningCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMSigningCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details über das Signaturzertifikat abgerufen, das dem Benutzer mit dem Namen `Bob` zugeordnet ist. **
```
Get-IAMSigningCertificate -UserName Bob
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListSigningCertificates AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMUser`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMUser`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zum Benutzer mit dem Namen `David` abgerufen.**
```
Get-IAMUser -UserName David
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden Details zum aktuell angemeldeten IAM-Benutzer abgerufen.**
```
Get-IAMUser
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetUser AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMUserList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMUserList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Sammlung von Benutzern in der aktuellen Version abgerufen. AWS-Konto**
```
Get-IAMUserList
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListUsers AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMUserPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMUserPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Details der Inline-Richtlinie mit dem Namen `Davids_IAM_Admin_Policy` abgerufen, die in den IAM-Benutzer mit dem Namen `David` eingebettet ist. Das Richtliniendokument ist URL-codiert.**
```
$results = Get-IAMUserPolicy -PolicyName Davids_IAM_Admin_Policy -UserName David
$results
```
**Ausgabe:**
```
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/*"
]
}
]
}
```
+ Einzelheiten zur API finden Sie unter [GetUserPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMUserPolicyList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMUserPolicyList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Liste der Namen der Inline-Richtlinien abgerufen, die in den IAM-Benutzer mit dem Namen `David` eingebettet sind.**
```
Get-IAMUserPolicyList -UserName David
```
**Ausgabe:**
```
Davids_IAM_Admin_Policy
```
+ Einzelheiten zur API finden Sie unter [ListUserPolicies AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMUserTagList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMUserTagList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das dem Benutzer zugeordnete Tag abgerufen.**
```
Get-IAMUserTagList -UserName joe
```
+ Einzelheiten zur API finden Sie unter [ListUserTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-IAMVirtualMFADevice`
Das folgende Codebeispiel zeigt die Verwendung. `Get-IAMVirtualMFADevice`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Sammlung der virtuellen MFA-Geräte abgerufen, die Benutzern im AWS Konto zugewiesen sind. Bei jeder `User`-Eigenschaft handelt es sich um ein Objekt mit Angaben zum IAM-Benutzer, dem das Gerät zugewiesen ist.**
```
Get-IAMVirtualMFADevice -AssignmentStatus Assigned
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListVirtualMfaDevices AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `New-IAMAccessKey`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMAccessKey`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues Paar aus Zugriffsschlüssel und geheimem Zugriffsschlüssel erstellt und dem Benutzer `David` zugewiesen. Stellen Sie sicher, dass Sie die `AccessKeyId`- und `SecretAccessKey`-Werte in einer Datei speichern, da Sie den `SecretAccessKey` nur zu diesem Zeitpunkt abrufen können. Sie können es später nicht abrufen. Bei Verlust des geheimen Schlüssels müssen Sie ein neues Zugriffsschlüsselpaar erstellen.**
```
New-IAMAccessKey -UserName David
```
**Ausgabe:**
```
AccessKeyId : AKIAIOSFODNN7EXAMPLE
CreateDate : 4/13/2015 1:00:42 PM
SecretAccessKey : wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Status : Active
UserName : David
```
+ Einzelheiten zur API finden Sie unter [CreateAccessKey AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-IAMAccountAlias`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMAccountAlias`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Kontoalias für Ihr AWS Konto in geändert. `mycompanyaws` Die Adresse der Benutzeranmeldeseite wird in panyaws.signin.aws.amazon.com/console geändert https://mycom. Die ursprüngliche URL unter Verwendung Ihrer Konto-ID-Nummer anstelle des Alias (https://.signin.aws.amazon.com/console) funktioniert weiterhin. Alle zuvor definierten URLs Alias-basierten Funktionen funktionieren jedoch nicht mehr.**
```
New-IAMAccountAlias -AccountAlias mycompanyaws
```
+ Einzelheiten zur API finden Sie unter [CreateAccountAlias AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `New-IAMGroup`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue IAM-Gruppe mit dem Namen `Developers` erstellt.**
```
New-IAMGroup -GroupName Developers
```
**Ausgabe:**
```
Arn : arn:aws:iam::123456789012:group/Developers
CreateDate : 4/14/2015 11:21:31 AM
GroupId : QNEJ5PM4NFSQCEXAMPLE1
GroupName : Developers
Path : /
```
+ Einzelheiten zur API finden Sie unter [CreateGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-IAMInstanceProfile`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMInstanceProfile`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues IAM Instance-Profil mit dem Namen `ProfileForDevEC2Instance` erstellt. Sie müssen den Befehl `Add-IAMRoleToInstanceProfile` separat ausführen, um das Instance-Profil einer vorhandenen IAM-Rolle zuzuordnen, die Berechtigungen für die Instance bereitstellt. Hängen Sie abschließend das Instanzprofil an eine EC2 Instance an, wenn Sie sie starten. Verwenden Sie dazu das Cmdlet `New-EC2Instance` entweder mit dem Parameter `InstanceProfile_Arn` oder `InstanceProfile_Name`.**
```
New-IAMInstanceProfile -InstanceProfileName ProfileForDevEC2Instance
```
**Ausgabe:**
```
Arn : arn:aws:iam::123456789012:instance-profile/ProfileForDevEC2Instance
CreateDate : 4/14/2015 11:31:39 AM
InstanceProfileId : DYMFXL556EY46EXAMPLE1
InstanceProfileName : ProfileForDevEC2Instance
Path : /
Roles : {}
```
+ Einzelheiten zur API finden Sie unter [CreateInstanceProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-IAMLoginProfile`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMLoginProfile`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein (temporäres) Passwort für den IAM-Benutzer Bob erstellt und festgelegt, dass der Benutzer das Passwort bei der nächsten Anmeldung von `Bob` ändern muss.**
```
New-IAMLoginProfile -UserName Bob -Password P@ssw0rd -PasswordResetRequired $true
```
**Ausgabe:**
```
CreateDate PasswordResetRequired UserName
---------- --------------------- --------
4/14/2015 12:26:30 PM True Bob
```
+ Einzelheiten zur API finden Sie unter [CreateLoginProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-IAMOpenIDConnectProvider`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMOpenIDConnectProvider`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein IAM-OIDC-Anbieter erstellt, der dem OIDC-kompatiblen Anbieter-Service zugeordnet ist, der unter der URL `https://example.oidcprovider.com` und der Client-ID `my-testapp-1` zu finden ist. Der OIDC-Anbieter stellt den Fingerabdruck bereit. Um den Fingerabdruck zu authentifizieren, folgen Sie den Schritten unter http://docs.aws.amazon. com/IAM/latest/UserGuide/identity- .html. providers-oidc-obtain-thumbprint**
```
New-IAMOpenIDConnectProvider -Url https://example.oidcprovider.com -ClientIDList my-testapp-1 -ThumbprintList 990F419EXAMPLEECF12DDEDA5EXAMPLE52F20D9E
```
**Ausgabe:**
```
arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com
```
+ Einzelheiten zur API finden Sie unter [CreateOpenIdConnectProvider AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-IAMPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird im aktuellen AWS Konto eine neue IAM-Richtlinie mit dem Namen `MySamplePolicy` Die Datei `MySamplePolicy.json` enthält den Richtlinieninhalt erstellt. Beachten Sie, dass Sie den Switch-Parameter `-Raw` verwenden müssen, um die JSON-Richtliniendatei erfolgreich zu verarbeiten.**
```
New-IAMPolicy -PolicyName MySamplePolicy -PolicyDocument (Get-Content -Raw MySamplePolicy.json)
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreatePolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-IAMPolicyVersion`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMPolicyVersion`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue „v2“-Version der IAM-Richtlinie erstellt, deren ARN `arn:aws:iam::123456789012:policy/MyPolicy` lautet, und als standardmäßige Version festgelegt. Die Datei `NewPolicyVersion.json` enthält den Richtlinieninhalt. Beachten Sie, dass Sie den Switch-Parameter `-Raw` verwenden müssen, um die JSON-Richtliniendatei erfolgreich zu verarbeiten.**
```
New-IAMPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MyPolicy -PolicyDocument (Get-content -Raw NewPolicyVersion.json) -SetAsDefault $true
```
**Ausgabe:**
```
CreateDate Document IsDefaultVersion VersionId
---------- -------- ---------------- ---------
4/15/2015 10:54:54 AM True v2
```
+ Einzelheiten zur API finden Sie unter [CreatePolicyVersion AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-IAMRole`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMRole`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Rolle mit dem Namen `MyNewRole` erstellt und die in der Datei `NewRoleTrustPolicy.json` gefundene Richtlinie daran angefügt. Beachten Sie, dass Sie den `-Raw`-Switch-Parameter verwenden müssen, um die JSON-Richtliniendatei erfolgreich zu verarbeiten. Das in der Ausgabe angezeigte Richtliniendokument ist URL-codiert. Die Decodierung erfolgt in diesem Beispiel mit der `UrlDecode` .NET-Methode.**
```
$results = New-IAMRole -AssumeRolePolicyDocument (Get-Content -raw NewRoleTrustPolicy.json) -RoleName MyNewRole
$results
```
**Ausgabe:**
```
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"
}
]
}
```
+ Einzelheiten zur API finden Sie unter [CreateRole AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-IAMSAMLProvider`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMSAMLProvider`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue SAML-Anbieter-Entität in IAM erstellt. Sie ist `MySAMLProvider` benannt und wird durch das SAML-Metadatendokument in der Datei `SAMLMetaData.xml` beschrieben, die separat von der Website des SAML-Service-Anbieters heruntergeladen wurde.**
```
New-IAMSAMLProvider -Name MySAMLProvider -SAMLMetadataDocument (Get-Content -Raw SAMLMetaData.xml)
```
**Ausgabe:**
```
arn:aws:iam::123456789012:saml-provider/MySAMLProvider
```
+ Einzelheiten zur API finden Sie unter [Create SAMLProvider](https://docs.aws.amazon.com/powershell/v5/reference) in *AWS -Tools für PowerShell Cmdlet Reference (*V5).
### `New-IAMServiceLinkedRole`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMServiceLinkedRole`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine serviceverknüpfte Rolle für den Autoscaling-Service erstellt.**
```
New-IAMServiceLinkedRole -AWSServiceName autoscaling.amazonaws.com -CustomSuffix RoleNameEndsWithThis -Description "My service-linked role to support autoscaling"
```
+ Einzelheiten zur API finden Sie unter [CreateServiceLinkedRole AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-IAMUser`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMUser`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein IAM-Benutzer mit dem Namen `Bob` erstellt. Wenn Bob sich an der AWS Konsole anmelden muss, müssen Sie den Befehl separat ausführen, `New-IAMLoginProfile` um ein Anmeldeprofil mit einem Passwort zu erstellen. Wenn Bob plattformübergreifende CLI-Befehle ausführen AWS PowerShell oder AWS API-Aufrufe tätigen muss, müssen Sie den `New-IAMAccessKey` Befehl separat ausführen, um Zugriffsschlüssel zu erstellen.**
```
New-IAMUser -UserName Bob
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateUser AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-IAMVirtualMFADevice`
Das folgende Codebeispiel zeigt die Verwendung. `New-IAMVirtualMFADevice`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues virtuelles MFA-Gerät erstellt. In Zeilen 2 und 3 wird der Wert `Base32StringSeed`, den das virtuelle MFA-Softwareprogramm zum Erstellen eines Kontos benötigt (als Alternative zum QR-Code), extrahiert. Nachdem Sie das Programm mit dem Wert konfiguriert haben, erhalten Sie vom Programm zwei aufeinanderfolgende Authentifizierungs-Codes. Verwenden Sie abschließend den letzten Befehl, um das virtuelle MFA-Gerät mit dem IAM-Benutzer `Bob` zu verknüpfen und das Konto mit den beiden Authentifizierungscodes zu synchronisieren.**
```
$Device = New-IAMVirtualMFADevice -VirtualMFADeviceName BobsMFADevice
$SR = New-Object System.IO.StreamReader($Device.Base32StringSeed)
$base32stringseed = $SR.ReadToEnd()
$base32stringseed
CZWZMCQNW4DEXAMPLE3VOUGXJFZYSUW7EXAMPLECR4NJFD65GX2SLUDW2EXAMPLE
```
**Ausgabe:**
```
-- 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
```
**Beispiel 2: In diesem Beispiel wird ein neues virtuelles MFA-Gerät erstellt. In Zeilen 2 und 3 wird der Wert `QRCodePNG` extrahiert und in eine Datei geschrieben. Dieses Bild kann vom virtuellen MFA-Softwareprogramm gescannt werden, um ein Konto zu erstellen (als Alternative zur manuellen Eingabe des StringSeed Base32-Werts). Nachdem Sie das Konto in Ihrem virtuellen MFA-Programm erstellt haben, erhalten Sie zwei aufeinanderfolgende Authentifizierungscodes. Geben Sie diese in die letzten Befehle ein, um das virtuelle MFA-Gerät mit dem IAM-Benutzer `Bob` zu verknüpfen und das Konto zu synchronisieren.**
```
$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
```
**Ausgabe:**
```
-- Pause here to scan PNG with virtual MFA program to register account. --
Enable-IAMMFADevice -SerialNumber $Device.SerialNumber -UserName Bob -AuthenticationCode1 123456 -AuthenticationCode2 789012
```
+ Einzelheiten zur API finden Sie unter [CreateVirtualMfaDevice AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Publish-IAMServerCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Publish-IAMServerCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues Serverzertifikat in das IAM-Konto hochgeladen. Die Dateien, die den Text des Zertifikats, den privaten Schlüssel und (optional) die Zertifikatskette enthalten, müssen alle PEM-codiert sein. Beachten Sie, dass die Parameter den tatsächlichen Inhalt der Dateien und nicht die Dateinamen erfordern. Um den Dateiinhalt erfolgreich zu verarbeiten, müssen Sie den `-Raw`-Switch-Parameter verwenden.**
```
Publish-IAMServerCertificate -ServerCertificateName MyTestCert -CertificateBody (Get-Content -Raw server.crt) -PrivateKey (Get-Content -Raw server.key)
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UploadServerCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Publish-IAMSigningCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Publish-IAMSigningCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues X.509-Signaturzertifikat hochgeladen und dem IAM-Benutzer mit dem Namen `Bob` zugeordnet. Die Datei mit dem Zertifikatstext ist PEM-codiert. Der `CertificateBody`-Parameter erfordert den tatsächlichen Inhalt der Zertifikatsdatei und nicht den Dateinamen. Sie müssen den `-Raw`-Switch-Parameter verwenden, um die Datei erfolgreich zu verarbeiten.**
```
Publish-IAMSigningCertificate -UserName Bob -CertificateBody (Get-Content -Raw SampleSigningCert.pem)
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UploadSigningCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-IAMGroupPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Register-IAMGroupPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die vom Kunden verwaltete Richtlinie mit dem Namen `TesterPolicy` an die IAM-Gruppe `Testers` angefügt. Die in der Standardversion dieser Richtlinie definierten Berechtigungen wirken sich unmittelbar auf die Benutzer in dieser Gruppe aus.**
```
Register-IAMGroupPolicy -GroupName Testers -PolicyArn arn:aws:iam::123456789012:policy/TesterPolicy
```
**Beispiel 2: In diesem Beispiel wird die AWS verwaltete Richtlinie mit dem Namen der `AdministratorAccess` IAM-Gruppe angehängt. `Admins` Die in der neuesten Version dieser Richtlinie definierten Berechtigungen wirken sich unmittelbar auf die Benutzer in dieser Gruppe aus.**
```
Register-IAMGroupPolicy -GroupName Admins -PolicyArn arn:aws:iam::aws:policy/AdministratorAccess
```
+ Einzelheiten zur API finden Sie unter [AttachGroupPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Register-IAMRolePolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Register-IAMRolePolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die AWS verwaltete Richtlinie mit dem Namen der `SecurityAudit` IAM-Rolle angehängt. `CoSecurityAuditors` Die Benutzer, die diese Rolle übernehmen, sind unmittelbar von den in der neuesten Version dieser Richtlinie definierten Berechtigungen betroffen.**
```
Register-IAMRolePolicy -RoleName CoSecurityAuditors -PolicyArn arn:aws:iam::aws:policy/SecurityAudit
```
+ Einzelheiten zur API finden Sie unter [AttachRolePolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Register-IAMUserPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Register-IAMUserPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die AWS verwaltete Richtlinie mit dem Namen des `AmazonCognitoPowerUser` IAM-Benutzers angehängt. `Bob` Der Benutzer ist unmittelbar von den in der neuesten Version dieser Richtlinie definierten Berechtigungen betroffen.**
```
Register-IAMUserPolicy -UserName Bob -PolicyArn arn:aws:iam::aws:policy/AmazonCognitoPowerUser
```
+ Einzelheiten zur API finden Sie unter [AttachUserPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Remove-IAMAccessKey`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMAccessKey`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das AWS Zugriffsschlüsselpaar mit der Schlüssel-ID des `AKIAIOSFODNN7EXAMPLE` angegebenen Benutzers gelöscht. `Bob`**
```
Remove-IAMAccessKey -AccessKeyId AKIAIOSFODNN7EXAMPLE -UserName Bob -Force
```
+ Einzelheiten zur API finden Sie unter [DeleteAccessKey AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMAccountAlias`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMAccountAlias`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Kontoalias aus Ihrem AWS-Konto entfernt. Die Benutzeranmeldeseite mit dem Alias https://mycom panyaws.signin.aws.amazon.com/console funktioniert nicht mehr. Sie müssen stattdessen die ursprüngliche URL mit Ihrer ID-Nummer unter https://.signin.aws.amazon.com/console verwenden. AWS-Konto **
```
Remove-IAMAccountAlias -AccountAlias mycompanyaws
```
+ *Einzelheiten zur API finden Sie unter [DeleteAccountAlias](https://docs.aws.amazon.com/powershell/v5/reference)Cmdlet-Referenz (V5).AWS -Tools für PowerShell *
### `Remove-IAMAccountPasswordPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMAccountPasswordPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Kennwortrichtlinie für gelöscht AWS-Konto und alle Werte auf ihre ursprünglichen Standardwerte zurückgesetzt. Wenn derzeit keine Kennwortrichtlinie existiert, wird die folgende Fehlermeldung angezeigt: Die Kontorichtlinie mit dem Namen PasswordPolicy kann nicht gefunden werden.**
```
Remove-IAMAccountPasswordPolicy
```
+ Einzelheiten zur API finden Sie unter [DeleteAccountPasswordPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Remove-IAMClientIDFromOpenIDConnectProvider`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMClientIDFromOpenIDConnectProvider`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Client-ID `My-TestApp-3` aus der Liste der Clients entfernt, die dem IAM-OIDC-Anbieter IDs zugeordnet sind, dessen ARN lautet. `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
```
+ Einzelheiten zur API finden Sie unter [RemoveClientIdFromOpenIdConnectProvider AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Remove-IAMGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die IAM-Gruppe mit dem Namen `MyTestGroup` gelöscht. Mit dem ersten Befehl werden alle IAM-Benutzer entfernt, die Mitglieder der Gruppe sind, und mit dem zweiten Befehl wird die IAM-Gruppe gelöscht. Beide Befehle funktionieren ohne weitere Bestätigungsaufforderung.**
```
(Get-IAMGroup -GroupName MyTestGroup).Users | Remove-IAMUserFromGroup -GroupName MyTestGroup -Force
Remove-IAMGroup -GroupName MyTestGroup -Force
```
+ Einzelheiten zur API finden Sie unter [DeleteGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMGroupPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMGroupPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Inline-Richtlinie mit dem Namen `TesterPolicy` aus der IAM-Gruppe `Testers` entfernt. Die Benutzer in dieser Gruppe verlieren sofort die in dieser Richtlinie definierten Berechtigungen.**
```
Remove-IAMGroupPolicy -GroupName Testers -PolicyName TestPolicy
```
+ Einzelheiten zur API finden Sie unter [DeleteGroupPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMInstanceProfile`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMInstanceProfile`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene EC2 Instanzprofil gelöscht. `MyAppInstanceProfile` Mit dem ersten Befehl werden alle Rollen vom Instance-Profil getrennt, und mit dem zweiten Befehl wird das Instance-Profil gelöscht.**
```
(Get-IAMInstanceProfile -InstanceProfileName MyAppInstanceProfile).Roles | Remove-IAMRoleFromInstanceProfile -InstanceProfileName MyAppInstanceProfile
Remove-IAMInstanceProfile -InstanceProfileName MyAppInstanceProfile
```
+ Einzelheiten zur API finden Sie unter [DeleteInstanceProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMLoginProfile`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMLoginProfile`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Anmeldeprofil des IAM-Benutzers `Bob` gelöscht. Dadurch wird verhindert, dass sich der Benutzer an der Konsole anmeldet. AWS Es verhindert nicht, dass der Benutzer AWS CLI- PowerShell oder API-Aufrufe mit AWS Zugriffsschlüsseln ausführt, die möglicherweise noch mit dem Benutzerkonto verknüpft sind.**
```
Remove-IAMLoginProfile -UserName Bob
```
+ Einzelheiten zur API finden Sie unter [DeleteLoginProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Remove-IAMOpenIDConnectProvider`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMOpenIDConnectProvider`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der IAM-OIDC-Anbieter gelöscht, der eine Verbindung zum Anbieter `example.oidcprovider.com` herstellt. Stellen Sie sicher, dass Sie alle Rollen aktualisieren oder löschen, die im `Principal`-Element der Vertrauensrichtlinie der Rolle auf diesen Anbieter verweisen.**
```
Remove-IAMOpenIDConnectProvider -OpenIDConnectProviderArn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com
```
+ Einzelheiten zur API finden Sie unter [DeleteOpenIdConnectProvider AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Richtlinie gelöscht, deren ARN `arn:aws:iam::123456789012:policy/MySamplePolicy` lautet. Bevor Sie die Richtlinie löschen können, müssen Sie zunächst alle Versionen außer der Standardversion löschen, indem Sie `Remove-IAMPolicyVersion` ausführen. Sie müssen die Richtlinie auch von allen IAM-Benutzern, -Gruppen oder -Rollen trennen.**
```
Remove-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy
```
**Beispiel 2: In diesem Beispiel wird eine Richtlinie gelöscht, indem zuerst alle nicht standardmäßigen Richtlinienversionen gelöscht werden, die Richtlinie dann von allen zugeordneten IAM-Entitäten getrennt wird und schließlich die Richtlinie selbst gelöscht wird. In der ersten Zeile wird das Richtlinienobjekt abgerufen. Über die zweite Zeile werden alle Richtlinienversionen, die nicht als standardmäßige Version gekennzeichnet sind, in einer Sammlung erfasst und dann wird jede Richtlinie in der Sammlung gelöscht. In der dritten Zeile werden alle Benutzer, Gruppen und Rollen des IAM abgerufen, denen die Richtlinie angefügt ist. Die Zeilen vier bis sechs trennen die Richtlinie von jeder angefügten Entität. In der letzten Zeile wird dieser Befehl zum Entfernen der verwalteten Richtlinie sowie der verbleibenden Standardversion verwendet. Das Beispiel schließt den `-Force`-Switch-Parameter in jede Zeile ein, in der er benötigt wird, um Bestätigungsaufforderungen zu unterdrücken.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [DeletePolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMPolicyVersion`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMPolicyVersion`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die als `v2` identifizierte Version aus der Richtlinie gelöscht, deren ARN `arn:aws:iam::123456789012:policy/MySamplePolicy` lautet.**
```
Remove-IAMPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy -VersionID v2
```
**Beispiel 2: In diesem Beispiel wird eine Richtlinie gelöscht, indem zuerst alle nicht standardmäßigen Richtlinienversionen und dann die Richtlinie selbst gelöscht werden. In der ersten Zeile wird das Richtlinienobjekt abgerufen. Über die zweite Zeile werden alle Richtlinienversionen, die nicht als standardmäßig gekennzeichnet sind, in einer Sammlung abgerufen und dann wird dieser Befehl zur Löschung jeder einzelnen Richtlinie in der Sammlung verwendet. In der letzten Zeile wird die Richtlinie selbst sowie die verbleibende Standardversion entfernt. Beachten Sie, dass Sie zum erfolgreichen Löschen einer verwalteten Richtlinie die Richtlinie auch von allen Benutzern, Gruppen oder Rollen trennen müssen, indem Sie die Befehle `Unregister-IAMUserPolicy`, `Unregister-IAMGroupPolicy` und `Unregister-IAMRolePolicy` verwenden. Weitere Informationen finden Sie im Beispiel für das `Remove-IAMPolicy` Cmdlet.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [DeletePolicyVersion AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMRole`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMRole`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Rolle mit dem Namen `MyNewRole` aus dem aktuellen IAM-Konto gelöscht. Bevor Sie die Rolle löschen können, müssen Sie zunächst mit dem `Unregister-IAMRolePolicy`-Befehl alle verwalteten Richtlinien entfernen. Inline-Richtlinien werden mit der Rolle gelöscht.**
```
Remove-IAMRole -RoleName MyNewRole
```
**Beispiel 2: In diesem Beispiel werden alle verwalteten Richtlinien von der Rolle mit dem Namen `MyNewRole` getrennt und dann die Rolle gelöscht. In der ersten Zeile werden alle verwalteten Richtlinien abgerufen, die der Rolle als Sammlung zugeordnet sind, und dann werden alle Richtlinien in der Sammlung von der Rolle getrennt. In der zweiten Zeile wird die Rolle selbst gelöscht. Inline-Richtlinien werden zusammen mit der Rolle gelöscht.**
```
Get-IAMAttachedRolePolicyList -RoleName MyNewRole | Unregister-IAMRolePolicy -RoleName MyNewRole
Remove-IAMRole -RoleName MyNewRole
```
+ Einzelheiten zur API finden Sie unter [DeleteRole AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMRoleFromInstanceProfile`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMRoleFromInstanceProfile`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Rolle `MyNewRole` aus dem genannten EC2 Instanzprofil gelöscht. `MyNewRole` Ein in der IAM-Konsole erstelltes Instance-Profil hat immer denselben Namen wie die Rolle, wie in diesem Beispiel. Wenn Sie sie in der API oder CLI erstellen, können sie unterschiedliche Namen haben.**
```
Remove-IAMRoleFromInstanceProfile -InstanceProfileName MyNewRole -RoleName MyNewRole -Force
```
+ Einzelheiten zur API finden Sie unter [RemoveRoleFromInstanceProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMRolePermissionsBoundary`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMRolePermissionsBoundary`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird gezeigt, wie die an eine IAM-Rolle angefügte Berechtigung entfernt wird.**
```
Remove-IAMRolePermissionsBoundary -RoleName MyRoleName
```
+ Einzelheiten zur API finden Sie unter [DeleteRolePermissionsBoundary AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMRolePolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMRolePolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Inline-Richtlinie `S3AccessPolicy` gelöscht, die in die IAM-Rolle `S3BackupRole` eingebettet ist.**
```
Remove-IAMRolePolicy -PolicyName S3AccessPolicy -RoleName S3BackupRole
```
+ Einzelheiten zur API finden Sie unter [DeleteRolePolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMRoleTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMRoleTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Tag aus der Rolle "MyRoleName" mit dem Tag-Schlüssel „abac“ entfernt. Um mehrere Tags zu entfernen, geben Sie eine durch Kommas getrennte Liste mit Tag-Schlüsseln an.**
```
Remove-IAMRoleTag -RoleName MyRoleName -TagKey "abac","xyzw"
```
+ Einzelheiten zur API finden Sie unter [UntagRole AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMSAMLProvider`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMSAMLProvider`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der IAM SAML 2.0-Anbieter gelöscht, dessen ARN `arn:aws:iam::123456789012:saml-provider/SAMLADFSProvider` lautet.**
```
Remove-IAMSAMLProvider -SAMLProviderArn arn:aws:iam::123456789012:saml-provider/SAMLADFSProvider
```
+ Einzelheiten zur API finden Sie unter [Delete SAMLProvider](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `Remove-IAMServerCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMServerCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Serverzertifikat mit dem Namen `MyServerCert` gelöscht.**
```
Remove-IAMServerCertificate -ServerCertificateName MyServerCert
```
+ Einzelheiten zur API finden Sie unter [DeleteServerCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMServiceLinkedRole`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMServiceLinkedRole`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wurde die serviceverknüpfte Rolle gelöscht. Bitte beachten Sie, dass dieser Befehl fehlschlägt, wenn der Service diese Rolle weiterhin verwendet.**
```
Remove-IAMServiceLinkedRole -RoleName AWSServiceRoleForAutoScaling_RoleNameEndsWithThis
```
+ Einzelheiten zur API finden Sie unter [DeleteServiceLinkedRole AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMSigningCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMSigningCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Signaturzertifikat mit der ID `Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU` des IAM-Benutzers mit dem Namen `Bob` gelöscht.**
```
Remove-IAMSigningCertificate -UserName Bob -CertificateId Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU
```
+ Einzelheiten zur API finden Sie unter [DeleteSigningCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMUser`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMUser`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der IAM-Benutzer mit dem Namen `Bob` gelöscht.**
```
Remove-IAMUser -UserName Bob
```
**Beispiel 2: In diesem Beispiel wird der IAM-Benutzer mit dem Namen `Theresa` zusammen mit allen Elementen gelöscht, die zuerst gelöscht werden müssen.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [DeleteUser AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMUserFromGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMUserFromGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der IAM-Benutzer `Bob` aus der Gruppe `Testers` entfernt.**
```
Remove-IAMUserFromGroup -GroupName Testers -UserName Bob
```
**Beispiel 2: In diesem Beispiel werden alle Gruppen gesucht, in denen der IAM-Benutzer `Theresa` Mitglied ist, und dann wird `Theresa` aus diesen Gruppen entfernt.**
```
$groups = Get-IAMGroupForUser -UserName Theresa
foreach ($group in $groups) { Remove-IAMUserFromGroup -GroupName $group.GroupName -UserName Theresa -Force }
```
**Beispiel 3: In diesem Beispiel wird eine alternative Möglichkeit zum Entfernen des IAM-Benutzers `Bob` aus der `Testers`-Gruppe gezeigt.**
```
Get-IAMGroupForUser -UserName Bob | Remove-IAMUserFromGroup -UserName Bob -GroupName Testers -Force
```
+ Einzelheiten zur API finden Sie unter [RemoveUserFromGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMUserPermissionsBoundary`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMUserPermissionsBoundary`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird gezeigt, wie die Berechtigungsgrenze entfernt wird, die einem IAM-Benutzer zugeordnet ist.**
```
Remove-IAMUserPermissionsBoundary -UserName joe
```
+ Einzelheiten zur API finden Sie unter [DeleteUserPermissionsBoundary AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMUserPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMUserPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Inline-Richtlinie mit dem Namen `AccessToEC2Policy` gelöscht, die in den IAM-Benutzer mit dem Namen `Bob` eingebettet ist.**
```
Remove-IAMUserPolicy -PolicyName AccessToEC2Policy -UserName Bob
```
**Beispiel 2: In diesem Beispiel werden alle Inline-Richtlinien gefunden, die in den IAM-Benutzer mit dem Namen `Theresa` eingebettet sind, und dann gelöscht.**
```
$inlinepols = Get-IAMUserPolicies -UserName Theresa
foreach ($pol in $inlinepols) { Remove-IAMUserPolicy -PolicyName $pol -UserName Theresa -Force}
```
+ Einzelheiten zur API finden Sie unter [DeleteUserPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMUserTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMUserTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Tag vom Benutzer namens „joe“ mit den Tag-Schlüsseln „abac“ und „xyzw“ entfernt. Um mehrere Tags zu entfernen, geben Sie eine durch Kommas getrennte Liste mit Tag-Schlüsseln an.**
```
Remove-IAMUserTag -UserName joe -TagKey "abac","xyzw"
```
+ Einzelheiten zur API finden Sie unter [UntagUser AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-IAMVirtualMFADevice`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-IAMVirtualMFADevice`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das virtuelle IAM-MFA-Gerät gelöscht, dessen ARN `arn:aws:iam::123456789012:mfa/bob` lautet.**
```
Remove-IAMVirtualMFADevice -SerialNumber arn:aws:iam::123456789012:mfa/bob
```
**Beispiel 2: In diesem Beispiel wird überprüft, ob der IAM-Benutzerin Theresa ein MFA-Gerät zugewiesen ist. Wenn eines gefunden wird, wird das Gerät für den IAM-Benutzer deaktiviert. Wenn das Gerät virtuell ist, wird es ebenfalls gelöscht.**
```
$mfa = Get-IAMMFADevice -UserName Theresa
if ($mfa) {
Disable-IAMMFADevice -SerialNumber $mfa.SerialNumber -UserName $name
if ($mfa.SerialNumber -like "arn:*") { Remove-IAMVirtualMFADevice -SerialNumber $mfa.SerialNumber }
}
```
+ Einzelheiten zur API finden Sie unter [DeleteVirtualMfaDevice AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Request-IAMCredentialReport`
Das folgende Codebeispiel zeigt die Verwendung. `Request-IAMCredentialReport`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Erstellung eines neuen Berichts angefordert, was alle vier Stunden erfolgen kann. Wenn der letzte Bericht noch aktuell ist, lautet das Feld „Status“ `COMPLETE`. Verwenden Sie `Get-IAMCredentialReport`, um den vollständigen Bericht anzuzeigen.**
```
Request-IAMCredentialReport
```
**Ausgabe:**
```
Description State
----------- -----
No report exists. Starting a new report generation task STARTED
```
+ Einzelheiten zur API finden Sie unter [GenerateCredentialReport AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Request-IAMServiceLastAccessedDetail`
Das folgende Codebeispiel zeigt die Verwendung. `Request-IAMServiceLastAccessedDetail`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel entspricht dem API-Cmdlet. GenerateServiceLastAccessedDetails Dies liefert eine Job-ID, die in Get-IAMServiceLastAccessedDetail und Get- verwendet werden kann IAMService LastAccessedDetailWithEntity**
```
Request-IAMServiceLastAccessedDetail -Arn arn:aws:iam::123456789012:user/TestUser
```
+ Einzelheiten zur API finden Sie unter [GenerateServiceLastAccessedDetails AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Set-IAMDefaultPolicyVersion`
Das folgende Codebeispiel zeigt die Verwendung. `Set-IAMDefaultPolicyVersion`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die `v2`-Version der Richtlinie, deren ARN `arn:aws:iam::123456789012:policy/MyPolicy` lautet, als standardmäßige aktive Version festgelegt.**
```
Set-IAMDefaultPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MyPolicy -VersionId v2
```
+ Einzelheiten zur API finden Sie unter [SetDefaultPolicyVersion AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-IAMRolePermissionsBoundary`
Das folgende Codebeispiel zeigt die Verwendung. `Set-IAMRolePermissionsBoundary`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird gezeigt, wie die Berechtigungsgrenze für eine IAM-Rolle festgelegt wird. Sie können AWS verwaltete Richtlinien oder benutzerdefinierte Richtlinien als Berechtigungsgrenze festlegen.**
```
Set-IAMRolePermissionsBoundary -RoleName MyRoleName -PermissionsBoundary arn:aws:iam::123456789012:policy/intern-boundary
```
+ Einzelheiten zur API finden Sie unter [PutRolePermissionsBoundary AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Set-IAMUserPermissionsBoundary`
Das folgende Codebeispiel zeigt die Verwendung. `Set-IAMUserPermissionsBoundary`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird gezeigt, wie die Berechtigungsgrenze für den Benutzer festgelegt wird. Sie können AWS verwaltete Richtlinien oder benutzerdefinierte Richtlinien als Berechtigungsgrenze festlegen.**
```
Set-IAMUserPermissionsBoundary -UserName joe -PermissionsBoundary arn:aws:iam::123456789012:policy/intern-boundary
```
+ Einzelheiten zur API finden Sie unter [PutUserPermissionsBoundary AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Sync-IAMMFADevice`
Das folgende Codebeispiel zeigt die Verwendung. `Sync-IAMMFADevice`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das MFA-Gerät, das dem IAM-Benutzer `Bob` zugeordnet ist und dessen ARN `arn:aws:iam::123456789012:mfa/bob` lautet, mit einem Authentifizierungs-Programm synchronisiert, das die beiden Authentifizierungs-Codes bereitgestellt hat.**
```
Sync-IAMMFADevice -SerialNumber arn:aws:iam::123456789012:mfa/theresa -AuthenticationCode1 123456 -AuthenticationCode2 987654 -UserName Bob
```
**Beispiel 2: In diesem Beispiel wird das IAM-MFA-Gerät, das dem IAM-Benutzer `Theresa` zugeordnet ist, mit einem physischen Gerät synchronisiert, das die Seriennummer `ABCD12345678` hat und die beiden Authentifizierungs-Codes bereitgestellt hat.**
```
Sync-IAMMFADevice -SerialNumber ABCD12345678 -AuthenticationCode1 123456 -AuthenticationCode2 987654 -UserName Theresa
```
+ Einzelheiten zur API finden Sie unter [ResyncMfaDevice AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-IAMGroupPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-IAMGroupPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die verwaltete Gruppenrichtlinie, deren ARN `arn:aws:iam::123456789012:policy/TesterAccessPolicy` lautet, von der Gruppe mit dem Namen `Testers` getrennt.**
```
Unregister-IAMGroupPolicy -GroupName Testers -PolicyArn arn:aws:iam::123456789012:policy/TesterAccessPolicy
```
**Beispiel 2: In diesem Beispiel werden alle verwalteten Richtlinien gesucht, die der Gruppe mit dem Namen `Testers` zugeordnet sind, und von der Gruppe getrennt.**
```
Get-IAMAttachedGroupPolicies -GroupName Testers | Unregister-IAMGroupPolicy -Groupname Testers
```
+ Einzelheiten zur API finden Sie unter [DetachGroupPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-IAMRolePolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-IAMRolePolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die verwaltete Gruppenrichtlinie, deren ARN `arn:aws:iam::123456789012:policy/FederatedTesterAccessPolicy` lautet, von der Rolle mit dem Namen `FedTesterRole` getrennt.**
```
Unregister-IAMRolePolicy -RoleName FedTesterRole -PolicyArn arn:aws:iam::123456789012:policy/FederatedTesterAccessPolicy
```
**Beispiel 2: In diesem Beispiel werden alle verwalteten Richtlinien gesucht, die der Rolle mit dem Namen `FedTesterRole` zugeordnet sind, und von der Rolle getrennt.**
```
Get-IAMAttachedRolePolicyList -RoleName FedTesterRole | Unregister-IAMRolePolicy -Rolename FedTesterRole
```
+ Einzelheiten zur API finden Sie unter [DetachRolePolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-IAMUserPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-IAMUserPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die verwaltete Richtlinie, deren ARN `arn:aws:iam::123456789012:policy/TesterPolicy` lautet, vom IAM-Benutzer mit dem Namen `Bob` getrennt.**
```
Unregister-IAMUserPolicy -UserName Bob -PolicyArn arn:aws:iam::123456789012:policy/TesterPolicy
```
**Beispiel 2: In diesem Beispiel werden alle verwalteten Richtlinien gesucht, die dem IAM-Benutzer mit dem Namen `Theresa` zugeordnet sind, und diese Richtlinien werden vom Benutzer getrennt.**
```
Get-IAMAttachedUserPolicyList -UserName Theresa | Unregister-IAMUserPolicy -Username Theresa
```
+ Einzelheiten zur API finden Sie unter [DetachUserPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMAccessKey`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMAccessKey`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Status des Zugriffsschlüssels `AKIAIOSFODNN7EXAMPLE` für den IAM-Benutzer mit dem Namen `Bob` in `Inactive` geändert.**
```
Update-IAMAccessKey -UserName Bob -AccessKeyId AKIAIOSFODNN7EXAMPLE -Status Inactive
```
+ Einzelheiten zur API finden Sie unter [UpdateAccessKey AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMAccountPasswordPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMAccountPasswordPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Passwortrichtlinie für das Konto mit den angegebenen Einstellungen aktualisiert. Beachten Sie, dass alle Parameter, die nicht im Befehl enthalten sind, nicht unverändert bleiben. Stattdessen werden diese auf die Standardwerte zurückgesetzt.**
```
Update-IAMAccountPasswordPolicy -AllowUsersToChangePasswords $true -HardExpiry $false -MaxPasswordAge 90 -MinimumPasswordLength 8 -PasswordReusePrevention 20 -RequireLowercaseCharacters $true -RequireNumbers $true -RequireSymbols $true -RequireUppercaseCharacters $true
```
+ Einzelheiten zur API finden Sie unter [UpdateAccountPasswordPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMAssumeRolePolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMAssumeRolePolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die IAM-Rolle mit dem Namen `ClientRole` mit einer neuen Vertrauensrichtlinie aktualisiert, deren Inhalt aus der Datei `ClientRolePolicy.json` stammt. Beachten Sie, dass Sie den `-Raw`-Switch-Parameter verwenden müssen, um den Inhalt der JSON-Datei erfolgreich zu verarbeiten.**
```
Update-IAMAssumeRolePolicy -RoleName ClientRole -PolicyDocument (Get-Content -raw ClientRolePolicy.json)
```
+ Einzelheiten zur API finden Sie unter [UpdateAssumeRolePolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die IAM-Gruppe `Testers` in `AppTesters` umbenannt.**
```
Update-IAMGroup -GroupName Testers -NewGroupName AppTesters
```
**Beispiel 2: In diesem Beispiel wird der Pfad der IAM-Gruppe `AppTesters` in `/Org1/Org2/` geändert. Dadurch wird die ARN für die Gruppe in `arn:aws:iam::123456789012:group/Org1/Org2/AppTesters` geändert.**
```
Update-IAMGroup -GroupName AppTesters -NewPath /Org1/Org2/
```
+ Einzelheiten zur API finden Sie unter [UpdateGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMLoginProfile`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMLoginProfile`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues temporäres Passwort für den IAM-Benutzer `Bob` festgelegt und der Benutzer muss das Passwort bei der nächsten Anmeldung ändern.**
```
Update-IAMLoginProfile -UserName Bob -Password "P@ssw0rd1234" -PasswordResetRequired $true
```
+ Einzelheiten zur API finden Sie unter [UpdateLoginProfile AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMOpenIDConnectProviderThumbprint`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMOpenIDConnectProviderThumbprint`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Zertifikat-Fingerabdruckliste für den OIDC-Anbieter, dessen ARN `arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com` lautet, aktualisiert, um einen neuen Fingerabdruck zu verwenden. Der OIDC-Anbieter gibt den neuen Wert frei, wenn sich das dem Anbieter zugeordnete Zertifikat ändert.**
```
Update-IAMOpenIDConnectProviderThumbprint -OpenIDConnectProviderArn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com -ThumbprintList 7359755EXAMPLEabc3060bce3EXAMPLEec4542a3
```
+ Einzelheiten zur API finden Sie unter [UpdateOpenIdConnectProviderThumbprint AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMRole`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMRole`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Rollenbeschreibung und der maximale Sitzungsdauerwert (in Sekunden) aktualisiert, für den die Sitzung einer Rolle angefordert werden kann.**
```
Update-IAMRole -RoleName MyRoleName -Description "My testing role" -MaxSessionDuration 43200
```
+ Einzelheiten zur API finden Sie unter [UpdateRole AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMRoleDescription`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMRoleDescription`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Beschreibung einer IAM-Rolle in Ihrem Konto aktualisiert.**
```
Update-IAMRoleDescription -RoleName MyRoleName -Description "My testing role"
```
+ Einzelheiten zur API finden Sie unter [UpdateRoleDescription AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMSAMLProvider`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMSAMLProvider`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der SAML-Provider in IAM, dessen ARN `arn:aws:iam::123456789012:saml-provider/SAMLADFS` lautet, mit einem neuen SAML-Metadatendokument aus der Datei `SAMLMetaData.xml` aktualisiert. Beachten Sie, dass Sie den `-Raw`-Switch-Parameter verwenden müssen, um den Inhalt der JSON-Datei erfolgreich zu verarbeiten.**
```
Update-IAMSAMLProvider -SAMLProviderArn arn:aws:iam::123456789012:saml-provider/SAMLADFS -SAMLMetadataDocument (Get-Content -Raw SAMLMetaData.xml)
```
+ Einzelheiten zur API finden Sie unter [UpdateSamlProvider AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMServerCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMServerCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Zertifikat mit dem Namen `MyServerCertificate` in `MyRenamedServerCertificate` umbenannt.**
```
Update-IAMServerCertificate -ServerCertificateName MyServerCertificate -NewServerCertificateName MyRenamedServerCertificate
```
**Beispiel 2: In diesem Beispiel wird das Zertifikat mit dem Namen `MyServerCertificate` in den Pfad /Org1/Org2/ verschoben. Dadurch wird die ARN für die Ressource zu `arn:aws:iam::123456789012:server-certificate/Org1/Org2/MyServerCertificate` geändert.**
```
Update-IAMServerCertificate -ServerCertificateName MyServerCertificate -NewPath /Org1/Org2/
```
+ Einzelheiten zur API finden Sie unter [UpdateServerCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMSigningCertificate`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMSigningCertificate`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Zertifikat aktualisiert, das dem IAM-Benutzer mit dem Namen `Bob` und der Zertifikats-ID `Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU` zugeordnet ist, um es als inaktiv zu markieren.**
```
Update-IAMSigningCertificate -CertificateId Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU -UserName Bob -Status Inactive
```
+ Einzelheiten zur API finden Sie unter [UpdateSigningCertificate AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-IAMUser`
Das folgende Codebeispiel zeigt die Verwendung. `Update-IAMUser`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der IAM-Benutzer `Bob` in `Robert` umbenannt.**
```
Update-IAMUser -UserName Bob -NewUserName Robert
```
**Beispiel 2: In diesem Beispiel wird der Pfad des IAM-Benutzers `Bob` in `/Org1/Org2/` geändert, wodurch der ARN für den Benutzer effektiv zu `arn:aws:iam::123456789012:user/Org1/Org2/bob` geändert wird.**
```
Update-IAMUser -UserName Bob -NewPath /Org1/Org2/
```
+ Einzelheiten zur API finden Sie unter [UpdateUser AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-IAMGroupPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Write-IAMGroupPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Inline-Richtlinie mit dem Namen `AppTesterPolicy` erstellt und in die IAM-Gruppe `AppTesters` eingebettet. Wenn bereits eine Inline-Richtlinie mit demselben Namen vorhanden ist, wird diese überschrieben. Der Inhalt der JSON-Richtlinie wird in der Datei `apptesterpolicy.json` gespeichert. Beachten Sie, dass Sie den `-Raw`-Parameter verwenden müssen, um den Inhalt der JSON-Datei erfolgreich zu verarbeiten.**
```
Write-IAMGroupPolicy -GroupName AppTesters -PolicyName AppTesterPolicy -PolicyDocument (Get-Content -Raw apptesterpolicy.json)
```
+ Einzelheiten zur API finden Sie unter [PutGroupPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-IAMRolePolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Write-IAMRolePolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Inline-Richtlinie mit dem Namen `FedTesterRolePolicy` erstellt und in die IAM-Rolle `FedTesterRole` eingebettet. Wenn bereits eine Inline-Richtlinie mit demselben Namen vorhanden ist, wird diese überschrieben. Der Inhalt der JSON-Richtlinie stammt aus der Datei `FedTesterPolicy.json`. Beachten Sie, dass Sie den `-Raw`-Parameter verwenden müssen, um den Inhalt der JSON-Datei erfolgreich zu verarbeiten.**
```
Write-IAMRolePolicy -RoleName FedTesterRole -PolicyName FedTesterRolePolicy -PolicyDocument (Get-Content -Raw FedTesterPolicy.json)
```
+ Einzelheiten zur API finden Sie unter [PutRolePolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-IAMUserPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Write-IAMUserPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Inline-Richtlinie mit dem Namen `EC2AccessPolicy` erstellt und in den IAM-Benutzer `Bob` eingebettet. Wenn bereits eine Inline-Richtlinie mit demselben Namen vorhanden ist, wird diese überschrieben. Der Inhalt der JSON-Richtlinie stammt aus der Datei `EC2AccessPolicy.json`. Beachten Sie, dass Sie den `-Raw`-Parameter verwenden müssen, um den Inhalt der JSON-Datei erfolgreich zu verarbeiten.**
```
Write-IAMUserPolicy -UserName Bob -PolicyName EC2AccessPolicy -PolicyDocument (Get-Content -Raw EC2AccessPolicy.json)
```
+ Einzelheiten zur API finden Sie unter [PutUserPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Kinesis-Beispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Kinesis Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-KINRecord`
Das folgende Codebeispiel zeigt die Verwendung. `Get-KINRecord`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird gezeigt, wie Daten aus einer Reihe von einem oder mehreren Datensätzen zurückgegeben und extrahiert werden können. Der Iterator, an den geliefert Get-KINRecord wird, bestimmt die Startposition der zurückzugebenden Datensätze, die in diesem Beispiel in einer Variablen, \$1records, erfasst werden. Auf jeden einzelnen Datensatz kann dann durch Indizierung der \$1records-Sammlung zugegriffen werden. Unter der Annahme, dass es sich bei den Daten im Datensatz um UTF-8-codierten Text handelt, zeigt der letzte Befehl, wie Sie die Daten aus dem Objekt extrahieren und als Text MemoryStream an die Konsole zurückgeben können.**
```
$records
$records = Get-KINRecord -ShardIterator "AAAAAAAAAAGIc....9VnbiRNaP"
```
**Ausgabe:**
```
MillisBehindLatest NextShardIterator Records
------------------ ----------------- -------
0 AAAAAAAAAAERNIq...uDn11HuUs {Key1, Key2}
```
```
$records.Records[0]
```
**Ausgabe:**
```
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())
```
**Ausgabe:**
```
test data from string
```
+ Einzelheiten zur API finden Sie unter [GetRecords AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-KINShardIterator`
Das folgende Codebeispiel zeigt die Verwendung. `Get-KINShardIterator`
**Tools für PowerShell V5**
**Beispiel 1: Gibt einen Shard-Iterator für den angegebenen Shard und die Startposition zurück. Einzelheiten zu den Shard-IDs und Sequenznummern können der Ausgabe des Get-KINStream Cmdlets entnommen werden, indem auf die Shards-Auflistung des zurückgegebenen Stream-Objekts verwiesen wird. Der zurückgegebene Iterator kann zusammen mit dem Get-KINRecord Cmdlet verwendet werden, um Datensätze im Shard abzurufen.**
```
Get-KINShardIterator -StreamName "mystream" -ShardId "shardId-000000000000" -ShardIteratorType AT_SEQUENCE_NUMBER -StartingSequenceNumber "495598645..."
```
**Ausgabe:**
```
AAAAAAAAAAGIc....9VnbiRNaP
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([GetShardIterator](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Get-KINStream`
Das folgende Codebeispiel zeigt die Verwendung. `Get-KINStream`
**Tools für PowerShell V5**
**Beispiel 1: Gibt Details des angegebenen Streams zurück.**
```
Get-KINStream -StreamName "mystream"
```
**Ausgabe:**
```
HasMoreShards : False
RetentionPeriodHours : 24
Shards : {}
StreamARN : arn:aws:kinesis:us-west-2:123456789012:stream/mystream
StreamName : mystream
StreamStatus : ACTIVE
```
+ Einzelheiten zur API finden Sie unter [DescribeStream AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-KINStream`
Das folgende Codebeispiel zeigt die Verwendung. `New-KINStream`
**Tools für PowerShell V5**
**Beispiel 1: Erzeugt einen neuen Stream.**
```
New-KINStream -StreamName "mystream" -ShardCount 1
```
+ Einzelheiten zur API finden Sie unter [CreateStream AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-KINStream`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-KINStream`
**Tools für PowerShell V5**
**Beispiel 1: Löscht den angegebenen Stream. Sie werden um eine Bestätigung gebeten, bevor der Befehl ausgeführt wird. Verwenden Sie den Schalter -Force, um die Bestätigungsaufforderung zu unterdrücken.**
```
Remove-KINStream -StreamName "mystream"
```
+ Einzelheiten zur API finden Sie unter [DeleteStream AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-KINRecord`
Das folgende Codebeispiel zeigt die Verwendung. `Write-KINRecord`
**Tools für PowerShell V5**
**Beispiel 1: Schreibt einen Datensatz, der die an den Parameter -Text übergebene Zeichenfolge enthält.**
```
Write-KINRecord -Text "test data from string" -StreamName "mystream" -PartitionKey "Key1"
```
**Beispiel 2: Schreibt einen Datensatz, der die Daten aus der angegebenen Datei enthält. Die Datei wird als Folge von Bytes behandelt. Wenn sie Text enthält, sollte sie daher vor der Verwendung mit diesem Cmdlet mit der erforderlichen Kodierung geschrieben werden.**
```
Write-KINRecord -FilePath "C:\TestData.txt" -StreamName "mystream" -PartitionKey "Key2"
```
+ Einzelheiten zur API finden Sie unter [PutRecord AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Lambda-Beispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Lambda Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-LMResourceTag`
Das folgende Codebeispiel zeigt die Verwendung von. `Add-LMResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Fügt die drei Tags (Washington, Oregon und Kalifornien) und ihre zugehörigen Werte zu der angegebenen Funktion hinzu, die durch ihre ARN identifiziert wird.**
```
Add-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction" -Tag @{ "Washington" = "Olympia"; "Oregon" = "Salem"; "California" = "Sacramento" }
```
+ Einzelheiten zur API finden Sie unter [TagResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-LMAccountSetting`
Das folgende Codebeispiel zeigt die Verwendung. `Get-LMAccountSetting`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel wird angezeigt, um das Kontolimit und die Kontonutzung zu vergleichen**
```
Get-LMAccountSetting | Select-Object @{Name="TotalCodeSizeLimit";Expression={$_.AccountLimit.TotalCodeSize}}, @{Name="TotalCodeSizeUsed";Expression={$_.AccountUsage.TotalCodeSize}}
```
**Ausgabe:**
```
TotalCodeSizeLimit TotalCodeSizeUsed
------------------ -----------------
80530636800 15078795
```
+ Einzelheiten zur API finden Sie unter [GetAccountSettings AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-LMAlias`
Das folgende Codebeispiel zeigt die Verwendung. `Get-LMAlias`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Gewichtungen der Routing-Konfiguration für einen bestimmten Lambda-Funktionsalias abgerufen.**
```
Get-LMAlias -FunctionName "MylambdaFunction123" -Name "newlabel1" -Select RoutingConfig
```
**Ausgabe:**
```
AdditionalVersionWeights
------------------------
{[1, 0.6]}
```
+ Einzelheiten zur API finden Sie unter [GetAlias AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-LMFunctionConcurrency`
Das folgende Codebeispiel zeigt die Verwendung. `Get-LMFunctionConcurrency`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel ruft die reservierte Gleichzeitigkeit für die Lambda-Funktion ab**
```
Get-LMFunctionConcurrency -FunctionName "MylambdaFunction123" -Select *
```
**Ausgabe:**
```
ReservedConcurrentExecutions
----------------------------
100
```
+ Einzelheiten zur API finden Sie unter [GetFunctionConcurrency AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-LMFunctionConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Get-LMFunctionConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt die versionsspezifische Konfiguration einer Lambda-Funktion zurück.**
```
Get-LMFunctionConfiguration -FunctionName "MylambdaFunction123" -Qualifier "PowershellAlias"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetFunctionConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-LMFunctionList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-LMFunctionList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Lambda-Funktionen mit sortierter Codegröße angezeigt**
```
Get-LMFunctionList | Sort-Object -Property CodeSize | Select-Object FunctionName, RunTime, Timeout, CodeSize
```
**Ausgabe:**
```
FunctionName Runtime Timeout CodeSize
------------ ------- ------- --------
test python2.7 3 243
MylambdaFunction123 python3.8 600 659
myfuncpython1 python3.8 303 675
```
+ Einzelheiten zur API finden Sie unter [ListFunctions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-LMPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-LMPolicy`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Funktionsrichtlinie der Lambda-Funktion angezeigt**
```
Get-LMPolicy -FunctionName test -Select Policy
```
**Ausgabe:**
```
{"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"}]}
```
+ Einzelheiten zur API finden Sie unter [GetPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-LMProvisionedConcurrencyConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Get-LMProvisionedConcurrencyConfig`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die bereitgestellte Gleichzeitigkeitskonfiguration für den angegebenen Alias der Lambda-Funktion abgerufen.**
```
C:\>Get-LMProvisionedConcurrencyConfig -FunctionName "MylambdaFunction123" -Qualifier "NewAlias1"
```
**Ausgabe:**
```
AllocatedProvisionedConcurrentExecutions : 0
AvailableProvisionedConcurrentExecutions : 0
LastModified : 2020-01-15T03:21:26+0000
RequestedProvisionedConcurrentExecutions : 70
Status : IN_PROGRESS
StatusReason :
```
+ Einzelheiten zur API finden Sie unter [GetProvisionedConcurrencyConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-LMProvisionedConcurrencyConfigList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-LMProvisionedConcurrencyConfigList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Liste der bereitgestellten Gleichzeitigkeitskonfigurationen für eine Lambda-Funktion abgerufen.**
```
Get-LMProvisionedConcurrencyConfigList -FunctionName "MylambdaFunction123"
```
+ Einzelheiten zur API finden Sie unter [ListProvisionedConcurrencyConfigs AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-LMResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-LMResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Ruft die Tags und ihre Werte ab, die derzeit für die angegebene Funktion festgelegt sind.**
```
Get-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction"
```
**Ausgabe:**
```
Key Value
--- -----
California Sacramento
Oregon Salem
Washington Olympia
```
+ Einzelheiten zur API finden Sie unter [ListTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-LMVersionsByFunction`
Das folgende Codebeispiel zeigt die Verwendung. `Get-LMVersionsByFunction`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt die Liste der versionsspezifischen Konfigurationen für jede Version der Lambda-Funktion zurück.**
```
Get-LMVersionsByFunction -FunctionName "MylambdaFunction123"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListVersionsByFunction AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-LMAlias`
Das folgende Codebeispiel zeigt die Verwendung. `New-LMAlias`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neuer Lambda-Alias für die angegebene Version und Routing-Konfiguration erstellt, um den Prozentsatz der Aufrufe für dieses System anzugeben.**
```
New-LMAlias -FunctionName "MylambdaFunction123" -RoutingConfig_AdditionalVersionWeight @{Name="1";Value="0.6} -Description "Alias for version 4" -FunctionVersion 4 -Name "PowershellAlias"
```
+ Einzelheiten zur API finden Sie unter [CreateAlias AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Publish-LMFunction`
Das folgende Codebeispiel zeigt die Verwendung. `Publish-LMFunction`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue C\$1-Funktion (dotnetcore1.0 Runtime) mit dem Namen AWS Lambda erstellt, die die kompilierten Binärdateien für die Funktion aus einer ZIP-Datei MyFunction im lokalen Dateisystem bereitstellt (relative oder absolute Pfade können verwendet werden). C\$1-Lambda-Funktionen spezifizieren den Handler für die Funktion mit der Bezeichnung AssemblyName: :Namespace. ClassName::. MethodName Sie sollten die Teile Assembly-Name (ohne .dll-Suffix), Namespace, Klassenname und Methodenname der Handler-Spezifikation entsprechend ersetzen. Für die neue Funktion werden die Umgebungsvariablen 'envvar1' und 'envvar2' aus den bereitgestellten Werten eingerichtet.**
```
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" }
```
**Ausgabe:**
```
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 :
```
**Beispiel 2: Dieses Beispiel ähnelt dem vorherigen, mit dem Unterschied, dass die Funktions-Binärdateien zunächst in einen Amazon S3-Bucket hochgeladen werden (der sich in derselben Region befinden muss wie die vorgesehene Lambda-Funktion) und das resultierende S3-Objekt dann bei der Erstellung der Funktion referenziert wird.**
```
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" }
```
+ Einzelheiten zur API finden Sie unter [CreateFunction AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Publish-LMVersion`
Das folgende Codebeispiel zeigt die Verwendung. `Publish-LMVersion`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Version für den vorhandenen Snapshot von Lambda-Funktionscode erstellt**
```
Publish-LMVersion -FunctionName "MylambdaFunction123" -Description "Publishing Existing Snapshot of function code as a new version through Powershell"
```
+ Einzelheiten zur API finden Sie unter [PublishVersion AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-LMAlias`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-LMAlias`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die im Befehl erwähnte Lambda-Funktion Alias gelöscht.**
```
Remove-LMAlias -FunctionName "MylambdaFunction123" -Name "NewAlias"
```
+ Einzelheiten zur API finden Sie unter [DeleteAlias AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-LMFunction`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-LMFunction`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine bestimmte Version einer Lambda-Funktion gelöscht**
```
Remove-LMFunction -FunctionName "MylambdaFunction123" -Qualifier '3'
```
+ Einzelheiten zur API finden Sie unter [DeleteFunction AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-LMFunctionConcurrency`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-LMFunctionConcurrency`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Funktionsgleichzeitigkeit der Lambda-Funktion aufgehoben.**
```
Remove-LMFunctionConcurrency -FunctionName "MylambdaFunction123"
```
+ Einzelheiten zur API finden Sie unter [DeleteFunctionConcurrency AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-LMPermission`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-LMPermission`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Funktionsrichtlinie für die angegebene StatementId Lambda-Funktion entfernt.**
```
$policy = Get-LMPolicy -FunctionName "MylambdaFunction123" -Select Policy | ConvertFrom-Json| Select-Object -ExpandProperty Statement
Remove-LMPermission -FunctionName "MylambdaFunction123" -StatementId $policy[0].Sid
```
+ Einzelheiten zur API finden Sie unter [RemovePermission AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-LMProvisionedConcurrencyConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-LMProvisionedConcurrencyConfig`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die bereitgestellte Gleichzeitigkeitskonfiguration für einen bestimmten Alias entfernt.**
```
Remove-LMProvisionedConcurrencyConfig -FunctionName "MylambdaFunction123" -Qualifier "NewAlias1"
```
+ Einzelheiten zur API finden Sie unter [DeleteProvisionedConcurrencyConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-LMResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-LMResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Entfernt die angegebenen Tags aus einer Funktion. Das Cmdlet fordert Sie zur Bestätigung auf, bevor der Vorgang fortgesetzt wird, sofern der Schalter -Force nicht angegeben ist. Es wird ein einziger Aufruf an den Dienst gesendet, um die Tags zu entfernen.**
```
Remove-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction" -TagKey "Washington","Oregon","California"
```
**Beispiel 2: Entfernt die angegebenen Tags aus einer Funktion. Das Cmdlet fordert Sie zur Bestätigung auf, bevor der Vorgang fortgesetzt wird, sofern der Schalter -Force nicht angegeben ist. Sobald der Dienst pro bereitgestelltem Tag aufgerufen wurde.**
```
"Washington","Oregon","California" | Remove-LMResourceTag -Resource "arn:aws:lambda:us-west-2:123456789012:function:MyFunction"
```
+ Einzelheiten zur API finden Sie unter [UntagResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-LMAlias`
Das folgende Codebeispiel zeigt die Verwendung. `Update-LMAlias`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel aktualisiert die Konfiguration einer vorhandenen Lambda-Funktion-Alias. Der RoutingConfiguration Wert wird aktualisiert, sodass 60% (0,6) des Datenverkehrs auf Version 1 umgestellt werden**
```
Update-LMAlias -FunctionName "MylambdaFunction123" -Description " Alias for version 2" -FunctionVersion 2 -Name "newlabel1" -RoutingConfig_AdditionalVersionWeight @{Name="1";Value="0.6}
```
+ Einzelheiten zur API finden Sie unter [UpdateAlias AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Update-LMFunctionCode`
Das folgende Codebeispiel zeigt die Verwendung. `Update-LMFunctionCode`
**Tools für PowerShell V5**
**Beispiel 1: Aktualisiert die Funktion mit dem Namen 'MyFunction' mit neuem Inhalt, der in der angegebenen ZIP-Datei enthalten ist. Für eine C\$1.NET-Core-Lambda-Funktion sollte die ZIP-Datei die kompilierte Assembly enthalten.**
```
Update-LMFunctionCode -FunctionName MyFunction -ZipFilename .\UpdatedCode.zip
```
**Beispiel 2: Dieses Beispiel ähnelt dem vorherigen, verwendet aber ein Amazon S3-Objekt, das den aktualisierten Code enthält, um die Funktion zu aktualisieren.**
```
Update-LMFunctionCode -FunctionName MyFunction -BucketName amzn-s3-demo-bucket -Key UpdatedCode.zip
```
+ Einzelheiten zur API finden Sie unter [UpdateFunctionCode AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Update-LMFunctionConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Update-LMFunctionConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel aktualisiert die vorhandene Lambda-Funktionskonfiguration**
```
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
```
+ Einzelheiten zur API finden Sie unter [UpdateFunctionConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-LMFunctionConcurrency`
Das folgende Codebeispiel zeigt die Verwendung. `Write-LMFunctionConcurrency`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Gleichzeitigkeitseinstellungen für die Funktion als Ganzes angewendet.**
```
Write-LMFunctionConcurrency -FunctionName "MylambdaFunction123" -ReservedConcurrentExecution 100
```
+ Einzelheiten zur API finden Sie unter [PutFunctionConcurrency AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-LMProvisionedConcurrencyConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Write-LMProvisionedConcurrencyConfig`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird dem Alias einer Funktion eine bereitgestellte Gleichzeitigkeitskonfiguration hinzugefügt**
```
Write-LMProvisionedConcurrencyConfig -FunctionName "MylambdaFunction123" -ProvisionedConcurrentExecution 20 -Qualifier "NewAlias1"
```
+ Einzelheiten zur API finden Sie unter [PutProvisionedConcurrencyConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Amazon ML-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon ML Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-MLBatchPrediction`
Das folgende Codebeispiel zeigt die Verwendung `Get-MLBatchPrediction` von.
**Tools für PowerShell V5**
**Beispiel 1: Gibt die detaillierten Metadaten für eine Batch-Vorhersage mit der id-ID zurück.**
```
Get-MLBatchPrediction -BatchPredictionId ID
```
+ Einzelheiten zur API finden Sie unter [GetBatchPrediction AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-MLBatchPredictionList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-MLBatchPredictionList`
**Tools für PowerShell V5**
**Beispiel 1: Gibt eine Liste aller BatchPredictions und der zugehörigen Datensätze zurück, die dem in der Anfrage angegebenen Suchkriterium entsprechen.**
```
Get-MLBatchPredictionList
```
**Beispiel 2: Gibt eine Liste aller BatchPredictions mit dem Status ABGESCHLOSSEN zurück.**
```
Get-MLBatchPredictionList -FilterVariable Status -EQ COMPLETED
```
+ Einzelheiten zur API finden Sie unter [DescribeBatchPredictions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-MLDataSource`
Das folgende Codebeispiel zeigt die Verwendung. `Get-MLDataSource`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Metadaten, den Status und die Datendateiinformationen für a DataSource mit der ID-ID zurück**
```
Get-MLDataSource -DataSourceId ID
```
+ Einzelheiten zur API finden Sie unter [GetDataSource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-MLDataSourceList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-MLDataSourceList`
**Tools für PowerShell V5**
**Beispiel 1: Gibt eine Liste aller DataSources und der zugehörigen Datensätze zurück.**
```
Get-MLDataSourceList
```
**Beispiel 2: Gibt eine Liste aller DataSources mit dem Status ABGESCHLOSSEN zurück.**
```
Get-MLDataDourceList -FilterVariable Status -EQ COMPLETED
```
+ Einzelheiten zur API finden Sie unter [DescribeDataSources AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-MLEvaluation`
Das folgende Codebeispiel zeigt die Verwendung. `Get-MLEvaluation`
**Tools für PowerShell V5**
**Beispiel 1: Gibt Metadaten und Status für eine Bewertung mit der id-ID zurück.**
```
Get-MLEvaluation -EvaluationId ID
```
+ Einzelheiten zur API finden Sie unter [GetEvaluation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-MLEvaluationList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-MLEvaluationList`
**Tools für PowerShell V5**
**Beispiel 1: Gibt eine Liste aller Evaluierungsressourcen zurück**
```
Get-MLEvaluationList
```
**Beispiel 2: Gibt eine Liste aller Evaluierungen mit dem Status COMPLETED zurück.**
```
Get-MLEvaluationList -FilterVariable Status -EQ COMPLETED
```
+ Einzelheiten zur API finden Sie unter [DescribeEvaluations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-MLModel`
Das folgende Codebeispiel zeigt die Verwendung. `Get-MLModel`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die detaillierten Metadaten, den Status, das Schema und die Datendateiinformationen für eine MLModel mit der ID-ID zurück.**
```
Get-MLModel -ModelId ID
```
+ API-Details finden Sie unter [Get MLModel](https://docs.aws.amazon.com/powershell/v5/reference) in *AWS -Tools für PowerShell Cmdlet-Referenz (V5).*
### `Get-MLModelList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-MLModelList`
**Tools für PowerShell V5**
**Beispiel 1: Gibt eine Liste aller Modelle und der zugehörigen Datensätze zurück. **
```
Get-MLModelList
```
**Beispiel 2: Gibt eine Liste aller Modelle mit dem Status COMPLETED zurück.**
```
Get-MLModelList -FilterVariable Status -EQ COMPLETED
```
+ Einzelheiten zur API finden Sie unter [Describe MLModels](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `Get-MLPrediction`
Das folgende Codebeispiel zeigt die Verwendung. `Get-MLPrediction`
**Tools für PowerShell V5**
**Beispiel 1: Sendet einen Datensatz an die URL des Echtzeit-Prognoseendpunkts für das Modell mit der id-ID.**
```
Get-MLPrediction -ModelId ID -PredictEndpoint URL -Record @{"A" = "B"; "C" = "D";}
```
+ Weitere API-Informationen finden Sie unter [Predict](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*.
### `New-MLBatchPrediction`
Das folgende Codebeispiel zeigt, wie man es benutzt`New-MLBatchPrediction`.
**Tools für PowerShell V5**
**Beispiel 1: Erstellen Sie eine neue Batch-Vorhersageanforderung für das Modell mit der id-ID und speichern Sie die Ausgabe am angegebenen S3-Speicherort.**
```
New-MLBatchPrediction -ModelId ID -Name NAME -OutputURI s3://...
```
+ Einzelheiten zur API finden Sie unter [CreateBatchPrediction AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-MLDataSourceFromS3`
Das folgende Codebeispiel zeigt die Verwendung. `New-MLDataSourceFromS3`
**Tools für PowerShell V5**
**Beispiel 1: Erstellen Sie eine Datenquelle mit Daten für einen S3-Speicherort mit dem Namen NAME und dem Schema SCHEMA.**
```
New-MLDataSourceFromS3 -Name NAME -ComputeStatistics $true -DataSpec_DataLocationS3 "s3://BUCKET/KEY" -DataSchema SCHEMA
```
+ Einzelheiten zur API finden Sie unter [CreateDataSourceFromS3](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `New-MLEvaluation`
Das folgende Codebeispiel zeigt die Verwendung. `New-MLEvaluation`
**Tools für PowerShell V5**
**Beispiel 1: Erstellen Sie eine Auswertung für eine bestimmte Datenquellen-ID und Modell-ID.**
```
New-MLEvaluation -Name NAME -DataSourceId DSID -ModelId MID
```
+ Einzelheiten zur API finden Sie unter [CreateEvaluation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-MLModel`
Das folgende Codebeispiel zeigt die Verwendung. `New-MLModel`
**Tools für PowerShell V5**
**Beispiel 1: Erstellen Sie ein neues Modell mit Trainingsdaten.**
```
New-MLModel -Name NAME -ModelType BINARY -Parameter @{...} -TrainingDataSourceId ID
```
+ Einzelheiten zur API finden Sie unter [Create MLModel](https://docs.aws.amazon.com/powershell/v5/reference) in *AWS -Tools für PowerShell Cmdlet Reference (*V5).
### `New-MLRealtimeEndpoint`
Das folgende Codebeispiel zeigt die Verwendung. `New-MLRealtimeEndpoint`
**Tools für PowerShell V5**
**Beispiel 1: Erstellen Sie einen neuen Echtzeit-Vorhersage-Endpunkt für die angegebene Modell-ID.**
```
New-MLRealtimeEndpoint -ModelId ID
```
+ Einzelheiten zur API finden Sie unter [CreateRealtimeEndpoint AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Macie-Beispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit Macie verwenden.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-MAC2FindingList`
Das folgende Codebeispiel zeigt die Verwendung von. `Get-MAC2FindingList`
**Tools für PowerShell V5**
**Beispiel 1: Gibt eine Liste mit Ergebnissen zurück, die FindingIds eine Erkennung sensibler Daten mit dem Typ „CREDIT\$1CARD\$1NUMBER“ oder „US\$1SOCIAL\$1SECURITY\$1NUMBER“ enthalten**
```
$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
```
+ *Einzelheiten zur API finden Sie unter Cmdlet-Referenz (V5). [ListFindings](https://docs.aws.amazon.com/powershell/v5/reference)AWS -Tools für PowerShell *
# AWS-Preisliste Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. AWS-Preisliste
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-PLSAttributeValue`
Das folgende Codebeispiel zeigt die Verwendung `Get-PLSAttributeValue` von.
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Werte für das Attribut 'volumeType' für Amazon EC2 in der Region us-east-1 zurück.**
```
Get-PLSAttributeValue -ServiceCode AmazonEC2 -AttributeName "volumeType" -region us-east-1
```
**Ausgabe:**
```
Value
-----
Cold HDD
General Purpose
Magnetic
Provisioned IOPS
Throughput Optimized HDD
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([GetAttributeValues](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Get-PLSProduct`
Das folgende Codebeispiel zeigt die Verwendung. `Get-PLSProduct`
**Tools für PowerShell V5**
**Beispiel 1: Gibt Details aller Produkte für Amazon zurück EC2.**
```
Get-PLSProduct -ServiceCode AmazonEC2 -Region us-east-1
```
**Ausgabe:**
```
{"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"},...
```
**Beispiel 2: Gibt Daten für Amazon EC2 in der Region US-East-1 zurück, gefiltert nach Volumetypen von „General Purpose“, die SSD-gestützt sind.**
```
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
```
**Ausgabe:**
```
{"product":{"productFamily":"Storage","attributes":{"storageMedia":"SSD-backed","maxThroughputvolume":"160 MB/sec","volumeType":"General Purpose","maxIopsvolume":"10000",...
```
+ *Einzelheiten zur API finden Sie unter [GetProducts](https://docs.aws.amazon.com/powershell/v5/reference)Cmdlet-Referenz (V5).AWS -Tools für PowerShell *
### `Get-PLSService`
Das folgende Codebeispiel zeigt die Verwendung. `Get-PLSService`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Metadaten für alle verfügbaren Servicecodes in der Region us-east-1 zurück.**
```
Get-PLSService -Region us-east-1
```
**Ausgabe:**
```
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
...
```
**Beispiel 2: Gibt die Metadaten für den EC2 Amazon-Service in der Region us-east-1 zurück.**
```
Get-PLSService -ServiceCode AmazonEC2 -Region us-east-1
```
**Ausgabe:**
```
AttributeNames ServiceCode
-------------- -----------
{volumeType, maxIopsvolume, instanceCapacity10xlarge, locationType...} AmazonEC2
```
+ Einzelheiten zur API finden Sie unter [DescribeServices AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
# Beispiele für Resource Groups mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Resource Groups Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-RGResourceTag`
Das folgende Codebeispiel zeigt die Verwendung `Add-RGResourceTag` von.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Tag-Schlüssel „Instances“ mit dem Wert „workboxes“ zur angegebenen Ressourcengruppe arn hinzugefügt.**
```
Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes
```
**Ausgabe:**
```
Arn Tags
--- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]}
```
+ Weitere API-Informationen finden Sie unter [Tag](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*.
### `Find-RGResource`
Das folgende Codebeispiel zeigt, wie man es benutzt`Find-RGResource`.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Ressourcentyp ResourceQuery für Instanz mit Tag-Filtern erstellt und Ressourcen gesucht.**
```
$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
```
**Ausgabe:**
```
ResourceArn ResourceType
----------- ------------
arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance
```
+ Einzelheiten zur API finden Sie unter [SearchResources AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-RGGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-RGGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Ressourcengruppe anhand des Gruppennamens abgerufen.**
```
Get-RGGroup -GroupName auto-no
```
**Ausgabe:**
```
Description GroupArn Name
----------- -------- ----
arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no
```
+ Einzelheiten zur API finden Sie unter [GetGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-RGGroupList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-RGGroupList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden bereits erstellte Ressourcengruppen aufgelistet.**
```
Get-RGGroupList
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-RGGroupQuery`
Das folgende Codebeispiel zeigt die Verwendung. `Get-RGGroupQuery`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Ressourcenabfrage für die angegebene Ressourcengruppe abgerufen**
```
Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery
```
**Ausgabe:**
```
Query Type
----- ----
{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0
```
+ Einzelheiten zur API finden Sie unter [GetGroupQuery AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-RGGroupResourceList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-RGGroupResourceList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Gruppenressourcen auf der Grundlage einer Filterung nach Ressourcentyp aufgelistet**
```
Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListGroupResources AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-RGResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-RGResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Tags für die angegebene Ressourcengruppe arn aufgelistet**
```
Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes
```
**Ausgabe:**
```
Key Value
--- -----
Instances workboxes
```
+ Einzelheiten zur API finden Sie unter [GetTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-RGGroup`
Das folgende Codebeispiel zeigt die Verwendung. `New-RGGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue tagbasierte AWS Ressourcengruppe für Resource Groups mit dem Namen TestPowerShellGroup erstellt. Die Gruppe umfasst EC2 Amazon-Instances in der aktuellen Region, die mit dem Tag-Schlüssel „Name“ und dem Tag-Wert „test2" gekennzeichnet sind. Der Befehl gibt die Abfrage und den Typ der Gruppe sowie die Ergebnisse der Operation zurück.**
```
$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."
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-RGGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-RGGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die benannte Ressourcengruppe entfernt**
```
Remove-RGGroup -GroupName non-tag-cfn-elbv2
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-RGResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-RGResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das erwähnte Tag aus der Ressourcengruppe entfernt**
```
Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances
```
**Ausgabe:**
```
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}
```
+ Weitere API-Informationen finden Sie unter [Untag](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*.
### `Update-RGGroup`
Das folgende Codebeispiel zeigt, wie man es benutzt`Update-RGGroup`.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Beschreibung der Gruppe aktualisiert**
```
Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove"
```
**Ausgabe:**
```
Description GroupArn Name
----------- -------- ----
Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes
```
+ Einzelheiten zur API finden Sie unter [UpdateGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-RGGroupQuery`
Das folgende Codebeispiel zeigt die Verwendung. `Update-RGGroupQuery`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Abfrageobjekt erstellt und die Abfrage für die Gruppe aktualisiert.**
```
$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
```
**Ausgabe:**
```
GroupName ResourceQuery
--------- -------------
build600 Amazon.ResourceGroups.Model.ResourceQuery
```
+ Einzelheiten zur API finden Sie unter [UpdateGroupQuery AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# API-Beispiele für Ressourcengruppen-Tagging mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe der AWS -Tools für PowerShell V5 with Resource Groups Tagging-API Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-RGTResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Add-RGTResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Tag-Schlüssel „stage“ und „version“ mit den Werten „beta“ und „preprod\$1test“ zu einem Amazon-S3-Bucket und einer Amazon-DynamoDB-Tabelle hinzugefügt. Es wird ein einziger Aufruf an den Service gesendet, um die Tags anzuwenden.**
```
$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" }
```
**Beispiel 2: In diesem Beispiel werden die angegebenen Tags und Werte zu einem Amazon-S3-Bucket und einer Amazon-DynamoDB-Tabelle hinzugefügt. Es werden zwei Aufrufe an den Service gesendet, einer für jede Ressource-ARN, die in das Cmdlet übergeben wird.**
```
$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" }
```
+ Einzelheiten zur API finden Sie unter [TagResources AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-RGTResource`
Das folgende Codebeispiel zeigt die Verwendung. `Get-RGTResource`
**Tools für PowerShell V5**
**Beispiel 1: Gibt alle markierten Ressourcen in einer Region und die mit der Ressource verbundenen Tag-Schlüssel zurück. Wenn dem Cmdlet kein -Region-Parameter angegeben wird, versucht es, die Region aus den Shell- oder Instanz-Metadaten abzuleiten. EC2 **
```
Get-RGTResource
```
**Ausgabe:**
```
ResourceARN Tags
----------- ----
arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version}
arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag}
```
**Beispiel 2: Gibt alle markierten Ressourcen des angegebenen Typs in einer Region zurück. Die Zeichenfolge für jeden Servicenamen und Ressourcentyp entspricht der Zeichenfolge, die im Amazon-Ressourcennamen (ARN) einer Ressource eingebettet ist.**
```
Get-RGTResource -ResourceType "s3"
```
**Ausgabe:**
```
ResourceARN Tags
----------- ----
arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag}
```
**Beispiel 3: Gibt alle markierten Ressourcen des angegebenen Typs in einer Region zurück. Beachten Sie, dass beim Übergeben der Ressourcentypen an das Cmdlet für jeden angegebenen Ressourcentyp ein Aufruf des Services erfolgt.**
```
"dynamodb","s3" | Get-RGTResource
```
**Ausgabe:**
```
ResourceARN Tags
----------- ----
arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version}
arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag}
```
**Beispiel 4: Gibt alle markierten Ressourcen zurück, die dem angegebenen Filter entsprechen.**
```
Get-RGTResource -TagFilter @{ Key="stage" }
```
**Ausgabe:**
```
ResourceARN Tags
----------- ----
arn:aws:s3:::amzn-s3-demo-bucket {stage, version, othertag}
```
**Beispiel 5: Gibt alle markierten Ressourcen zurück, die dem angegebenen Filter und Ressourcentyp entsprechen.**
```
Get-RGTResource -TagFilter @{ Key="stage" } -ResourceType "dynamodb"
```
**Ausgabe:**
```
ResourceARN Tags
----------- ----
arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version}
```
**Beispiel 6: Gibt alle markierten Ressourcen zurück, die dem angegebenen Filter entsprechen.**
```
Get-RGTResource -TagFilter @{ Key="stage"; Values=@("beta","gamma") }
```
**Ausgabe:**
```
ResourceARN Tags
----------- ----
arn:aws:dynamodb:us-west-2:123456789012:table/mytable {stage, version}
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([GetResources](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Get-RGTTagKey`
Das folgende Codebeispiel zeigt die Verwendung. `Get-RGTTagKey`
**Tools für PowerShell V5**
**Beispiel 1: Gibt alle Tag-Schlüssel in der angegebenen Region zurück. Wenn der Parameter -Region nicht angegeben ist, versucht das Cmdlet, die Region aus den Metadaten der Standard-Shellregion oder der Instanz abzuleiten. EC2 Beachten Sie, dass die Tag-Schlüssel nicht in einer bestimmten Reihenfolge zurückgegeben werden.**
```
Get-RGTTagKey -region us-west-2
```
**Ausgabe:**
```
version
stage
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([GetTagKeys](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Get-RGTTagValue`
Das folgende Codebeispiel zeigt die Verwendung. `Get-RGTTagValue`
**Tools für PowerShell V5**
**Beispiel 1: Gibt den Wert für das angegebene Tag in einer Region zurück. Wenn der Parameter -Region nicht angegeben ist, versucht das Cmdlet, die Region aus den Metadaten der Standard-Shellregion oder der Instanz abzuleiten. EC2 **
```
Get-RGTTagValue -Key "stage" -Region us-west-2
```
**Ausgabe:**
```
beta
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([GetTagValues](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Remove-RGTResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-RGTResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Entfernt die Tag-Schlüssel „stage“ und „version“ sowie die zugehörigen Werte aus einem Amazon-S3-Bucket und einer Amazon-DynamoDB-Tabelle. Es wird ein einziger Aufruf an den Dienst gesendet, um die Tags zu entfernen. Bevor die Tags entfernt werden, fordert das Cmdlet zur Bestätigung auf. Um die Bestätigung zu umgehen, fügen Sie den Parameter -Force hinzu.**
```
$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"
```
**Beispiel 2: Entfernt die Tag-Schlüssel „stage“ und „version“ sowie die zugehörigen Werte aus einem Amazon-S3-Bucket und einer Amazon-DynamoDB-Tabelle. Es werden zwei Aufrufe an den Service gesendet, einer für jede Ressource-ARN, die in das Cmdlet übergeben wird. Vor jedem Aufruf fordert das Cmdlet zur Bestätigung auf. Um die Bestätigung zu umgehen, fügen Sie den Parameter -Force hinzu.**
```
$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"
```
+ Einzelheiten zur API finden Sie unter [UntagResources AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Route-53-Beispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit Route 53 verwenden.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Edit-R53ResourceRecordSet`
Das folgende Codebeispiel zeigt die Verwendung `Edit-R53ResourceRecordSet` von.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein A-Eintrag für www.example.com erstellt und der A-Eintrag für test.example.com von 192.0.2.3 in 192.0.2.1 geändert. Beachten Sie, dass Werte für Änderungen an TXT-Datensätzen in doppelten Anführungszeichen stehen müssen. Weitere Informationen finden Sie in der Dokumentation zu Amazon Route 53 Sie können das Get-R53Change Cmdlet verwenden, um abzufragen, wann die Änderungen abgeschlossen sind.**
```
$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 = @()
$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 = @()
$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 = @()
$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
```
**Beispiel 2: Dieses Beispiel zeigt, wie Alias-Ressourceneinträge erstellt werden. „Z222222222“ ist die ID der von Amazon Route 53 gehosteten Zone, in der Sie den Alias-Ressourceneintragssatz erstellen. „example.com“ ist der Zonenapex, für den Sie einen Alias erstellen möchten, und „www.example.com“ ist eine Subdomain, für die Sie ebenfalls einen Alias erstellen möchten. 'Z1111111111111' ist ein Beispiel für eine Hosting-Zonen-ID für den Load Balancer und 'example-load-balancer-1111111111.us-east-1.elb.amazonaws.com' ist ein Beispiel für einen Load Balancer-Domainnamen, mit dem Amazon Route 53 auf Anfragen für example.com und www.example.com antwortet. Weitere Informationen finden Sie in der Dokumentation zu Amazon Route 53 Sie können das Cmdlet verwenden, um abzufragen, wann die Änderungen abgeschlossen sind. Get-R53Change**
```
$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
```
**Beispiel 3: In diesem Beispiel werden zwei A-Einträge für www.example.com erstellt. In einem Viertel der Fälle (1/(1\$13)) antwortet Amazon Route 53 auf Anfragen für www.example.com mit den beiden Werten für den ersten Ressourceneintrag (192.0.2.9 und 192.0.2.10). In drei Viertel der Fälle (3/(1\$13)) antwortet Amazon Route 53 auf Anfragen für www.example.com mit den beiden Werten für den zweiten Ressourceneintrag (192.0.2.11 und 192.0.2.12). Weitere Informationen finden Sie in der Dokumentation zu Amazon Route 53 Mit dem Get-R53Change Cmdlet können Sie abfragen, wann die Änderungen abgeschlossen sind.**
```
$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 = @()
$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 = @()
$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
```
**Beispiel 4: Dieses Beispiel zeigt, wie gewichtete Alias-Ressourcendatensätze erstellt werden, vorausgesetzt, dass example.com die Domain ist, für die Sie gewichtete Alias-Ressourcendatensätze erstellen möchten. SetIdentifier unterscheidet die beiden gewichteten Alias-Ressourcendatensätze voneinander. Dieses Element ist erforderlich, da die Elemente „Name“ und „Type“ für beide Ressourceneintragsätze dieselben Werte haben. Z111111111111111 und Z3333333333333 sind Beispiele für gehostete Zonen für den ELB-Load Balancer, angegeben durch den Wert von. IDs DNSName example-load-balancer-2222222222.us-east-1.elb.amazonaws.com und example-load-balancer -4444444444.us-east-1.elb.amazonaws.com sind Beispiele für Elastic Load Balancing Balancing-Domains, von denen Amazon Route 53 auf Anfragen für example.com antwortet. Weitere Informationen finden Sie in der Dokumentation zu Amazon Route 53 Sie können das Cmdlet verwenden, um abzufragen, wann die Änderungen Get-R53Change abgeschlossen sind.**
```
$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
```
**Beispiel 5: In diesem Beispiel werden zwei Latenz-Alias-Ressourceneinträge erstellt, einer für einen ELB-Load Balancer in der Region US-West (Oregon) (us-west-2) und einer für einen Load Balancer in der Region Asien-Pazifik (Singapur) (ap-southeast-1). Weitere Informationen finden Sie in der Dokumentation zu Amazon Route 53 Mit dem Get-R53Change Cmdlet können Sie abfragen, wann die Änderungen abgeschlossen sind.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [ChangeResourceRecordSets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-R53AccountLimit`
Das folgende Codebeispiel zeigt die Verwendung. `Get-R53AccountLimit`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die maximale Anzahl von gehosteten Zonen zurückgegeben, die mit dem aktuellen Konto erstellt werden können.**
```
Get-R53AccountLimit -Type MAX_HOSTED_ZONES_BY_OWNER
```
**Ausgabe:**
```
15
```
+ Einzelheiten zur API finden Sie unter [GetAccountLimit AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-R53CheckerIpRanges`
Das folgende Codebeispiel zeigt die Verwendung. `Get-R53CheckerIpRanges`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die CIDRs Integritätsprüfungen für Route53 zurückgegeben**
```
Get-R53CheckerIpRanges
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetCheckerIpRanges AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-R53HostedZone`
Das folgende Codebeispiel zeigt die Verwendung. `Get-R53HostedZone`
**Tools für PowerShell V5**
**Beispiel 1: Gibt Details der gehosteten Zone mit der ID PJN98 FT9 Z1D633 zurück.**
```
Get-R53HostedZone -Id Z1D633PJN98FT9
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([GetHostedZone](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Get-R53HostedZoneCount`
Das folgende Codebeispiel zeigt die Verwendung. `Get-R53HostedZoneCount`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Gesamtzahl der öffentlichen und privaten gehosteten Zonen für die aktuelle AWS-Konto Version zurück.**
```
Get-R53HostedZoneCount
```
+ Einzelheiten zur API finden Sie unter [GetHostedZoneCount AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-R53HostedZoneLimit`
Das folgende Codebeispiel zeigt die Verwendung. `Get-R53HostedZoneLimit`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Limit für die maximale Anzahl von Datensätzen zurückgegeben, die in der angegebenen gehosteten Zone erstellt werden können.**
```
Get-R53HostedZoneLimit -HostedZoneId Z3MEQ8T7HAAAAF -Type MAX_RRSETS_BY_ZONE
```
**Ausgabe:**
```
5
```
+ Einzelheiten zur API finden Sie unter [GetHostedZoneLimit AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-R53HostedZoneList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-R53HostedZoneList`
**Tools für PowerShell V5**
**Beispiel 1: Gibt alle Ihre öffentlichen und privaten gehosteten Zonen aus.**
```
Get-R53HostedZoneList
```
**Beispiel 2: Gibt alle Hosting-Zonen aus, die dem wiederverwendbaren Delegierungssatz mit der ID NZ8 X2CISAMPLE zugeordnet sind**
```
Get-R53HostedZoneList -DelegationSetId NZ8X2CISAMPLE
```
+ Einzelheiten zur API finden Sie unter [ListHostedZones AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-R53HostedZonesByName`
Das folgende Codebeispiel zeigt die Verwendung. `Get-R53HostedZonesByName`
**Tools für PowerShell V5**
**Beispiel 1: Gibt alle Ihre öffentlichen und privaten gehosteten Zonen in ASCII-Reihenfolge nach Domainnamen zurück.**
```
Get-R53HostedZonesByName
```
**Beispiel 2: Gibt Ihre öffentlichen und privaten gehosteten Zonen in ASCII-Reihenfolge nach Domainnamen zurück, beginnend mit dem angegebenen DNS-Namen.**
```
Get-R53HostedZonesByName -DnsName example2.com
```
+ Einzelheiten zur API finden Sie unter [ListHostedZonesByName AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-R53QueryLoggingConfigList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-R53QueryLoggingConfigList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Konfigurationen für die DNS-Abfrageprotokollierung zurückgegeben, die mit dem aktuellen AWS-Konto verknüpft sind.**
```
Get-R53QueryLoggingConfigList
```
**Ausgabe:**
```
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:*
```
+ Einzelheiten zur API finden Sie unter [ListQueryLoggingConfigs AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-R53ReusableDelegationSet`
Das folgende Codebeispiel zeigt die Verwendung. `Get-R53ReusableDelegationSet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen über den angegebenen Delegationssatz abgerufen, einschließlich der vier Nameserver, die dem Delegationssatz zugewiesen sind.**
```
Get-R53ReusableDelegationSet -Id N23DS9X4AYEAAA
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [GetReusableDelegationSet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-R53HostedZone`
Das folgende Codebeispiel zeigt die Verwendung. `New-R53HostedZone`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt eine neue gehostete Zone namens „example.com“, die mit einem wiederverwendbaren Delegationssatz verknüpft ist. Beachten Sie, dass Sie einen Wert für den CallerReference Parameter angeben müssen, damit Anfragen, die bei Bedarf wiederholt werden müssen, ohne das Risiko eingehen zu müssen, dass der Vorgang zweimal ausgeführt wird. Da die gehostete Zone in einer VPC erstellt wird, ist sie automatisch privat und Sie sollten den PrivateZone Parameter - HostedZoneConfig \$1 nicht festlegen.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [CreateHostedZone AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-R53QueryLoggingConfig`
Das folgende Codebeispiel zeigt die Verwendung. `New-R53QueryLoggingConfig`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine neue Route53-DNS-Abfrageprotokollierungskonfiguration für die angegebene gehostete Zone erstellt. Amazon Route53 veröffentlicht DNS-Abfrageprotokolle in der angegebenen Cloudwatch-Protokollgruppe.**
```
New-R53QueryLoggingConfig -HostedZoneId Z3MEQ8T7HAAAAF -CloudWatchLogsLogGroupArn arn:aws:logs:us-east-1:111111111111:log-group:/aws/route53/example.com:*
```
**Ausgabe:**
```
QueryLoggingConfig Location
------------------ --------
Amazon.Route53.Model.QueryLoggingConfig https://route53.amazonaws.com/2013-04-01/queryloggingconfig/ee5aaa95-4e03-4fdc-9d28-9e24ddaaaaa3
```
+ Einzelheiten zur API finden Sie unter [CreateQueryLoggingConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-R53ReusableDelegationSet`
Das folgende Codebeispiel zeigt die Verwendung. `New-R53ReusableDelegationSet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein wiederverwendbarer Delegationssatz mit vier Nameservern erstellt, der von mehreren gehosteten Zonen wiederverwendet werden kann.**
```
New-R53ReusableDelegationSet -CallerReference testcallerreference
```
**Ausgabe:**
```
DelegationSet Location
------------- --------
Amazon.Route53.Model.DelegationSet https://route53.amazonaws.com/2013-04-01/delegationset/N23DS9XAAAAAXM
```
+ Einzelheiten zur API finden Sie unter [CreateReusableDelegationSet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-R53VPCWithHostedZone`
Das folgende Codebeispiel zeigt die Verwendung. `Register-R53VPCWithHostedZone`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene VPC mit der privaten gehosteten Zone verknüpft.**
```
Register-R53VPCWithHostedZone -HostedZoneId Z3MEQ8T7HAAAAF -VPC_VPCId vpc-f1b9aaaa -VPC_VPCRegion us-east-1
```
**Ausgabe:**
```
Id Status SubmittedAt Comment
-- ------ ----------- -------
/change/C3SCAAA633Z6DX PENDING 01/28/2020 19:32:02
```
+ API-Einzelheiten finden Sie unter [Associate VPCWith HostedZone](https://docs.aws.amazon.com/powershell/v5/reference) in *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `Remove-R53HostedZone`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-R53HostedZone`
**Tools für PowerShell V5**
**Beispiel 1: Löscht die gehostete Zone mit der angegebenen ID. Sie werden zur Bestätigung aufgefordert, bevor der Befehl ausgeführt wird, es sei denn, Sie fügen den Schalterparameter -Force hinzu.**
```
Remove-R53HostedZone -Id Z1PA6795UKMFR9
```
+ Einzelheiten zur API finden Sie unter [DeleteHostedZone AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-R53QueryLoggingConfig`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-R53QueryLoggingConfig`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Konfiguration für die Protokollierung von DNS-Abfragen entfernt.**
```
Remove-R53QueryLoggingConfig -Id ee528e95-4e03-4fdc-9d28-9e24daaa20063
```
+ Einzelheiten zur API finden Sie unter [DeleteQueryLoggingConfig AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-R53ReusableDelegationSet`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-R53ReusableDelegationSet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der angegebene wiederverwendbare Delegationssatz gelöscht.**
```
Remove-R53ReusableDelegationSet -Id N23DS9X4AYAAAM
```
+ Einzelheiten zur API finden Sie unter [DeleteReusableDelegationSet AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-R53VPCFromHostedZone`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-R53VPCFromHostedZone`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene VPC von der privaten gehosteten Zone getrennt.**
```
Unregister-R53VPCFromHostedZone -HostedZoneId Z3MEQ8T7HAAAAF -VPC_VPCId vpc-f1b9aaaa -VPC_VPCRegion us-east-1
```
**Ausgabe:**
```
Id Status SubmittedAt Comment
-- ------ ----------- -------
/change/C2XFCAAAA9HKZG PENDING 01/28/2020 10:35:55
```
+ Einzelheiten zur API finden Sie unter [Disassociate VPCFrom HostedZone](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz* (V5).
### `Update-R53HostedZoneComment`
Das folgende Codebeispiel zeigt die Verwendung. `Update-R53HostedZoneComment`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl aktualisiert den Kommentar für die angegebene gehostete Zone.**
```
Update-R53HostedZoneComment -Id Z385PDS6AAAAAR -Comment "This is my first hosted zone"
```
**Ausgabe:**
```
Id : /hostedzone/Z385PDS6AAAAAR
Name : example.com.
CallerReference : C5B55555-7147-EF04-8341-69131E805C89
Config : Amazon.Route53.Model.HostedZoneConfig
ResourceRecordSetCount : 9
LinkedService :
```
+ Einzelheiten zur API finden Sie unter [UpdateHostedZoneComment AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Amazon S3 S3-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe der AWS -Tools für PowerShell V5 mit Amazon S3 Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Copy-S3Object`
Das folgende Codebeispiel zeigt die Verwendung `Copy-S3Object` von.
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl kopiert das Objekt „sample.txt” aus dem Bucket „test-files” in denselben Bucket, jedoch mit einem neuen Schlüssel „sample-copy.txt”.**
```
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -DestinationKey sample-copy.txt
```
**Beispiel 2: Dieser Befehl kopiert das Objekt „sample.txt” aus dem Bucket „test-files” in den Bucket „backup-files” mit dem Schlüssel „sample-copy.txt”.**
```
Copy-S3Object -BucketName amzn-s3-demo-source-bucket -Key sample.txt -DestinationKey sample-copy.txt -DestinationBucket amzn-s3-demo-destination-bucket
```
**Beispiel 3: Dieser Befehl lädt das Objekt „sample.txt” aus dem Bucket „test-files” in eine lokale Datei mit dem Namen „local-sample.txt” herunter.**
```
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -LocalFile local-sample.txt
```
**Beispiel 4: Lädt das einzelne Objekt in die angegebene Datei herunter. Die heruntergeladene Datei befindet sich unter c:\$1downloads\$1data\$1archive.zip**
```
Copy-S3Object -BucketName amzn-s3-demo-bucket -Key data/archive.zip -LocalFolder c:\downloads
```
**Beispiel 5: Lädt alle Objekte, die mit dem angegebenen Schlüsselpräfix übereinstimmen, in den lokalen Ordner herunter. Die relative Schlüsselhierarchie wird als Unterordner im gesamten Download-Speicherort beibehalten.**
```
Copy-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix data -LocalFolder c:\downloads
```
+ Einzelheiten zur API finden Sie unter [CopyObject AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3Bucket`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3Bucket`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt alle S3-Buckets zurück.**
```
Get-S3Bucket
```
**Beispiel 2: Dieser Befehl gibt einen Bucket mit dem Namen „test-files“ zurück**
```
Get-S3Bucket -BucketName amzn-s3-demo-bucket
```
+ Einzelheiten zur API finden Sie unter [ListBuckets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketACL`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketACL`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl ruft die Details des Objektbesitzers des S3-Objekts ab.**
```
(Get-S3BucketACL -BucketName 'amzn-s3-demo-bucket' -Select *).Owner
```
**Ausgabe:**
```
DisplayName Id
----------- --
testusername 9988776a6554433d22f1100112e334acb45566778899009e9887bd7f66c5f544
```
+ Einzelheiten zur API finden Sie unter [GetBucketAcl AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketAccelerateConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketAccelerateConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt den Wert „Enabled“ zurück, wenn die Übertragungsbeschleunigungseinstellungen für den angegebenen Bucket aktiviert sind.**
```
Get-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket'
```
**Ausgabe:**
```
Value
-----
Enabled
```
+ Einzelheiten zur API finden Sie unter [GetBucketAccelerateConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketAnalyticsConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketAnalyticsConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Details des Analysefilters mit dem Namen „testfilter” im angegebenen S3-Bucket zurück.**
```
Get-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'
```
+ Einzelheiten zur API finden Sie unter [GetBucketAnalyticsConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketAnalyticsConfigurationList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketAnalyticsConfigurationList`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die ersten 100 Analysekonfigurationen des angegebenen S3-Buckets zurück.**
```
Get-S3BucketAnalyticsConfigurationList -BucketName 'amzn-s3-demo-bucket'
```
+ Einzelheiten zur API finden Sie unter [ListBucketAnalyticsConfigurations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketEncryption`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketEncryption`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt alle serverseitigen Verschlüsselungsregeln zurück, die dem angegebenen Bucket zugeordnet sind.**
```
Get-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'
```
+ Einzelheiten zur API finden Sie unter [GetBucketEncryption AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketInventoryConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketInventoryConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Details des Inventars mit dem Namen „testinventory” für den angegebenen S3-Bucket zurück.**
```
Get-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testinventory'
```
+ Einzelheiten zur API finden Sie unter [GetBucketInventoryConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketInventoryConfigurationList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketInventoryConfigurationList`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die ersten 100 Inventarkonfigurationen des angegebenen S3-Buckets zurück.**
```
Get-S3BucketInventoryConfigurationList -BucketName 'amzn-s3-demo-bucket'
```
+ Einzelheiten zur API finden Sie unter [ListBucketInventoryConfigurations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketLocation`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketLocation`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Standortbeschränkung für den Bucket „amzn-s3-demo-bucket“ zurück, sofern eine Beschränkung vorhanden ist.**
```
Get-S3BucketLocation -BucketName 'amzn-s3-demo-bucket'
```
**Ausgabe:**
```
Value
-----
ap-south-1
```
+ Einzelheiten zur API finden Sie unter [GetBucketLocation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketLogging`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketLogging`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt den Protokollierungsstatus für den angegebenen Bucket zurück.**
```
Get-S3BucketLogging -BucketName 'amzn-s3-demo-bucket'
```
**Ausgabe:**
```
TargetBucketName Grants TargetPrefix
---------------- ------ ------------
testbucket1 {} testprefix
```
+ Einzelheiten zur API finden Sie unter [GetBucketLogging AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketMetricsConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketMetricsConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Details zum Metrikfilter mit dem Namen „testfilter” für den angegebenen S3-Bucket zurück.**
```
Get-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testfilter'
```
+ Einzelheiten zur API finden Sie unter [GetBucketMetricsConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketNotification`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketNotification`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Benachrichtigungskonfiguration des angegebenen Buckets abgerufen.**
```
Get-S3BucketNotification -BucketName amzn-s3-demo-bucket | select -ExpandProperty TopicConfigurations
```
**Ausgabe:**
```
Id Topic
-- -----
mimo arn:aws:sns:eu-west-1:123456789012:topic-1
```
+ Einzelheiten zur API finden Sie unter [GetBucketNotification AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketPolicy`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die mit dem angegebenen S3-Bucket verknüpfte Bucket-Richtlinie aus.**
```
Get-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'
```
+ Einzelheiten zur API finden Sie unter [GetBucketPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketPolicyStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketPolicyStatus`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt den Richtlinienstatus für den angegebenen S3-Bucket zurück und gibt an, ob der Bucket öffentlich ist.**
```
Get-S3BucketPolicyStatus -BucketName 'amzn-s3-demo-bucket'
```
+ Einzelheiten zur API finden Sie unter [GetBucketPolicyStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketReplication`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketReplication`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die informationen der Replikationskonfiguration zurück, die für den Bucket mit dem Namen „amzn-s3-demo-bucket“ festgelegt wurden.**
```
Get-S3BucketReplication -BucketName amzn-s3-demo-bucket
```
+ Einzelheiten zur API finden Sie unter [GetBucketReplication AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketRequestPayment`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketRequestPayment`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Zahlungsanforderungskonfiguration für den Bucket mit dem Namen „amzn-s3-demo-bucket“ zurück. Standardmäßig zahlt der Bucket-Eigentümer für die Downloads aus dem Bucket.**
```
Get-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket
```
+ Einzelheiten zur API finden Sie unter [GetBucketRequestPayment AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketTagging`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketTagging`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt alle Tags zurück, die mit dem angegebenen Bucket verknüpft sind.**
```
Get-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'
```
+ Einzelheiten zur API finden Sie unter [GetBucketTagging AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketVersioning`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketVersioning`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt den Status der Versionierung in Bezug auf den angegebenen Bucket zurück.**
```
Get-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket'
```
+ Einzelheiten zur API finden Sie unter [GetBucketVersioning AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3BucketWebsite`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3BucketWebsite`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Details der statischen Website-Konfigurationen des angegebenen S3-Buckets zurück.**
```
Get-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'
```
+ Einzelheiten zur API finden Sie unter [GetBucketWebsite AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3CORSConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3CORSConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt ein Objekt zurück, das alle CORS-Konfigurationsregeln enthält, die dem angegebenen S3-Bucket entsprechen.**
```
Get-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket' -Select Configuration.Rules
```
**Ausgabe:**
```
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 : {}
```
+ Einzelheiten zur API finden Sie unter [Get CORSConfiguration](https://docs.aws.amazon.com/powershell/v5/reference) in *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `Get-S3HeadBucket`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3HeadBucket`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Ausgabe mit dem HTTP-Statuscode 200 OK für einen vorhandenen Bucket zurück, wenn der Benutzer die Erlaubnis hat, darauf zuzugreifen. BucketArn Der Parameter wird nur für S3-Verzeichnis-Buckets unterstützt**.
```
Get-S3HeadBucket -BucketName amzn-s3-demo-bucket
```
**Ausgabe:**
```
AccessPointAlias : False
BucketArn :
BucketLocationName :
BucketLocationType :
BucketRegion : us-east-2
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 0
HttpStatusCode : OK
```
**Beispiel 2: Dieser Befehl gibt einen Fehler mit HTTP-Statuscode NotFound für einen nicht existierenden Bucket aus.**
```
Get-S3HeadBucket -BucketName amzn-s3-non-existing-bucket
```
**Ausgabe:**
```
Get-S3HeadBucket: Error making request with Error Code NotFound and Http Status Code NotFound. No further error information was returned by the service.
```
**Beispiel 3: Dieser Befehl löst einen Fehler mit dem HTTP-Statuscode „Forbidden“ für einen vorhandenen Bucket aus, auf den der Benutzer keine Zugriffsberechtigung hat.**
```
Get-S3HeadBucket -BucketName amzn-s3-no-access-bucket
```
**Ausgabe:**
```
Get-S3HeadBucket: Error making request with Error Code Forbidden and Http Status Code Forbidden. No further error information was returned by the service.
```
+ Einzelheiten zur API finden Sie unter [HeadBucket AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-S3LifecycleConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3LifecycleConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Lebenszykluskonfiguration für den Bucket abgerufen.**
```
Get-S3LifecycleConfiguration -BucketName amzn-s3-demo-bucket
```
**Ausgabe:**
```
Rules
-----
{Remove-in-150-days, Archive-to-Glacier-in-30-days}
```
+ Einzelheiten zur API finden Sie unter [GetLifecycleConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3Object`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3Object`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl ruft die Informationen über alle Elemente im Bucket „test-files“ ab.**
```
Get-S3Object -BucketName amzn-s3-demo-bucket
```
**Beispiel 2: Dieser Befehl ruft die Informationen über das Objekt „sample.txt“ aus dem Bucket „test-files“ ab.**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt
```
**Beispiel 3: Dieser Befehl ruft die Informationen über alle Elemente mit dem Präfix „sample“ aus dem Bucket „test-files“ ab.**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample
```
+ Einzelheiten zur API finden Sie unter [ListObjects AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3ObjectACL`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3ObjectACL`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl ruft die Details des Objektbesitzers des S3-Objekts ab.**
```
(Get-S3ObjectACL -BucketName 'amzn-s3-demo-bucket' -key 'initialize.ps1' -Select *).Owner
```
**Ausgabe:**
```
DisplayName Id
----------- --
testusername 9988776a6554433d22f1100112e334acb45566778899009e9887bd7f66c5f544
```
+ Einzelheiten zur API finden Sie unter [GetObjectAcl AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3ObjectLockConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3ObjectLockConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt den Wert „Enabled“ zurück, wenn die Objektsperrkonfiguration für den angegebenen S3-Bucket aktiviert ist.**
```
Get-S3ObjectLockConfiguration -BucketName 'amzn-s3-demo-bucket' -Select ObjectLockConfiguration.ObjectLockEnabled
```
**Ausgabe:**
```
Value
-----
Enabled
```
+ Einzelheiten zur API finden Sie unter [GetObjectLockConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3ObjectMetadata`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3ObjectMetadata`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Metadaten des Objekts mit dem Schlüssel 'ListTrusts.txt' im angegebenen S3-Bucket zurück.**
```
Get-S3ObjectMetadata -BucketName 'amzn-s3-demo-bucket' -Key 'ListTrusts.txt'
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [GetObjectMetadata AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-S3ObjectRetention`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3ObjectRetention`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl gibt den Modus und das Datum zurück, bis das Objekt aufbewahrt wird.**
```
Get-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt'
```
+ Einzelheiten zur API finden Sie unter [GetObjectRetention AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3ObjectTagSet`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3ObjectTagSet`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Tags zurückgegeben, die mit dem Objekt im angegebenen S3-Bucket verknüpft sind.**
```
Get-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket'
```
**Ausgabe:**
```
Key Value
--- -----
test value
```
+ Einzelheiten zur API finden Sie unter [GetObjectTagging AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3PreSignedURL`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3PreSignedURL`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl gibt eine vorab signierte URL für einen angegebenen Schlüssel und ein Ablaufdatum zurück.**
```
Get-S3PreSignedURL -BucketName 'amzn-s3-demo-bucket' -Key 'testkey' -Expires '2023-11-16'
```
**Beispiel 2: Der Befehl gibt eine vorab signierte URL für einen Verzeichnis-Bucket mit angegebenem Schlüssel und ein Ablaufdatum zurück.**
```
[Amazon.AWSConfigsS3]::UseSignatureVersion4 = $true
Get-S3PreSignedURL -BucketName amzn-s3-demo-bucket--usw2-az1--x-s3 -Key 'testkey' -Expire '2023-11-17'
```
+ Einzelheiten zur API finden Sie unter [GetPreSignedURL](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `Get-S3PublicAccessBlock`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3PublicAccessBlock`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl gibt die Konfiguration der öffentlichen Zugriffssperre des angegebenen S3-Buckets zurück.**
```
Get-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket'
```
+ Einzelheiten zur API finden Sie unter [GetPublicAccessBlock AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-S3Version`
Das folgende Codebeispiel zeigt die Verwendung. `Get-S3Version`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Metadaten zu allen Versionen von Objekten im angegebenen S3-Bucket zurück.**
```
Get-S3Version -BucketName 'amzn-s3-demo-bucket'
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [ListVersions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-S3Bucket`
Das folgende Codebeispiel zeigt die Verwendung. `New-S3Bucket`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl erstellt einen neuen privaten Bucket mit dem Namen „sample-bucket“.**
```
New-S3Bucket -BucketName amzn-s3-demo-bucket
```
**Beispiel 2: Dieser Befehl erstellt einen neuen Bucket mit dem Namen „sample-bucket“ mit Lese- und Schreibberechtigungen.**
```
New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadWrite
```
**Beispiel 3: Dieser Befehl erstellt einen neuen Bucket mit dem Namen „sample-bucket“ mit Leseberechtigungen.**
```
New-S3Bucket -BucketName amzn-s3-demo-bucket -PublicReadOnly
```
**Beispiel 4: Dieser Befehl erstellt einen neuen Verzeichnis-Bucket mit dem Namen „amzn-s3-demo-bucket--use1-az5--x-s3" mit. 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
```
+ Einzelheiten zur [PutBucket](https://docs.aws.amazon.com/powershell/v5/reference)API *AWS -Tools für PowerShell finden Sie unter* Cmdlet-Referenz (V5).
### `Read-S3Object`
Das folgende Codebeispiel zeigt die Verwendung. `Read-S3Object`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl ruft das Objekt "sample.txt" aus dem Bucket „amzn-s3-demo-bucket“ ab und speichert es in einer Datei mit dem Namen "local-sample.txt" am aktuellen Speicherort. Die Datei „local-sample.txt” muss vor dem Aufruf dieses Befehls nicht vorhanden sein.**
```
Read-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -File local-sample.txt
```
**Beispiel 2: Dieser Befehl ruft das virtuelle Verzeichnis „DIR“ aus dem Bucket „amzn-s3-demo-bucket“ ab und speichert es in einem Ordner mit dem Namen „Local-dir“ am aktuellen Speicherort. Der Ordner „Local-DIR“ muss vor dem Aufruf dieses Befehls nicht vorhanden sein.**
```
Read-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix DIR -Folder Local-DIR
```
**Beispiel 3: Lädt alle Objekte mit Schlüsseln, die auf „.json“ enden, aus Buckets, deren Name „config“ enthält, in Dateien im angegebenen Ordner herunter. Die Objektschlüssel werden verwendet, um die Dateinamen festzulegen.**
```
Get-S3Bucket | ? { $_.BucketName -like '*config*' } | Get-S3Object | ? { $_.Key -like '*.json' } | Read-S3Object -Folder C:\ConfigObjects
```
+ *Einzelheiten zur API finden Sie unter Cmdlet-Referenz (V5). [GetObject](https://docs.aws.amazon.com/powershell/v5/reference)AWS -Tools für PowerShell *
### `Remove-S3Bucket`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3Bucket`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl entfernt alle Objekte und Objektversionen aus dem Bucket „test-files“ und löscht anschließend den Bucket. Der Befehl fordert Sie auf, den Vorgang zu bestätigen, bevor er ausgeführt wird. Fügen Sie den Schalter -Force hinzu, um die Bestätigung zu unterdrücken. Beachten Sie, dass nicht leere Buckets nicht gelöscht werden können.**
```
Remove-S3Bucket -BucketName amzn-s3-demo-bucket -DeleteBucketContent
```
+ Einzelheiten zur API finden Sie unter [DeleteBucket AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-S3BucketAnalyticsConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3BucketAnalyticsConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl entfernt den Analysefilter mit dem Namen „testfilter” im angegebenen S3-Bucket.**
```
Remove-S3BucketAnalyticsConfiguration -BucketName 'amzn-s3-demo-bucket' -AnalyticsId 'testfilter'
```
+ Einzelheiten zur API finden Sie unter [DeleteBucketAnalyticsConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-S3BucketEncryption`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3BucketEncryption`
**Tools für PowerShell V5**
**Beispiel 1: Dadurch wird die für den angegebenen S3-Bucket aktivierte Verschlüsselung deaktiviert.**
```
Remove-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteBucketEncryption AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-S3BucketInventoryConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3BucketInventoryConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl entfernt das Inventar mit dem Namen 'testInventoryName', das dem angegebenen S3-Bucket entspricht.**
```
Remove-S3BucketInventoryConfiguration -BucketName 'amzn-s3-demo-bucket' -InventoryId 'testInventoryName'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteBucketInventoryConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Remove-S3BucketMetricsConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3BucketMetricsConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl entfernt den Metrikfilter mit dem Namen „testmetrics” im angegebenen S3-Bucket.**
```
Remove-S3BucketMetricsConfiguration -BucketName 'amzn-s3-demo-bucket' -MetricsId 'testmetrics'
```
+ Einzelheiten zur API finden Sie unter [DeleteBucketMetricsConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-S3BucketPolicy`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3BucketPolicy`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl entfernt die mit dem angegebenen S3-Bucket verknüpfte Bucket-Richtlinie.**
```
Remove-S3BucketPolicy -BucketName 'amzn-s3-demo-bucket'
```
+ Einzelheiten zur API finden Sie unter [DeleteBucketPolicy AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-S3BucketReplication`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3BucketReplication`
**Tools für PowerShell V5**
**Beispiel 1: Löscht die Replikationskonfiguration, die mit dem Bucket namens „amzn-s3-demo-bucket“ verknüpft ist. Beachten Sie, dass für diesen Vorgang eine Genehmigung für die DeleteReplicationConfiguration Aktion s3: erforderlich ist. Sie werden vor der Ausführung des Vorgangs zur Bestätigung aufgefordert. Um die Bestätigung zu unterdrücken, verwenden Sie den Schalter -Force.**
```
Remove-S3BucketReplication -BucketName amzn-s3-demo-bucket
```
+ Einzelheiten zur API finden Sie unter [DeleteBucketReplication AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Remove-S3BucketTagging`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3BucketTagging`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl entfernt alle Tags, die mit dem angegebenen Bucket verknüpft sind.**
```
Remove-S3BucketTagging -BucketName 'amzn-s3-demo-bucket'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteBucketTagging AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-S3BucketWebsite`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3BucketWebsite`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl deaktiviert die statische Website-Hosting-Eigenschaft des angegebenen S3-Buckets.**
```
Remove-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteBucketWebsite AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-S3CORSConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3CORSConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl entfernt die CORS-Konfiguration für den angegebenen S3-Bucket.**
```
Remove-S3CORSConfiguration -BucketName 'amzn-s3-demo-bucket'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [Delete CORSConfiguration](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `Remove-S3LifecycleConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3LifecycleConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl entfernt alle Lebenszyklusregeln für den angegebenen S3-Bucket.**
```
Remove-S3LifecycleConfiguration -BucketName 'amzn-s3-demo-bucket'
```
+ Einzelheiten zur API finden Sie unter [DeleteLifecycleConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-S3MultipartUpload`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3MultipartUpload`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl bricht mehrteilige Uploads ab, die vor mehr als 5 Tagen erstellt wurden.**
```
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -DaysBefore 5
```
**Beispiel 2: Dieser Befehl bricht mehrteilige Uploads ab, die vor dem 2. Januar 2014 erstellt wurden.**
```
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "Thursday, January 02, 2014"
```
**Beispiel 2: Dieser Befehl bricht mehrteilige Uploads ab, die vor dem 2. Januar 2014, 10:45:37, erstellt wurden.**
```
Remove-S3MultipartUpload -BucketName amzn-s3-demo-bucket -InitiatedDate "2014/01/02 10:45:37"
```
+ Einzelheiten zur API finden Sie unter [AbortMultipartUpload AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-S3Object`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3Object`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl entfernt das Objekt „sample.txt” aus dem Bucket „test-files”. Sie werden vor der Ausführung des Befehls um eine Bestätigung gebeten. Um den Prompt zu unterdrücken, verwenden Sie den -Force-Schalter.**
```
Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt
```
**Beispiel 2: Dieser Befehl entfernt die angegebene Version des Objekts „sample.txt“ aus dem Bucket „test-files“, vorausgesetzt, der Bucket wurde so konfiguriert, dass Objektversionen aktiviert sind.**
```
Remove-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt -VersionId HLbxnx6V9omT6AQYVpks8mmFKQcejpqt
```
**Beispiel 3: Dieser Befehl entfernt die Objekte „sample1.txt“, „sample2.txt“ und „sample3.txt“ als einzelne Stapelverarbeitung aus dem Bucket „test-files“. Die Antwort des Services listet alle verarbeiteten Schlüssel auf, unabhängig davon, ob die Löschung erfolgreich war oder fehlgeschlagen ist. Um nur Fehler für Schlüssel zu erhalten, die vom Dienst nicht verarbeitet werden konnten, fügen Sie den ReportErrorsOnly Parameter - hinzu (dieser Parameter kann auch mit dem Alias -Quiet angegeben werden).**
```
Remove-S3Object -BucketName amzn-s3-demo-bucket -KeyCollection @( "sample1.txt", "sample2.txt", "sample3.txt" )
```
**Beispiel 4: In diesem Beispiel wird ein Inline-Ausdruck mit dem KeyCollection Parameter - verwendet, um die Schlüssel der zu löschenden Objekte abzurufen. Get-S3Objectgibt eine Sammlung von Amazon.S3.Model.S3Object-Instanzen zurück, von denen jede ein Key-Element vom Typ Zeichenfolge hat, das das Objekt** identifiziert.
```
Remove-S3Object -bucketname "amzn-s3-demo-bucket" -KeyCollection (Get-S3Object "test-files" -KeyPrefix "prefix/subprefix" | select -ExpandProperty Key)
```
**Beispiel 5: In diesem Beispiel werden alle Objekte abgerufen, die einen Schlüsselpräfix „prefix/subprefix“ im Bucket haben, und gelöscht. Beachten Sie, dass die eingehenden Objekte nacheinander verarbeitet werden. Bei großen Sammlungen sollten Sie erwägen, die Sammlung an den Parameter - InputObject (alias -S3ObjectCollection) des Cmdlets zu übergeben, damit das Löschen als Batch mit einem einzigen Aufruf des Dienstes erfolgen kann.**
```
Get-S3Object -BucketName "amzn-s3-demo-bucket" -KeyPrefix "prefix/subprefix" | Remove-S3Object -Force
```
**Beispiel 6: In diesem Beispiel wird eine Sammlung von ObjectVersion Amazon.S3.Model.S3-Instances, die Löschmarkierungen darstellen, zur Löschung an das Cmdlet übergeben. Beachten Sie, dass die eingehenden Objekte nacheinander verarbeitet werden. Bei großen Sammlungen sollten Sie erwägen, die Sammlung an den Parameter - InputObject (alias -S3ObjectCollection) des Cmdlets zu übergeben, damit das Löschen als Batch mit einem einzigen Aufruf des Dienstes erfolgen kann.**
```
(Get-S3Version -BucketName "amzn-s3-demo-bucket").Versions | Where {$_.IsDeleteMarker -eq "True"} | Remove-S3Object -Force
```
**Beispiel 7: Dieses Skript zeigt, wie eine Gruppe von Objekten (in diesem Fall Löschmarken) im Batch-Modus gelöscht werden kann, indem ein Array von Objekten erstellt wird, die mit dem Parameter - verwendet werden sollen. KeyAndVersionCollection **
```
$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
```
+ Einzelheiten zur API finden Sie unter [DeleteObjects AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-S3ObjectTagSet`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3ObjectTagSet`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl entfernt alle Tags, die mit dem Objekt mit dem Schlüssel „testfile.txt” im angegebenen S3-Bucket verknüpft sind.**
```
Remove-S3ObjectTagSet -Key 'testfile.txt' -BucketName 'amzn-s3-demo-bucket' -Select '^Key'
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteObjectTagging AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-S3PublicAccessBlock`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-S3PublicAccessBlock`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl deaktiviert die Einstellung „Öffentlicher Zugriff blockieren“ für den angegebenen Bucket.**
```
Remove-S3PublicAccessBlock -BucketName 'amzn-s3-demo-bucket' -Force -Select '^BucketName'
```
**Ausgabe:**
```
amzn-s3-demo-bucket
```
+ Einzelheiten zur API finden Sie unter [DeletePublicAccessBlock AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-S3BucketEncryption`
Das folgende Codebeispiel zeigt die Verwendung. `Set-S3BucketEncryption`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl aktiviert die AES256 serverseitige Standardverschlüsselung mit Amazon S3 Managed Keys (SSE-S3) für den angegebenen Bucket.**
```
$Encryptionconfig = @{ServerSideEncryptionByDefault = @{ServerSideEncryptionAlgorithm = "AES256"}}
Set-S3BucketEncryption -BucketName 'amzn-s3-demo-bucket' -ServerSideEncryptionConfiguration_ServerSideEncryptionRule $Encryptionconfig
```
+ Einzelheiten zur API finden Sie unter [PutBucketEncryption AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Test-S3Bucket`
Das folgende Codebeispiel zeigt die Verwendung. `Test-S3Bucket`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt „True“ zurück, wenn der Bucket existiert, andernfalls „False“. Der Befehl gibt „True“ zurück, auch wenn der Bucket nicht zum Benutzer gehört.**
```
Test-S3Bucket -BucketName amzn-s3-demo-bucket
```
+ Einzelheiten zur API finden Sie unter [Test-S3Bucket AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-S3BucketAccelerateConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Write-S3BucketAccelerateConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl aktiviert die Übertragungsbeschleunigung für den angegebenen S3-Bucket.**
```
$statusVal = New-Object Amazon.S3.BucketAccelerateStatus('Enabled')
Write-S3BucketAccelerateConfiguration -BucketName 'amzn-s3-demo-bucket' -AccelerateConfiguration_Status $statusVal
```
+ Einzelheiten zur API finden Sie unter [PutBucketAccelerateConfiguration AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-S3BucketNotification`
Das folgende Codebeispiel zeigt die Verwendung. `Write-S3BucketNotification`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die SNS-Themenkonfiguration für das S3-Ereignis konfiguriert ObjectRemovedDelete und die Benachrichtigung für den angegebenen S3-Bucket aktiviert**
```
$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
```
**Beispiel 2: Dieses Beispiel aktiviert Benachrichtigungen ObjectCreatedAll für den angegebenen Bucket und sendet ihn an die Lambda-Funktion.**
```
$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
```
**Beispiel 3: In diesem Beispiel werden zwei verschiedene Lambda-Konfigurationen auf der Grundlage unterschiedlicher Schlüsselsuffixe erstellt und beide in einem einzigen Befehl konfiguriert.**
```
#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
```
+ Einzelheiten zur API finden Sie unter [PutBucketNotification AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-S3BucketReplication`
Das folgende Codebeispiel zeigt die Verwendung. `Write-S3BucketReplication`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel legt eine Replikationskonfiguration mit einer einzigen Regel fest, die die Replikation aller neuen Objekte, die mit dem Schlüsselnamenpräfix "" im Bucket 'amzn-s3-demo-bucket' erstellt wurden, im Bucket 'amzn-s3-demo-bucket' ermöglicht. 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
```
**Beispiel 2: Dieses Beispiel legt eine Replikationskonfiguration mit mehreren Regeln fest, die die Replikation aller neuen Objekte, die entweder mit dem Schlüsselnamenpräfix "" oder "TaxDocs" erstellt wurden, in den Bucket 'amzn-s3-demo-bucket' ermöglichen. OtherDocs Die Schlüsselpräfixe dürfen sich nicht überschneiden.**
```
$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
```
**Beispiel 3: In diesem Beispiel wird die Replikationskonfiguration für den angegebenen Bucket aktualisiert, um die Regel zu deaktivieren, die die Replikation von Objekten mit dem Schlüsselnamenpräfix "" in den Bucket 'amzn-s3-demo-bucket' steuert. TaxDocs**
```
$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
```
+ *Einzelheiten zur API finden Sie unter Cmdlet-Referenz (V5). [PutBucketReplication](https://docs.aws.amazon.com/powershell/v5/reference)AWS -Tools für PowerShell *
### `Write-S3BucketRequestPayment`
Das folgende Codebeispiel zeigt die Verwendung. `Write-S3BucketRequestPayment`
**Tools für PowerShell V5**
**Beispiel 1: Aktualisiert die Konfiguration für Zahlungsanforderungen für den Bucket mit dem Namen „amzn-s3-demo-bucket“, sodass der Person, die Downloads aus dem Bucket anfordert, die Kosten für den Download in Rechnung gestellt werden. Standardmäßig zahlt der Bucket-Eigentümer für Downloads. Verwenden Sie 'BucketOwner' für den Parameter RequestPaymentConfiguration \$1Payer, um die Zahlung für die Anforderung wieder auf die Standardwerte zurückzusetzen.**
```
Write-S3BucketRequestPayment -BucketName amzn-s3-demo-bucket -RequestPaymentConfiguration_Payer Requester
```
+ Einzelheiten zur API finden Sie unter [PutBucketRequestPayment AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Write-S3BucketTagging`
Das folgende Codebeispiel zeigt die Verwendung. `Write-S3BucketTagging`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl wendet zwei Tags auf einen Bucket namens „`cloudtrail-test-2018`“ an: ein Tag mit dem Schlüssel „Stage“ und dem Wert „Test“ sowie ein Tag mit dem Schlüssel „Environment“ und dem Wert „Alpha“. Um zu überprüfen, ob die Tags zum Bucket hinzugefügt wurden, führen Sie `Get-S3BucketTagging -BucketName bucket_name` aus. Die Ergebnisse sollten die Tags anzeigen, die Sie im ersten Befehl auf den Bucket angewendet haben. Beachten Sie, dass `Write-S3BucketTagging` den gesamten vorhandenen Tag-Satz eines Buckets überschreibt. Um einzelne Tags hinzuzufügen oder zu löschen, führen Sie die Cmdlets Resource Groups und Tagging API aus, `Add-RGTResourceTag` und `Remove-RGTResourceTag`. Verwenden Sie alternativ den Tag-Editor in der AWS Management Console, um S3-Bucket-Tags zu verwalten.**
```
Write-S3BucketTagging -BucketName amzn-s3-demo-bucket -TagSet @( @{ Key="Stage"; Value="Test" }, @{ Key="Environment"; Value="Alpha" } )
```
**Beispiel 2: Dieser Befehl übergibt einen Bucket namens `cloudtrail-test-2018` in das `Write-S3BucketTagging`-Cmdlet. Er wendet die Tags „Stage:Production“ und „Department:Finance“ auf den Bucket an. Beachten Sie, dass `Write-S3BucketTagging` den gesamten vorhandenen Tag-Satz eines Buckets überschreibt.**
```
Get-S3Bucket -BucketName amzn-s3-demo-bucket | Write-S3BucketTagging -TagSet @( @{ Key="Stage"; Value="Production" }, @{ Key="Department"; Value="Finance" } )
```
+ Einzelheiten zur API finden Sie unter [PutBucketTagging AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Write-S3BucketVersioning`
Das folgende Codebeispiel zeigt die Verwendung. `Write-S3BucketVersioning`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl aktiviert die Versionierung für den angegebenen S3-Bucket.**
```
Write-S3BucketVersioning -BucketName 'amzn-s3-demo-bucket' -VersioningConfig_Status Enabled
```
+ Einzelheiten zur API finden Sie unter [PutBucketVersioning AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-S3BucketWebsite`
Das folgende Codebeispiel zeigt die Verwendung. `Write-S3BucketWebsite`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl aktiviert das Website-Hosting für den angegebenen Bucket mit dem Indexdokument „index.html“ und dem Fehlerdokument „error.html“.**
```
Write-S3BucketWebsite -BucketName 'amzn-s3-demo-bucket' -WebsiteConfiguration_IndexDocumentSuffix 'index.html' -WebsiteConfiguration_ErrorDocument 'error.html'
```
+ Einzelheiten zur API finden Sie unter [PutBucketWebsite AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-S3LifecycleConfiguration`
Das folgende Codebeispiel zeigt die Verwendung. `Write-S3LifecycleConfiguration`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die im \$1 NewRule angegebene Konfiguration geschrieben/ersetzt. Diese Konfiguration stellt sicher, dass Objekte mit bestimmten Präfix- und Tag-Werten eingeschränkt werden.**
```
$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
```
**Beispiel 2: In diesem Beispiel werden mehrere Regeln mit Filterung festgelegt. \$1 ArchiveRule legt fest, dass die Objekte in 30 Tagen auf Glacier und in 120 Tagen archiviert DeepArchive werden sollen. \$1 ExpireRule läuft sowohl in der aktuellen als auch in früheren Versionen in 150 Tagen für Objekte ab, bei denen das Präfix 'py' und der tag:key 'archieved' auf 'yes' gesetzt** sind.
```
$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
```
+ *Einzelheiten zur API finden Sie unter [PutLifecycleConfiguration](https://docs.aws.amazon.com/powershell/v5/reference)Cmdlet-Referenz (V5).AWS -Tools für PowerShell *
### `Write-S3Object`
Das folgende Codebeispiel zeigt die Verwendung. `Write-S3Object`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl lädt die einzelne Datei „local-sample.txt“ auf Amazon S3 hoch und erstellt ein Objekt mit dem Schlüssel „sample.txt“ im Bucket „test-files“.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -File .\local-sample.txt
```
**Beispiel 2: Dieser Befehl lädt die einzelne Datei „sample.txt“ auf Amazon S3 hoch und erstellt ein Objekt mit dem Schlüssel „sample.txt“ im Bucket „test-files“. Wenn der Parameter -Key nicht angegeben wird, wird der Dateiname als S3-Objektschlüssel verwendet.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -File .\sample.txt
```
**Beispiel 3: Dieser Befehl lädt die einzelne Datei "local-sample.txt" auf Amazon S3 hoch und erstellt ein Objekt mit dem Schlüssel "prefix/to/sample.txt“ im Bucket „test-files“.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "prefix/to/sample.txt" -File .\local-sample.txt
```
**Beispiel 4: Dieser Befehl lädt alle Dateien im Unterverzeichnis „Scripts“ in den Bucket „test-files“ hoch und wendet das gemeinsame key prefix "SampleScripts" auf jedes Objekt an. Jede hochgeladene Datei hat den Schlüssel "SampleScripts/filename", wobei 'Dateiname' variiert.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\
```
**Beispiel 5: Dieser Befehl lädt alle\$1.ps1-Dateien im lokalen Verzeichnis „Scripts“ in den Bucket „test-files“ hoch und wendet das gemeinsame key prefix "" SampleScripts auf jedes Objekt an. Jede hochgeladene Datei hat den Schlüssel "SampleScripts/filename.ps1", wobei 'Dateiname' variiert.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder .\Scripts -KeyPrefix SampleScripts\ -SearchPattern *.ps1
```
**Beispiel 6: Dieser Befehl erstellt ein neues S3-Objekt, das die angegebene Inhaltszeichenfolge mit dem Schlüssel „sample.txt“ enthält.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Key "sample.txt" -Content "object contents"
```
**Beispiel 7: Dieser Befehl lädt die angegebene Datei hoch (der Dateiname wird als Schlüssel verwendet) und wendet die angegebenen Tags auf das neue Objekt an.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -File "sample.txt" -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}
```
**Beispiel 8: Dieser Befehl lädt den angegebenen Ordner rekursiv hoch und wendet die angegebenen Tags auf alle neuen Objekte an.**
```
Write-S3Object -BucketName amzn-s3-demo-bucket -Folder . -KeyPrefix "TaggedFiles" -Recurse -TagSet @{Key="key1";Value="value1"},@{Key="key2";Value="value2"}
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([PutObject](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Write-S3ObjectRetention`
Das folgende Codebeispiel zeigt die Verwendung. `Write-S3ObjectRetention`
**Tools für PowerShell V5**
**Beispiel 1: Der Befehl aktiviert den Governance-Aufbewahrungsmodus bis zum Datum „31st Dec 2019 00:00:00“ für das Objekt „testfile.txt“ im angegebenen S3-Bucket.**
```
Write-S3ObjectRetention -BucketName 'amzn-s3-demo-bucket' -Key 'testfile.txt' -Retention_Mode GOVERNANCE -Retention_RetainUntilDate "2019-12-31T00:00:00"
```
+ Einzelheiten zur API finden Sie unter [PutObjectRetention AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Security Hub CSPM-Beispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Security Hub CSPM Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-SHUBFinding`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SHUBFinding`
**Tools für PowerShell V5**
**Beispiel 1: Mit diesem Befehl werden Security Hub Hub-Ergebnisse vom Amazon EC2; -Service abgerufen.**
```
$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
```
**Beispiel 2: Dieser Befehl ruft Security Hub Hub-Ergebnisse aus der AWS Konto-ID 123456789012 ab.**
```
$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
```
**Beispiel 3: Dieser Befehl ruft Security-Hub-Erkenntnisse ab, die für den Standard „pci-dss“ generiert wurden.**
```
$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
```
**Beispiel 4: Dieser Befehl ruft Security-Hub-Erkenntnisse mit kritischem Schweregrad ab, die den Workflow-Status NOTIFIED haben**
```
$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
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([GetFindings](https://docs.aws.amazon.com/powershell/v5/reference)V5).
# Amazon SES SES-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon SES Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Get-SESIdentity`
Das folgende Codebeispiel zeigt die Verwendung`Get-SESIdentity`.
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt eine Liste zurück, die alle Identitäten (E-Mail-Adressen und Domains) für ein bestimmtes AWS Konto enthält, unabhängig vom Bestätigungsstatus.**
```
Get-SESIdentity
```
+ Einzelheiten zur API finden Sie unter [ListIdentities AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SESSendQuota`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SESSendQuota`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die aktuellen Sende-Limits des Benutzers zurück.**
```
Get-SESSendQuota
```
+ Einzelheiten zur API finden Sie unter [GetSendQuota AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SESSendStatistic`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SESSendStatistic`
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl gibt die Sendestatistik des Benutzers zurück. Das Ergebnis ist eine Liste mit Datenpunkten, die die letzten zwei Wochen Sendeaktivität repräsentieren. Jeder Datenpunkt in der Liste enthält Statistiken für ein Intervall von 15 Minuten.**
```
Get-SESSendStatistic
```
+ Einzelheiten zur API finden Sie unter [GetSendStatistics AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Amazon SES API v2-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon SES API v2 Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Send-SES2Email`
Das folgende Codebeispiel zeigt die Verwendung`Send-SES2Email`.
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel zeigt, wie Sie eine Standard-E-Mail-Nachricht versenden.**
```
Send-SES2Email -FromEmailAddress "sender@example.com" -Destination_ToAddress "recipient@example.com" -Subject_Data "Email Subject" -Text_Data "Email Body"
```
+ Einzelheiten zur API finden Sie unter [SendEmail AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Amazon SNS SNS-Beispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon SNS Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Publish-SNSMessage`
Das folgende Codebeispiel zeigt die Verwendung von. `Publish-SNSMessage`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel zeigt das Veröffentlichen einer Nachricht mit einer einzigen MessageAttribute deklarierten Inline.**
```
Publish-SNSMessage -TopicArn "arn:aws:sns:us-west-2:123456789012:my-topic" -Message "Hello" -MessageAttribute @{'City'=[Amazon.SimpleNotificationService.Model.MessageAttributeValue]@{DataType='String'; StringValue ='AnyCity'}}
```
**Beispiel 2: Dieses Beispiel zeigt die Veröffentlichung einer Nachricht, bei der mehrere Nachrichten im Voraus MessageAttributes deklariert wurden.**
```
$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
```
+ Weitere API-Informationen finden Sie unter [Publish](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*.
# Amazon SQS SQS-Beispiele mit Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon SQS Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-SQSPermission`
Das folgende Codebeispiel zeigt die Verwendung von. `Add-SQSPermission`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel können die angegebenen Benutzer AWS-Konto Nachrichten aus der angegebenen Warteschlange senden.**
```
Add-SQSPermission -Action SendMessage -AWSAccountId 80398EXAMPLE -Label SendMessagesFromMyQueue -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Einzelheiten zur API finden Sie unter [AddPermission AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Clear-SQSQueue`
Das folgende Codebeispiel zeigt die Verwendung. `Clear-SQSQueue`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Nachrichten aus der angegebenen Warteschlange gelöscht.**
```
Clear-SQSQueue -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Einzelheiten zur API finden Sie unter [PurgeQueue AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-SQSMessageVisibility`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-SQSMessageVisibility`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Sichtbarkeits-Timeout für die Nachricht mit dem angegebenen Empfangs-Handle in der angegebenen Warteschlange auf 10 Stunden geändert (10 Stunden \$1 60 Minuten \$1 60 Sekunden = 36 000 Sekunden).**
```
Edit-SQSMessageVisibility -QueueUrl https://sqs.us-east-1.amazonaws.com/8039EXAMPLE/MyQueue -ReceiptHandle AQEBgGDh...J/Iqww== -VisibilityTimeout 36000
```
+ Einzelheiten zur API finden Sie unter [ChangeMessageVisibility AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-SQSMessageVisibilityBatch`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-SQSMessageVisibilityBatch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Sichtbarkeits-Timeout für zwei Nachrichten mit den angegebenen Empfangs-Handles in der angegebenen Warteschlange geändert. Das Sichtbarkeits-Timeout der ersten Nachricht wird auf 10 Stunden geändert (10 Stunden \$1 60 Minuten \$1 60 Sekunden = 36 000 Sekunden). Das Sichtbarkeits-Timeout der zweiten Nachricht wird auf 5 Stunden geändert (5 Stunden \$1 60 Minuten \$1 60 Sekunden = 18 000 Sekunden).**
```
$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
```
**Ausgabe:**
```
Failed Successful
------ ----------
{} {Request2, Request1}
```
+ Einzelheiten zur API finden Sie unter [ChangeMessageVisibilityBatch AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SQSDeadLetterSourceQueue`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SQSDeadLetterSourceQueue`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Warteschlangen aufgeführt, die URLs sich auf die angegebene Warteschlange als Warteschlange für unzustellbare Nachrichten verlassen.**
```
Get-SQSDeadLetterSourceQueue -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyDeadLetterQueue
```
**Ausgabe:**
```
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyOtherQueue
```
+ Einzelheiten zur API finden Sie unter [ListDeadLetterSourceQueues AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SQSQueue`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SQSQueue`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Parameter aufgelistet.**
```
Get-SQSQueue
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle Warteschlangen auflistet, die mit dem angegebenen Namen beginnen.**
```
Get-SQSQueue -QueueNamePrefix My
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListQueues AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SQSQueueAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SQSQueueAttribute`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zu den Attributen für die angegebene Warteschlange aufgelistet.**
```
Get-SQSQueueAttribute -AttributeName All -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
**Ausgabe:**
```
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]...}
```
**Beispiel 2: In diesem Beispiel werden nur die angegebenen Attribute für die angegebene Warteschlange separat aufgelistet.**
```
Get-SQSQueueAttribute -AttributeName MaximumMessageSize, VisibilityTimeout -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
**Ausgabe:**
```
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]}
```
+ Einzelheiten zur API finden Sie unter [GetQueueAttributes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SQSQueueUrl`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SQSQueueUrl`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die URL der Warteschlange mit dem angegebenen Namen aufgelistet.**
```
Get-SQSQueueUrl -QueueName MyQueue
```
**Ausgabe:**
```
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Einzelheiten zur API finden Sie unter [GetQueueUrl AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-SQSQueue`
Das folgende Codebeispiel zeigt die Verwendung. `New-SQSQueue`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Warteschlange mit dem angegebenen Namen erstellt.**
```
New-SQSQueue -QueueName MyQueue
```
**Ausgabe:**
```
https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Einzelheiten zur API finden Sie unter [CreateQueue AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Receive-SQSMessage`
Das folgende Codebeispiel zeigt die Verwendung. `Receive-SQSMessage`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen für die nächsten 10 Nachrichten aufgelistet, die in der angegebenen Warteschlange empfangen werden sollen. Die Informationen enthalten Werte für die angegebenen Nachrichtenattribute, sofern sie existieren.**
```
Receive-SQSMessage -AttributeName SenderId, SentTimestamp -MessageAttributeName StudentName, StudentGrade -MessageCount 10 -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
**Ausgabe:**
```
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==
```
+ Einzelheiten zur API finden Sie unter [ReceiveMessage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-SQSMessage`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-SQSMessage`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Nachricht mit dem angegebenen Empfangs-Handle aus der angegebenen Warteschlange gelöscht.**
```
Remove-SQSMessage -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue -ReceiptHandle AQEBd329...v6gl8Q==
```
+ Einzelheiten zur API finden Sie unter [DeleteMessage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-SQSMessageBatch`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-SQSMessageBatch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden zwei Nachrichten mit den angegebenen Empfangs-Handles aus der angegebenen Warteschlange gelöscht.**
```
$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
```
**Ausgabe:**
```
Failed Successful
------ ----------
{} {Request1, Request2}
```
+ Einzelheiten zur API finden Sie unter [DeleteMessageBatch AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-SQSPermission`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-SQSPermission`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Berechtigungseinstellungen mit der angegebenen Bezeichnung aus der angegebenen Warteschlange entfernt.**
```
Remove-SQSPermission -Label SendMessagesFromMyQueue -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Einzelheiten zur API finden Sie unter [RemovePermission AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-SQSQueue`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-SQSQueue`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene Warteschlange gelöscht.**
```
Remove-SQSQueue -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Einzelheiten zur API finden Sie unter [DeleteQueue AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Send-SQSMessage`
Das folgende Codebeispiel zeigt die Verwendung. `Send-SQSMessage`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Nachricht mit den angegebenen Attributen und dem angegebenen Nachrichtentext an die angegebene Warteschlange gesendet, wobei die Zustellung der Nachricht um 10 Sekunden verzögert wird.**
```
$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
```
**Ausgabe:**
```
MD5OfMessageAttributes MD5OfMessageBody MessageId
---------------------- ---------------- ---------
1d3e51347bc042efbdf6dda31EXAMPLE 51b0a3256d59467f973009b73EXAMPLE c35fed8f-c739-4d0c-818b-1820eEXAMPLE
```
+ Einzelheiten zur API finden Sie unter [SendMessage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Send-SQSMessageBatch`
Das folgende Codebeispiel zeigt die Verwendung. `Send-SQSMessageBatch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden zwei Nachrichten mit den angegebenen Attributen und Nachrichtentexten an die angegebene Warteschlange gesendet. Die Zustellung verzögert sich um 15 Sekunden für die erste Nachricht und um 10 Sekunden für die zweite Nachricht.**
```
$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
```
**Ausgabe:**
```
Failed Successful
------ ----------
{} {FirstMessage, SecondMessage}
```
+ Einzelheiten zur API finden Sie unter [SendMessageBatch AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Set-SQSQueueAttribute`
Das folgende Codebeispiel zeigt die Verwendung. `Set-SQSQueueAttribute`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel zeigt, wie Sie eine Richtlinie festlegen, mit der eine Warteschlange für ein SNS-Thema abonniert wird. Wenn eine Nachricht in einem Thema veröffentlicht wird, wird eine Nachricht an die abonnierte Warteschlange gesendet.**
```
# 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 }
```
**Beispiel 2: In diesem Beispiel werden die angegebenen Attribute für die angegebene Warteschlange festgelegt.**
```
Set-SQSQueueAttribute -Attribute @{"DelaySeconds" = "10"; "MaximumMessageSize" = "131072"} -QueueUrl https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue
```
+ Einzelheiten zur API finden Sie unter [SetQueueAttributes AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# AWS STS Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. AWS STS
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Convert-STSAuthorizationMessage`
Das folgende Codebeispiel zeigt die Verwendung `Convert-STSAuthorizationMessage` von.
**Tools für PowerShell V5**
**Beispiel 1: Decodiert die zusätzlichen Informationen, die im bereitgestellten codierten Nachrichteninhalt enthalten sind, der als Antwort auf eine Anfrage zurückgegeben wurde. Die Zusatzinformationen werden verschlüsselt, da es sich bei den Details des Autorisierungsstatus um vertrauliche Informationen handeln kann, die der Benutzer, der die Aktion angefordert hat, nicht sehen sollte.**
```
Convert-STSAuthorizationMessage -EncodedMessage "...encoded message..."
```
+ Einzelheiten zur API finden Sie unter [DecodeAuthorizationMessage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-STSFederationToken`
Das folgende Codebeispiel zeigt die Verwendung. `Get-STSFederationToken`
**Tools für PowerShell V5**
**Beispiel 1: Fordert ein Verbund-Token an, das eine Stunde lang gültig ist, mit „Bob“ als Namen des Verbundbenutzers. Dieser Name kann verwendet werden, um in einer ressourcenbasierten Richtlinie (z. B. einer Amazon-S3-Bucket-Richtlinie) auf den Namen des Verbundbenutzers zu verweisen. Die bereitgestellte IAM-Richtlinie im JSON-Format wird verwendet, um die Berechtigungen, die dem IAM-Benutzer zur Verfügung stehen, einzuschränken. Die angegebene Richtlinie kann nicht mehr Berechtigungen gewähren, als dem anfordernden Benutzer gewährt wurden. Die endgültigen Berechtigungen für den Verbundbenutzer sind der restriktivste Satz, basierend auf der Schnittmenge der übergebenen Richtlinie und der IAM-Benutze-Richtlinie.**
```
Get-STSFederationToken -Name "Bob" -Policy "...JSON policy..." -DurationInSeconds 3600
```
+ Einzelheiten zur API finden Sie unter [GetFederationToken AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-STSSessionToken`
Das folgende Codebeispiel zeigt die Verwendung. `Get-STSSessionToken`
**Tools für PowerShell V5**
**Beispiel 1: Gibt eine `Amazon.RuntimeAWSCredentials`-Instance mit temporären Anmeldeinformationen zurück, die für einen festgelegten Zeitraum gültig sind. Die Anmeldeinformationen, die zum Anfordern temporärer Anmeldeinformationen verwendet werden, werden aus den aktuellen Shell-Standardwerten abgeleitet. Um andere Anmeldeinformationen anzugeben, verwenden Sie die Parameter - ProfileName oder - AccessKey /-SecretKey .**
```
Get-STSSessionToken
```
**Ausgabe:**
```
AccessKeyId Expiration SecretAccessKey SessionToken
----------- ---------- --------------- ------------
EXAMPLEACCESSKEYID 2/16/2015 9:12:28 PM examplesecretaccesskey... SamPleTokeN.....
```
**Beispiel 2: Gibt eine `Amazon.RuntimeAWSCredentials`-Instance mit temporären Anmeldeinformationen zurück, die eine Stunde lang gültig sind. Die zum Stellen der Anfrage verwendeten Anmeldeinformationen werden aus dem angegebenen Profil abgerufen.**
```
Get-STSSessionToken -DurationInSeconds 3600 -ProfileName myprofile
```
**Ausgabe:**
```
AccessKeyId Expiration SecretAccessKey SessionToken
----------- ---------- --------------- ------------
EXAMPLEACCESSKEYID 2/16/2015 9:12:28 PM examplesecretaccesskey... SamPleTokeN.....
```
**Beispiel 3: Gibt eine `Amazon.RuntimeAWSCredentials`-Instance mit temporären Anmeldeinformationen zurück, die eine Stunde lang gültig sind. Dabei wird die Identifikationsnummer des MFA-Geräts verwendet, das dem Konto zugeordnet ist, dessen Anmeldeinformationen im Profil „myprofilename“ angegeben sind, und der vom Gerät bereitgestellte Wert.**
```
Get-STSSessionToken -DurationInSeconds 3600 -ProfileName myprofile -SerialNumber YourMFADeviceSerialNumber -TokenCode 123456
```
**Ausgabe:**
```
AccessKeyId Expiration SecretAccessKey SessionToken
----------- ---------- --------------- ------------
EXAMPLEACCESSKEYID 2/16/2015 9:12:28 PM examplesecretaccesskey... SamPleTokeN.....
```
+ Einzelheiten zur API finden Sie unter [GetSessionToken AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Use-STSRole`
Das folgende Codebeispiel zeigt die Verwendung. `Use-STSRole`
**Tools für PowerShell V5**
**Beispiel 1: Gibt einen Satz temporärer Anmeldeinformationen (Zugriffsschlüssel, geheimer Schlüssel und Sitzungstoken) zurück, die eine Stunde lang für den Zugriff auf AWS Ressourcen verwendet werden können, auf die der anfragende Benutzer normalerweise keinen Zugriff hat. Die zurückgegebenen Anmeldeinformationen verfügen über die Berechtigungen, die von der Zugriffsrichtlinie der übernommenen Rolle und der bereitgestellten Richtlinie zugelassen sind (Sie können die bereitgestellte Richtlinie nicht verwenden, um Berechtigungen zu gewähren, die über die in der Zugriffsrichtlinie der übernommenen Rolle definierten Berechtigungen hinausgehen).**
```
Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -Policy "...JSON policy..." -DurationInSeconds 3600
```
**Beispiel 2: Gibt einen Satz temporärer Anmeldeinformationen zurück, die eine Stunde gültig sind und über dieselben Berechtigungen verfügen, die in der Zugriffsrichtlinie der übernommenen Rolle definiert sind.**
```
Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -DurationInSeconds 3600
```
**Beispiel 3: Gibt einen Satz temporärer Anmeldeinformationen zurück, die die Seriennummer und das generierte Token von einem MFA bereitstellen, das den Anmeldeinformationen des Benutzers zugeordnet ist, die zur Ausführung des Cmdlet verwendet werden.**
```
Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -DurationInSeconds 3600 -SerialNumber "GAHT12345678" -TokenCode "123456"
```
**Beispiel 4: Gibt einen Satz temporärer Anmeldeinformationen zurück, die eine in einem Kundenkonto definierte Rolle übernommen haben. Für jede Rolle, die der Drittanbieter übernehmen kann, muss das Kundenkonto eine Rolle mithilfe einer Kennung erstellen, die jedes Mal, wenn die Rolle übernommen wird, im ExternalId Parameter - übergeben werden muss.**
```
Use-STSRole -RoleSessionName "Bob" -RoleArn "arn:aws:iam::123456789012:role/demo" -DurationInSeconds 3600 -ExternalId "ABC123"
```
+ Einzelheiten zur API finden Sie unter [AssumeRole AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Use-STSWebIdentityRole`
Das folgende Codebeispiel zeigt die Verwendung. `Use-STSWebIdentityRole`
**Tools für PowerShell V5**
**Beispiel 1: Gibt einen temporären Satz Anmeldeinformationen mit einer Gültigkeit von einer Stunde für einen Benutzer zurück, der mit dem Identitätsanbieter „Anmeldung mit Amazon“ authentifiziert wurde. Die Anmeldeinformationen übernehmen die Zugriffsrichtlinie, die der durch die Rollen-ARN identifizierten Rolle zugeordnet ist. Optional können Sie eine JSON-Richtlinie an den Parameter -Richtlinie übergeben, die die Zugriffsberechtigungen weiter verfeinert (Sie können keine Berechtigungen mehr gewähren, als in den mit der Rolle verknüpften Berechtigungen verfügbar sind). Der an - übergebene Wert WebIdentityToken ist die eindeutige Benutzerkennung, die vom Identitätsanbieter zurückgegeben wurde.**
```
Use-STSWebIdentityRole -DurationInSeconds 3600 -ProviderId "www.amazon.com" -RoleSessionName "app1" -RoleArn "arn:aws:iam::123456789012:role/FederatedWebIdentityRole" -WebIdentityToken "Atza...DVI0r1"
```
+ Einzelheiten zur API finden Sie unter [AssumeRoleWithWebIdentity AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
# Support Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. Support
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-ASACommunicationToCase`
Das folgende Codebeispiel zeigt die Verwendung `Add-ASACommunicationToCase` von.
**Tools für PowerShell V5**
**Beispiel 1: Fügt den Text einer E-Mail-Kommunikation zum angegebenen Fall hinzu.**
```
Add-ASACommunicationToCase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -CommunicationBody "Some text about the case"
```
**Beispiel 2: Fügt den Text einer E-Mail-Nachricht zum angegebenen Fall sowie eine oder mehrere E-Mail-Adressen hinzu, die in der CC-Zeile der E-Mail enthalten sind.**
```
Add-ASACommunicationToCase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -CcEmailAddress @("email1@address.com", "email2@address.com") -CommunicationBody "Some text about the case"
```
+ Einzelheiten zur API finden Sie unter [AddCommunicationToCase AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASACase`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASACase`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Details aller Supportfälle zurück.**
```
Get-ASACase
```
**Beispiel 2: Gibt die Details aller Supportfälle seit dem angegebenen Datum und der angegebenen Uhrzeit zurück.**
```
Get-ASACase -AfterTime "2013-09-10T03:06Z"
```
**Beispiel 3: Gibt die Details der ersten 10 Supportfälle zurück, einschließlich derer, die gelöst wurden.**
```
Get-ASACase -MaxResult 10 -IncludeResolvedCases $true
```
**Beispiel 4: Gibt die Details des einzelnen angegebenen Supportfalls zurück.**
```
Get-ASACase -CaseIdList "case-12345678910-2013-c4c1d2bf33c5cf47"
```
**Beispiel 5: Gibt die Details der angegebenen Supportfälle zurück.**
```
Get-ASACase -CaseIdList @("case-12345678910-2013-c4c1d2bf33c5cf47", "case-18929034710-2011-c4fdeabf33c5cf47")
```
+ Einzelheiten zur API finden Sie unter [DescribeCases AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASACommunication`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASACommunication`
**Tools für PowerShell V5**
**Beispiel 1: Gibt alle Kommunikationen für den angegebenen Fall zurück.**
```
Get-ASACommunication -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47"
```
**Beispiel 2: Gibt alle Kommunikationen seit Mitternacht UTC am 1. Januar 2012 für den angegebenen Fall zurück.**
```
Get-ASACommunication -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -AfterTime "2012-01-10T00:00Z"
```
+ Einzelheiten zur API finden Sie unter [DescribeCommunications AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASAService`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASAService`
**Tools für PowerShell V5**
**Beispiel 1: Gibt alle verfügbaren Servicecodes, Namen und Kategorien zurück.**
```
Get-ASAService
```
**Beispiel 2: Gibt den Namen und die Kategorien für den Service mit dem angegebenen Code zurück.**
```
Get-ASAService -ServiceCodeList "amazon-cloudfront"
```
**Beispiel 3: Gibt den Namen und die Kategorien für die angegebenen Servicecodes zurück.**
```
Get-ASAService -ServiceCodeList @("amazon-cloudfront", "amazon-cloudwatch")
```
**Beispiel 4: Gibt den Namen und die Kategorien (in Japanisch) für die angegebenen Servicecodes zurück. Derzeit werden die Sprachcodes Englisch („en“) und Japanisch („ja“) unterstützt.**
```
Get-ASAService -ServiceCodeList @("amazon-cloudfront", "amazon-cloudwatch") -Language "ja"
```
+ Einzelheiten zur API finden Sie unter [DescribeServices AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASASeverityLevel`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASASeverityLevel`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Liste der Schweregrade zurück, die einem AWS Support-Fall zugewiesen werden können.**
```
Get-ASASeverityLevel
```
**Beispiel 2: Gibt die Liste der Schweregrade zurück, die einem AWS Support-Fall zugewiesen werden können. Die Namen der Grade werden auf Japanisch zurückgegeben.**
```
Get-ASASeverityLevel -Language "ja"
```
+ Einzelheiten zur API finden Sie unter [DescribeSeverityLevels AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-ASATrustedAdvisorCheck`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASATrustedAdvisorCheck`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Sammlung von Prüfungen von Trusted Advisor zurück. Sie müssen den Parameter „Language“ angeben, der entweder „en“ für englische Ausgabe oder „ja“ für japanische Ausgabe akzeptieren kann.**
```
Get-ASATrustedAdvisorCheck -Language "en"
```
+ Einzelheiten zur API finden Sie unter [DescribeTrustedAdvisorChecks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASATrustedAdvisorCheckRefreshStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASATrustedAdvisorCheckRefreshStatus`
**Tools für PowerShell V5**
**Beispiel 1: Gibt den aktuellen Status der Aktualisierungsanforderungen für die angegebenen Prüfungen zurück. Anfrage — ASATrusted AdvisorCheckRefresh kann verwendet werden, um anzufordern, dass die Statusinformationen der Prüfungen aktualisiert werden.**
```
Get-ASATrustedAdvisorCheckRefreshStatus -CheckId @("checkid1", "checkid2")
```
+ Einzelheiten zur API finden Sie unter [DescribeTrustedAdvisorCheckRefreshStatuses AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-ASATrustedAdvisorCheckResult`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASATrustedAdvisorCheckResult`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die Ergebnisse einer Prüfung von Trusted Advisor zurück. Die Liste der verfügbaren Trusted Advisor Advisor-Checks kann mit Get- abgerufen werden ASATrustedAdvisorChecks. Die Ausgabe umfasst den Gesamtstatus der Prüfung, den Zeitstempel, zu dem die Prüfung zuletzt durchgeführt wurde, und die eindeutige Prüf-ID für die jeweilige Prüfung. Um die Ergebnisse auf Japanisch auszugeben, fügen Sie den Parameter -Language „ja“ hinzu.**
```
Get-ASATrustedAdvisorCheckResult -CheckId "checkid1"
```
+ Einzelheiten zur API finden Sie unter [DescribeTrustedAdvisorCheckResult AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-ASATrustedAdvisorCheckSummary`
Das folgende Codebeispiel zeigt die Verwendung. `Get-ASATrustedAdvisorCheckSummary`
**Tools für PowerShell V5**
**Beispiel 1: Gibt die neueste Zusammenfassung für die angegebene Prüfung von Trusted Advisor zurück.**
```
Get-ASATrustedAdvisorCheckSummary -CheckId "checkid1"
```
**Beispiel 2: Gibt die neuesten Zusammenfassungen für die angegebenen Prüfungen von Trusted Advisor zurück.**
```
Get-ASATrustedAdvisorCheckSummary -CheckId @("checkid1", "checkid2")
```
+ Einzelheiten zur API finden Sie unter [DescribeTrustedAdvisorCheckSummaries AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-ASACase`
Das folgende Codebeispiel zeigt die Verwendung. `New-ASACase`
**Tools für PowerShell V5**
**Beispiel 1: Erstellt einen neuen Fall im AWS Support Center. Werte für die CategoryCode Parameter - ServiceCode und - können mit dem Get-ASAService Cmdlet abgerufen werden. Der Wert für den SeverityCode Parameter - kann mit dem Cmdlet abgerufen werden. Get-ASASeverityLevel Der Wert des IssueType Parameters - kann entweder „Kundenservice“ oder „technisch“ sein. Bei Erfolg wird die AWS Support-Fallnummer ausgegeben. Standardmäßig wird der Fall auf Englisch bearbeitet. Um Japanisch zu verwenden, fügen Sie den Parameter -Language „ja“ hinzu. Die CommunicationBody Parameter -ServiceCode, -CategoryCode, -Subject und - sind verpflichtend.**
```
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"
```
+ Einzelheiten zur API finden Sie unter [CreateCase AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Request-ASATrustedAdvisorCheckRefresh`
Das folgende Codebeispiel zeigt die Verwendung. `Request-ASATrustedAdvisorCheckRefresh`
**Tools für PowerShell V5**
**Beispiel 1: Fordert eine Aktualisierung für die angegebene Prüfung von Trusted Advisor an.**
```
Request-ASATrustedAdvisorCheckRefresh -CheckId "checkid1"
```
+ Einzelheiten zur API finden Sie unter [RefreshTrustedAdvisorCheck AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Resolve-ASACase`
Das folgende Codebeispiel zeigt die Verwendung. `Resolve-ASACase`
**Tools für PowerShell V5**
**Beispiel 1: Gibt den Anfangszustand des angegebenen Falls und den aktuellen Zustand nach Abschluss des Aufrufs zur Lösung zurück.**
```
Resolve-ASACase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47"
```
+ Einzelheiten zur API finden Sie unter [ResolveCase AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Systems Manager Manager-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Systems Manager Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Add-SSMResourceTag`
Das folgende Codebeispiel zeigt die Verwendung`Add-SSMResourceTag`.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Wartungsfenster mit neuen Tags aktualisiert. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$option1 = @{Key="Stack";Value=@("Production")}
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $option1
```
**Beispiel 2: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um jedes Tag zu erstellen. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
$tag1 = New-Object Amazon.SimpleSystemsManagement.Model.Tag
$tag1.Key = "Stack"
$tag1.Value = "Production"
Add-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -Tag $tag1
```
+ Einzelheiten zur API finden Sie unter [AddTagsToResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Edit-SSMDocumentPermission`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-SSMDocumentPermission`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden allen Konten für ein Dokument „Teilen“-Berechtigungen hinzugefügt. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Edit-SSMDocumentPermission -Name "RunShellScript" -PermissionType "Share" -AccountIdsToAdd all
```
**Beispiel 2: Dieses Beispiel fügt einem bestimmten Konto die Berechtigung zum „Freigeben“ eines Dokuments hinzu. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Edit-SSMDocumentPermission -Name "RunShellScriptNew" -PermissionType "Share" -AccountIdsToAdd "123456789012"
```
+ Einzelheiten zur API finden Sie unter [ModifyDocumentPermission AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMActivation`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMActivation`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel enthält Details zu den Aktivierungen in Ihrem Konto.**
```
Get-SSMActivation
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeActivations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMAssociation`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMAssociation`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel beschreibt die Zuordnung zwischen einer Instance und einem Dokument.**
```
Get-SSMAssociation -InstanceId "i-0000293ffd8c57862" -Name "AWS-UpdateSSMAgent"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeAssociation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMAssociationExecution`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMAssociationExecution`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Ausführungen für die angegebene Zuordnungs-ID zurückgegeben**
```
Get-SSMAssociationExecution -AssociationId 123a45a0-c678-9012-3456-78901234db5e
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeAssociationExecutions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMAssociationExecutionTarget`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMAssociationExecutionTarget`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Ressourcen-ID und ihr Ausführungsstatus angezeigt, die Teil der Ausführungsziele der Zuordnung sind**
```
Get-SSMAssociationExecutionTarget -AssociationId 123a45a0-c678-9012-3456-78901234db5e -ExecutionId 123a45a0-c678-9012-3456-78901234db5e | Select-Object ResourceId, Status
```
**Ausgabe:**
```
ResourceId Status
---------- ------
i-0b1b2a3456f7a890b Success
i-01c12a45d6fc7a89f Success
i-0a1caf234f56d7dc8 Success
i-012a3fd45af6dbcfe Failed
i-0ddc1df23c4a5fb67 Success
```
**Beispiel 2: Dieser Befehl überprüft die jeweilige Ausführung einer bestimmten Automatisierung seit gestern, der ein Befehlsdokument zugeordnet ist. Außerdem wird geprüft, ob die Ausführung der Zuordnung fehlgeschlagen ist, und wenn ja, werden die Details zum Befehlsaufruf für die Ausführung zusammen mit der Instance-ID angezeigt**
```
$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
}
}
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeAssociationExecutionTargets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMAssociationList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMAssociationList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel listet Details zu den Zuordnungen für eine Instance auf. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$filter1 = @{Key="InstanceId";Value=@("i-0000293ffd8c57862")}
Get-SSMAssociationList -AssociationFilterList $filter1
```
**Ausgabe:**
```
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}
```
**Beispiel 2: In diesem Beispiel werden alle Verknüpfungen für ein Konfigurationsdokument aufgeführt. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$filter2 = @{Key="Name";Value=@("AWS-UpdateSSMAgent")}
Get-SSMAssociationList -AssociationFilterList $filter2
```
**Ausgabe:**
```
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}
```
**Beispiel 3: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um jeden Filter zu erstellen.**
```
$filter1 = New-Object Amazon.SimpleSystemsManagement.Model.AssociationFilter
$filter1.Key = "InstanceId"
$filter1.Value = "i-0000293ffd8c57862"
Get-SSMAssociationList -AssociationFilterList $filter1
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [ListAssociations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-SSMAssociationVersionList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMAssociationVersionList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Versionen der angegebenen Zuordnung abgerufen.**
```
Get-SSMAssociationVersionList -AssociationId 123a45a0-c678-9012-3456-78901234db5e
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [ListAssociationVersions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMAutomationExecution`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMAutomationExecution`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Details einer Automation-Ausführung angezeigt.**
```
Get-SSMAutomationExecution -AutomationExecutionId "4105a4fc-f944-11e6-9d32-8fb2db27a909"
```
**Ausgabe:**
```
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...}
```
**Beispiel 2: In diesem Beispiel werden die Schrittdetails für die angegebene Automatisierungsausführungs-ID aufgeführt**
```
Get-SSMAutomationExecution -AutomationExecutionId e1d2bad3-4567-8901-ae23-456c7c8901be | Select-Object -ExpandProperty StepExecutions | Select-Object StepName, Action, StepStatus, ValidNextSteps
```
**Ausgabe:**
```
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 {}
```
+ Einzelheiten zur API finden Sie unter [GetAutomationExecution AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMAutomationExecutionList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMAutomationExecutionList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle aktiven und beendeten Automation-Ausführungen beschrieben, die mit Ihrem Konto verknüpft sind.**
```
Get-SSMAutomationExecutionList
```
**Ausgabe:**
```
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]]}
```
**Beispiel 2: In diesem Beispiel werden die Ausführungs-ID, das Dokument und der start/end Ausführungszeitstempel für Ausführungen angezeigt, bei denen es sich nicht um „Success“ handelt AutomationExecutionStatus **
```
Get-SSMAutomationExecutionList | Where-Object AutomationExecutionStatus -ne "Success" | Select-Object AutomationExecutionId, DocumentName, AutomationExecutionStatus, ExecutionStartTime, ExecutionEndTime | Format-Table -AutoSize
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter *AWS -Tools für PowerShell Cmdlet-Referenz* ([DescribeAutomationExecutions](https://docs.aws.amazon.com/powershell/v5/reference)V5).
### `Get-SSMAutomationStepExecution`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMAutomationStepExecution`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen über alle aktiven und beendeten Schrittausführungen in einem Automation-Workflow angezeigt.**
```
Get-SSMAutomationStepExecution -AutomationExecutionId e1d2bad3-4567-8901-ae23-456c7c8901be | Select-Object StepName, Action, StepStatus
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeAutomationStepExecutions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMAvailablePatch`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMAvailablePatch`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel ruft alle verfügbaren Patches für Windows Server 2012 ab, die den MSRC-Schweregrad „Kritisch“ aufweisen. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$filter1 = @{Key="PRODUCT";Values=@("WindowsServer2012")}
$filter2 = @{Key="MSRC_SEVERITY";Values=@("Critical")}
Get-SSMAvailablePatch -Filter $filter1,$filter2
```
**Ausgabe:**
```
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
...
```
**Beispiel 2: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um jeden Filter zu erstellen.**
```
$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
```
**Beispiel 3: In diesem Beispiel werden alle Updates abgerufen, die in den letzten 20 Tagen veröffentlicht wurden und für Produkte gelten, die 2019 entsprechen WindowsServer**
```
Get-SSMAvailablePatch | Where-Object ReleaseDate -ge (Get-Date).AddDays(-20) | Where-Object Product -eq "WindowsServer2019" | Select-Object ReleaseDate, Product, Title
```
**Ausgabe:**
```
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)
```
+ Einzelheiten zur API finden Sie unter [DescribeAvailablePatches AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMCommand`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMCommand`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle angeforderten Befehle aufgeführt.**
```
Get-SSMCommand
```
**Ausgabe:**
```
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 : {}
```
**Beispiel 2: In diesem Beispiel wird der Status eines bestimmten Befehls abgerufen.**
```
Get-SSMCommand -CommandId "4b75a163-d39a-4d97-87c9-98ae52c6be35"
```
**Beispiel 3: In diesem Beispiel werden alle SSM-Befehle abgerufen, die nach dem 2019-04-01T 00:00:00 Z aufgerufen wurden**
```
Get-SSMCommand -Filter @{Key="InvokedAfter";Value="2019-04-01T00:00:00Z"} | Select-Object CommandId, DocumentName, Status, RequestedDateTime | Sort-Object -Property RequestedDateTime -Descending
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListCommands AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMCommandInvocation`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMCommandInvocation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Aufrufe eines Befehls aufgeführt.**
```
Get-SSMCommandInvocation -CommandId "b8eac879-0541-439d-94ec-47a80d554f44" -Detail $true
```
**Ausgabe:**
```
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 :
```
**Beispiel 2: In diesem Beispiel wird der Aufruf der Befehls-ID CommandPlugins e1eb2e3c-ed4c-5123-45c1-234f5612345f aufgeführt**
```
Get-SSMCommandInvocation -CommandId e1eb2e3c-ed4c-5123-45c1-234f5612345f -Detail:$true | Select-Object -ExpandProperty CommandPlugins
```
**Ausgabe:**
```
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
```
+ Einzelheiten *AWS -Tools für PowerShell zur API [ListCommandInvocations](https://docs.aws.amazon.com/powershell/v5/reference)finden Sie unter Cmdlet-Referenz (V5*).
### `Get-SSMCommandInvocationDetail`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMCommandInvocationDetail`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Details eines Befehls angezeigt, der auf einer Instance ausgeführt wurde.**
```
Get-SSMCommandInvocationDetail -InstanceId "i-0cb2b964d3e14fd9f" -CommandId "b8eac879-0541-439d-94ec-47a80d554f44"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetCommandInvocation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMComplianceItemList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMComplianceItemList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Liste der Compliance-Elemente für die angegebene Ressourcen-ID und den angegebenen Ressourcentyp aufgeführt, wobei nach dem Compliance-Typ „Association“ gefiltert wird**
```
Get-SSMComplianceItemList -ResourceId i-1a2caf345f67d0dc2 -ResourceType ManagedInstance -Filter @{Key="ComplianceType";Values="Association"}
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [ListComplianceItems AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMComplianceSummaryList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMComplianceSummaryList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel gibt eine Sammelzahl konformer und nicht konformer Ressourcen für alle Konformitätstypen zurück.**
```
Get-SSMComplianceSummaryList
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [ListComplianceSummaries AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMConnectionStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMConnectionStatus`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Session-Manager-Verbindungsstatus für eine Instance abgerufen, um festzustellen, ob sie verbunden und bereit ist, Session-Manager-Verbindungen zu empfangen.**
```
Get-SSMConnectionStatus -Target i-0a1caf234f12d3dc4
```
**Ausgabe:**
```
Status Target
------ ------
Connected i-0a1caf234f12d3dc4
```
+ Einzelheiten zur API finden Sie unter [GetConnectionStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMDefaultPatchBaseline`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMDefaultPatchBaseline`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Standard-Patch-Baseline angezeigt.**
```
Get-SSMDefaultPatchBaseline
```
**Ausgabe:**
```
arn:aws:ssm:us-west-2:123456789012:patchbaseline/pb-04fb4ae6142167966
```
+ Einzelheiten zur API finden Sie unter [GetDefaultPatchBaseline AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMDeployablePatchSnapshotForInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMDeployablePatchSnapshotForInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der aktuelle Snapshot für die von einer Instance verwendete Patch-Baseline angezeigt. Dieser Befehl muss von der Instance aus mit den Anmeldeinformationen der Instance ausgeführt werden. Um sicherzustellen, dass die Instance-Anmeldedaten verwendet werden, übergibt das Beispiel ein `Amazon.Runtime.InstanceProfileAWSCredentials`-Objekt an den Anmeldeinformationen-Parameter.**
```
$credentials = [Amazon.Runtime.InstanceProfileAWSCredentials]::new()
Get-SSMDeployablePatchSnapshotForInstance -SnapshotId "4681775b-098f-4435-a956-0ef33373ac11" -InstanceId "i-0cb2b964d3e14fd9f" -Credentials $credentials
```
**Ausgabe:**
```
InstanceId SnapshotDownloadUrl
---------- -------------------
i-0cb2b964d3e14fd9f https://patch-baseline-snapshot-us-west-2.s3-us-west-2.amazonaws.com/853d0d3db0f0cafe...1692/4681775b-098f-4435...
```
**Beispiel 2: Dieses Beispiel zeigt, wie man das volle SnapshotDownloadUrl bekommt. Dieser Befehl muss von der Instance aus mit den Anmeldeinformationen der Instance ausgeführt werden. Um sicherzustellen, dass die Instanzanmeldedaten verwendet werden, konfiguriert das Beispiel die PowerShell Sitzung für die Verwendung eines `Amazon.Runtime.InstanceProfileAWSCredentials` Objekts.**
```
Set-AWSCredential -Credential ([Amazon.Runtime.InstanceProfileAWSCredentials]::new())
(Get-SSMDeployablePatchSnapshotForInstance -SnapshotId "4681775b-098f-4435-a956-0ef33373ac11" -InstanceId "i-0cb2b964d3e14fd9f").SnapshotDownloadUrl
```
**Ausgabe:**
```
https://patch-baseline-snapshot-us-west-2.s3-us-west-2.amazonaws.com/853d0d3db0f0cafe...
```
+ Einzelheiten zur API finden Sie unter [GetDeployablePatchSnapshotForInstance AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMDocument`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMDocument`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Inhalt eines Dokuments zurückgegeben.**
```
Get-SSMDocument -Name "RunShellScript"
```
**Ausgabe:**
```
Content
-------
{...
```
**Beispiel 2: In diesem Beispiel wird der vollständige Inhalt eines Dokuments angezeigt.**
```
(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 }}"
}
}
]
}
```
+ Einzelheiten zur API finden Sie unter [GetDocument AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMDocumentDescription`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMDocumentDescription`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zu einem Dokument zurückgegeben.**
```
Get-SSMDocumentDescription -Name "RunShellScript"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeDocument AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMDocumentList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMDocumentList`
**Tools für PowerShell V5**
**Beispiel 1: Listet alle Konfigurationsdokumente in Ihrem Konto auf.**
```
Get-SSMDocumentList
```
**Ausgabe:**
```
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
...
```
**Beispiel 2: In diesem Beispiel werden alle Automatisierungsdokumente abgerufen, deren Name mit „Platform“ übereinstimmt**
```
Get-SSMDocumentList -DocumentFilterList @{Key="DocumentType";Value="Automation"} | Where-Object Name -Match "Platform"
```
**Ausgabe:**
```
DocumentFormat : JSON
DocumentType : Automation
DocumentVersion : 7
Name : KT-Get-Platform
Owner : 987654123456
PlatformTypes : {Windows, Linux}
SchemaVersion : 0.3
Tags : {}
TargetType :
VersionName :
```
+ Einzelheiten zur API finden Sie unter [ListDocuments AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMDocumentPermission`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMDocumentPermission`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Versionen eines Dokuments aufgeführt.**
```
Get-SSMDocumentVersionList -Name "RunShellScript"
```
**Ausgabe:**
```
CreatedDate DocumentVersion IsDefaultVersion Name
----------- --------------- ---------------- ----
2/24/2017 5:25:13 AM 1 True RunShellScript
```
+ Einzelheiten zur API finden Sie unter [DescribeDocumentPermission AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMDocumentVersionList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMDocumentVersionList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Versionen eines Dokuments aufgeführt.**
```
Get-SSMDocumentVersionList -Name "AWS-UpdateSSMAgent"
```
**Ausgabe:**
```
CreatedDate : 6/1/2021 5:19:10 PM
DocumentFormat : JSON
DocumentVersion : 1
IsDefaultVersion : True
Name : AWS-UpdateSSMAgent
Status : Active
```
+ Einzelheiten zur API finden Sie unter [ListDocumentVersions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMEffectiveInstanceAssociationList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMEffectiveInstanceAssociationList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel beschreibt die effektiven Zuordnungen für eine Instance.**
```
Get-SSMEffectiveInstanceAssociationList -InstanceId "i-0000293ffd8c57862" -MaxResult 5
```
**Ausgabe:**
```
AssociationId Content
------------- -------
d8617c07-2079-4c18-9847-1655fc2698b0 {...
```
**Beispiel 2: In diesem Beispiel wird der Inhalt der effektiven Verknüpfungen für eine Instance angezeigt.**
```
(Get-SSMEffectiveInstanceAssociationList -InstanceId "i-0000293ffd8c57862" -MaxResult 5).Content
```
**Ausgabe:**
```
{
"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 }}"
}
]
}
}
}
```
+ Einzelheiten zur API finden Sie unter [DescribeEffectiveInstanceAssociations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMEffectivePatchesForPatchBaseline`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMEffectivePatchesForPatchBaseline`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Patch-Baselines mit einer maximalen Ergebnisliste von 1 aufgeführt.**
```
Get-SSMEffectivePatchesForPatchBaseline -BaselineId "pb-0a2f1059b670ebd31" -MaxResult 1
```
**Ausgabe:**
```
Patch PatchStatus
----- -----------
Amazon.SimpleSystemsManagement.Model.Patch Amazon.SimpleSystemsManagement.Model.PatchStatus
```
**Beispiel 2: In diesem Beispiel wird der Patchstatus für alle Patch-Baselines mit einer maximalen Ergebnisliste von 1 angezeigt.**
```
(Get-SSMEffectivePatchesForPatchBaseline -BaselineId "pb-0a2f1059b670ebd31" -MaxResult 1).PatchStatus
```
**Ausgabe:**
```
ApprovalDate DeploymentStatus
------------ ----------------
12/21/2010 6:00:00 PM APPROVED
```
+ Einzelheiten zur API finden Sie unter [DescribeEffectivePatchesForPatchBaseline AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMInstanceAssociationsStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMInstanceAssociationsStatus`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel zeigt Details zu den Zuordnungen für eine Instance.**
```
Get-SSMInstanceAssociationsStatus -InstanceId "i-0000293ffd8c57862"
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel wird der Status der Instance-Zuordnung für die angegebene Instance-ID überprüft und außerdem der Ausführungsstatus dieser Zuordnungen angezeigt**
```
Get-SSMInstanceAssociationsStatus -InstanceId i-012e3cb4df567e8aa | ForEach-Object {Get-SSMAssociationExecution -AssociationId .AssociationId}
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeInstanceAssociationsStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMInstanceInformation`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMInstanceInformation`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel zeigt Details zu jeder Ihrer Instances.**
```
Get-SSMInstanceInformation
```
**Ausgabe:**
```
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
```
**Beispiel 2: Dieses Beispiel zeigt, wie der Parameter -Filter verwendet wird, um Ergebnisse nur nach den AWS Systems Manager Manager-Instanzen in der Region `us-east-1` mit dem Wert `AgentVersion` von `2.2.800.0` zu filtern. Eine Liste der gültigen -Filter-Schlüsselwerte finden Sie im InstanceInformation API-Referenzthema (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
```
**Ausgabe:**
```
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
```
**Beispiel 3: Dieses Beispiel zeigt, wie der InstanceInformationFilterList Parameter - verwendet wird, um Ergebnisse nur nach den AWS Systems Manager Manager-Instanzen in `PlatformTypes` der Region `us-east-1` mit `Windows` oder zu filtern`Linux`. Eine Liste der gültigen InstanceInformationFilterList Schlüsselwerte finden Sie im InstanceInformationFilter API-Referenzthema (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
```
**Ausgabe:**
```
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
```
**Beispiel 4: In diesem Beispiel werden von SSM verwaltete Instanzen und Exporte InstanceId LastPingDateTime sowie PlatformName in eine CSV-Datei aufgeführt. PingStatus**
```
Get-SSMInstanceInformation | Select-Object InstanceId, PingStatus, LastPingDateTime, PlatformName | Export-Csv Instance-details.csv -NoTypeInformation
```
+ Einzelheiten zur API finden Sie unter [DescribeInstanceInformation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMInstancePatch`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMInstancePatch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Details zur Patch-Konformität für eine Instance abgerufen.**
```
Get-SSMInstancePatch -InstanceId "i-08ee91c0b17045407"
```
+ Einzelheiten zur API finden Sie unter [DescribeInstancePatches AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMInstancePatchState`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMInstancePatchState`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Status der Patch-Zusammenfassung für eine Instance abgerufen.**
```
Get-SSMInstancePatchState -InstanceId "i-08ee91c0b17045407"
```
**Beispiel 2: In diesem Beispiel werden die Status der Patch-Zusammenfassung für zwei Instances abgerufen.**
```
Get-SSMInstancePatchState -InstanceId "i-08ee91c0b17045407","i-09a618aec652973a9"
```
+ Einzelheiten zur API finden Sie unter [DescribeInstancePatchStates AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMInstancePatchStatesForPatchGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMInstancePatchStatesForPatchGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden für eine Patch-Gruppe eine Übersicht über den Patch-Zustand auf der Ebene einzelner Instances abgerufen.**
```
Get-SSMInstancePatchStatesForPatchGroup -PatchGroup "Production"
```
+ Einzelheiten zur API finden Sie unter [DescribeInstancePatchStatesForPatchGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMInventory`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMInventory`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die benutzerdefinierten Metadaten für Ihr Inventar abgerufen.**
```
Get-SSMInventory
```
**Ausgabe:**
```
Data Id
---- --
{[AWS:InstanceInformation, Amazon.SimpleSystemsManagement.Model.InventoryResultItem]} i-0cb2b964d3e14fd9f
```
+ Einzelheiten zur API finden Sie unter [GetInventory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMInventoryEntriesList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMInventoryEntriesList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle benutzerdefinierten Inventareinträge für eine Instance aufgeführt.**
```
Get-SSMInventoryEntriesList -InstanceId "i-0cb2b964d3e14fd9f" -TypeName "Custom:RackInfo"
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden die Details aufgeführt.**
```
(Get-SSMInventoryEntriesList -InstanceId "i-0cb2b964d3e14fd9f" -TypeName "Custom:RackInfo").Entries
```
**Ausgabe:**
```
Key Value
--- -----
RackLocation Bay B/Row C/Rack D/Shelf E
```
+ Einzelheiten zur API finden Sie unter [ListInventoryEntries AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMInventoryEntryList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMInventoryEntryList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden `AWS:Network`-Typinventareinträge für die Instance abgerufen.**
```
Get-SSMInventoryEntryList -InstanceId mi-088dcb0ecea37b076 -TypeName AWS:Network | Select-Object -ExpandProperty Entries
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [Get- SSMInventory EntryList](https://docs.aws.amazon.com/powershell/v5/reference) in *AWS -Tools für PowerShell Cmdlet-Referenz (*V5).
### `Get-SSMInventorySchema`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMInventorySchema`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Liste von Inventartypnamen für das Konto zurückgegeben.**
```
Get-SSMInventorySchema
```
+ Einzelheiten zur API finden Sie unter [GetInventorySchema AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMLatestEC2Image`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMLatestEC2Image`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel listet die neuesten Windows auf. AMIs**
```
PS Get-SSMLatestEC2Image -Path ami-windows-latest
```
**Ausgabe:**
```
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
...
```
**Beispiel 2: In diesem Beispiel wird die AMI-ID eines bestimmten Amazon-Linux-Images für die Region us-west-2 abgerufen.**
```
PS Get-SSMLatestEC2Image -Path ami-amazon-linux-latest -ImageName amzn-ami-hvm-x86_64-ebs -Region us-west-2
```
**Ausgabe:**
```
ami-09b92cd132204c704
```
**Beispiel 3: In diesem Beispiel werden alle neuesten Windows aufgeführt, die dem angegebenen Platzhalterausdruck AMIs entsprechen.**
```
Get-SSMLatestEC2Image -Path ami-windows-latest -ImageName *Windows*2019*English*
```
**Ausgabe:**
```
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
...
```
+ API-Einzelheiten finden [Sie unter SSMLatest EC2 Get-Image in *AWS -Tools für PowerShell Cmdlet-Referenz*](https://docs.aws.amazon.com/powershell/v5/reference) (V5).
### `Get-SSMMaintenanceWindow`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMMaintenanceWindow`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zu einem Wartungsfenster abgerufen.**
```
Get-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetMaintenanceWindow AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMMaintenanceWindowExecution`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMMaintenanceWindowExecution`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel listet Informationen über eine Aufgabenausführungen als Teil einer Wartungsfenster-Ausführung auf.**
```
Get-SSMMaintenanceWindowExecution -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetMaintenanceWindowExecution AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMMaintenanceWindowExecutionList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMMaintenanceWindowExecutionList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Ausführungen für ein Wartungsfenster aufgeführt.**
```
Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d"
```
**Ausgabe:**
```
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
```
**Beispiel 2: In diesem Beispiel werden alle Ausführungen für ein Wartungsfenster vor einem bestimmten Datum aufgeführt.**
```
$option1 = @{Key="ExecutedBefore";Values=@("2016-11-04T05:00:00Z")}
Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d" -Filter $option1
```
**Beispiel 3: In diesem Beispiel werden alle Ausführungen für ein Wartungsfenster nach einem bestimmten Datum aufgeführt.**
```
$option1 = @{Key="ExecutedAfter";Values=@("2016-11-04T05:00:00Z")}
Get-SSMMaintenanceWindowExecutionList -WindowId "mw-03eb9db42890fb82d" -Filter $option1
```
+ Einzelheiten zur API finden Sie unter [DescribeMaintenanceWindowExecutions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMMaintenanceWindowExecutionTask`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMMaintenanceWindowExecutionTask`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Informationen zu einer Aufgabe aufgeführt, die Teil einer Ausführung im Rahmen eines Wartungsfensters war.**
```
Get-SSMMaintenanceWindowExecutionTask -TaskId "ac0c6ae1-daa3-4a89-832e-d384503b6586" -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [GetMaintenanceWindowExecutionTask AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMMaintenanceWindowExecutionTaskInvocationList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMMaintenanceWindowExecutionTaskInvocationList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel listet die Aufrufe einer Aufgabenausführungen als Teil einer Wartungsfenster-Ausführung auf.**
```
Get-SSMMaintenanceWindowExecutionTaskInvocationList -TaskId "ac0c6ae1-daa3-4a89-832e-d384503b6586" -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Ausgabe:**
```
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 :
```
+ Einzelheiten zur API finden Sie unter [DescribeMaintenanceWindowExecutionTaskInvocations AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMMaintenanceWindowExecutionTaskList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMMaintenanceWindowExecutionTaskList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel listet die Aufgaben auf, die mit der Ausführung eines Wartungsfensters verbunden sind.**
```
Get-SSMMaintenanceWindowExecutionTaskList -WindowExecutionId "518d5565-5969-4cca-8f0e-da3b2a638355"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeMaintenanceWindowExecutionTasks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMMaintenanceWindowList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMMaintenanceWindowList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Wartungsfenster in Ihrem Konto aufgeführt.**
```
Get-SSMMaintenanceWindowList
```
**Ausgabe:**
```
Cutoff : 1
Duration : 4
Enabled : True
Name : My-First-Maintenance-Window
WindowId : mw-06d59c1a07c022145
```
+ Einzelheiten zur API finden Sie unter [DescribeMaintenanceWindows AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMMaintenanceWindowTarget`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMMaintenanceWindowTarget`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Ziele für ein Wartungsfenster aufgeführt.**
```
Get-SSMMaintenanceWindowTarget -WindowId "mw-06cf17cbefcb4bf4f"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeMaintenanceWindowTargets AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMMaintenanceWindowTaskList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMMaintenanceWindowTaskList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden alle Aufgaben für ein Wartungsfenster aufgeführt.**
```
Get-SSMMaintenanceWindowTaskList -WindowId "mw-06cf17cbefcb4bf4f"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeMaintenanceWindowTasks AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMParameterHistory`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMParameterHistory`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Werteverlauf für einen Parameter aufgeführt.**
```
Get-SSMParameterHistory -Name "Welcome"
```
**Ausgabe:**
```
Description :
KeyId :
LastModifiedDate : 3/3/2017 6:55:25 PM
LastModifiedUser : arn:aws:iam::123456789012:user/admin
Name : Welcome
Type : String
Value : helloWorld
```
+ Einzelheiten zur API finden Sie unter [GetParameterHistory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMParameterList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMParameterList`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel listet alle Parameter auf.**
```
Get-SSMParameterList
```
**Ausgabe:**
```
Description :
KeyId :
LastModifiedDate : 3/3/2017 6:58:23 PM
LastModifiedUser : arn:aws:iam::123456789012:user/admin
Name : Welcome
Type : String
```
+ Einzelheiten zur API finden Sie unter [DescribeParameters AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMParameterValue`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMParameterValue`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Werte für einen Parameter aufgeführt.**
```
Get-SSMParameterValue -Name "Welcome"
```
**Ausgabe:**
```
InvalidParameters Parameters
----------------- ----------
{} {Welcome}
```
**Beispiel 2: In diesem Beispiel werden die Details des Werts aufgeführt.**
```
(Get-SSMParameterValue -Name "Welcome").Parameters
```
**Ausgabe:**
```
Name Type Value
---- ---- -----
Welcome String Good day, Sunshine!
```
+ Einzelheiten zur API finden Sie unter [GetParameters AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMPatchBaseline`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMPatchBaseline`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel listet alle Patch-Baselines auf.**
```
Get-SSMPatchBaseline
```
**Ausgabe:**
```
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...
```
**Beispiel 2: Dieses Beispiel listet alle Patch-Baselines auf, die von bereitgestellt werden. AWS Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$filter1 = @{Key="OWNER";Values=@("AWS")}
```
**Ausgabe:**
```
Get-SSMPatchBaseline -Filter $filter1
```
**Beispiel 3: In diesem Beispiel werden alle Patch-Baselines mit Ihnen als Eigentümer aufgeführt. Die in diesem Beispiel verwendete Syntax erfordert PowerShell Version 3 oder höher.**
```
$filter1 = @{Key="OWNER";Values=@("Self")}
```
**Ausgabe:**
```
Get-SSMPatchBaseline -Filter $filter1
```
**Beispiel 4: Bei PowerShell Version 2 müssen Sie New-Object verwenden, um jedes Tag zu erstellen.**
```
$filter1 = New-Object Amazon.SimpleSystemsManagement.Model.PatchOrchestratorFilter
$filter1.Key = "OWNER"
$filter1.Values = "AWS"
Get-SSMPatchBaseline -Filter $filter1
```
**Ausgabe:**
```
BaselineDescription BaselineId BaselineName DefaultBaselin
e
------------------- ---------- ------------ --------------
Default Patch Baseline Provided by AWS. arn:aws:ssm:us-west-2:123456789012:patchbaseline/pb-04fb4ae6142167966 AWS-DefaultPatchBaseline True
```
+ Einzelheiten zur API finden Sie unter [DescribePatchBaselines AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Get-SSMPatchBaselineDetail`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMPatchBaselineDetail`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Details für eine Patch-Baseline angezeigt.**
```
Get-SSMPatchBaselineDetail -BaselineId "pb-03da896ca3b68b639"
```
**Ausgabe:**
```
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 : {}
```
+ Einzelheiten zur API finden Sie unter [GetPatchBaseline AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMPatchBaselineForPatchGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMPatchBaselineForPatchGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Patch-Baseline für eine Patchgruppe angezeigt.**
```
Get-SSMPatchBaselineForPatchGroup -PatchGroup "Production"
```
**Ausgabe:**
```
BaselineId PatchGroup
---------- ----------
pb-045f10b4f382baeda Production
```
+ Einzelheiten zur API finden Sie unter [GetPatchBaselineForPatchGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMPatchGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMPatchGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Registrierungen der Patchgruppen aufgeführt.**
```
Get-SSMPatchGroup
```
**Ausgabe:**
```
BaselineIdentity PatchGroup
---------------- ----------
Amazon.SimpleSystemsManagement.Model.PatchBaselineIdentity Production
```
+ Einzelheiten zur API finden Sie unter [DescribePatchGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMPatchGroupState`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMPatchGroupState`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die allgemeine Zusammenfassung der Patch-Konformität für eine Patch-Gruppe abgerufen.**
```
Get-SSMPatchGroupState -PatchGroup "Production"
```
**Ausgabe:**
```
Instances : 4
InstancesWithFailedPatches : 1
InstancesWithInstalledOtherPatches : 4
InstancesWithInstalledPatches : 3
InstancesWithMissingPatches : 0
InstancesWithNotApplicablePatches : 0
```
+ Einzelheiten zur API finden Sie unter [DescribePatchGroupState AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-SSMResourceComplianceSummaryList`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMResourceComplianceSummaryList`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Zusammenfassung der Anzahl auf Ressourcenebene abgerufen. Die Zusammenfassung enthält Informationen über den Status „konform“ und „nicht konform“ sowie detaillierte Angaben zum Schweregrad von Produkten, die „Windows10“ entsprechen. Da der MaxResult Standardwert 100 ist, wenn der Parameter nicht angegeben ist und dieser Wert nicht gültig ist, wird der MaxResult Parameter hinzugefügt und der Wert auf 50 gesetzt.**
```
$FilterValues = @{
"Key"="Product"
"Type"="EQUAL"
"Values"="Windows10"
}
Get-SSMResourceComplianceSummaryList -Filter $FilterValues -MaxResult 50
```
+ Einzelheiten zur API finden Sie unter [ListResourceComplianceSummaries AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-SSMResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-SSMResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel listet die Tags für ein Wartungsfenster auf.**
```
Get-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow"
```
**Ausgabe:**
```
Key Value
--- -----
Stack Production
```
+ Einzelheiten zur API finden Sie unter [ListTagsForResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-SSMActivation`
Das folgende Codebeispiel zeigt die Verwendung. `New-SSMActivation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine verwaltete Instance erstellt.**
```
New-SSMActivation -DefaultInstanceName "MyWebServers" -IamRole "SSMAutomationRole" -RegistrationLimit 10
```
**Ausgabe:**
```
ActivationCode ActivationId
-------------- ------------
KWChhOxBTiwDcKE9BlKC 08e51e79-1e36-446c-8e63-9458569c1363
```
+ Einzelheiten zur API finden Sie unter [CreateActivation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-SSMAssociation`
Das folgende Codebeispiel zeigt die Verwendung. `New-SSMAssociation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird mithilfe von instance ein Konfigurationsdokument einer Instanz zugeordnet. IDs**
```
New-SSMAssociation -InstanceId "i-0cb2b964d3e14fd9f" -Name "AWS-UpdateSSMAgent"
```
**Ausgabe:**
```
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 :
```
**Beispiel 2: In diesem Beispiel wird mithilfe von Zielen ein Konfigurationsdokument einer Instance zugeordnet.**
```
$target = @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")}
New-SSMAssociation -Name "AWS-UpdateSSMAgent" -Target $target
```
**Ausgabe:**
```
Name : AWS-UpdateSSMAgent
InstanceId :
Date : 3/1/2017 6:22:21 PM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
**Beispiel 3: In diesem Beispiel wird mithilfe von Zielen und Parametern ein Konfigurationsdokument einer Instance zugeordnet.**
```
$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
```
**Ausgabe:**
```
Name : Configure-CloudWatch
InstanceId :
Date : 5/17/2018 3:17:44 PM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
**Beispiel 4: In diesem Beispiel wird eine Zuordnung mit allen Instances in der Region erstellt, mit`AWS-GatherSoftwareInventory`. Außerdem werden benutzerdefinierte Dateien und Registrierungsverzeichnisse in den zu erfassenden Parametern bereitgestellt**
```
$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)"
```
**Ausgabe:**
```
Name : AWS-GatherSoftwareInventory
InstanceId :
Date : 6/9/2019 8:57:56 AM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
+ Einzelheiten zur API finden Sie unter [CreateAssociation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-SSMAssociationFromBatch`
Das folgende Codebeispiel zeigt die Verwendung. `New-SSMAssociationFromBatch`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Konfigurationsdokument mehreren Instances zugeordnet. Die Ausgabe gibt gegebenenfalls eine Liste mit erfolgreichen und fehlgeschlagenen Vorgängen zurück.**
```
$option1 = @{InstanceId="i-0cb2b964d3e14fd9f";Name=@("AWS-UpdateSSMAgent")}
$option2 = @{InstanceId="i-0000293ffd8c57862";Name=@("AWS-UpdateSSMAgent")}
New-SSMAssociationFromBatch -Entry $option1,$option2
```
**Ausgabe:**
```
Failed Successful
------ ----------
{} {Amazon.SimpleSystemsManagement.Model.FailedCreateAssociation, Amazon.SimpleSystemsManagement.Model.FailedCreateAsso...
```
**Beispiel 2: In diesem Beispiel werden alle Details eines erfolgreichen Vorgangs angezeigt.**
```
$option1 = @{InstanceId="i-0cb2b964d3e14fd9f";Name=@("AWS-UpdateSSMAgent")}
$option2 = @{InstanceId="i-0000293ffd8c57862";Name=@("AWS-UpdateSSMAgent")}
(New-SSMAssociationFromBatch -Entry $option1,$option2).Successful
```
+ Einzelheiten zur API finden Sie unter [CreateAssociationBatch AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-SSMDocument`
Das folgende Codebeispiel zeigt die Verwendung. `New-SSMDocument`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Dokument in Ihrem Konto erstellt. Das Dokument muss im JSON-Format vorliegen. Weitere Informationen zum Schreiben eines Konfigurationsdokuments finden Sie unter Konfigurationsdokument in der SSM-API-Referenz.**
```
New-SSMDocument -Content (Get-Content -Raw "c:\temp\RunShellScript.json") -Name "RunShellScript" -DocumentType "Command"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [CreateDocument AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-SSMMaintenanceWindow`
Das folgende Codebeispiel zeigt die Verwendung. `New-SSMMaintenanceWindow`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein neues Wartungsfenster mit dem angegebenen Namen erstellt, das an jedem Dienstag um 16 Uhr für 4 Stunden läuft, mit einer Frist von 1 Stunde, und das Ziele ohne Zuordnung zulässt.**
```
New-SSMMaintenanceWindow -Name "MyMaintenanceWindow" -Duration 4 -Cutoff 1 -AllowUnassociatedTarget $true -Schedule "cron(0 16 ? * TUE *)"
```
**Ausgabe:**
```
mw-03eb53e1ea7383998
```
+ Einzelheiten zur API finden Sie unter [CreateMaintenanceWindow AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-SSMPatchBaseline`
Das folgende Codebeispiel zeigt die Verwendung. `New-SSMPatchBaseline`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Patch-Baseline erstellt, die Patches sieben Tage nach der Veröffentlichung durch Microsoft für verwaltete Instances genehmigt, auf denen Windows Server 2019 in einer Produktionsumgebung ausgeführt wird.**
```
$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
```
**Ausgabe:**
```
pb-0z4z6221c4296b23z
```
+ Einzelheiten zur API finden Sie unter [CreatePatchBaseline AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-SSMDefaultPatchBaseline`
Das folgende Codebeispiel zeigt die Verwendung. `Register-SSMDefaultPatchBaseline`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Patch-Baseline als Standard-Patch-Baseline registriert.**
```
Register-SSMDefaultPatchBaseline -BaselineId "pb-03da896ca3b68b639"
```
**Ausgabe:**
```
pb-03da896ca3b68b639
```
+ Einzelheiten zur API finden Sie unter [RegisterDefaultPatchBaseline AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-SSMPatchBaselineForPatchGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Register-SSMPatchBaselineForPatchGroup`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel registriert eine Patch-Baseline für eine Patch-Gruppe.**
```
Register-SSMPatchBaselineForPatchGroup -BaselineId "pb-03da896ca3b68b639" -PatchGroup "Production"
```
**Ausgabe:**
```
BaselineId PatchGroup
---------- ----------
pb-03da896ca3b68b639 Production
```
+ Einzelheiten zur API finden Sie unter [RegisterPatchBaselineForPatchGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-SSMTargetWithMaintenanceWindow`
Das folgende Codebeispiel zeigt die Verwendung. `Register-SSMTargetWithMaintenanceWindow`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Instance mit einem Wartungsfenster registriert.**
```
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"
```
**Ausgabe:**
```
d8e47760-23ed-46a5-9f28-927337725398
```
**Beispiel 2: In diesem Beispiel werden mehrere Instances mit einem Wartungsfenster registriert.**
```
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"
```
**Ausgabe:**
```
6ab5c208-9fc4-4697-84b7-b02a6cc25f7d
```
**Beispiel 3: In diesem Beispiel wird mithilfe von EC2 Tags eine Instanz mit einem Wartungsfenster registriert.**
```
$option1 = @{Key="tag:Environment";Values=@("Production")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE"
```
**Ausgabe:**
```
2994977e-aefb-4a71-beac-df620352f184
```
+ Einzelheiten zur API finden Sie unter [RegisterTargetWithMaintenanceWindow AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Register-SSMTaskWithMaintenanceWindow`
Das folgende Codebeispiel zeigt die Verwendung. `Register-SSMTaskWithMaintenanceWindow`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Aufgabe mit einem Wartungsfenster unter Verwendung einer Instance-ID registriert. Die Ausgabe ist die Aufgaben-ID.**
```
$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
```
**Ausgabe:**
```
f34a2c47-ddfd-4c85-a88d-72366b69af1b
```
**Beispiel 2: In diesem Beispiel wird eine Aufgabe mit einem Wartungsfenster unter Verwendung einer Ziel-ID registriert. Die Ausgabe ist die Aufgaben-ID.**
```
$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
```
**Ausgabe:**
```
f34a2c47-ddfd-4c85-a88d-72366b69af1b
```
**Beispiel 3: In diesem Beispiel wird ein Parameterobjekt für das Run-Befehlsdokument `AWS-RunPowerShellScript` und eine Aufgabe mit einem bestimmten Wartungsfenster unter Verwendung der Ziel-ID erstellt. Die Rückgabeausgabe ist die Aufgaben-ID.**
```
$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
```
**Ausgabe:**
```
f1e2ef34-5678-12e3-456a-12334c5c6cbe
```
**Beispiel 4: In diesem Beispiel wird eine AWS Systems Manager Automation-Aufgabe mithilfe eines Dokuments mit dem Namen registriert`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"
```
+ Einzelheiten zur API finden Sie unter [RegisterTaskWithMaintenanceWindow AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Remove-SSMActivation`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-SSMActivation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Aktivierung gelöscht. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Remove-SSMActivation -ActivationId "08e51e79-1e36-446c-8e63-9458569c1363"
```
+ Einzelheiten zur API finden Sie unter [DeleteActivation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-SSMAssociation`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-SSMAssociation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Verknüpfung zwischen einer Instance und einem Dokument gelöscht. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Remove-SSMAssociation -InstanceId "i-0cb2b964d3e14fd9f" -Name "AWS-UpdateSSMAgent"
```
+ Einzelheiten zur API finden Sie unter [DeleteAssociation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-SSMDocument`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-SSMDocument`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Dokument gelöscht. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Remove-SSMDocument -Name "RunShellScript"
```
+ Einzelheiten zur API finden Sie unter [DeleteDocument AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-SSMMaintenanceWindow`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-SSMMaintenanceWindow`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Wartungsfenster entfernt.**
```
Remove-SSMMaintenanceWindow -WindowId "mw-06d59c1a07c022145"
```
**Ausgabe:**
```
mw-06d59c1a07c022145
```
+ Einzelheiten zur API finden Sie unter [DeleteMaintenanceWindow AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-SSMParameter`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-SSMParameter`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Parameter gelöscht. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Remove-SSMParameter -Name "helloWorld"
```
+ Einzelheiten zur API finden Sie unter [DeleteParameter AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-SSMPatchBaseline`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-SSMPatchBaseline`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Patch-Baseline gelöscht.**
```
Remove-SSMPatchBaseline -BaselineId "pb-045f10b4f382baeda"
```
**Ausgabe:**
```
pb-045f10b4f382baeda
```
+ Einzelheiten zur API finden Sie unter [DeletePatchBaseline AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-SSMResourceTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-SSMResourceTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Tag aus einem Wartungsfenster entfernt. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Remove-SSMResourceTag -ResourceId "mw-03eb9db42890fb82d" -ResourceType "MaintenanceWindow" -TagKey "Production"
```
+ Einzelheiten zur API finden Sie unter [RemoveTagsFromResource AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Send-SSMCommand`
Das folgende Codebeispiel zeigt die Verwendung. `Send-SSMCommand`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Echo-Befehl auf einer Ziel-Instance ausgeführt.**
```
Send-SSMCommand -DocumentName "AWS-RunPowerShellScript" -Parameter @{commands = "echo helloWorld"} -Target @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")}
```
**Ausgabe:**
```
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}
```
**Beispiel 2: Dieses Beispiel zeigt, wie ein Befehl ausgeführt wird, der verschachtelte Parameter akzeptiert.**
```
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
```
+ Einzelheiten zur API finden Sie unter [SendCommand AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Start-SSMAutomationExecution`
Das folgende Codebeispiel zeigt die Verwendung. `Start-SSMAutomationExecution`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Dokument ausgeführt, das eine Automatisierungsrolle, eine AMI-Quell-ID und eine EC2 Amazon-Instance-Rolle angibt.**
```
Start-SSMAutomationExecution -DocumentName AWS-UpdateLinuxAmi -Parameter @{'AutomationAssumeRole'='arn:aws:iam::123456789012:role/SSMAutomationRole';'SourceAmiId'='ami-f173cc91';'InstanceIamRole'='EC2InstanceRole'}
```
**Ausgabe:**
```
3a532a4f-0382-11e7-9df7-6f11185f6dd1
```
+ Einzelheiten zur API finden Sie unter [StartAutomationExecution AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Start-SSMSession`
Das folgende Codebeispiel zeigt die Verwendung. `Start-SSMSession`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Verbindung zu einem Ziel für eine Session-Manager-Sitzung initiiert, wodurch die Portweiterleitung aktiviert wird. Hinweis: Sie müssen den Region-Parameter hinzufügen, falls er nicht bereits mit AWSCredentials festgelegt wurde.**
```
Start-SSMSession -Target 'i-064578e5e7454488f' -DocumentName 'AWS-StartPortForwardingSession' -Parameter @{ localPortNumber = '8080'; portNumber = '80' } -Region 'us-west-1'
```
**Ausgabe:**
```
Starting session with SessionId: testUser-xi4glew849asyeryde34u4dfsdfy
Port 8080 opened for sessionId testUser-xi4glew849asyeryde34u4dfsdfy.
Waiting for connections...
```
**Beispiel 2: Hier wird eine interaktive Sitzung mit einer angegebenen Instance für eine Session-Manager-Sitzung erstellt.**
```
Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1'
```
**Ausgabe:**
```
Starting session with SessionId : testUser-xi4glew849asyeryde34u4dfsdfy
Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.
Install the latest PowerShell for new features and improvements!
PS C:\Windows\system32> whoami
ec2amaz-fnsdrwv\ec2-test-user
PS C:\Windows\system32>
```
**Beispiel 3: Dieses Beispiel erstellt eine Sitzung, ohne eine Verbindung herzustellen, und gibt die TokenValue Eigenschaften SessionId, und zurück StreamUrl, die für die Verbindung mit der Sitzung erforderlich sind.**
```
Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1' -DisablePluginInvocation
```
**Ausgabe:**
```
SessionId : testUser-xi4glew849asyeryde34u4dfsdfy
StreamUrl : {StreamUrl value redacted}
TokenValue : {Token value redacted}
ContentLength : 1207
HttpStatusCode : OK
```
+ Einzelheiten zur API finden Sie unter [StartSession AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Stop-SSMAutomationExecution`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-SSMAutomationExecution`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Automation-Ausführung gestoppt. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Stop-SSMAutomationExecution -AutomationExecutionId "4105a4fc-f944-11e6-9d32-8fb2db27a909"
```
+ Einzelheiten zur API finden Sie unter [StopAutomationExecution AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Stop-SSMCommand`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-SSMCommand`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird versucht, einen Befehl abzubrechen. Wenn der Vorgang erfolgreich ist, erfolgt keine Ausgabe.**
```
Stop-SSMCommand -CommandId "9ded293e-e792-4440-8e3e-7b8ec5feaa38"
```
+ Einzelheiten zur API finden Sie unter [CancelCommand AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-SSMManagedInstance`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-SSMManagedInstance`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Registrierung einer verwalteten Instance aufgehoben. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Unregister-SSMManagedInstance -InstanceId "mi-08ab247cdf1046573"
```
+ Einzelheiten zur API finden Sie unter [DeregisterManagedInstance AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-SSMPatchBaselineForPatchGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-SSMPatchBaselineForPatchGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Registrierung einer Patchgruppe von einer Patch-Baseline aufgehoben.**
```
Unregister-SSMPatchBaselineForPatchGroup -BaselineId "pb-045f10b4f382baeda" -PatchGroup "Production"
```
**Ausgabe:**
```
BaselineId PatchGroup
---------- ----------
pb-045f10b4f382baeda Production
```
+ Einzelheiten zur API finden Sie unter [DeregisterPatchBaselineForPatchGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-SSMTargetFromMaintenanceWindow`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-SSMTargetFromMaintenanceWindow`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Ziel aus einem Wartungsfenster entfernt.**
```
Unregister-SSMTargetFromMaintenanceWindow -WindowTargetId "6ab5c208-9fc4-4697-84b7-b02a6cc25f7d" -WindowId "mw-06cf17cbefcb4bf4f"
```
**Ausgabe:**
```
WindowId WindowTargetId
-------- --------------
mw-06cf17cbefcb4bf4f 6ab5c208-9fc4-4697-84b7-b02a6cc25f7d
```
+ Einzelheiten zur API finden Sie unter [DeregisterTargetFromMaintenanceWindow AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Unregister-SSMTaskFromMaintenanceWindow`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-SSMTaskFromMaintenanceWindow`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Aufgabe aus einem Wartungsfenster entfernt.**
```
Unregister-SSMTaskFromMaintenanceWindow -WindowTaskId "f34a2c47-ddfd-4c85-a88d-72366b69af1b" -WindowId "mw-03a342e62c96d31b0"
```
**Ausgabe:**
```
WindowId WindowTaskId
-------- ------------
mw-03a342e62c96d31b0 f34a2c47-ddfd-4c85-a88d-72366b69af1b
```
+ Einzelheiten zur API finden Sie unter [DeregisterTaskFromMaintenanceWindow AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-SSMAssociation`
Das folgende Codebeispiel zeigt die Verwendung. `Update-SSMAssociation`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird eine Verknüpfung mit einer neuen Dokumentversion aktualisiert.**
```
Update-SSMAssociation -AssociationId "93285663-92df-44cb-9f26-2292d4ecc439" -DocumentVersion "1"
```
**Ausgabe:**
```
Name : AWS-UpdateSSMAgent
InstanceId :
Date : 3/1/2017 6:22:21 PM
Status.Name :
Status.Date :
Status.Message :
Status.AdditionalInfo :
```
+ Einzelheiten zur API finden Sie unter [UpdateAssociation AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-SSMAssociationStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Update-SSMAssociationStatus`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Zuordnungsstatus der Zuordnung zwischen einer Instance und einem Konfigurationsdokument aktualisiert.**
```
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"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UpdateAssociationStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-SSMDocument`
Das folgende Codebeispiel zeigt die Verwendung. `Update-SSMDocument`
**Tools für PowerShell V5**
**Beispiel 1: Dadurch wird eine neue Version eines Dokuments mit dem aktualisierten Inhalt der von Ihnen angegebenen JSON-Datei erstellt. Das Dokument muss im JSON-Format vorliegen. Sie können die Dokumentversion mit dem Cmdlet „Get- SSMDocumentVersionList“ abrufen.**
```
Update-SSMDocument -Name RunShellScript -DocumentVersion "1" -Content (Get-Content -Raw "c:\temp\RunShellScript.json")
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [UpdateDocument AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Update-SSMDocumentDefaultVersion`
Das folgende Codebeispiel zeigt die Verwendung. `Update-SSMDocumentDefaultVersion`
**Tools für PowerShell V5**
**Beispiel 1: Dadurch wird die Standardversion eines Dokuments aktualisiert. Sie können die verfügbaren Dokumentversionen mit dem Cmdlet „Get- SSMDocumentVersionList“ abrufen.**
```
Update-SSMDocumentDefaultVersion -Name "RunShellScript" -DocumentVersion "2"
```
**Ausgabe:**
```
DefaultVersion Name
-------------- ----
2 RunShellScript
```
+ Einzelheiten zur API finden Sie unter [UpdateDocumentDefaultVersion AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Update-SSMMaintenanceWindow`
Das folgende Codebeispiel zeigt die Verwendung. `Update-SSMMaintenanceWindow`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Name eines Wartungsfensters aktualisiert.**
```
Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Name "My-Renamed-MW"
```
**Ausgabe:**
```
AllowUnassociatedTargets : False
Cutoff : 1
Duration : 2
Enabled : True
Name : My-Renamed-MW
Schedule : cron(0 */30 * * * ? *)
WindowId : mw-03eb9db42890fb82d
```
**Beispiel 2: In diesem Beispiel wird ein Wartungsfenster aktiviert.**
```
Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Enabled $true
```
**Ausgabe:**
```
AllowUnassociatedTargets : False
Cutoff : 1
Duration : 2
Enabled : True
Name : My-Renamed-MW
Schedule : cron(0 */30 * * * ? *)
WindowId : mw-03eb9db42890fb82d
```
**Beispiel 3: In diesem Beispiel wird ein Wartungsfenster deaktiviert.**
```
Update-SSMMaintenanceWindow -WindowId "mw-03eb9db42890fb82d" -Enabled $false
```
**Ausgabe:**
```
AllowUnassociatedTargets : False
Cutoff : 1
Duration : 2
Enabled : False
Name : My-Renamed-MW
Schedule : cron(0 */30 * * * ? *)
WindowId : mw-03eb9db42890fb82d
```
+ Einzelheiten zur API finden Sie unter [UpdateMaintenanceWindow AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-SSMManagedInstanceRole`
Das folgende Codebeispiel zeigt die Verwendung. `Update-SSMManagedInstanceRole`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Rolle einer verwalteten Instance aktualisiert. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Update-SSMManagedInstanceRole -InstanceId "mi-08ab247cdf1046573" -IamRole "AutomationRole"
```
+ Einzelheiten zur API finden Sie unter [UpdateManagedInstanceRole AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Update-SSMPatchBaseline`
Das folgende Codebeispiel zeigt die Verwendung. `Update-SSMPatchBaseline`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden einer vorhandenen Patch-Baseline zwei Patches als abgelehnt und ein Patch als genehmigt hinzugefügt.**
```
Update-SSMPatchBaseline -BaselineId "pb-03da896ca3b68b639" -RejectedPatch "KB2032276","MS10-048" -ApprovedPatch "KB2124261"
```
**Ausgabe:**
```
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}
```
+ Einzelheiten zur API finden Sie unter [UpdatePatchBaseline AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-SSMComplianceItem`
Das folgende Codebeispiel zeigt die Verwendung. `Write-SSMComplianceItem`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein benutzerdefiniertes Compliance-Element für die angegebene verwaltete Instance geschrieben**
```
$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"
```
+ Einzelheiten zur API finden Sie unter [PutComplianceItems AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-SSMInventory`
Das folgende Codebeispiel zeigt die Verwendung. `Write-SSMInventory`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden einer Instance Informationen zum Rack-Standort zugewiesen. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [PutInventory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Write-SSMParameter`
Das folgende Codebeispiel zeigt die Verwendung. `Write-SSMParameter`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird ein Parameter erstellt. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Write-SSMParameter -Name "Welcome" -Type "String" -Value "helloWorld"
```
**Beispiel 2: In diesem Beispiel wird ein Parameter geändert. Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.**
```
Write-SSMParameter -Name "Welcome" -Type "String" -Value "Good day, Sunshine!" -Overwrite $true
```
+ Einzelheiten zur API finden Sie unter [PutParameter AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# Amazon Translate Translate-Beispiele mit Tools für PowerShell V5
Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS -Tools für PowerShell V5 mit Amazon Translate Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `ConvertTo-TRNTargetLanguage`
Das folgende Codebeispiel zeigt die Verwendung`ConvertTo-TRNTargetLanguage`.
**Tools für PowerShell V5**
**Beispiel 1: Konvertiert den angegebenen englischen Text in Französisch. Der zu konvertierende Text kann auch als Parameter -Text übergeben werden.**
```
"Hello World" | ConvertTo-TRNTargetLanguage -SourceLanguageCode en -TargetLanguageCode fr
```
+ Einzelheiten zur API finden Sie unter [TranslateText AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
# AWS WAFV2 Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. AWS WAFV2
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `New-WAF2WebACL`
Das folgende Codebeispiel zeigt die Verwendung `New-WAF2WebACL` von.
**Tools für PowerShell V5**
**Beispiel 1: Dieser Befehl erstellt eine neue Web-ACL mit dem Namen „waf-test“. Bitte beachten Sie, dass 'DefaultAction' gemäß der Dokumentation zur Service-API eine erforderliche Eigenschaft ist. Daher sollte ein Wert für entweder '- DefaultAction \$1Allow' oder and/or '- DefaultAction \$1Block 'angegeben werden. Da '- DefaultAction \$1Allow' und '- DefaultAction \$1Block 'nicht die erforderlichen Eigenschaften sind, könnte der Wert '@ \$1\$1' als Platzhalter verwendet werden, wie im obigen Beispiel gezeigt.**
```
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 @{}
```
**Ausgabe:**
```
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
```
+ *Einzelheiten zur API finden Sie unter [CreateWebAcl](https://docs.aws.amazon.com/powershell/v5/reference)Cmdlet-Referenz (V5).AWS -Tools für PowerShell *
# WorkSpaces Beispiele für die Verwendung von Tools für V5 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 mit verwenden. WorkSpaces
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Approve-WKSIpRule`
Das folgende Codebeispiel zeigt die Verwendung `Approve-WKSIpRule` von.
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Regeln zu einer vorhandenen IP-Gruppe hinzugefügt**
```
$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
```
+ Einzelheiten zur API finden Sie unter [AuthorizeIpRules AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Copy-WKSWorkspaceImage`
Das folgende Codebeispiel zeigt die Verwendung. `Copy-WKSWorkspaceImage`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel kopiert das Workspace-Bild mit der angegebenen ID von us-west-2 in die aktuelle Region mit dem Namen "" CopiedImageTest**
```
Copy-WKSWorkspaceImage -Name CopiedImageTest -SourceRegion us-west-2 -SourceImageId wsi-djfoedhw6
```
**Ausgabe:**
```
wsi-456abaqfe
```
+ Einzelheiten zur API finden Sie unter [CopyWorkspaceImage AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Edit-WKSClientProperty`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSClientProperty`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird Reconnection für den Workspaces-Client aktiviert**
```
Edit-WKSClientProperty -Region us-west-2 -ClientProperties_ReconnectEnabled "ENABLED" -ResourceId d-123414a369
```
+ Einzelheiten zur API finden Sie unter [ModifyClientProperties AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-WKSSelfServicePermission`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSSelfServicePermission`
**Tools für PowerShell V5**
**Beispiel1: In diesem Beispiel werden Self-Service-Berechtigungen zum Ändern des Rechentyps und zum Erhöhen der Volumengröße für das angegebene Verzeichnis aktiviert.**
```
Edit-WKSSelfservicePermission -Region us-west-2 -ResourceId d-123454a369 -SelfservicePermissions_ChangeComputeType ENABLED -SelfservicePermissions_IncreaseVolumeSize ENABLED
```
+ Einzelheiten zur API finden Sie unter [ModifySelfservicePermissions AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-WKSWorkspaceAccessProperty`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSWorkspaceAccessProperty`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Workspace-Zugriff auf Android und Chrome OS für das angegebene Verzeichnis aktiviert**
```
Edit-WKSWorkspaceAccessProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceAccessProperties_DeviceTypeAndroid ALLOW -WorkspaceAccessProperties_DeviceTypeChromeOs ALLOW
```
+ Einzelheiten zur API finden Sie unter [ModifyWorkspaceAccessProperties AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-WKSWorkspaceCreationProperty`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSWorkspaceCreationProperty`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden beim Erstellen eines Workspace die Standardwerte für Internetzugriff und Wartungsmodus auf „true“ gesetzt**
```
Edit-WKSWorkspaceCreationProperty -Region us-west-2 -ResourceId d-123454a369 -WorkspaceCreationProperties_EnableInternetAccess $true -WorkspaceCreationProperties_EnableMaintenanceMode $true
```
+ Einzelheiten zur API finden Sie unter [ModifyWorkspaceCreationProperties AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-WKSWorkspaceProperty`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSWorkspaceProperty`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Eigenschaft Workspace Running Mode für den angegebenen Workspace auf Auto Stop geändert**
```
Edit-WKSWorkspaceProperty -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceProperties_RunningMode AUTO_STOP
```
+ Einzelheiten zur API finden Sie unter [ModifyWorkspaceProperties AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Edit-WKSWorkspaceState`
Das folgende Codebeispiel zeigt die Verwendung. `Edit-WKSWorkspaceState`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Status des angegebenen Workspace auf „Verfügbar“ geändert**
```
Edit-WKSWorkspaceState -WorkspaceId ws-w361s100v -Region us-west-2 -WorkspaceState AVAILABLE
```
+ Einzelheiten zur API finden Sie unter [ModifyWorkspaceState AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-WKSClientProperty`
Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSClientProperty`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Client-Eigenschaften des Workspace Client für das angegebene Verzeichnis abgerufen**
```
Get-WKSClientProperty -ResourceId d-223562a123
```
+ Einzelheiten zur API finden Sie unter [DescribeClientProperties AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-WKSIpGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSIpGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Details der angegebenen IP-Gruppe in der angegebenen Region abgerufen**
```
Get-WKSIpGroup -Region us-east-1 -GroupId wsipg-8m1234v45
```
**Ausgabe:**
```
GroupDesc GroupId GroupName UserRules
--------- ------- --------- ---------
wsipg-8m1234v45 TestGroup {Amazon.WorkSpaces.Model.IpRuleItem, Amazon.WorkSpaces.Model.IpRuleItem}
```
+ Einzelheiten zur API finden Sie unter [DescribeIpGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-WKSTag`
Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das Tag für den angegebenen Workspace abgerufen**
```
Get-WKSTag -WorkspaceId ws-w361s234r -Region us-west-2
```
**Ausgabe:**
```
Key Value
--- -----
auto-delete no
purpose Workbench
```
+ Einzelheiten zur API finden Sie unter [DescribeTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-WKSWorkspace`
Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspace`
**Tools für PowerShell V5**
**Beispiel 1: Ruft Details aller Ihrer Verbindungen WorkSpaces zur Pipeline ab.**
```
Get-WKSWorkspace
```
**Ausgabe:**
```
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
```
**Beispiel 2: Dieser Befehl zeigt die Werte der untergeordneten Eigenschaften von `WorkSpaceProperties` für einen Workspace in der `us-west-2`-Region an. Weitere Informationen zu den untergeordneten Eigenschaften von finden Sie `WorkSpaceProperties` unter https://docs.aws.amazon.com/workspaces/ latest/api/API \$1 WorkspaceProperties .html.**
```
(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties
```
**Ausgabe:**
```
ComputeTypeName : STANDARD
RootVolumeSizeGib : 80
RunningMode : AUTO_STOP
RunningModeAutoStopTimeoutInMinutes : 60
UserVolumeSizeGib : 50
```
**Beispiel 3: Dieser Befehl zeigt den Wert der untergeordneten Eigenschaft `RootVolumeSizeGib` von `WorkSpaceProperties` für einen Workspace in der `us-west-2`-Region an. Die Größe des Root-Volumes in GiB beträgt 80.**
```
(Get-WKSWorkspace -Region us-west-2 -WorkSpaceId ws-xdaf7hc9s).WorkspaceProperties.RootVolumeSizeGib
```
**Ausgabe:**
```
80
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Get-WKSWorkspaceBundle`
Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspaceBundle`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zu allen Workspace-Bundles in der aktuellen Region abgerufen**
```
Get-WKSWorkspaceBundle
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspaceBundles AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-WKSWorkspaceDirectory`
Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspaceDirectory`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden die Verzeichnisdetails für registrierte Verzeichnisse aufgeführt**
```
Get-WKSWorkspaceDirectory
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspaceDirectories AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-WKSWorkspaceImage`
Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspaceImage`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel werden Details zu allen Images in der Region abgerufen**
```
Get-WKSWorkspaceImage
```
**Ausgabe:**
```
Description :This image is copied from another image
ErrorCode :
ErrorMessage :
ImageId : wsi-345ahdjgo
Name : CopiedImageTest
OperatingSystem : Amazon.WorkSpaces.Model.OperatingSystem
RequiredTenancy : DEFAULT
State : AVAILABLE
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspaceImages AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-WKSWorkspaceSnapshot`
Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspaceSnapshot`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel zeigt den Zeitstempel des letzten Snapshots, der für den angegebenen Workspace erstellt wurde**
```
Get-WKSWorkspaceSnapshot -WorkspaceId ws-w361s100v
```
**Ausgabe:**
```
RebuildSnapshots RestoreSnapshots
---------------- ----------------
{Amazon.WorkSpaces.Model.Snapshot} {Amazon.WorkSpaces.Model.Snapshot}
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspaceSnapshots AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Get-WKSWorkspacesConnectionStatus`
Das folgende Codebeispiel zeigt die Verwendung. `Get-WKSWorkspacesConnectionStatus`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird der Verbindungsstatus für den angegebenen Workspace abgerufen**
```
Get-WKSWorkspacesConnectionStatus -WorkspaceId ws-w123s234r
```
+ Einzelheiten zur API finden Sie unter [DescribeWorkspacesConnectionStatus AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-WKSIpGroup`
Das folgende Codebeispiel zeigt die Verwendung. `New-WKSIpGroup`
**Tools für PowerShell V5**
**Beispiel 1: Dieses Beispiel erstellt eine leere IP-Gruppe mit dem Namen FreshEmptyIpGroup**
```
New-WKSIpGroup -GroupName "FreshNewIPGroup"
```
**Ausgabe:**
```
wsipg-w45rty4ty
```
+ Einzelheiten zur API finden Sie unter [CreateIpGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `New-WKSTag`
Das folgende Codebeispiel zeigt die Verwendung. `New-WKSTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird einem Workspace namens `ws-wsname` ein neues Tag hinzugefügt. Das Tag hat den Schlüssel „Name“ und den Schlüsselwert `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
```
**Beispiel 1: In diesem Beispiel wird einem Workspace namens `ws-wsname` mehrere Tags hinzugefügt. Ein Tag hat den Schlüssel „Name“ und den Schlüsselwert `AWS_Workspace`; das andere Tag hat den Tag-Schlüssel „Stage“ und den Schlüsselwert „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
```
+ Einzelheiten zur API finden Sie unter [CreateTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `New-WKSWorkspace`
Das folgende Codebeispiel zeigt die Verwendung. `New-WKSWorkspace`
**Tools für PowerShell V5**
**Beispiel 1: Erstellen Sie eine WorkSpace für das bereitgestellte Bundle, Verzeichnis und Benutzer.**
```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME"}
```
**Beispiel 2: In diesem Beispiel werden mehrere erstellt WorkSpaces**
```
New-WKSWorkspace -Workspace @{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_1"},@{"BundleID" = "wsb-1a2b3c4d"; "DirectoryId" = "d-1a2b3c4d"; "UserName" = "USERNAME_2"}
```
+ Einzelheiten zur API finden Sie unter [CreateWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Register-WKSIpGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Register-WKSIpGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene IP-Gruppe im angegebenen Verzeichnis registriert**
```
Register-WKSIpGroup -GroupId wsipg-23ahsdres -DirectoryId d-123412e123
```
+ Einzelheiten zur API finden Sie unter [AssociateIpGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Register-WKSWorkspaceDirectory`
Das folgende Codebeispiel zeigt die Verwendung. `Register-WKSWorkspaceDirectory`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das angegebene Verzeichnis für Workspaces Service registriert**
```
Register-WKSWorkspaceDirectory -DirectoryId d-123412a123 -EnableWorkDoc $false
```
+ Einzelheiten zur API finden Sie unter [RegisterWorkspaceDirectory AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-WKSIpGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-WKSIpGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die angegebene IP-Gruppe gelöscht**
```
Remove-WKSIpGroup -GroupId wsipg-32fhgtred
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteIpGroup AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-WKSTag`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-WKSTag`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird das dem Workspace zugeordnete Tag entfernt**
```
Remove-WKSTag -ResourceId ws-w10b3abcd -TagKey "Type"
```
**Ausgabe:**
```
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
```
+ Einzelheiten zur API finden Sie unter [DeleteTags AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Remove-WKSWorkspace`
Das folgende Codebeispiel zeigt die Verwendung. `Remove-WKSWorkspace`
**Tools für PowerShell V5**
**Beispiel 1: Beendet mehrere WorkSpaces. Die Verwendung der Option -Force verhindert, dass das Cmdlet zur Bestätigung auffordert.**
```
Remove-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0" -Force
```
**Beispiel 2: Ruft die Auflistung aller Ihrer Daten ab WorkSpaces und leitet sie über die Pipeline IDs an den WorkSpaceId Parameter - von Remove- WKSWorkspace weiter, wodurch alle von. WorkSpaces Das Cmdlet fragt nach, bevor jedes Cmdlet beendet wird. WorkSpace Um die Bestätigungsaufforderung zu unterdrücken, fügen Sie den Schalter -Force hinzu.**
```
Get-WKSWorkspaces | Remove-WKSWorkspace
```
**Beispiel 3: Dieses Beispiel zeigt, wie TerminateRequest Objekte übergeben werden, die definieren, dass sie beendet werden WorkSpaces sollen. Das Cmdlet fordert Sie zur Bestätigung auf, bevor es fortfährt, es sei denn, der Schalterparameter -Force ist ebenfalls angegeben.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [TerminateWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Reset-WKSWorkspace`
Das folgende Codebeispiel zeigt die Verwendung. `Reset-WKSWorkspace`
**Tools für PowerShell V5**
**Beispiel 1: Baut die angegebene Datei neu auf. WorkSpace**
```
Reset-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Beispiel 2: Ruft die Sammlung aller Ihrer Dateien ab WorkSpaces und leitet sie IDs an den WorkSpaceId -Parameter von Reset- weiterWKSWorkspace, wodurch der WorkSpaces neu erstellt wird.**
```
Get-WKSWorkspaces | Reset-WKSWorkspace
```
+ Einzelheiten zur API finden Sie unter [RebuildWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).
### `Restart-WKSWorkspace`
Das folgende Codebeispiel zeigt die Verwendung. `Restart-WKSWorkspace`
**Tools für PowerShell V5**
**Beispiel 1: Startet den angegebenen neu. WorkSpace**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d"
```
**Beispiel 2: Startet mehrere neu. WorkSpaces**
```
Restart-WKSWorkspace -WorkspaceId "ws-1a2b3c4d","ws-5a6b7c8d"
```
**Beispiel 3: Ruft die Sammlung all Ihrer Daten ab WorkSpaces und leitet sie IDs an den WorkSpaceId Parameter - von Restart- weiterWKSWorkspace, wodurch der WorkSpaces neu gestartet wird.**
```
Get-WKSWorkspaces | Restart-WKSWorkspace
```
+ Einzelheiten zur API finden Sie unter [RebootWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz* (V5).
### `Stop-WKSWorkspace`
Das folgende Codebeispiel zeigt die Verwendung. `Stop-WKSWorkspace`
**Tools für PowerShell V5**
**Beispiel 1: Stoppt mehrere WorkSpaces.**
```
Stop-WKSWorkspace -WorkspaceId "ws-1a2b3c4d5","ws-6a7b8c9d0"
```
**Beispiel 2: Ruft die Sammlung all Ihrer Daten ab WorkSpaces und leitet sie IDs an den WorkSpaceId Parameter - von Stop- weiter WorkSpaces , WKSWorkspace wodurch der gestoppt wird.**
```
Get-WKSWorkspaces | Stop-WKSWorkspace
```
**Beispiel 3: Dieses Beispiel zeigt, wie StopRequest Objekte übergeben werden, die definieren, was gestoppt werden WorkSpaces soll.**
```
$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
```
+ Einzelheiten zur API finden Sie unter [StopWorkspaces AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (V5*).
### `Unregister-WKSIpGroup`
Das folgende Codebeispiel zeigt die Verwendung. `Unregister-WKSIpGroup`
**Tools für PowerShell V5**
**Beispiel 1: In diesem Beispiel wird die Registrierung der angegebenen IP-Gruppe im angegebenen Verzeichnis aufgehoben**
```
Unregister-WKSIpGroup -GroupId wsipg-12abcdphq -DirectoryId d-123454b123
```
+ Einzelheiten zur API finden Sie unter [DisassociateIpGroups AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5).