Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar. 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. # CloudFront Beispiele für die Verwendung von Tools für V4 PowerShell Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V4 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 von`Get-CFCloudFrontOriginAccessIdentity`. **Tools für PowerShell V4** **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/v4/reference)*Cmdlet-Referenz (*V4). ### `Get-CFCloudFrontOriginAccessIdentityConfig` Das folgende Codebeispiel zeigt die Verwendung. `Get-CFCloudFrontOriginAccessIdentityConfig` **Tools für PowerShell V4** **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/v4/reference)*Cmdlet-Referenz (*V4). ### `Get-CFCloudFrontOriginAccessIdentityList` Das folgende Codebeispiel zeigt die Verwendung. `Get-CFCloudFrontOriginAccessIdentityList` **Tools für PowerShell V4** **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/v4/reference)*Cmdlet-Referenz (*V4). ### `Get-CFDistribution` Das folgende Codebeispiel zeigt die Verwendung. `Get-CFDistribution` **Tools für PowerShell V4** **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/v4/reference)*Cmdlet-Referenz (V4).* ### `Get-CFDistributionConfig` Das folgende Codebeispiel zeigt die Verwendung. `Get-CFDistributionConfig` **Tools für PowerShell V4** **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/v4/reference)*Cmdlet-Referenz (V4).* ### `Get-CFDistributionList` Das folgende Codebeispiel zeigt die Verwendung. `Get-CFDistributionList` **Tools für PowerShell V4** **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/v4/reference)*Cmdlet-Referenz (V4).* ### `New-CFDistribution` Das folgende Codebeispiel zeigt die Verwendung. `New-CFDistribution` **Tools für PowerShell V4** **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/v4/reference)*Cmdlet-Referenz (*V4). ### `New-CFInvalidation` Das folgende Codebeispiel zeigt die Verwendung. `New-CFInvalidation` **Tools für PowerShell V4** **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/v4/reference)*Cmdlet-Referenz (V4).* ### `New-CFSignedCookie` Das folgende Codebeispiel zeigt die Verwendung. `New-CFSignedCookie` **Tools für PowerShell V4** **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/v4/reference) *(V4).* ### `New-CFSignedUrl` Das folgende Codebeispiel zeigt die Verwendung. `New-CFSignedUrl` **Tools für PowerShell V4** **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/v4/reference) *(V4).*