FSxEjemplos de Amazon que utilizan herramientas para PowerShell - AWS SDKEjemplos de código
Acciones

Hay más AWS SDK ejemplos disponibles en el GitHub repositorio de AWS Doc SDK Examples.

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.

FSxEjemplos de Amazon que utilizan herramientas para PowerShell

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Tools for PowerShell mediante AmazonFSx.

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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usar Add-FSXResourceTag.

Herramientas para PowerShell

Ejemplo 1: En este ejemplo se añaden etiquetas al recurso dado.

Add-FSXResourceTag -ResourceARN "arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a" -Tag @{Key="Users";Value="Test"} -PassThru

Salida:

arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a

En el siguiente ejemplo de código se muestra cómo usar Get-FSXBackup.

Herramientas para PowerShell

Ejemplo 1: Este ejemplo busca las copias de seguridad creadas desde ayer para el identificador del sistema de archivos indicado.

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 API obtener más información, consulte la referencia DescribeBackupsde AWS Tools for PowerShell cmdlets.

En el siguiente ejemplo de código se muestra cómo usar Get-FSXFileSystem.

Herramientas para PowerShell

Ejemplo 1: Este ejemplo devuelve la descripción de lo dadofilesystemId.

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

En el siguiente ejemplo de código se muestra cómo usar Get-FSXResourceTagList.

Herramientas para PowerShell

Ejemplo 1: En este ejemplo se enumeran las etiquetas del recurso arn proporcionado.

Get-FSXResourceTagList -ResourceARN $fsx.ResourceARN

Salida:

Key         Value
---         -----
FSx-Service Windows
Users       Dev

  • Para API obtener más información, consulte la referencia ListTagsForResourcedel AWS Tools for PowerShell cmdlet.

En el siguiente ejemplo de código se muestra cómo usar New-FSXBackup.

Herramientas para PowerShell

Ejemplo 1: En este ejemplo se crea una copia de seguridad del sistema de archivos indicado.

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

En el siguiente ejemplo de código se muestra cómo usar New-FSXFileSystem.

Herramientas para PowerShell

Ejemplo 1: 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 al Microsoft Active Directory especificado.

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 API obtener más información, consulte CreateFileSystemla referencia de AWS Tools for PowerShell cmdlets.

En el siguiente ejemplo de código se muestra cómo usar New-FSXFileSystemFromBackup.

Herramientas para 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

En el siguiente ejemplo de código se muestra cómo usar Remove-FSXBackup.

Herramientas para PowerShell

Ejemplo 1: En este ejemplo se elimina el identificador de copia de seguridad indicado.

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 API obtener más información, consulte la referencia del DeleteBackupcmdlet AWS Tools for PowerShell .

En el siguiente ejemplo de código se muestra cómo usar Remove-FSXFileSystem.

Herramientas para PowerShell

Ejemplo 1: En este ejemplo se elimina el ID del sistema de FSX archivos indicado.

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 API obtener más información, consulte DeleteFileSystemla referencia del AWS Tools for PowerShell cmdlet.

En el siguiente ejemplo de código se muestra cómo usar Remove-FSXResourceTag.

Herramientas para PowerShell

Ejemplo 1: En este ejemplo se elimina la etiqueta de recurso del sistema de FSX archivos correspondienteARN.

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

En el siguiente ejemplo de código se muestra cómo usar Update-FSXFileSystem.

Herramientas para PowerShell

Ejemplo 1: Este ejemplo actualiza los días de retención de copias de seguridad automáticas del sistema de FSX archivos 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