Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples) 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Tools for PowerShell V5 を使用した Amazon EFS の例 次のコード例は、Amazon EFS で AWS Tools for PowerShell V5 を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。 *アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。 各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。 **Topics** + [アクション](#actions) ## アクション ### `Edit-EFSMountTargetSecurityGroup` 次のコード例は、`Edit-EFSMountTargetSecurityGroup` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: 指定されたマウントターゲットに対して有効なセキュリティグループを更新します。「sg-xxxxxxxx」の形式で最大 5 つ指定できます。** ``` Edit-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d -SecurityGroup sg-group1,sg-group3 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[ModifyMountTargetSecurityGroups](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-EFSFileSystem` 次のコード例は、`Get-EFSFileSystem` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: リージョン内の発信者のアカウントが所有するすべてのファイルシステムのコレクションを返します。** ``` Get-EFSFileSystem ``` **出力:** ``` CreationTime : 5/26/2015 4:02:38 PM CreationToken : 1a2bff54-85e0-4747-bd95-7bc172c4f555 FileSystemId : fs-1a2b3c4d LifeCycleState : available Name : NumberOfMountTargets : 0 OwnerId : 123456789012 SizeInBytes : Amazon.ElasticFileSystem.Model.FileSystemSize CreationTime : 5/26/2015 4:06:23 PM CreationToken : 2b4daa14-85e0-4747-bd95-7bc172c4f555 FileSystemId : fs-4d3c2b1a ... ``` **例 2: 指定されたファイルシステムの詳細を返します。** ``` Get-EFSFileSystem -FileSystemId fs-1a2b3c4d ``` **例 3: ファイルシステムの作成時に指定されたべき等性作成トークンを使用して、ファイルシステムの詳細を返します。** ``` Get-EFSFileSystem -CreationToken 1a2bff54-85e0-4747-bd95-7bc172c4f555 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeFileSystems](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-EFSMountTarget` 次のコード例は、`Get-EFSMountTarget` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: 指定されたファイルシステムに関連付けられたマウントターゲットのコレクションを返します。** ``` Get-EFSMountTarget -FileSystemId fs-1a2b3c4d ``` **出力:** ``` FileSystemId : fs-1a2b3c4d IpAddress : 10.0.0.131 LifeCycleState : available MountTargetId : fsmt-1a2b3c4d NetworkInterfaceId : eni-1a2b3c4d OwnerId : 123456789012 SubnetId : subnet-1a2b3c4d ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeMountTargets](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-EFSMountTargetSecurityGroup` 次のコード例は、`Get-EFSMountTargetSecurityGroup` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: マウントターゲットに関連付けられたネットワークインターフェイスに現在割り当てられているセキュリティグループの ID を返します。** ``` Get-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d ``` **出力:** ``` sg-1a2b3c4d ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeMountTargetSecurityGroups](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Get-EFSTag` 次のコード例は、`Get-EFSTag` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: 指定されたファイルシステムに現在関連付けられているタグのコレクションを返します。** ``` Get-EFSTag -FileSystemId fs-1a2b3c4d ``` **出力:** ``` Key Value --- ----- Name My File System tagkey1 tagvalue1 tagkey2 tagvalue2 ``` + API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。** ### `New-EFSFileSystem` 次のコード例は、`New-EFSFileSystem` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: 新しい空のファイルシステムを作成します。作成のべき等性を保証するために使用されるトークンは自動的に生成され、返されたオブジェクトの `CreationToken` メンバーからアクセスできます。** ``` New-EFSFileSystem ``` **出力:** ``` CreationTime : 5/26/2015 4:02:38 PM CreationToken : 1a2bff54-85e0-4747-bd95-7bc172c4f555 FileSystemId : fs-1a2b3c4d LifeCycleState : creating Name : NumberOfMountTargets : 0 OwnerId : 123456789012 SizeInBytes : Amazon.ElasticFileSystem.Model.FileSystemSize ``` **例 2: カスタムトークンを使用して新しい空のファイルシステムを作成し、作成のべき等性を保証します。** ``` New-EFSFileSystem -CreationToken "MyUniqueToken" ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[CreateFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `New-EFSMountTarget` 次のコード例は、`New-EFSMountTarget` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: ファイルシステムのマウントターゲットを新規に作成します。指定されたサブネットを使用して、マウントターゲットが作成される仮想プライベートクラウド (VPC) と、(サブネットのアドレス範囲から) 自動割り当てされる IP アドレスを決定します。割り当てられた IP アドレスを使用して、このファイルシステムを Amazon EC2 インスタンスにマウントできます。セキュリティグループが指定されていないため、ターゲット用に作成されたネットワークインターフェイスは、サブネットの VPC のデフォルトのセキュリティグループに関連付けられます。** ``` New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d ``` **出力:** ``` FileSystemId : fs-1a2b3c4d IpAddress : 10.0.0.131 LifeCycleState : creating MountTargetId : fsmt-1a2b3c4d NetworkInterfaceId : eni-1a2b3c4d OwnerId : 123456789012 SubnetId : subnet-1a2b3c4d ``` **例 2: 自動割り当て IP アドレスを使用して、指定されたファイルシステムの新しいマウントターゲットを作成します。マウントターゲット用に作成されたネットワークインターフェイスは、指定されたセキュリティグループに関連付けられます (「sg-xxxxxxxx」の形式で最大 5 つまで指定できます)。** ``` New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -SecurityGroup sg-group1,sg-group2,sg-group3 ``` **例 3: 指定された IP アドレスを使用して、指定されたファイルシステムの新しいマウントターゲットを作成します。** ``` New-EFSMountTarget -FileSystemId fs-1a2b3c4d -SubnetId subnet-1a2b3c4d -IpAddress 10.0.0.131 ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[CreateMountTarget](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `New-EFSTag` 次のコード例は、`New-EFSTag` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: 指定ファイルシステムにタグのコレクションを適用します。指定キーを持つタグが既にファイルシステムに存在する場合、タグの値は更新されます。** ``` New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="tagkey1";Value="tagvalue1"},@{Key="tagkey2";Value="tagvalue2"} ``` **例 2: 指定ファイルシステムの名前タグを設定します。この値は、Get-EFSFileSystem コマンドレットを使用するときに、他のファイルシステムの詳細とともに返されます。** ``` New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="Name";Value="My File System"} ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[CreateTags](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Remove-EFSFileSystem` 次のコード例は、`Remove-EFSFileSystem` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: 使用されなくなった指定ファイルシステムを削除します (ファイルシステムにマウントターゲットがある場合は、最初に削除する必要があります)。コマンドレットが続行される前に確認を求めるプロンプトが表示されます。プロンプトを表示しないようにするには、`-Force` スイッチを使用します。** ``` Remove-EFSFileSystem -FileSystemId fs-1a2b3c4d ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DeleteFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Remove-EFSMountTarget` 次のコード例は、`Remove-EFSMountTarget` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: 指定されたマウントターゲットを削除します。操作を続行する前に確認画面が表示されます。プロンプトを表示しないようにするには、`-Force` スイッチを使用します。このオペレーションでは、ターゲットを介してファイルシステムのマウントが強制的に中断されることに注意してください。可能であれば、このコマンドを実行する前にファイルシステムのアンマウントを検討してください。** ``` Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DeleteMountTarget](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。 ### `Remove-EFSTag` 次のコード例は、`Remove-EFSTag` を使用する方法を示しています。 **Tools for PowerShell V5** **例 1: ファイルシステムから 1 つ以上のタグのコレクションを削除します。コマンドレットが続行される前に確認を求めるプロンプトが表示されます。プロンプトを表示しないようにするには、`-Force` スイッチを使用します。** ``` Remove-EFSTag -FileSystemId fs-1a2b3c4d -TagKey "tagkey1","tagkey2" ``` + API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DeleteTags](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。