È stata rilasciata la versione 5 (V5) di! AWS Strumenti per PowerShell
Per informazioni sulle modifiche introduttive e sulla migrazione delle applicazioni, consulta l'argomento sulla migrazione.
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CloudFront esempi di utilizzo di Tools for V5 PowerShell
I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Strumenti per PowerShell V5 con. CloudFront
Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.
Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.
Argomenti
Azioni
Il seguente esempio di codice mostra come utilizzareGet-CFCloudFrontOriginAccessIdentity.
- Strumenti per PowerShell V5
-
Esempio 1: questo esempio restituisce un'identità di accesso all' CloudFront origine di Amazon specifica, specificata dal parametro -Id. Sebbene il parametro -Id non sia obbligatorio, se non lo si specifica non viene restituito alcun risultato.
Get-CFCloudFrontOriginAccessIdentity -Id E3XXXXXXXXXXRTOutput:
CloudFrontOriginAccessIdentityConfig Id S3CanonicalUserId ------------------------------------ -- ----------------- Amazon.CloudFront.Model.CloudFrontOr... E3XXXXXXXXXXRT 4b6e...-
Per i dettagli sull'API, vedere GetCloudFrontOriginAccessIdentityin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. Get-CFCloudFrontOriginAccessIdentityConfig
- Strumenti per PowerShell V5
-
Esempio 1: questo esempio restituisce informazioni di configurazione su una singola identità di accesso di CloudFront origine Amazon, specificata dal parametro -Id. Si verificano errori se non viene specificato alcun parametro -Id.
Get-CFCloudFrontOriginAccessIdentityConfig -Id E3XXXXXXXXXXRTOutput:
CallerReference Comment --------------- ------- mycallerreference: 2/1/2011 1:16:32 PM Caller reference: 2/1/2011 1:16:32 PM-
Per i dettagli sull'API, vedere GetCloudFrontOriginAccessIdentityConfigin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. Get-CFCloudFrontOriginAccessIdentityList
- Strumenti per PowerShell V5
-
Esempio 1: questo esempio restituisce un elenco di identità di accesso di CloudFront origine di Amazon. Poiché il MaxItem parametro - specifica il valore 2, i risultati includono due identità.
Get-CFCloudFrontOriginAccessIdentityList -MaxItem 2Output:
IsTruncated : True Items : {E326XXXXXXXXXT, E1YWXXXXXXX9B} Marker : MaxItems : 2 NextMarker : E1YXXXXXXXXX9B Quantity : 2-
Per i dettagli sull'API, vedere ListCloudFrontOriginAccessIdentitiesin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. Get-CFDistribution
- Strumenti per PowerShell V5
-
Esempio 1: recupera le informazioni relative a una distribuzione specifica.
Get-CFDistribution -Id EXAMPLE0000ID-
Per i dettagli sull'API, vedere GetDistributionin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. Get-CFDistributionConfig
- Strumenti per PowerShell V5
-
Esempio 1: recupera la configurazione di una distribuzione specifica.
Get-CFDistributionConfig -Id EXAMPLE0000ID-
Per i dettagli sull'API, vedere GetDistributionConfigin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. Get-CFDistributionList
- Strumenti per PowerShell V5
-
Esempio 1: restituisce le distribuzioni.
Get-CFDistributionList-
Per i dettagli sull'API, vedere ListDistributionsin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. New-CFDistribution
- Strumenti per PowerShell V5
-
Esempio 1: crea una CloudFront distribuzione di base, configurata con registrazione e memorizzazione nella 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-
Per i dettagli sull'API, vedere CreateDistributionin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. New-CFInvalidation
- Strumenti per PowerShell V5
-
Esempio 1: questo esempio crea una nuova invalidazione per una distribuzione con l’ID EXAMPLENSTXAXE. CallerReference è un ID univoco scelto dall'utente; in questo caso, viene utilizzato un timestamp che rappresenta il 15 maggio 2019 alle 9:00. La variabile $Paths archivia tre percorsi di immagini e file multimediali che l’utente non desidera vengano inseriti nella cache distribuita. Il valore del parametro -Paths_Quantity è il numero totale di percorsi specificati nel parametro -Paths_Item.
$Paths = "/images/*.gif", "/images/image1.jpg", "/videos/*.mp4" New-CFInvalidation -DistributionId "EXAMPLENSTXAXE" -InvalidationBatch_CallerReference 20190515090000 -Paths_Item $Paths -Paths_Quantity 3Output:
Invalidation Location ------------ -------- Amazon.CloudFront.Model.Invalidation https://cloudfront.amazonaws.com/2018-11-05/distribution/EXAMPLENSTXAXE/invalidation/EXAMPLE8NOK9H-
Per i dettagli sull'API, vedere CreateInvalidationin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. New-CFSignedCookie
- Strumenti per PowerShell V5
-
Esempio 1: crea un cookie firmato per la risorsa specificata utilizzando una policy di accesso predefinita. Il cookie sarà valido per un anno.
$params = @{ "ResourceUri"="http://xyz.cloudfront.net/image1.jpeg" "KeyPairId"="AKIAIOSFODNN7EXAMPLE" "PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem" "ExpiresOn"=(Get-Date).AddYears(1) } New-CFSignedCookie @paramsOutput:
Expires ------- [CloudFront-Expires, 1472227284]Esempio 2: crea un cookie firmato per le risorse specificate utilizzando una policy personalizzata. Il cookie sarà valido tra 24 ore e scadrà una settimana dopo.
$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 @paramsOutput:
Policy ------ [CloudFront-Policy, eyJTd...wIjo...Esempio 3: crea un cookie firmato per le risorse specificate utilizzando una policy personalizzata. Il cookie sarà valido tra 24 ore e scadrà una settimana dopo. L’accesso alle risorse è limitato all’intervallo IP specificato.
$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 @paramsOutput:
Policy ------ [CloudFront-Policy, eyJTd...wIjo...-
Per i dettagli sull'API, vedere CFSignedNew-Cookie in AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. New-CFSignedUrl
- Strumenti per PowerShell V5
-
Esempio 1: crea un URL firmato per la risorsa specificata utilizzando una policy di accesso predefinita. L’URL sarà valido per un’ora. Un oggetto System.Uri contenente l’URL firmato viene emesso nella pipeline.
$params = @{ "ResourceUri"="https://cdn.example.com/index.html" "KeyPairId"="AKIAIOSFODNN7EXAMPLE" "PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem" "ExpiresOn"=(Get-Date).AddHours(1) } New-CFSignedUrl @paramsEsempio 2: crea un URL firmato per la risorsa specificata utilizzando una policy personalizzata. L’URL sarà valido tra 24 ore e scadrà una settimana dopo.
$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 @paramsEsempio 3: crea un URL firmato per la risorsa specificata utilizzando una policy personalizzata. L’URL sarà valido tra 24 ore e scadrà una settimana dopo. L’accesso alla risorsa è limitato all’intervallo IP specificato.
$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-
Per i dettagli sull'API, vedere New- CFSigned Url in AWS Strumenti per PowerShell Cmdlet Reference (V5).
-