La version 5 (V5) du Outils AWS pour PowerShell est sortie \$1 Pour plus d'informations sur les modifications majeures et la migration de vos applications, consultez la [rubrique relative à la migration](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html). [https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html) Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # CloudFront exemples d'utilisation de Tools for PowerShell V5 Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de la Outils AWS pour PowerShell V5 avec CloudFront. Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés. Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte. **Topics** + [Actions](#actions) ## Actions ### `Get-CFCloudFrontOriginAccessIdentity` L'exemple de code suivant montre comment utiliser`Get-CFCloudFrontOriginAccessIdentity`. **Outils pour PowerShell V5** **Exemple 1 : Cet exemple renvoie une identité d'accès Amazon CloudFront Origin spécifique, spécifiée par le paramètre -Id. Bien que le paramètre -Id ne soit pas obligatoire, aucun résultat n’est renvoyé si vous ne le spécifiez pas.** ``` Get-CFCloudFrontOriginAccessIdentity -Id E3XXXXXXXXXXRT ``` **Sortie** : ``` CloudFrontOriginAccessIdentityConfig Id S3CanonicalUserId ------------------------------------ -- ----------------- Amazon.CloudFront.Model.CloudFrontOr... E3XXXXXXXXXXRT 4b6e... ``` + Pour plus de détails sur l'API, reportez-vous [GetCloudFrontOriginAccessIdentity](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Get-CFCloudFrontOriginAccessIdentityConfig` L'exemple de code suivant montre comment utiliser`Get-CFCloudFrontOriginAccessIdentityConfig`. **Outils pour PowerShell V5** **Exemple 1 : Cet exemple renvoie des informations de configuration concernant une seule identité CloudFront d'accès à Amazon Origin, spécifiée par le paramètre -Id. Des erreurs se produisent si aucun paramètre -Id n’est spécifié.** ``` Get-CFCloudFrontOriginAccessIdentityConfig -Id E3XXXXXXXXXXRT ``` **Sortie** : ``` CallerReference Comment --------------- ------- mycallerreference: 2/1/2011 1:16:32 PM Caller reference: 2/1/2011 1:16:32 PM ``` + Pour plus de détails sur l'API, reportez-vous [GetCloudFrontOriginAccessIdentityConfig](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Get-CFCloudFrontOriginAccessIdentityList` L'exemple de code suivant montre comment utiliser`Get-CFCloudFrontOriginAccessIdentityList`. **Outils pour PowerShell V5** **Exemple 1 : Cet exemple renvoie une liste des identités CloudFront d'accès d'origine Amazon. Comme le MaxItem paramètre - spécifie une valeur de 2, les résultats incluent deux identités.** ``` Get-CFCloudFrontOriginAccessIdentityList -MaxItem 2 ``` **Sortie** : ``` IsTruncated : True Items : {E326XXXXXXXXXT, E1YWXXXXXXX9B} Marker : MaxItems : 2 NextMarker : E1YXXXXXXXXX9B Quantity : 2 ``` + Pour plus de détails sur l'API, reportez-vous [ListCloudFrontOriginAccessIdentities](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Get-CFDistribution` L'exemple de code suivant montre comment utiliser`Get-CFDistribution`. **Outils pour PowerShell V5** **Exemple 1 : extrait les informations d’une distribution spécifique.** ``` Get-CFDistribution -Id EXAMPLE0000ID ``` + Pour plus de détails sur l'API, reportez-vous [GetDistribution](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Get-CFDistributionConfig` L'exemple de code suivant montre comment utiliser`Get-CFDistributionConfig`. **Outils pour PowerShell V5** **Exemple 1 : extrait la configuration d’une distribution spécifique.** ``` Get-CFDistributionConfig -Id EXAMPLE0000ID ``` + Pour plus de détails sur l'API, reportez-vous [GetDistributionConfig](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `Get-CFDistributionList` L'exemple de code suivant montre comment utiliser`Get-CFDistributionList`. **Outils pour PowerShell V5** **Exemple 1 : renvoie les distributions.** ``` Get-CFDistributionList ``` + Pour plus de détails sur l'API, reportez-vous [ListDistributions](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `New-CFDistribution` L'exemple de code suivant montre comment utiliser`New-CFDistribution`. **Outils pour PowerShell V5** **Exemple 1 : crée une CloudFront distribution de base, configurée avec la journalisation et la mise en cache.** ``` $origin = New-Object Amazon.CloudFront.Model.Origin $origin.DomainName = "amzn-s3-demo-bucket.s3.amazonaws.com" $origin.Id = "UniqueOrigin1" $origin.S3OriginConfig = New-Object Amazon.CloudFront.Model.S3OriginConfig $origin.S3OriginConfig.OriginAccessIdentity = "" New-CFDistribution ` -DistributionConfig_Enabled $true ` -DistributionConfig_Comment "Test distribution" ` -Origins_Item $origin ` -Origins_Quantity 1 ` -Logging_Enabled $true ` -Logging_IncludeCookie $true ` -Logging_Bucket amzn-s3-demo-logging-bucket.s3.amazonaws.com ` -Logging_Prefix "help/" ` -DistributionConfig_CallerReference Client1 ` -DistributionConfig_DefaultRootObject index.html ` -DefaultCacheBehavior_TargetOriginId $origin.Id ` -ForwardedValues_QueryString $true ` -Cookies_Forward all ` -WhitelistedNames_Quantity 0 ` -TrustedSigners_Enabled $false ` -TrustedSigners_Quantity 0 ` -DefaultCacheBehavior_ViewerProtocolPolicy allow-all ` -DefaultCacheBehavior_MinTTL 1000 ` -DistributionConfig_PriceClass "PriceClass_All" ` -CacheBehaviors_Quantity 0 ` -Aliases_Quantity 0 ``` + Pour plus de détails sur l'API, reportez-vous [CreateDistribution](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `New-CFInvalidation` L'exemple de code suivant montre comment utiliser`New-CFInvalidation`. **Outils pour PowerShell V5** **Exemple 1 : cet exemple crée une invalidation sur une distribution dont l’ID est EXAMPLENSTXAXE. CallerReference Il s'agit d'un identifiant unique choisi par l'utilisateur ; dans ce cas, un horodatage représentant le 15 mai 2019 à 9 h 00 est utilisé. La variable \$1Paths stocke trois chemins vers des fichiers image et média que l’utilisateur ne souhaite pas inclure dans le cache de la distribution. La valeur du paramètre -Paths\$1Quantity correspond au nombre total de chemins indiqués dans le paramètre -Paths\$1Item.** ``` $Paths = "/images/*.gif", "/images/image1.jpg", "/videos/*.mp4" New-CFInvalidation -DistributionId "EXAMPLENSTXAXE" -InvalidationBatch_CallerReference 20190515090000 -Paths_Item $Paths -Paths_Quantity 3 ``` **Sortie** : ``` Invalidation Location ------------ -------- Amazon.CloudFront.Model.Invalidation https://cloudfront.amazonaws.com/2018-11-05/distribution/EXAMPLENSTXAXE/invalidation/EXAMPLE8NOK9H ``` + Pour plus de détails sur l'API, reportez-vous [CreateInvalidation](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ### `New-CFSignedCookie` L'exemple de code suivant montre comment utiliser`New-CFSignedCookie`. **Outils pour PowerShell V5** **Exemple 1 : crée un cookie signé sur la ressource spécifiée à l’aide d’une politique prédéfinie. Le cookie sera valide pendant un an.** ``` $params = @{ "ResourceUri"="http://xyz.cloudfront.net/image1.jpeg" "KeyPairId"="AKIAIOSFODNN7EXAMPLE" "PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem" "ExpiresOn"=(Get-Date).AddYears(1) } New-CFSignedCookie @params ``` **Sortie** : ``` Expires ------- [CloudFront-Expires, 1472227284] ``` **Exemple 2 : crée un cookie signé sur les ressources spécifiées à l’aide d’une politique personnalisée. Le cookie sera valide dans les 24 heures et expirera une semaine plus tard.** ``` $start = (Get-Date).AddHours(24) $params = @{ "ResourceUri"="http://xyz.cloudfront.net/content/*.jpeg" "KeyPairId"="AKIAIOSFODNN7EXAMPLE" "PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem" "ExpiresOn"=$start.AddDays(7) "ActiveFrom"=$start } New-CFSignedCookie @params ``` **Sortie** : ``` Policy ------ [CloudFront-Policy, eyJTd...wIjo... ``` **Exemple 3 : crée un cookie signé sur les ressources spécifiées à l’aide d’une politique personnalisée. Le cookie sera valide dans les 24 heures et expirera une semaine plus tard. L’accès aux ressources est limité à la plage d’adresses IP spécifiée.** ``` $start = (Get-Date).AddHours(24) $params = @{ "ResourceUri"="http://xyz.cloudfront.net/content/*.jpeg" "KeyPairId"="AKIAIOSFODNN7EXAMPLE" "PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem" "ExpiresOn"=$start.AddDays(7) "ActiveFrom"=$start "IpRange"="192.0.2.0/24" } New-CFSignedCookie @params ``` **Sortie** : ``` Policy ------ [CloudFront-Policy, eyJTd...wIjo... ``` + Pour plus de détails sur l'API, voir [New- CFSigned Cookie](https://docs.aws.amazon.com/powershell/v5/reference) in *Outils AWS pour PowerShell Cmdlet Reference (V5)*. ### `New-CFSignedUrl` L'exemple de code suivant montre comment utiliser`New-CFSignedUrl`. **Outils pour PowerShell V5** **Exemple 1 : crée une URL signée sur la ressource spécifiée à l’aide d’une politique prédéfinie. L’URL sera valide pendant une heure. Un objet System.Uri contenant l’URL signée est émis dans le pipeline.** ``` $params = @{ "ResourceUri"="https://cdn.example.com/index.html" "KeyPairId"="AKIAIOSFODNN7EXAMPLE" "PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem" "ExpiresOn"=(Get-Date).AddHours(1) } New-CFSignedUrl @params ``` **Exemple 2 : crée une URL signée sur la ressource spécifiée à l’aide d’une politique personnalisée. L’URL sera valide dans 24 heures et expirera une semaine plus tard.** ``` $start = (Get-Date).AddHours(24) $params = @{ "ResourceUri"="https://cdn.example.com/index.html" "KeyPairId"="AKIAIOSFODNN7EXAMPLE" "PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem" "ExpiresOn"=(Get-Date).AddDays(7) "ActiveFrom"=$start } New-CFSignedUrl @params ``` **Exemple 3 : crée une URL signée sur la ressource spécifiée à l’aide d’une politique personnalisée. L’URL sera valide dans 24 heures et expirera une semaine plus tard. L’accès à la ressource est limité à la plage d’adresses IP spécifiée.** ``` $start = (Get-Date).AddHours(24) $params = @{ "ResourceUri"="https://cdn.example.com/index.html" "KeyPairId"="AKIAIOSFODNN7EXAMPLE" "PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem" "ExpiresOn"=(Get-Date).AddDays(7) "ActiveFrom"=$start "IpRange"="192.0.2.0/24" } New-CFSignedUrl @params ``` + Pour plus de détails sur l'API, voir [New- CFSigned Url](https://docs.aws.amazon.com/powershell/v5/reference) dans la *référence des Outils AWS pour PowerShell applets de commande (V5)*.