的版本 5 (V5) AWS Tools for PowerShell 已经发布！ 有关重大更改和迁移应用程序的信息，请参阅[迁移主题](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)。 [https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html) 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 使用适用于 PowerShell V5 的工具的 Amazon EFS 示例 以下代码示例向您展示了如何使用带有 Amazon EFS 的 AWS Tools for PowerShell V5 来执行操作和实现常见场景。 *操作*是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。 每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。 **Topics** + [操作](#actions) ## 操作 ### `Edit-EFSMountTargetSecurityGroup` 以下代码示例演示了如何使用 `Edit-EFSMountTargetSecurityGroup`。 **适用于 PowerShell V5 的工具** **示例 1：更新对指定挂载目标有效的安全组。最多可以指定 5 个，格式为“sg-xxxxxxxx”。** ``` Edit-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d -SecurityGroup sg-group1,sg-group3 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [ModifyMountTargetSecurityGroups](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-EFSFileSystem` 以下代码示例演示了如何使用 `Get-EFSFileSystem`。 **适用于 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 Cmdlet 参考 (V* 5) [DescribeFileSystems](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-EFSMountTarget` 以下代码示例演示了如何使用 `Get-EFSMountTarget`。 **适用于 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 Cmdlet 参考 (V* 5) [DescribeMountTargets](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-EFSMountTargetSecurityGroup` 以下代码示例演示了如何使用 `Get-EFSMountTargetSecurityGroup`。 **适用于 PowerShell V5 的工具** **示例 1：返回安全组的 ID，这些安全组当前分配给与挂载目标关联的网络接口。** ``` Get-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d ``` **输出**： ``` sg-1a2b3c4d ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeMountTargetSecurityGroups](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-EFSTag` 以下代码示例演示了如何使用 `Get-EFSTag`。 **适用于 PowerShell V5 的工具** **示例 1：返回当前与指定文件系统关联的标签集合。** ``` Get-EFSTag -FileSystemId fs-1a2b3c4d ``` **输出**： ``` Key Value --- ----- Name My File System tagkey1 tagvalue1 tagkey2 tagvalue2 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `New-EFSFileSystem` 以下代码示例演示了如何使用 `New-EFSFileSystem`。 **适用于 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 Cmdlet 参考 (V* 5) [CreateFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `New-EFSMountTarget` 以下代码示例演示了如何使用 `New-EFSMountTarget`。 **适用于 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 地址为指定的文件系统创建新的挂载目标。为挂载目标创建的网络接口与指定的安全组相关联（最多可以指定 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 参考 (V* 5) [CreateMountTarget](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `New-EFSTag` 以下代码示例演示了如何使用 `New-EFSTag`。 **适用于 PowerShell V5 的工具** **示例 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 参考 (V* 5) [CreateTags](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Remove-EFSFileSystem` 以下代码示例演示了如何使用 `Remove-EFSFileSystem`。 **适用于 PowerShell V5 的工具** **示例 1：删除不再使用的指定文件系统（如果文件系统有挂载目标，则必须先将其移除）。在 cmdlet 继续运行之前，系统将提示您进行确认 - 要禁止确认，请使用 `-Force` 开关。** ``` Remove-EFSFileSystem -FileSystemId fs-1a2b3c4d ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeleteFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Remove-EFSMountTarget` 以下代码示例演示了如何使用 `Remove-EFSMountTarget`。 **适用于 PowerShell V5 的工具** **示例 1：删除指定的挂载目标。在操作继续之前，系统会提示您进行确认。要禁止提示，请使用 `-Force` 开关。请注意，此操作通过目标来强制中断文件系统的所有挂载 - 如果可行，您可能需要考虑在运行此命令之前卸载文件系统。** ``` Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeleteMountTarget](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Remove-EFSTag` 以下代码示例演示了如何使用 `Remove-EFSTag`。 **适用于 PowerShell V5 的工具** **示例 1：从文件系统中删除包含一个或多个标签的集合。在 cmdlet 继续运行之前，系统将提示您进行确认 - 要禁止确认，请使用 `-Force` 开关。** ``` Remove-EFSTag -FileSystemId fs-1a2b3c4d -TagKey "tagkey1","tagkey2" ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeleteTags](https://docs.aws.amazon.com/powershell/v5/reference)中的。