Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Tools for PowerShell V5를 사용한 Amazon FSx 예제
다음 코드 예제에서는 Amazon FSx에서 AWS Tools for PowerShell V5를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `Add-FSXResourceTag`
다음 코드 예시는 `Add-FSXResourceTag`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 예제에서는 지정된 리소스에 태그를 추가합니다.**
```
Add-FSXResourceTag -ResourceARN "arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a" -Tag @{Key="Users";Value="Test"}
```
**출력:**
```
arn:aws:fsx:eu-west-1:123456789012:file-system/fs-01cd23bc4bdf5678a
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [TagResource](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Get-FSXBackup`
다음 코드 예시는 `Get-FSXBackup`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 참조(V5)*의 [DescribeBackups](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-FSXFileSystem`
다음 코드 예시는 `Get-FSXFileSystem`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 참조(V5)*의 [DescribeFileSystems](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-FSXResourceTagList`
다음 코드 예시는 `Get-FSXResourceTagList`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 예제에서는 제공된 리소스 ARN에 대한 태그를 나열합니다.**
```
Get-FSXResourceTagList -ResourceARN $fsx.ResourceARN
```
**출력:**
```
Key Value
--- -----
FSx-Service Windows
Users Dev
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [ListTagsForResource](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `New-FSXBackup`
다음 코드 예시는 `New-FSXBackup`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 참조(V5)*의 [CreateBackup](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `New-FSXFileSystem`
다음 코드 예시는 `New-FSXFileSystem`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 예제에서는 초당 최대 8MB의 처리량을 지원하는 지정된 서브넷의 액세스를 허용하는 새 300GB Windows 파일 시스템을 생성합니다. 새 파일 시스템은 지정된 Microsoft Active Directory에 자동으로 조인됩니다.**
```
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 참조(V5)*의 [CreateFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `New-FSXFileSystemFromBackup`
다음 코드 예시는 `New-FSXFileSystemFromBackup`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 예제에서는 기존 Amazon FSx for Windows File Server 백업에서 새 Amazon 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
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [CreateFileSystemFromBackup](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Remove-FSXBackup`
다음 코드 예시는 `Remove-FSXBackup`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 예제에서는 지정된 backup-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 참조(V5)*의 [DeleteBackup](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Remove-FSXFileSystem`
다음 코드 예시는 `Remove-FSXFileSystem`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 참조(V5)*의 [DeleteFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Remove-FSXResourceTag`
다음 코드 예시는 `Remove-FSXResourceTag`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 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 참조(V5)*의 [UntagResource](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Update-FSXFileSystem`
다음 코드 예시는 `Update-FSXFileSystem`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 이 예제에서는 UpdateFileSystemWindowsConfiguration을 통해 FSX 파일 시스템 자동 백업 보존 기간을 업데이트합니다.**
```
$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 참조(V5)*의 [UpdateFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.