使用以下工具的 Amazon EFS 示例 PowerShell

以下代码示例向您展示了如何在 Amazon EFS 中使用来执行操作和实现常见场景。 AWS Tools for PowerShell

操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。

每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。

操作

Edit-EFSMountTargetSecurityGroup

以下代码示例演示如何使用 Edit-EFSMountTargetSecurityGroup。

用于 PowerShell

示例 1：更新指定挂载目标的有效安全组。最多可以指定 5 个，格式为 “sg-xxxxxxxx”。

Edit-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d -SecurityGroup sg-group1,sg-group3

• 有关 API 的详细信息，请参阅 AWS Tools for PowerShell Cmdlet 参考ModifyMountTargetSecurityGroups中的。

Get-EFSFileSystem

以下代码示例演示如何使用 Get-EFSFileSystem。

用于 PowerShell

示例 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 Cmdlet 参考DescribeFileSystems中的。

Get-EFSMountTarget

以下代码示例演示如何使用 Get-EFSMountTarget。

用于 PowerShell

示例 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 Cmdlet 参考DescribeMountTargets中的。

Get-EFSMountTargetSecurityGroup

以下代码示例演示如何使用 Get-EFSMountTargetSecurityGroup。

用于 PowerShell

示例 1：返回当前分配给与挂载目标关联的网络接口的安全组的 ID。

Get-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d

输出：

sg-1a2b3c4d

• 有关 API 的详细信息，请参阅 AWS Tools for PowerShell Cmdlet 参考DescribeMountTargetSecurityGroups中的。

Get-EFSTag

以下代码示例演示如何使用 Get-EFSTag。

用于 PowerShell

示例 1：返回当前与指定文件系统关联的标签集合。

Get-EFSTag -FileSystemId fs-1a2b3c4d

输出：

Key         Value
---         -----
Name        My File System
tagkey1     tagvalue1
tagkey2     tagvalue2

• 有关 API 的详细信息，请参阅 AWS Tools for PowerShell Cmdlet 参考DescribeTags中的。

New-EFSFileSystem

以下代码示例演示如何使用 New-EFSFileSystem。

用于 PowerShell

示例 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 Cmdlet 参考CreateFileSystem中的。

New-EFSMountTarget

以下代码示例演示如何使用 New-EFSMountTarget。

用于 PowerShell

示例 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 地址为指定的文件系统创建新的挂载目标。为挂载目标创建的网络接口与指定的安全组相关联（最多可以指定 5 个，格式为 “sg-xxxxxxxx”）。

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 Cmdlet 参考CreateMountTarget中的。

New-EFSTag

以下代码示例演示如何使用 New-EFSTag。

用于 PowerShell

示例 1：将标签集合应用于指定的文件系统。如果文件系统上已经存在指定密钥的标签，则该标签的值将被更新。

New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="tagkey1";Value="tagvalue1"},@{Key="tagkey2";Value="tagvalue2"}

示例 2：为指定文件系统设置名称标签。使用 Get-EFSFileSystem cmdlet 时，此值会与其他文件系统详细信息一起返回。

New-EFSTag -FileSystemId fs-1a2b3c4d -Tag @{Key="Name";Value="My File System"}

• 有关 API 的详细信息，请参阅 AWS Tools for PowerShell Cmdlet 参考CreateTags中的。

Remove-EFSFileSystem

以下代码示例演示如何使用 Remove-EFSFileSystem。

用于 PowerShell

示例 1：删除不再使用的指定文件系统（如果文件系统有挂载目标，则必须先将其删除）。在 cmdlet 继续执行之前，系统会提示您进行确认-要取消确认，请使用开关。-Force

Remove-EFSFileSystem -FileSystemId fs-1a2b3c4d

• 有关 API 的详细信息，请参阅 AWS Tools for PowerShell Cmdlet 参考DeleteFileSystem中的。

Remove-EFSMountTarget

以下代码示例演示如何使用 Remove-EFSMountTarget。

用于 PowerShell

示例 1：删除指定的挂载目标。在操作继续之前，系统会提示您进行确认。要取消提示音，请使用开-Force关。请注意，此操作通过目标强制中断文件系统的所有挂载——如果可行，您可能需要考虑在运行此命令之前卸载文件系统。

Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d

• 有关 API 的详细信息，请参阅 AWS Tools for PowerShell Cmdlet 参考DeleteMountTarget中的。

Remove-EFSTag

以下代码示例演示如何使用 Remove-EFSTag。

用于 PowerShell

示例 1：从文件系统中删除一个或多个标签的集合。在 cmdlet 继续执行之前，系统会提示您进行确认-要取消确认，请使用开关。-Force

Remove-EFSTag -FileSystemId fs-1a2b3c4d -TagKey "tagkey1","tagkey2"

• 有关 API 的详细信息，请参阅 AWS Tools for PowerShell Cmdlet 参考DeleteTags中的。