¡Se Herramientas de AWS para PowerShell ha lanzado la versión 5 (V5) del\$1 Para obtener información sobre los cambios más importantes y la migración de sus aplicaciones, consulte el tema [sobre migración](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) Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # CloudFront ejemplos de uso de Tools for V5 PowerShell Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de la Herramientas de AWS para PowerShell V5 con. CloudFront Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados. En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto. **Topics** + [Acciones](#actions) ## Acciones ### `Get-CFCloudFrontOriginAccessIdentity` En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CFCloudFrontOriginAccessIdentity`. **Herramientas para la PowerShell V5** **Ejemplo 1: Este ejemplo devuelve una identidad de acceso a Amazon CloudFront Origin específica, especificada mediante el parámetro -Id. Aunque el parámetro -Id no es obligatorio, si no lo especifica, no se devolverá ningún resultado.** ``` Get-CFCloudFrontOriginAccessIdentity -Id E3XXXXXXXXXXRT ``` **Salida:** ``` CloudFrontOriginAccessIdentityConfig Id S3CanonicalUserId ------------------------------------ -- ----------------- Amazon.CloudFront.Model.CloudFrontOr... E3XXXXXXXXXXRT 4b6e... ``` + Para obtener más información sobre la API, consulte [GetCloudFrontOriginAccessIdentity Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). ### `Get-CFCloudFrontOriginAccessIdentityConfig` En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CFCloudFrontOriginAccessIdentityConfig`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: Este ejemplo devuelve información de configuración sobre una única identidad de acceso a Amazon CloudFront Origin, especificada mediante el parámetro -Id. Se producen errores si no se especifica ningún parámetro -Id.** ``` Get-CFCloudFrontOriginAccessIdentityConfig -Id E3XXXXXXXXXXRT ``` **Salida:** ``` CallerReference Comment --------------- ------- mycallerreference: 2/1/2011 1:16:32 PM Caller reference: 2/1/2011 1:16:32 PM ``` + Para obtener más información sobre la API, consulte [GetCloudFrontOriginAccessIdentityConfig Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). ### `Get-CFCloudFrontOriginAccessIdentityList` En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CFCloudFrontOriginAccessIdentityList`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: Este ejemplo devuelve una lista de identidades de acceso a Amazon CloudFront Origin. Como el MaxItem parámetro - especifica un valor de 2, los resultados incluyen dos identidades.** ``` Get-CFCloudFrontOriginAccessIdentityList -MaxItem 2 ``` **Salida:** ``` IsTruncated : True Items : {E326XXXXXXXXXT, E1YWXXXXXXX9B} Marker : MaxItems : 2 NextMarker : E1YXXXXXXXXX9B Quantity : 2 ``` + Para obtener más información sobre la API, consulte [ListCloudFrontOriginAccessIdentities Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (V5)*. ### `Get-CFDistribution` En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CFDistribution`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: Recupera la información de una distribución específica.** ``` Get-CFDistribution -Id EXAMPLE0000ID ``` + Para obtener más información sobre la API, consulte [GetDistribution](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ### `Get-CFDistributionConfig` En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CFDistributionConfig`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: Recupera la configuración de una distribución específica.** ``` Get-CFDistributionConfig -Id EXAMPLE0000ID ``` + Para obtener más información sobre la API, consulte [GetDistributionConfig](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ### `Get-CFDistributionList` En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CFDistributionList`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: Devuelve distribuciones.** ``` Get-CFDistributionList ``` + Para obtener más información sobre la API, consulte [ListDistributions](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ### `New-CFDistribution` En el siguiente ejemplo de código, se muestra cómo utilizar `New-CFDistribution`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: crea una CloudFront distribución básica, configurada con registro y almacenamiento en caché.** ``` $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 ``` + Para obtener más información sobre la API, consulte [CreateDistribution Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). ### `New-CFInvalidation` En el siguiente ejemplo de código, se muestra cómo utilizar `New-CFInvalidation`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se crea una nueva invalidación en una distribución con un ID de EXAMPLENSTXAXE. CallerReference Es un identificador único elegido por el usuario; en este caso, se utiliza una marca de tiempo que representa el 15 de mayo de 2019 a las 9:00 a. m. La variable \$1Paths almacena tres rutas a archivos multimedia y de imagen que el usuario no desea que formen parte de la memoria caché de la distribución. El valor del parámetro -Paths\$1Quantity es el número total de rutas especificadas en el parámetro -Paths\$1Item.** ``` $Paths = "/images/*.gif", "/images/image1.jpg", "/videos/*.mp4" New-CFInvalidation -DistributionId "EXAMPLENSTXAXE" -InvalidationBatch_CallerReference 20190515090000 -Paths_Item $Paths -Paths_Quantity 3 ``` **Salida:** ``` Invalidation Location ------------ -------- Amazon.CloudFront.Model.Invalidation https://cloudfront.amazonaws.com/2018-11-05/distribution/EXAMPLENSTXAXE/invalidation/EXAMPLE8NOK9H ``` + Para obtener más información sobre la API, consulte [CreateInvalidation Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (V5)*. ### `New-CFSignedCookie` En el siguiente ejemplo de código, se muestra cómo utilizar `New-CFSignedCookie`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: Crea una cookie firmada en el recurso especificado mediante una política predefinida. La cookie tendrá una validez de un año.** ``` $params = @{ "ResourceUri"="http://xyz.cloudfront.net/image1.jpeg" "KeyPairId"="AKIAIOSFODNN7EXAMPLE" "PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem" "ExpiresOn"=(Get-Date).AddYears(1) } New-CFSignedCookie @params ``` **Salida:** ``` Expires ------- [CloudFront-Expires, 1472227284] ``` **Ejemplo 2: Crea una cookie firmada en los recursos especificados mediante una política personalizada. La cookie será válida a partir de 24 horas y caducará una semana después.** ``` $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 ``` **Salida:** ``` Policy ------ [CloudFront-Policy, eyJTd...wIjo... ``` **Ejemplo 3: Crea una cookie firmada en los recursos especificados mediante una política personalizada. La cookie será válida a partir de 24 horas y caducará una semana después. El acceso a los recursos está restringido al intervalo de IP especificado.** ``` $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 ``` **Salida:** ``` Policy ------ [CloudFront-Policy, eyJTd...wIjo... ``` + Para obtener más información sobre la API, consulte [New- CFSigned Cookie](https://docs.aws.amazon.com/powershell/v5/reference) in *Herramientas de AWS para PowerShell Cmdlet Reference (*V5). ### `New-CFSignedUrl` En el siguiente ejemplo de código, se muestra cómo utilizar `New-CFSignedUrl`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: Crea una URL firmada en el recurso especificado mediante una política predefinida. La URL tendrá una validez de una hora. Se envía a la canalización un objeto System.Uri que contiene la URL firmada.** ``` $params = @{ "ResourceUri"="https://cdn.example.com/index.html" "KeyPairId"="AKIAIOSFODNN7EXAMPLE" "PrivateKeyFile"="C:\pk-AKIAIOSFODNN7EXAMPLE.pem" "ExpiresOn"=(Get-Date).AddHours(1) } New-CFSignedUrl @params ``` **Ejemplo 2: Crea una URL firmada en el recurso especificado mediante una política personalizada. La URL será válida a partir de 24 horas y caducará una semana después.** ``` $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 ``` **Ejemplo 3: Crea una URL firmada en el recurso especificado mediante una política personalizada. La URL será válida a partir de 24 horas y caducará una semana después. El acceso al recurso está restringido al intervalo de IP especificado.** ``` $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 ``` + Para obtener más información sobre la API, consulte [New- CFSigned Url](https://docs.aws.amazon.com/powershell/v5/reference) in *Herramientas de AWS para PowerShell Cmdlet Reference (*V5).