¡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.
# FSx Ejemplos de Amazon con Tools for PowerShell V5
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 Amazon FSx.
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
### `Add-FSXResourceTag`
En el siguiente ejemplo de código, se muestra cómo utilizar `Add-FSXResourceTag`.
**Herramientas para la PowerShell V5**
**Ejemplo 1: En este ejemplo se añaden etiquetas al recurso especificado.**
```
Add-FSXResourceTag -ResourceARN "arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a" -Tag @{Key="Users";Value="Test"}
```
**Salida:**
```
arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a
```
+ Para obtener más información sobre la API, consulte [TagResource](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-FSXBackup`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-FSXBackup`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se recuperan las copias de seguridad creadas desde ayer para el identificador del sistema de archivos especificado.**
```
Get-FSXBackup -Filter @{Name="file-system-id";Values=$fsx.FileSystemId} | Where-Object CreationTime -gt (Get-Date).AddDays(-1)
```
**Salida:**
```
BackupId : backup-01dac234e56782bcc
CreationTime : 6/14/2019 3:35:14 AM
FailureDetails :
FileSystem : Amazon.FSx.Model.FileSystem
KmsKeyId : arn:aws:kms:eu-west-1:123456789012:key/f1af23c4-1b23-1bde-a1f1-e1234c5af123
Lifecycle : AVAILABLE
ProgressPercent : 100
ResourceARN : arn:aws:fsx:eu-west-1:123456789012:backup/backup-01dac234e56782bcc
Tags : {}
Type : AUTOMATIC
```
+ Para obtener más información sobre la API, consulte [DescribeBackups](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-FSXFileSystem`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-FSXFileSystem`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se devuelve la descripción de un filesystemId especificado.**
```
Get-FSXFileSystem -FileSystemId fs-01cd23bc4bdf5678a
```
**Salida:**
```
CreationTime : 1/17/2019 9:55:30 AM
DNSName : fs-01cd23bc4bdf5678a.ktmsad.local
FailureDetails :
FileSystemId : fs-01cd23bc4bdf5678a
FileSystemType : WINDOWS
KmsKeyId : arn:aws:kms:eu-west-1:123456789012:key/f1af23c4-5b67-8bde-a9f0-e1234c5af678
Lifecycle : AVAILABLE
LustreConfiguration :
NetworkInterfaceIds : {eni-07d1dda1322b7e209}
OwnerId : 123456789012
ResourceARN : arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a
StorageCapacity : 300
SubnetIds : {subnet-7d123456}
Tags : {FSx-Service}
VpcId : vpc-41cf2b3f
WindowsConfiguration : Amazon.FSx.Model.WindowsFileSystemConfiguration
```
+ Para obtener más información sobre la API, consulte [DescribeFileSystems](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-FSXResourceTagList`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-FSXResourceTagList`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se muestran las etiquetas del ARN del recurso especificado.**
```
Get-FSXResourceTagList -ResourceARN $fsx.ResourceARN
```
**Salida:**
```
Key Value
--- -----
FSx-Service Windows
Users Dev
```
+ Para obtener más información sobre la API, consulte [ListTagsForResource](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `New-FSXBackup`
En el siguiente ejemplo de código, se muestra cómo utilizar `New-FSXBackup`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se crea una copia de seguridad del sistema de archivos especificado.**
```
New-FSXBackup -FileSystemId fs-0b1fac2345623456ba
```
**Salida:**
```
BackupId : backup-0b1fac2345623456ba
CreationTime : 6/14/2019 5:37:17 PM
FailureDetails :
FileSystem : Amazon.FSx.Model.FileSystem
KmsKeyId : arn:aws:kms:eu-west-1:123456789012:key/f1af23c4-1b23-1bde-a1f3-e1234c5af678
Lifecycle : CREATING
ProgressPercent : 0
ResourceARN : arn:aws:fsx:eu-west-1:123456789012:backup/backup-0b1fac2345623456ba
Tags : {}
Type : USER_INITIATED
```
+ Para obtener más información sobre la API, consulte [CreateBackup](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `New-FSXFileSystem`
En el siguiente ejemplo de código, se muestra cómo utilizar `New-FSXFileSystem`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo crea un nuevo sistema de archivos Windows de 300 GB, que permite el acceso desde la subred especificada y que admite un rendimiento de hasta 8 megabytes por segundo. El nuevo sistema de archivos se une automáticamente a la instancia de Microsoft Active Directory especificada.**
```
New-FSXFileSystem -FileSystemType WINDOWS -StorageCapacity 300 -SubnetId subnet-1a2b3c4d5e6f -WindowsConfiguration @{ThroughputCapacity=8;ActiveDirectoryId='d-1a2b3c4d'}
```
**Salida:**
```
CreationTime : 12/10/2018 6:06:59 PM
DNSName : fs-abcdef01234567890.example.com
FailureDetails :
FileSystemId : fs-abcdef01234567890
FileSystemType : WINDOWS
KmsKeyId : arn:aws:kms:us-west-2:123456789012:key/a1234567-252c-45e9-afaa-123456789abc
Lifecycle : CREATING
LustreConfiguration :
NetworkInterfaceIds : {}
OwnerId : 123456789012
ResourceARN : arn:aws:fsx:us-west-2:123456789012:file-system/fs-abcdef01234567890
StorageCapacity : 300
SubnetIds : {subnet-1a2b3c4d5e6f}
Tags : {}
VpcId : vpc-1a2b3c4d5e6f
WindowsConfiguration : Amazon.FSx.Model.WindowsFileSystemConfiguration
```
+ Para obtener más información sobre la API, consulte [CreateFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `New-FSXFileSystemFromBackup`
En el siguiente ejemplo de código, se muestra cómo utilizar `New-FSXFileSystemFromBackup`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Este ejemplo crea un nuevo sistema de FSx archivos de Amazon a partir de una copia de seguridad existente de Amazon FSx for Windows File Server.**
```
New-FSXFileSystemFromBackup -BackupId $backupID -Tag @{Key="tag:Name";Value="from-manual-backup"} -SubnetId $SubnetID -SecurityGroupId $SG_ID -WindowsConfiguration @{ThroughputCapacity=8;ActiveDirectoryId=$DirectoryID}
```
**Salida:**
```
CreationTime : 8/8/2019 12:59:58 PM
DNSName : fs-012ff34e56789120.ktmsad.local
FailureDetails :
FileSystemId : fs-012ff34e56789120
FileSystemType : WINDOWS
KmsKeyId : arn:aws:kms:eu-west-1:123456789012:key/f1af23c4-5b67-1bde-a2f3-e4567c8a9321
Lifecycle : CREATING
LustreConfiguration :
NetworkInterfaceIds : {}
OwnerId : 933303704102
ResourceARN : arn:aws:fsx:eu-west-1:123456789012:file-system/fs-012ff34e56789120
StorageCapacity : 300
SubnetIds : {subnet-fa1ae23c}
Tags : {tag:Name}
VpcId : vpc-12cf3b4f
WindowsConfiguration : Amazon.FSx.Model.WindowsFileSystemConfiguration
```
+ Para obtener más información sobre la API, consulte [CreateFileSystemFromBackup Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5).
### `Remove-FSXBackup`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-FSXBackup`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se elimina el backup-id especificado.**
```
Remove-FSXBackup -BackupId $backupID
```
**Salida:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-FSXBackup (DeleteBackup)" on target "backup-0bbca1e2345678e12".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
BackupId Lifecycle
-------- ---------
backup-0bbca1e2345678e12 DELETED
```
+ Para obtener más información sobre la API, consulte [DeleteBackup](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Remove-FSXFileSystem`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-FSXFileSystem`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Este ejemplo elimina el ID del sistema de archivos de FSX especificado.**
```
Remove-FSXFileSystem -FileSystemId fs-012ff34e567890120
```
**Salida:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-FSXFileSystem (DeleteFileSystem)" on target "fs-012ff34e567890120".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
FileSystemId Lifecycle WindowsResponse
------------ --------- ---------------
fs-012ff34e567890120 DELETING Amazon.FSx.Model.DeleteFileSystemWindowsResponse
```
+ Para obtener más información sobre la API, consulte [DeleteFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Remove-FSXResourceTag`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-FSXResourceTag`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: En este ejemplo se elimina la etiqueta de recurso del ARN de recurso del sistema de archivos de FSX especificado.**
```
Remove-FSXResourceTag -ResourceARN $FSX.ResourceARN -TagKey Users
```
**Salida:**
```
Confirm
Are you sure you want to perform this action?
Performing the operation "Remove-FSXResourceTag (UntagResource)" on target "arn:aws:fsx:eu-west-1:933303704102:file-system/fs-07cd45bc6bdf2674a".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
```
+ Para obtener más información sobre la API, consulte [UntagResource](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Update-FSXFileSystem`
En el siguiente ejemplo de código, se muestra cómo utilizar `Update-FSXFileSystem`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Este ejemplo actualiza los días de retención de copias de seguridad automáticas del sistema de archivos FSX mediante. UpdateFileSystemWindowsConfiguration**
```
$UpdateFSXWinConfig = [Amazon.FSx.Model.UpdateFileSystemWindowsConfiguration]::new()
$UpdateFSXWinConfig.AutomaticBackupRetentionDays = 35
Update-FSXFileSystem -FileSystemId $FSX.FileSystemId -WindowsConfiguration $UpdateFSXWinConfig
```
**Salida:**
```
CreationTime : 1/17/2019 9:55:30 AM
DNSName : fs-01cd23bc4bdf5678a.ktmsad.local
FailureDetails :
FileSystemId : fs-01cd23bc4bdf5678a
FileSystemType : WINDOWS
KmsKeyId : arn:aws:kms:eu-west-1:123456789012:key/f1af23c4-1b23-1bde-a1f2-e1234c5af678
Lifecycle : AVAILABLE
LustreConfiguration :
NetworkInterfaceIds : {eni-01cd23bc4bdf5678a}
OwnerId : 933303704102
ResourceARN : arn:aws:fsx:eu-west-1:933303704102:file-system/fs-07cd45bc6bdf2674a
StorageCapacity : 300
SubnetIds : {subnet-1d234567}
Tags : {FSx-Service}
VpcId : vpc-23cf4b5f
WindowsConfiguration : Amazon.FSx.Model.WindowsFileSystemConfiguration
```
+ Para obtener más información sobre la API, consulte [UpdateFileSystem Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5).