使用FSx以下工具的 Amazon 示例 PowerShell - AWS SDK代码示例
操作

AWS 文档 AWS SDK示例 GitHub 存储库中还有更多SDK示例。

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

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

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

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

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

主题

操作

以下代码示例演示如何使用 Add-FSXResourceTag。

用于 PowerShell

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

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

用于 PowerShell

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

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

用于 PowerShell

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

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

用于 PowerShell

示例 1：此示例列出了提供的资源 arn 的标签。

Get-FSXResourceTagList -ResourceARN $fsx.ResourceARN

输出：

Key         Value
---         -----
FSx-Service Windows
Users       Dev

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

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

用于 PowerShell

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

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

用于 PowerShell

示例 1：此示例创建了一个新的 300GB Windows 文件系统，允许从指定子网进行访问，该文件系统支持高达每秒 8 兆字节的吞吐量。新的文件系统将自动加入到指定的 Microsoft 活动目录。

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

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

用于 PowerShell

示例 1：此示例使用现有的 Amazon FSx for Windows 文件服务器备份创建新的亚马逊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

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

用于 PowerShell

示例 1：此示例删除了给定的备份 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 Cmdlet 参考DeleteBackup中的。

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

用于 PowerShell

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

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

用于 PowerShell

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

以下代码示例演示如何使用 Update-FSXFileSystem。

用于 PowerShell

示例 1：此示例通过更新FSX文件系统的自动备份保留天数 UpdateFileSystemWindowsConfiguration。

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