버전 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)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Tools for PowerShell V5를 사용한 Amazon EFS 예제
다음 코드 예제에서는 Amazon EFS에서 AWS Tools for PowerShell V5를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `Edit-EFSMountTargetSecurityGroup`
다음 코드 예시는 `Edit-EFSMountTargetSecurityGroup`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 지정된 탑재 대상에 적용되는 보안 그룹을 업데이트합니다. 'sg-xxxxxxxx' 형식으로 최대 5개까지 지정할 수 있습니다.**
```
Edit-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d -SecurityGroup sg-group1,sg-group3
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [ModifyMountTargetSecurityGroups](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-EFSFileSystem`
다음 코드 예시는 `Get-EFSFileSystem`의 사용 방법을 보여줍니다.
**Tools for 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 참조(V5)*의 [DescribeFileSystems](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-EFSMountTarget`
다음 코드 예시는 `Get-EFSMountTarget`의 사용 방법을 보여줍니다.
**Tools for 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 참조(V5)*의 [DescribeMountTargets](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-EFSMountTargetSecurityGroup`
다음 코드 예시는 `Get-EFSMountTargetSecurityGroup`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 탑재 대상과 연결된 네트워크 인터페이스에 현재 할당된 보안 그룹의 ID를 반환합니다.**
```
Get-EFSMountTargetSecurityGroup -MountTargetId fsmt-1a2b3c4d
```
**출력:**
```
sg-1a2b3c4d
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeMountTargetSecurityGroups](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Get-EFSTag`
다음 코드 예시는 `Get-EFSTag`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 지정된 파일 시스템에 현재 연결된 태그 모음을 반환합니다.**
```
Get-EFSTag -FileSystemId fs-1a2b3c4d
```
**출력:**
```
Key Value
--- -----
Name My File System
tagkey1 tagvalue1
tagkey2 tagvalue2
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DescribeTags](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `New-EFSFileSystem`
다음 코드 예시는 `New-EFSFileSystem`의 사용 방법을 보여줍니다.
**Tools for 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 참조(V5)*의 [CreateFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `New-EFSMountTarget`
다음 코드 예시는 `New-EFSMountTarget`의 사용 방법을 보여줍니다.
**Tools for 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 주소를 사용하여 지정된 파일 시스템에 대한 새 탑재 대상을 생성합니다. 탑재 대상에 대해 생성된 네트워크 인터페이스는 지정된 보안 그룹과 연결됩니다(보안 그룹은 'sg-xxxxxxxx' 형식으로 최대 5개까지 지정할 수 있음).**
```
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 참조(V5)*의 [CreateMountTarget](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `New-EFSTag`
다음 코드 예시는 `New-EFSTag`의 사용 방법을 보여줍니다.
**Tools for 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 참조(V5)*의 [CreateTags](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.
### `Remove-EFSFileSystem`
다음 코드 예시는 `Remove-EFSFileSystem`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 더 이상 사용되지 않는 지정된 파일 시스템을 삭제합니다(파일 시스템에 탑재 대상이 있는 경우 먼저 제거해야 함). cmdlet이 실행되기 전에 확인 프롬프트가 표시됩니다. 확인 프롬프트를 차단하려면 `-Force` 스위치를 사용하세요.**
```
Remove-EFSFileSystem -FileSystemId fs-1a2b3c4d
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DeleteFileSystem](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Remove-EFSMountTarget`
다음 코드 예시는 `Remove-EFSMountTarget`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 지정된 탑재 대상을 삭제합니다. 작업이 진행되기 전에 확인 메시지가 표시됩니다. 프롬프트를 차단하려면 `-Force` 스위치를 사용합니다. 이 작업은 대상을 통해 파일 시스템의 탑재를 강제로 중단합니다. 상황에 따라 이 명령을 실행하기 전에 파일 시스템의 탑재 해제를 고려할 수 있습니다.**
```
Remove-EFSMountTarget -MountTargetId fsmt-1a2b3c4d
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DeleteMountTarget](https://docs.aws.amazon.com/powershell/v5/reference)을 참조하세요.
### `Remove-EFSTag`
다음 코드 예시는 `Remove-EFSTag`의 사용 방법을 보여줍니다.
**Tools for PowerShell V5**
**예제 1: 파일 시스템에서 하나 이상의 태그 모음을 삭제합니다. cmdlet이 실행되기 전에 확인 프롬프트가 표시됩니다. 확인 프롬프트를 차단하려면 `-Force` 스위치를 사용하세요.**
```
Remove-EFSTag -FileSystemId fs-1a2b3c4d -TagKey "tagkey1","tagkey2"
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [DeleteTags](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.