Version 5 (V5) von AWS -Tools für PowerShell wurde veröffentlicht!
Informationen zu wichtigen Änderungen und zur Migration Ihrer Anwendungen finden Sie im Migrationsthema.
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 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 Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.
Themen
Aktionen
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 Parameter -Id nicht erforderlich ist, werden keine Ergebnisse zurückgegeben, wenn Sie ihn nicht angeben.
Get-CFCloudFrontOriginAccessIdentity -Id E3XXXXXXXXXXRTAusgabe:
CloudFrontOriginAccessIdentityConfig Id S3CanonicalUserId ------------------------------------ -- ----------------- Amazon.CloudFront.Model.CloudFrontOr... E3XXXXXXXXXXRT 4b6e...-
Einzelheiten zur API finden Sie unter GetCloudFrontOriginAccessIdentity AWS -Tools für PowerShellCmdlet-Referenz (V5).
-
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 der Parameter -Id nicht angegeben ist.
Get-CFCloudFrontOriginAccessIdentityConfig -Id E3XXXXXXXXXXRTAusgabe:
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 PowerShellCmdlet-Referenz (V5).
-
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 2Ausgabe:
IsTruncated : True Items : {E326XXXXXXXXXT, E1YWXXXXXXX9B} Marker : MaxItems : 2 NextMarker : E1YXXXXXXXXX9B Quantity : 2-
Einzelheiten zur API finden Sie unter ListCloudFrontOriginAccessIdentities AWS -Tools für PowerShellCmdlet-Referenz (V5).
-
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 PowerShellCmdlet-Referenz (V5).
-
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 PowerShellCmdlet-Referenz (V5).
-
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 PowerShellCmdlet-Referenz (V5).
-
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 PowerShellCmdlet-Referenz (V5).
-
Das folgende Codebeispiel zeigt die Verwendung. New-CFInvalidation
- Tools für PowerShell V5
-
Beispiel 1: In diesem Beispiel wird eine neue Gültigkeitsaufhebung 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 $Paths speichert drei Pfade zu Bild- und Mediendateien, die der Benutzer nicht als Teil des Caches der Distribution haben möchte. Der Parameterwert -Paths_Quantity ist die Gesamtzahl der im Parameter -Paths_Item angegebenen Pfade.
$Paths = "/images/*.gif", "/images/image1.jpg", "/videos/*.mp4" New-CFInvalidation -DistributionId "EXAMPLENSTXAXE" -InvalidationBatch_CallerReference 20190515090000 -Paths_Item $Paths -Paths_Quantity 3Ausgabe:
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 PowerShellCmdlet-Referenz (V5).
-
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 @paramsAusgabe:
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 @paramsAusgabe:
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 @paramsAusgabe:
Policy ------ [CloudFront-Policy, eyJTd...wIjo...-
Einzelheiten zur API finden Sie unter CFSignedNew-Cookie in AWS -Tools für PowerShell Cmdlet-Referenz (V5).
-
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 @paramsBeispiel 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 @paramsBeispiel 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 (V5).
-