Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples) 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Tools for PowerShell V4 を使用した Amazon FSx の例 次のコード例は、Amazon FSx で AWS Tools for PowerShell V4 を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。 *アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。 各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。 **Topics** + [アクション](#actions) ## アクション ### `Add-FSXResourceTag` 次のコード例は、`Add-FSXResourceTag` を使用する方法を示しています。 **Tools for PowerShell V4** **例 1: この例では、指定リソースにタグを追加します。** ``` Add-FSXResourceTag -ResourceARN "arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a" -Tag @{Key="Users";Value="Test"} -PassThru ``` **出力:** ``` arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[TagResource](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。 ### `Get-FSXBackup` 次のコード例は、`Get-FSXBackup` を使用する方法を示しています。 **Tools for PowerShell V4** **例 1: この例では、指定ファイルシステム ID に対して昨日以降に作成されたバックアップを取得します。** ``` Get-FSXBackup -Filter @{Name="file-system-id";Values=$fsx.FileSystemId} | Where-Object CreationTime -gt (Get-Date).AddDays(-1) ``` **出力:** ``` 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 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DescribeBackups](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。 ### `Get-FSXFileSystem` 次のコード例は、`Get-FSXFileSystem` を使用する方法を示しています。 **Tools for PowerShell V4** **例 1: この例では、指定の filesystemId の説明を返します。** ``` Get-FSXFileSystem -FileSystemId fs-01cd23bc4bdf5678a ``` **出力:** ``` 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 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DescribeFileSystems](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。 ### `Get-FSXResourceTagList` 次のコード例は、`Get-FSXResourceTagList` を使用する方法を示しています。 **Tools for PowerShell V4** **例 1: この例では、指定リソース ARN のタグを一覧表示します。** ``` Get-FSXResourceTagList -ResourceARN $fsx.ResourceARN ``` **出力:** ``` Key Value --- ----- FSx-Service Windows Users Dev ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[ListTagsForResource](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。 ### `New-FSXBackup` 次のコード例は、`New-FSXBackup` を使用する方法を示しています。 **Tools for PowerShell V4** **例 1: この例では、指定ファイルシステムのバックアップを作成します。** ``` New-FSXBackup -FileSystemId fs-0b1fac2345623456ba ``` **出力:** ``` 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 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[CreateBackup](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。 ### `New-FSXFileSystem` 次のコード例は、`New-FSXFileSystem` を使用する方法を示しています。 **Tools for PowerShell V4** **例 1: この例では、指定サブネットからのアクセスを許可し、1 秒あたり最大 8 メガバイトのスループットをサポートする新しい 300GB のWindows ファイルシステムを作成します。新しいファイルシステムは、指定の Microsoft Active Directory に自動的に結合されます。** ``` New-FSXFileSystem -FileSystemType WINDOWS -StorageCapacity 300 -SubnetId subnet-1a2b3c4d5e6f -WindowsConfiguration @{ThroughputCapacity=8;ActiveDirectoryId='d-1a2b3c4d'} ``` **出力:** ``` 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 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[CreateFileSystem](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。 ### `New-FSXFileSystemFromBackup` 次のコード例は、`New-FSXFileSystemFromBackup` を使用する方法を示しています。 **Tools for PowerShell V4** **例 1: この例では、既存の Amazon FSx for Windows File Server バックアップから新しい Amazon FSx ファイルシステムを作成します。** ``` New-FSXFileSystemFromBackup -BackupId $backupID -Tag @{Key="tag:Name";Value="from-manual-backup"} -SubnetId $SubnetID -SecurityGroupId $SG_ID -WindowsConfiguration @{ThroughputCapacity=8;ActiveDirectoryId=$DirectoryID} ``` **出力:** ``` 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 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[CreateFileSystemFromBackup](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。 ### `Remove-FSXBackup` 次のコード例は、`Remove-FSXBackup` を使用する方法を示しています。 **Tools for PowerShell V4** **例 1: この例では、指定 backup-id を削除します。** ``` Remove-FSXBackup -BackupId $backupID ``` **出力:** ``` 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 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DeleteBackup](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。 ### `Remove-FSXFileSystem` 次のコード例は、`Remove-FSXFileSystem` を使用する方法を示しています。 **Tools for PowerShell V4** **例 1: この例では、指定 FSX ファイルシステム ID を削除します。** ``` Remove-FSXFileSystem -FileSystemId fs-012ff34e567890120 ``` **出力:** ``` 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 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[DeleteFileSystem](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。 ### `Remove-FSXResourceTag` 次のコード例は、`Remove-FSXResourceTag` を使用する方法を示しています。 **Tools for PowerShell V4** **例 1: この例では、指定 FSX ファイルシステムリソース ARN のリソースタグを削除します。** ``` Remove-FSXResourceTag -ResourceARN $FSX.ResourceARN -TagKey Users ``` **出力:** ``` 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 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[UntagResource](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。 ### `Update-FSXFileSystem` 次のコード例は、`Update-FSXFileSystem` を使用する方法を示しています。 **Tools for PowerShell V4** **例 1: この例では、UpdateFileSystemWindowsConfiguration を介して FSX ファイルシステムの自動バックアップ保持日数を更新します。** ``` $UpdateFSXWinConfig = [Amazon.FSx.Model.UpdateFileSystemWindowsConfiguration]::new() $UpdateFSXWinConfig.AutomaticBackupRetentionDays = 35 Update-FSXFileSystem -FileSystemId $FSX.FileSystemId -WindowsConfiguration $UpdateFSXWinConfig ``` **出力:** ``` 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 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V4)* の「[UpdateFileSystem](https://docs.aws.amazon.com/powershell/v4/reference)」を参照してください。