View a markdown version of this page

使用适用于 PowerShell V4 的工具的 Amazon EFS 示例 - Amazon Tools for PowerShell （版本 4）
操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon Tools for PowerShell V4 的支持已到期。

我们建议您迁移到 Amazon Tools for PowerShell V5 。有关如何迁移的更多详细信息和信息，请参阅我们的终止支持公告。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用适用于 PowerShell V4 的工具的 Amazon EFS 示例

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

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

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

主题

操作

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

适用于 PowerShell V4 的工具

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

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

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

适用于 PowerShell V4 的工具

示例 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 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DescribeFileSystems中的。

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

适用于 PowerShell V4 的工具

示例 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 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DescribeMountTargets中的。

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

适用于 PowerShell V4 的工具

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

Get-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d

输出：

sg-1a2b3c4d

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

适用于 PowerShell V4 的工具

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

Get-EFSTag -FileSystemId fs-1a2b3c4d

输出：

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

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DescribeTags中的。

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

适用于 PowerShell V4 的工具

示例 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 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateFileSystem中的。

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

适用于 PowerShell V4 的工具

示例 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 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateMountTarget中的。

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

适用于 PowerShell V4 的工具

示例 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 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateTags中的。

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

适用于 PowerShell V4 的工具

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

Remove-EFSFileSystem -FileSystemId fs-1a2b3c4d

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteFileSystem中的。

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

适用于 PowerShell V4 的工具

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

Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteMountTarget中的。

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

适用于 PowerShell V4 的工具

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

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

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteTags中的。