Esempi per Amazon FSx con Strumenti per PowerShell V5 - Esempi di codice per SDK AWS
Azioni

Sono disponibili altri esempi per SDK AWS nel repository GitHub della documentazione degli esempi per SDK AWS.

Esempi per Amazon FSx con Strumenti per PowerShell V5

Gli esempi di codice seguenti mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Strumenti per PowerShell V5 con Amazon FSx.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni 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

L’esempio di codice seguente mostra come utilizzare Add-FSXResourceTag.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiunge tag alla risorsa specificata.

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

Output:

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

  • Per informazioni dettagliate sull’API, consulta TagResource nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Get-FSXBackup.

Strumenti per PowerShell V5

Esempio 1: questo esempio recupera i backup creati da ieri per il file system specificato con l’ID specificato.

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

Output:

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

  • Per informazioni dettagliate sull’API, consulta DescribeBackups nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Get-FSXFileSystem.

Strumenti per PowerShell V5

Esempio 1: questo esempio restituisce la descrizione dell’oggetto filesystemId specificato.

Get-FSXFileSystem -FileSystemId fs-01cd23bc4bdf5678a

Output:

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

  • Per informazioni dettagliate sull’API, consulta DescribeFileSystems nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Get-FSXResourceTagList.

Strumenti per PowerShell V5

Esempio 1: questo esempio elenca i tag per l’ARN di risorsa specificato.

Get-FSXResourceTagList -ResourceARN $fsx.ResourceARN

Output:

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

  • Per informazioni dettagliate sull’API, consulta ListTagsForResource nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare New-FSXBackup.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un backup del file system specificato.

New-FSXBackup -FileSystemId fs-0b1fac2345623456ba

Output:

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

  • Per informazioni dettagliate sull’API, consulta CreateBackup nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare New-FSXFileSystem.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un nuovo file system Windows da 300 GB, che consente l’accesso dalla sottorete specificata, che supporta un throughput fino a 8 megabyte al secondo. Il nuovo file system viene aggiunto automaticamente al servizio Microsoft Active Directory specificato.

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

Output:

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

  • Per informazioni dettagliate sull’API, consulta CreateFileSystem nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare New-FSXFileSystemFromBackup.

Strumenti per PowerShell V5

Esempio 1: questo esempio crea un nuovo file system Amazon FSx a partire da un backup esistente di Amazon FSx per 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}

Output:

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

  • Per informazioni dettagliate sull’API, consulta CreateFileSystemFromBackup nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Remove-FSXBackup.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove l’ID di backup specificato.

Remove-FSXBackup -BackupId $backupID

Output:

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

  • Per informazioni dettagliate sull’API, consulta DeleteBackup nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Remove-FSXFileSystem.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove l’ID del file system FSX specificato.

Remove-FSXFileSystem -FileSystemId fs-012ff34e567890120

Output:

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

  • Per informazioni dettagliate sull’API, consulta DeleteFileSystem nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Remove-FSXResourceTag.

Strumenti per PowerShell V5

Esempio 1: questo esempio rimuove il tag di risorsa per l’ARN di risorsa del file system FSX specificato.

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

Output:

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

  • Per informazioni dettagliate sull’API, consulta UntagResource nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

L’esempio di codice seguente mostra come utilizzare Update-FSXFileSystem.

Strumenti per PowerShell V5

Esempio 1: questo esempio aggiorna i giorni di conservazione automatica dei backup del file system FSX tramite UpdateFileSystemWindowsConfiguration.

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

Output:

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

  • Per informazioni dettagliate sull’API, consulta UpdateFileSystem nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).