FSxExemplos da Amazon usando ferramentas para PowerShell - AWS SDKExemplos de código
Ações

Há mais AWS SDK exemplos disponíveis no GitHub repositório AWS Doc SDK Examples.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

FSxExemplos da Amazon usando ferramentas para PowerShell

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Tools for PowerShell com a AmazonFSx.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, é possível ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.

Tópicos

Ações

O código de exemplo a seguir mostra como usar Add-FSXResourceTag.

Ferramentas para PowerShell

Exemplo 1: Este exemplo adiciona tags ao recurso fornecido.

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

Saída:

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

  • Para API obter detalhes, consulte TagResourceem Referência de AWS Tools for PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-FSXBackup.

Ferramentas para PowerShell

Exemplo 1: Este exemplo busca backups criados desde ontem para o ID do sistema de arquivos fornecido.

Get-FSXBackup -Filter @{Name="file-system-id";Values=$fsx.FileSystemId} | Where-Object CreationTime -gt (Get-Date).AddDays(-1)

Saída:

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 obter detalhes, consulte DescribeBackupsem Referência de AWS Tools for PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-FSXFileSystem.

Ferramentas para PowerShell

Exemplo 1: Este exemplo retorna a descrição de determinadofilesystemId.

Get-FSXFileSystem -FileSystemId fs-01cd23bc4bdf5678a

Saída:

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 API obter detalhes, consulte DescribeFileSystemsem Referência de AWS Tools for PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Get-FSXResourceTagList.

Ferramentas para PowerShell

Exemplo 1: Este exemplo lista as tags do recurso arn fornecido.

Get-FSXResourceTagList -ResourceARN $fsx.ResourceARN

Saída:

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

  • Para API obter detalhes, consulte ListTagsForResourceem Referência de AWS Tools for PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-FSXBackup.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria um backup do sistema de arquivos fornecido.

New-FSXBackup -FileSystemId fs-0b1fac2345623456ba

Saída:

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 API obter detalhes, consulte CreateBackupem Referência de AWS Tools for PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-FSXFileSystem.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria um novo sistema de arquivos Windows de 300 GB, permitindo acesso a partir da sub-rede especificada, que suporta taxa de transferência de até 8 megabytes por segundo. O novo sistema de arquivos é automaticamente associado ao Microsoft Active Directory especificado.

New-FSXFileSystem -FileSystemType WINDOWS -StorageCapacity 300 -SubnetId subnet-1a2b3c4d5e6f -WindowsConfiguration @{ThroughputCapacity=8;ActiveDirectoryId='d-1a2b3c4d'}

Saída:

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 obter detalhes, consulte CreateFileSystemem Referência de AWS Tools for PowerShell cmdlet.

O código de exemplo a seguir mostra como usar New-FSXFileSystemFromBackup.

Ferramentas para PowerShell

Exemplo 1: Este exemplo cria um novo sistema de FSx arquivos da Amazon a partir de um backup existente do Amazon FSx para 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}

Saída:

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

O código de exemplo a seguir mostra como usar Remove-FSXBackup.

Ferramentas para PowerShell

Exemplo 1: Este exemplo remove o ID de backup fornecido.

Remove-FSXBackup -BackupId $backupID

Saída:

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 obter detalhes, consulte DeleteBackupem Referência de AWS Tools for PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-FSXFileSystem.

Ferramentas para PowerShell

Exemplo 1: Este exemplo remove o ID do sistema de FSX arquivos fornecido.

Remove-FSXFileSystem -FileSystemId fs-012ff34e567890120

Saída:

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 obter detalhes, consulte DeleteFileSystemem Referência de AWS Tools for PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Remove-FSXResourceTag.

Ferramentas para PowerShell

Exemplo 1: Esse exemplo remove a tag de recurso do determinado recurso do sistema de FSX arquivosARN.

Remove-FSXResourceTag -ResourceARN $FSX.ResourceARN -TagKey Users

Saída:

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 API obter detalhes, consulte UntagResourceem Referência de AWS Tools for PowerShell cmdlet.

O código de exemplo a seguir mostra como usar Update-FSXFileSystem.

Ferramentas para PowerShell

Exemplo 1: Este exemplo atualiza os dias de retenção automática de backup do sistema de FSX arquivos UpdateFileSystemWindowsConfiguration.

$UpdateFSXWinConfig = [Amazon.FSx.Model.UpdateFileSystemWindowsConfiguration]::new()
	$UpdateFSXWinConfig.AutomaticBackupRetentionDays = 35
	Update-FSXFileSystem -FileSystemId $FSX.FileSystemId -WindowsConfiguration $UpdateFSXWinConfig

Saída:

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 API obter detalhes, consulte UpdateFileSystemem Referência de AWS Tools for PowerShell cmdlet.