

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# WorkSpaces 애플리케이션 클라이언트 설치 및 구성
<a name="install-configure-client"></a>

사용자가 WorkSpaces 애플리케이션 클라이언트를 직접 설치하도록 하거나 PowerShell 스크립트를 원격으로 실행하여 WorkSpaces 애플리케이션 클라이언트를 설치할 수 있습니다.

사용자가 스트리밍 세션에서 사용할 수 있도록 하려는 USB 디바이스를 정규화해야 합니다. USB 디바이스가 정규화되지 않은 경우 WorkSpaces 애플리케이션에서 감지되지 않으며 세션과 공유할 수 없습니다.

다음 주제에서는 WorkSpaces 애플리케이션 클라이언트를 설치하고 구성하는 방법을 설명합니다.

**Topics**
+ [사용자가 WorkSpaces 애플리케이션 클라이언트를 직접 설치하도록 하기](user-install-client.md)
+ [자습서: Amazon WorkSpaces 애플리케이션 클라이언트 설치 및 사용자에 맞게 클라이언트 환경 사용자 지정](install-client-configure-settings.md)
+ [WorkSpaces 애플리케이션 엔터프라이즈 배포 도구, 클라이언트 및 USB 드라이버를 수동으로 업데이트](update-enterprise-deployment-tool-client-usb-driver-manually.md)
+ [스트리밍 애플리케이션에 사용할 USB 디바이스 승인](qualify-usb-devices.md)
+ [WorkSpaces 애플리케이션 클라이언트 사용자를 위한 연결 방법 구성](use-client-start-streaming-session.md)
+ [사용자가 USB 디바이스를 WorkSpaces 애플리케이션 스트리밍 세션과 공유하도록 활성화](share-usb-devices-with-session.md)
+ [웹 브라우저에서 WorkSpaces 애플리케이션 클라이언트로 스트리밍 세션 리디렉션](redirect-streaming-session-from-web-to-client.md)
+ [WorkSpaces 애플리케이션 사용자를 위한 파일 시스템 리디렉션 활성화](enable-file-system-redirection.md)
+ [WorkSpaces 애플리케이션 사용자에 대해 로컬 프린터 리디렉션 활성화](enable-local-printer-redirection.md)

# 사용자가 WorkSpaces 애플리케이션 클라이언트를 직접 설치하도록 하기
<a name="user-install-client"></a>

WorkSpaces 애플리케이션 클라이언트를 설치하는 데 도움이 되도록 사용자에게 제공할 수 있는 step-by-step 지침은 [Windows용 설정](client-application-windows-installation-user.md) 또는 섹션을 참조하세요[macOS 설정 및 설치](client-application-mac-installation-user.md).

**중요**  
Windows 클라이언트의 경우 조직에서 사용자가 .exe 파일을 실행하지 못하도록 하는 바이러스 백신 소프트웨어를 배포한 경우 사용자가 WorkSpaces Applications 클라이언트 설치 .exe 프로그램을 실행하도록 허용하는 예외를 추가해야 합니다. 그렇지 않으면 사용자가 클라이언트를 설치하려고 해도 아무 일도 일어나지 않거나, 혹은 설치 프로그램을 시작한 후 오류 메시지가 표시됩니다.

사용자가 클라이언트를 설치한 후 사용자가 WorkSpaces 애플리케이션 스트리밍 세션 중에 USB 디바이스를 사용하도록 하려면 다음 요구 사항을 충족해야 합니다.
+ WorkSpaces 애플리케이션에서 사용할 수 있는 USB 디바이스를 검증해야 합니다. 자세한 내용은 [스트리밍 애플리케이션에 사용할 USB 디바이스 승인](qualify-usb-devices.md) 단원을 참조하십시오.
+ 디바이스에 자격을 부여한 후 사용자는 새 스트리밍 세션을 시작할 때마다 WorkSpaces 애플리케이션과 디바이스를 공유해야 합니다. 이 작업을 수행하는 데 도움이 되도록 사용자에게 제공할 수 있는 지침은 [USB 디바이스](client-application-windows-how-to-share-usb-devices-user.md) 단원을 참조하십시오.

# 자습서: Amazon WorkSpaces 애플리케이션 클라이언트 설치 및 사용자에 맞게 클라이언트 환경 사용자 지정
<a name="install-client-configure-settings"></a>

다음 섹션에서는 WorkSpaces Applications 클라이언트를 설치하고 사용자에 맞게 클라이언트 환경을 사용자 지정하는 방법을 설명합니다. 관리자가 사용자를 대신에 클라이언트를 다운로드하여 설치하는 경우에는 먼저 엔터프라이즈 배포 도구를 다운로드합니다. 그런 다음 PowerShell 스크립트를 실행하여 WorkSpaces 애플리케이션 클라이언트를 설치하고 클라이언트 설정을 원격으로 구성할 수 있습니다.

**참고**  
WorkSpaces 애플리케이션 macOS 클라이언트와 함께 엔터프라이즈 배포 도구를 사용하는 것은 지원되지 않습니다.

**Topics**
+ [엔터프라이즈 배포 도구 다운로드](#install-client-use-remote-deployment-tool)
+ [WorkSpaces 애플리케이션 클라이언트 및 USB 드라이버 설치](#run-powershell-script-install-client-usb-driver-silently)
+ [WorkSpaces 애플리케이션 클라이언트를 사용하여 WorkSpaces 애플리케이션 액세스](#access-appstream-with-client)
+ [WorkSpaces 애플리케이션 클라이언트 사용자의 StartURL 레지스트리 값 설정](#set-start-url-registry-value)
+ [WorkSpaces 애플리케이션 클라이언트에 대해 다른 도메인을 활성화하도록 TrustedDomains 레지스트리 값 설정 WorkSpaces](#set-trusted-domains-registry-value)
+ [AS2TrustedDomains DNS TXT 레코드를 생성하여 레지스트리 변경 없이 WorkSpaces 애플리케이션 클라이언트에 대해 도메인 활성화](#create-AS2TrustedDomains-DNS-TXT-record-client)
+ [신뢰할 수 있는 도메인에 대한 DNS TXT 레코드 조회 비활성화](#disable-DNS-TXT-record-lookup-client)
+ [자동 클라이언트 업데이트 비활성화 여부 선택](#disable-automatic-updates-client)
+ [온디맨드 진단 로그 업로드를 비활성화할지 여부 선택](#disable-on-demand-diagnostic-log-uploads)
+ [네이티브 애플리케이션 모드를 비활성화할지 여부 선택](#disable-native-application-mode-client)
+ [로컬 프린터 리디렉션을 비활성화할지 선택](#disable-local-printer-redirection-client)
+ [스마트 카드 리디렉션을 비활성화할지 선택](#disable-local-smart-card-support-client)
+ [사용자를 위한 추가 WorkSpaces 애플리케이션 클라이언트 설정 구성](#configure-client)
+ [그룹 정책을 사용하여 WorkSpaces 애플리케이션 클라이언트 환경 사용자 지정](#configure-client-with-adm-template-group-policy)

## 엔터프라이즈 배포 도구 다운로드
<a name="install-client-use-remote-deployment-tool"></a>

Enterprise Deployment Tool에는 WorkSpaces Applications 클라이언트 설치 파일과 그룹 정책 관리 템플릿이 포함되어 있습니다.

1. 엔터프라이즈 배포 도구를 다운로드하려면 [WorkSpaces 애플리케이션이 지원하는 클라이언트](https://clients.amazonappstream.com) 페이지 오른쪽 하단에서 **엔터프라이즈 배포 도구** 링크를 선택합니다. 이 링크를 선택하면 최신 버전의 도구에 필요한 파일이 들어 있는 .zip 파일이 열립니다.

1. 필요한 파일의 압축을 풀려면, 도구를 다운로드한 위치로 이동하여 **AmazonAppStreamClient\$1EnterpriseSetup\$1<version>** 폴더를 마우스 오른쪽 버튼으로 클릭한 후 **Extract All(모두 압축 풀기)**를 선택합니다. 이 폴더에는 두 가지 설치 프로그램과 그룹 정책 관리 템플릿이 있습니다.
   + WorkSpaces Applications 클라이언트 설치 관리자(AmazonAppStreamClientSetup\$1<version>.msi) - WorkSpaces Applications 클라이언트를 설치합니다.
   + WorkSpaces 애플리케이션 USB 드라이버 설치 프로그램(AmazonAppStreamUsbDriverSetup\$1<version>.exe) - WorkSpaces 애플리케이션을 통해 스트리밍된 애플리케이션에서 USB 디바이스를 사용하는 데 필요한 WorkSpaces 애플리케이션 USB 드라이버를 설치합니다.
   + WorkSpaces 애플리케이션 클라이언트 그룹 정책 관리 템플릿(as2\$1client\$1config.adm) - 그룹 정책을 통해 WorkSpaces 애플리케이션 클라이언트를 구성할 수 있습니다.

## WorkSpaces 애플리케이션 클라이언트 및 USB 드라이버 설치
<a name="run-powershell-script-install-client-usb-driver-silently"></a>

WorkSpaces Applications 클라이언트 설치 파일을 다운로드한 후 사용자 컴퓨터에서 다음 PowerShell 스크립트를 실행하여 WorkSpaces Applications 클라이언트 설치 파일, AppStreamClient.exe, 및 USB 드라이버를 자동으로 설치합니다.

**참고**  
이 스크립트를 실행하려면 관리자 권한으로 해당 컴퓨터에 로그인해야 합니다. 그 밖에 시작할 때 시스템 계정에서 원격으로 스크립트를 실행하는 방법도 있습니다.

```
Start-Process msiexec.exe -Wait -ArgumentList  '/i AmazonAppStreamClientSetup_<version>.msi /quiet'

Start-Process AmazonAppStreamUsbDriverSetup_<version>.exe -Wait -ArgumentList  '/quiet'
```

사용자의 컴퓨터에 엔터프라이즈 배포 도구를 설치하면 WorkSpaces 애플리케이션 클라이언트가 다음과 같이 설치됩니다.

1. WorkSpaces Applications 클라이언트 설치 파일은 사용자 컴퓨터의 C:\$1Program Files (x86)\$1Amazon WorkSpaces Applications Client Installer\$1AppStreamClient.exe.

1. 엔터프라이즈 배포 도구가 설치된 후 사용자가 컴퓨터에 처음 로그인하면 WorkSpaces 애플리케이션 클라이언트가 설치됩니다.
**참고**  
Enterprise Deployment Tool이 WorkSpaces Applications Client 폴더인 **AppStreamClient**가 이미 **%localappdata%**에 있음을 감지하면이 도구는 클라이언트를 설치하지 않습니다.

사용자가 WorkSpaces 애플리케이션 클라이언트를 제거하면 WorkSpaces 애플리케이션 엔터프라이즈 배포 도구를 업데이트할 때까지 클라이언트가 다시 설치되지 않습니다.

## WorkSpaces 애플리케이션 클라이언트를 사용하여 WorkSpaces 애플리케이션 액세스
<a name="access-appstream-with-client"></a>

기본적으로 사용자가 WorkSpaces 애플리케이션 클라이언트를 시작하면 WorkSpaces 애플리케이션 도메인이 포함된 URLs 또는 연결을 활성화하는 DNS TXT 레코드가 포함된 도메인에만 연결할 수 있습니다. 클라이언트 사용자가 다음 중 하나를 수행하여 WorkSpaces 애플리케이션 도메인 이외의 도메인에 액세스하도록 할 수 있습니다.
+ `StartURL` 레지스트리 값을 설정하여 사용자가 액세스할 수 있는 사용자 지정 URL(예: 조직의 로그인 포털 URL)을 지정합니다.
+ `TrustedDomains` 레지스트리 값을 설정하여 사용자가 액세스할 수 있는 신뢰할 수 있는 도메인을 지정합니다.
+ `AS2TrustedDomains` DNS TXT 레코드를 생성하여 사용자가 액세스할 수 있는 신뢰할 수 있는 도메인을 지정합니다. 이 방법을 사용하면 레지스트리를 변경할 필요가 없습니다.

**참고**  
WorkSpaces 애플리케이션 클라이언트 및 DNS TXT 레코드 구성은 사용자가 다른 연결 방법을 사용하여 지정한 도메인 또는 URLs에 액세스하는 것을 방지하지 않습니다. 예를 들어 사용자가 지정된 도메인 또는 URL에 대한 네트워크 액세스 권한이 있는 경우 웹 브라우저를 사용하여 해당 도메인 또는 URL에 액세스할 수 있습니다.

## WorkSpaces 애플리케이션 클라이언트 사용자의 StartURL 레지스트리 값 설정
<a name="set-start-url-registry-value"></a>

`StartUrl` 레지스트리 값을 사용하여 사용자가 클라이언트를 시작할 때 WorkSpaces 애플리케이션 클라이언트에 채워지는 사용자 지정 URL을 설정할 수 있습니다. 클라이언트를 설치하는 동안 이 HKLM 레지스트리 키를 만들어 사용자가 클라이언트를 시작할 때 URL을 지정할 필요가 없도록 할 수 있습니다.

WorkSpaces 애플리케이션 클라이언트를 설치한 후 다음 PowerShell 스크립트를 실행하여이 레지스트리 키를 생성하거나 WorkSpaces 애플리케이션 클라이언트 엔터프라이즈 배포 도구에 포함된 관리 템플릿을 사용하여 그룹 정책을 통해 클라이언트를 구성할 수 있습니다.

`StartUrl` 값을 자격 증명 공급자(IdP)의 URL로 바꿉니다. 이 URL은 디바이스에서 신뢰하는 인증서를 사용해야 합니다. 즉, `StartUrl` 웹 페이지에서 사용하는 인증서에는 URL의 도메인 이름이 포함된 주체 대체 이름(SAN)이 있어야 합니다. 예를 들어 `StartUrl`이 https://appstream.example.com으로 설정된 경우 SSL 인증서에 appstream.example.com이 포함된 SAN이 있어야 합니다.

**참고**  
이 스크립트를 실행하려면 관리자 권한으로 해당 컴퓨터에 로그인해야 합니다. 그 밖에 시작할 때 시스템 계정에서 원격으로 스크립트를 실행하는 방법도 있습니다.

```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "StartUrl" -Value "https://www.example.com" -PropertyType String -Force | Out-Null
```

## WorkSpaces 애플리케이션 클라이언트에 대해 다른 도메인을 활성화하도록 TrustedDomains 레지스트리 값 설정 WorkSpaces
<a name="set-trusted-domains-registry-value"></a>

지정한 신뢰할 수 있는 도메인의 URLs에 연결하도록 WorkSpaces 애플리케이션 클라이언트를 구성할 수 있습니다. 예를 들어, 사용자가 조직 도메인의 URL이나 하나 이상의 IdP 도메인에 있는 URL에 연결하도록 할 수 있습니다. URL을 지정할 때는 \$1.*example*-*idp*.*com* 형식을 사용합니다.

신뢰할 수 있는 도메인 목록을 쉼표로 구분된 형식으로 지정할 수 있습니다. 이 목록을 WorkSpaces Applications `TrustedDomains` HKLM 레지스트리 키에 레지스트리 값으로 추가합니다. WorkSpaces 애플리케이션 클라이언트를 설치할 때 또는 Microsoft Active Directory를 사용하는 경우 그룹 정책을 통해이 레지스트리 키를 생성하고 신뢰할 수 있는 도메인 목록을 지정하는 것이 좋습니다. 이렇게 하면 클라이언트가 설치된 직후 사용자가 신뢰할 수 있는 도메인의 URL에 연결할 수 있습니다.

WorkSpaces Applications 클라이언트를 설치한 후 다음 PowerShell 스크립트를 실행하여이 레지스트리 키를 생성할 수 있습니다. 또는 WorkSpaces 애플리케이션 클라이언트 엔터프라이즈 배포 도구에 포함된 관리 템플릿을 사용하여 그룹 정책을 통해 클라이언트를 구성할 수 있습니다.

`TrustedDomains` 값을 하나 이상의 조직 도메인이나 IdP 도메인의 쉼표로 구분된 목록으로 대체합니다. 신뢰할 수 있는 도메인 웹 페이지에서 사용하는 인증서에는 URL의 도메인이 포함된 SAN이 있어야 합니다. 예를 들어 신뢰할 수 있는 도메인에 \$1.example.com이 포함되어 있고 사용자가 https://appstream.example.com을 지정하는 경우 SSL 인증서에 appstream.example.com이 포함된 SAN이 있어야 합니다.

**참고**  
이 스크립트를 실행하려면 관리자 권한으로 해당 컴퓨터에 로그인해야 합니다. 그 밖에 시작할 때 시스템 계정에서 원격으로 스크립트를 실행하는 방법도 있습니다.

```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "TrustedDomains" -Value "*.example1.com, *.example2.com, aws.amazon.com" -PropertyType String -Force | Out-Null
```

다음은 신뢰할 수 있는 도메인 이름의 형식을 지정하기 위한 요구 사항 및 고려 사항입니다.
+ 다음 문자가 지원됩니다. a-z, 0-9, -, \$1
+ DNS는 도메인 이름에 표시되는 위치에 따라 \$1 문자를 와일드카드 또는 별표 문자(ASCII 42)로 처리합니다. DNS 레코드의 이름에 \$1를 와일드카드로 사용할 때의 제한 사항은 다음과 같습니다.
  + \$1는 도메인 이름에서 맨 왼쪽 라벨을 대체해야 합니다. 예: \$1.example.com 또는 \$1.prod.example.com. 다른 위치에 \$1를 포함시키면(예: prod.\$1.example.com) DNS가 이를 와일드카드가 아닌 별표 문자(ASCII 42)로 처리합니다.
  + \$1이 전체 라벨을 대신해야 합니다. 예를 들어, \$1prod.example.com 또는 prod\$1.example.com을 지정할 수 없습니다.
  + \$1는 \$1및 해당 하위 도메인의 모든 하위 도메인을 비롯한 하위 도메인 수준에 적용됩니다. 예를 들어 항목의 이름이 \$1.example.com인 경우 WorkSpaces 애플리케이션 클라이언트는 zenith.example.com, acme.zenith.example.com 및 pinnacle.acme.zenith.example.com 허용합니다.

## AS2TrustedDomains DNS TXT 레코드를 생성하여 레지스트리 변경 없이 WorkSpaces 애플리케이션 클라이언트에 대해 도메인 활성화
<a name="create-AS2TrustedDomains-DNS-TXT-record-client"></a>

해당 도메인의 DNS TXT 레코드를 생성하여 사용자가 조직 도메인의 URL(예: \$1.example.com)이나 IdP 도메인의 URL(예: \$1.example-idp.com)에 연결할 수 있도록 설정할 수 있습니다. DNS TXT 레코드를 생성하는 경우 사용자가 URL에 연결할 수 있도록 하는데 `StartURL` 또는 `TrustedDomains` 레지스트리 값이 필요 없습니다.

`AS2TrustedDomains=` 접두사가 붙은 쉼표로 구분된 형식으로 신뢰할 수 있는 하위 도메인 목록을 지정할 수 있습니다. 그런 다음 해당 도메인에 대한 DNS TXT 레코드를 생성합니다. `AS2TrustedDomains` DNS TXT 레코드는 DNS TXT 레코드가 생성된 도메인의 동일한 도메인 또는 하위 도메인만 사용 가능하도록 설정할 수 있습니다. DNS TXT 레코드로 다른 도메인은 사용 가능하게 설정할 수 없습니다.

DNS 레코드 설정에 대한 자세한 내용은 [Enable your organizational domain for the AppStream 2.0 client with a Route 53 DNS TXT record](https://aws.amazon.com/blogs/desktop-and-application-streaming/enable-your-organizational-domain-for-the-appstream-2-0-client-with-a-route-53-dns-txt-record/) 및 [Creating an AS2TrustedDomains DNS TXT record to redirect the AppStream 2.0 native client to a third-party identity provider](https://aws.amazon.com/blogs/desktop-and-application-streaming/creating-an-as2trusteddomains-dns-txt-record-to-redirect-the-appstream-2-0-native-client-to-a-third-party-identity-provider/)를 참조하세요.

**참고**  
DNS TXT 레코드를 생성하면 `StartURL` 또는 `TrustedDomains` 레지스트리 값에 포함되어 있지 않더라도 사용 가능하게 설정된 도메인에서 사용자가 스트리밍할 수 있습니다. WorkSpaces 애플리케이션 클라이언트 및 DNS TXT 레코드 구성은 사용자가 다른 연결 방법을 사용하여 지정한 도메인 또는 URLs에 액세스하는 것을 방지하지 않습니다. 예를 들어 사용자가 지정된 도메인 또는 URL에 대한 네트워크 액세스 권한이 있는 경우 웹 브라우저를 사용하여 해당 도메인 또는 URL에 액세스할 수 있습니다.

### DNS TXT 레코드 구성 예
<a name="configuration-example-AS2TrustedDomains-DNS-TXT-record-client"></a>

다음은 DNS TXT 레코드 구성의 예입니다. 이 예제의 구성을 사용하면 사용자가 WorkSpaces 애플리케이션 클라이언트를 시작하고 appstream.example.com 또는 연결할 수 appstream-dev.example.com. example.com에는 연결할 수 없습니다.
+ `Domains to enable` - appstream.example.com, appstream-dev.example.com
+ `DNS TXT record location` - example.com
+ `DNS TXT record value` - AS2TrustedDomains=appstream.example.com,appstream-dev.example.com

### 요구 사항 및 고려 사항
<a name="requirements-AS2TrustedDomains-DNS-TXT-record-client"></a>

DNS TXT 레코드를 생성할 때는 다음 요구 사항 및 고려 사항에 유의하십시오.
+ 두 번째 수준 도메인에서 TXT 레코드를 생성해야 합니다. 예를 들어 도메인이 prod.appstream.example.com인 경우 example.com에서 DNS TXT 레코드를 생성해야 합니다.
+ TXT 레코드 값은 `AS2TrustedDomains=`로 시작해야 합니다.
+ 다음 문자가 지원됩니다. a-z, 0-9, -, \$1
+ DNS는 도메인 이름에 표시되는 위치에 따라 \$1 문자를 와일드카드 또는 별표 문자(ASCII 42)로 처리합니다. DNS 레코드의 이름에 \$1를 와일드카드로 사용할 때의 제한 사항은 다음과 같습니다.
  + \$1는 도메인 이름에서 맨 왼쪽 라벨을 대체해야 합니다. 예: \$1.example.com 또는 \$1.prod.example.com. 다른 위치에 \$1를 포함시키면(예: prod.\$1.example.com) DNS가 이를 와일드카드가 아닌 별표 문자(ASCII 42)로 처리합니다.
  + \$1이 전체 라벨을 대신해야 합니다. 예를 들어, \$1prod.example.com 또는 prod\$1.example.com을 지정할 수 없습니다.
  + \$1는 \$1및 해당 하위 도메인의 모든 하위 도메인을 비롯한 하위 도메인 수준에 적용됩니다. 예를 들어 항목의 이름이 \$1.example.com 인 경우 WorkSpaces 애플리케이션 클라이언트는 zenith.example.com, acme.zenith.example.com 및 pinnacle.acme.zenith.example.com 도메인에 대한 연결을 허용합니다.

## 신뢰할 수 있는 도메인에 대한 DNS TXT 레코드 조회 비활성화
<a name="disable-DNS-TXT-record-lookup-client"></a>

기본적으로 사용자가 WorkSpaces 애플리케이션을 시작하고 WorkSpaces 애플리케이션 도메인이 아닌 URL을 지정하면 클라이언트는 DNS TXT 레코드 조회를 수행합니다. 도메인이 `AS2TrustedDomains` 목록에 포함되어 있는지 여부를 클라이언트에서 확인할 수 있도록 이 조회는 URL의 두 번째 수준 도메인에서 수행됩니다. 이 동작을 통해 사용자는 `StartURL` 또는 `TrustedDomains` 레지스트리 키에 지정되지 않은 도메인 또는 WorkSpaces 애플리케이션 도메인에 연결할 수 있습니다.

`DnsTxtRecordQueryDisabled` 레지스트리 키의 값을 `true`로 설정하여 이 동작을 비활성화할 수 있습니다. WorkSpaces Applications 클라이언트를 설치할 때이 레지스트리 키를 생성할 수 있습니다. 이렇게 하면 클라이언트가 `StartURL` 또는 `TrustedDomains` 레지스트리 키에 지정된 URL에만 연결합니다.

WorkSpaces Applications 클라이언트를 설치한 후 다음 PowerShell 스크립트를 실행하여이 레지스트리 키를 생성할 수 있습니다. 또는 WorkSpaces 애플리케이션 클라이언트 엔터프라이즈 배포 도구에 포함된 관리 템플릿을 사용하여 그룹 정책을 통해 클라이언트를 구성할 수 있습니다.

**참고**  
이 스크립트를 실행하려면 관리자 권한으로 해당 컴퓨터에 로그인해야 합니다. 그 밖에 시작할 때 시스템 계정에서 원격으로 스크립트를 실행하는 방법도 있습니다.

```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force
 
New-ItemProperty -Path $registryPath -Name "DnsTxtRecordQueryDisabled" -Value "true" -PropertyType String -Force | Out-Null
```

## 자동 클라이언트 업데이트 비활성화 여부 선택
<a name="disable-automatic-updates-client"></a>

기본적으로 새 버전의 WorkSpaces 애플리케이션 클라이언트를 사용할 수 있는 경우 클라이언트는 자동으로 최신 버전으로 업데이트됩니다. `AutoUpdateDisabled` 레지스트리 키 값을 `true`로 설정하여 자동 업데이트를 비활성화할 수 있습니다. WorkSpaces Applications 클라이언트를 설치할 때이 레지스트리 키를 생성할 수 있습니다. 이렇게 하면 새 버전이 릴리스될 때마다 클라이언트가 자동으로 업데이트되지 않습니다.

WorkSpaces Applications 클라이언트를 설치한 후 다음 PowerShell 스크립트를 실행하여이 레지스트리 키를 생성할 수 있습니다. 또는 WorkSpaces 애플리케이션 클라이언트 엔터프라이즈 배포 도구에 포함된 관리 템플릿을 사용하여 그룹 정책을 통해 클라이언트를 구성할 수 있습니다.

**참고**  
이 스크립트를 실행하려면 관리자 권한으로 해당 컴퓨터에 로그인해야 합니다. 그 밖에 시작할 때 시스템 계정에서 원격으로 스크립트를 실행하는 방법도 있습니다.

```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "AutoUpdateDisabled" -Value "True" -PropertyType String -Force | Out-Null
```

## 온디맨드 진단 로그 업로드를 비활성화할지 여부 선택
<a name="disable-on-demand-diagnostic-log-uploads"></a>

기본적으로 WorkSpaces 애플리케이션 클라이언트를 사용하면 사용자가 필요에 따라 진단 로그와 미니 덤프를 WorkSpaces 애플리케이션()에 업로드할 수 있습니다AWS. 또한 예외가 발생하거나 WorkSpaces 애플리케이션 클라이언트가 응답을 중지하면 미니 덤프 및 관련 로그를 업로드할지 여부를 선택하라는 메시지가 표시됩니다. 온디맨드 진단 로깅에 대한 자세한 내용은 [자동 및 온디맨드 진단 로그 업로드](feature-support-diagnostic-log-upload.md) 단원을 참조하십시오.

`UserUploadOfClientLogsAllowed` 레지스트리 키의 값을 `false`로 설정하여 이 동작을 비활성화할 수 있습니다. WorkSpaces Applications 클라이언트를 설치할 때이 HKLM 레지스트리 키를 생성할 수 있습니다.

WorkSpaces Applications 클라이언트를 설치한 후 다음 PowerShell 스크립트를 실행하여이 레지스트리 키를 생성할 수 있습니다. 또는 WorkSpaces 애플리케이션 클라이언트 엔터프라이즈 배포 도구에 포함된 관리 템플릿을 사용하여 그룹 정책을 통해 클라이언트를 구성할 수 있습니다.

**참고**  
이 스크립트를 실행하려면 관리자 권한으로 해당 컴퓨터에 로그인해야 합니다. 그 밖에 시작할 때 시스템 계정에서 원격으로 스크립트를 실행하는 방법도 있습니다.

```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "UserUploadOfClientLogsAllowed" -Value "false" -PropertyType String -Force | Out-Null
```

## 네이티브 애플리케이션 모드를 비활성화할지 여부 선택
<a name="disable-native-application-mode-client"></a>

기본적으로 WorkSpaces 애플리케이션 클라이언트는 클래식 모드 또는 기본 애플리케이션 모드에서 실행할 수 있습니다. `NativeAppModeDisabled` 레지스트리 키 값을 `true`로 설정하여 네이티브 애플리케이션 모드를 비활성화할 수 있습니다. WorkSpaces Applications 클라이언트를 설치할 때이 HKLM 레지스트리 키를 생성할 수 있습니다. 이 값을 `true`로 설정하면 클라이언트가 클래식 모드로만 실행됩니다. 네이티브 애플리케이션 모드에 대한 자세한 내용은 [네이티브 애플리케이션 모드](feature-support-native-application-mode.md) 단원을 참조하십시오.

WorkSpaces Applications 클라이언트를 설치한 후 다음 PowerShell 스크립트를 실행하여이 레지스트리 키를 생성할 수 있습니다. 또는 WorkSpaces 애플리케이션 클라이언트 엔터프라이즈 배포 도구에 포함된 관리 템플릿을 사용하여 그룹 정책을 통해 클라이언트를 구성할 수 있습니다.

**참고**  
이 스크립트를 실행하려면 관리자 권한으로 해당 컴퓨터에 로그인해야 합니다. 그 밖에 시작할 때 시스템 계정에서 원격으로 스크립트를 실행하는 방법도 있습니다.

```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "NativeAppModeDisabled" -Value "True" -PropertyType String -Force | Out-Null
```

## 로컬 프린터 리디렉션을 비활성화할지 선택
<a name="disable-local-printer-redirection-client"></a>

기본적으로 WorkSpaces 애플리케이션 클라이언트를 사용하면 스트리밍 애플리케이션에서 로컬 컴퓨터에 연결된 프린터로 인쇄 작업을 리디렉션할 수 있습니다. `PrinterRedirectionDisabled` 레지스트리 키 값을 `true`로 설정하여 로컬 프린터 리디렉션을 비활성화할 수 있습니다. WorkSpaces Applications 클라이언트를 설치할 때이 HKLM 레지스트리 키를 생성할 수 있습니다. 값이 `true`로 설정된 경우 클라이언트는 사용자의 스트리밍 애플리케이션에서 로컬 컴퓨터에 연결된 프린터로 인쇄 작업을 리디렉션하지 않습니다.

WorkSpaces Applications 클라이언트를 설치한 후 다음 PowerShell 스크립트를 실행하여이 레지스트리 키를 생성할 수 있습니다. 또는 WorkSpaces 애플리케이션 클라이언트 엔터프라이즈 배포 도구에 포함된 관리 템플릿을 사용하여 그룹 정책을 통해 클라이언트를 구성할 수 있습니다.

**참고**  
이 스크립트를 실행하려면 관리자 권한으로 해당 컴퓨터에 로그인해야 합니다. 그 밖에 시작할 때 시스템 계정에서 원격으로 스크립트를 실행하는 방법도 있습니다.

```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "PrinterRedirectionDisabled" -Value "True" -PropertyType String -Force | Out-Null
```

## 스마트 카드 리디렉션을 비활성화할지 선택
<a name="disable-local-smart-card-support-client"></a>

기본적으로 WorkSpaces 애플리케이션 클라이언트에 대해 스마트 카드 리디렉션이 활성화됩니다. 이 기능이 활성화되면 사용자는 USB 리디렉션 없이 WorkSpaces 애플리케이션 스트리밍 세션 중에 로컬 컴퓨터와 스마트 카드에 연결된 스마트 카드 리더를 사용할 수 있습니다. WorkSpaces 애플리케이션 스트리밍 세션 중에 사용자의 스마트 카드 리더와 스마트 카드는 로컬 애플리케이션에서 사용할 수 있도록 계속 액세스할 수 있습니다. 클라이언트는 사용자의 스트리밍 애플리케이션에서 로컬 스마트 카드로 스마트 카드 API 호출을 리디렉션합니다. `SmartCardRedirectionDisabled` 레지스트리 키 값을 `true`로 설정하여 스마트 카드 리디렉션을 비활성화할 수 있습니다. WorkSpaces Applications 클라이언트를 설치할 때이 HKLM 레지스트리 키를 생성할 수 있습니다.

값이 로 설정된 경우 `true`사용자는 USB 리디렉션 없이 WorkSpaces 애플리케이션 스트리밍 세션 중에 스마트 카드 리더와 스마트 카드를 사용할 수 없습니다. 이 경우 [디바이스에 자격을 부여](qualify-usb-devices.md)하지 않는 한 사용자는 로컬 컴퓨터에 연결된 스마트 카드를 사용하여 스트리밍 애플리케이션에 로그인할 수 없습니다. 디바이스를 검증한 후 사용자는 [디바이스를 WorkSpaces 애플리케이션과 공유](client-application-windows-how-to-share-usb-devices-user.md)해야 합니다. 스마트 카드 리디렉션이 비활성화된 경우 사용자의 WorkSpaces 애플리케이션 스트리밍 세션 중에는 로컬 애플리케이션에서 스마트 카드 리더 및 스마트 카드에 액세스할 수 없습니다.

WorkSpaces Applications 클라이언트를 설치한 후 다음 PowerShell 스크립트를 실행하여이 레지스트리 키를 생성할 수 있습니다. 또는 WorkSpaces 애플리케이션 클라이언트 엔터프라이즈 배포 도구에 포함된 관리 템플릿을 사용하여 그룹 정책을 통해 클라이언트를 구성할 수 있습니다.

**참고**  
이 스크립트를 실행하려면 관리자 권한으로 해당 컴퓨터에 로그인해야 합니다. 그 밖에 시작할 때 시스템 계정에서 원격으로 스크립트를 실행하는 방법도 있습니다.

```
$registryPath="HKLM:\Software\Amazon\AppStream Client"
New-Item -Path "HKLM:\Software\Amazon" -Name "AppStream Client" -Force

New-ItemProperty -Path $registryPath -Name "SmartCardRedirectionDisabled" -Value "True" -PropertyType String -Force | Out-Null
```

## 사용자를 위한 추가 WorkSpaces 애플리케이션 클라이언트 설정 구성
<a name="configure-client"></a>

WorkSpaces 애플리케이션 클라이언트는 레지스트리 키를 사용하여 다음과 같은 추가 클라이언트 설정을 구성합니다.
+ WorkSpaces Applications 클라이언트 최종 사용자 라이선스 계약(EULA) 수락
+ WorkSpaces 애플리케이션 클라이언트 EULA 버전 수락됨
+ WorkSpaces Applications 클라이언트에 대한 자동 진단 로그 업로드
+ USB 드라이버를 WorkSpaces 애플리케이션에 전달하는 데 사용되는 USB 드라이버의 자동 업데이트
+ WorkSpaces 애플리케이션 클라이언트에서 하드웨어 렌더링 활성화
+ WorkSpaces Applications 클라이언트에서 파일 시스템 리디렉션을 위한 사용자 지정 폴더 경로 설정
+ 시스템 기본 브라우저에서 ID 제공업체(idP)의 URL 열기
+ 스트리밍 데이터 손실에 대한 실시간 시각적 피드백을 제공하는 표시기 추가

다음 표에는 사용자를 위해 WorkSpaces 애플리케이션 클라이언트 환경을 사용자 지정하는 데 사용할 수 있는 추가 클라이언트 설정의 레지스트리 값이 요약되어 있습니다.

**참고**  
이러한 값은 대소문자를 구분합니다.


| 값 | 레지스트리 경로 | Type | 설명 | 데이터 | 
| --- | --- | --- | --- | --- | 
| EULAAccepted | HKCU\$1Software\$1Amazon\$1Appstream Client | 문자열 | 사용자를 대신하여 WorkSpaces 애플리케이션 클라이언트 EULA를 수락true하려면이 값을 로 설정합니다. | true/false | 
| AcceptedEULAVersion | HKCU\$1Software\$1Amazon\$1Appstream Client | 문자열 | 동의하는 EULA의 버전입니다. WorkSpaces Applications 클라이언트 EULA의 현재 버전이 수락된 EULA 버전과 다른 경우 사용자는 EULA의 현재 버전을 수락하라는 메시지가 표시됩니다. | 1.0 | 
| DiagnosticInfoCollectionAllowed | HKCU\$1Software\$1Amazon\$1Appstream Client | 문자열 | WorkSpaces 애플리케이션이 WorkSpaces 애플리케이션 클라이언트에서 WorkSpaces 애플리케이션 WorkSpaces()으로 진단 로그를 자동으로 전송하도록 true 하려면이 값을 로 설정합니다AWS. | true/false | 
| USBDriverOptIn | HKCU\$1Software\$1Amazon\$1Appstream Client | 문자열 | 이 값을 로 설정true하면 WorkSpaces 애플리케이션이 USB 드라이버를 WorkSpaces 애플리케이션에 전달하는 데 사용되는 USB 드라이버를 자동으로 업데이트할 수 있습니다. | true/false | 
| HardwareRenderingEnabled | HKCU\$1Software\$1Amazon\$1Appstream Client | 문자열 | WorkSpaces 애플리케이션 클라이언트에서 하드웨어 렌더링을 활성화true하려면이 값을 로 설정합니다. | true/false | 
| FileRedirectionCustomDefaultFolders | HKCU\$1Software\$1Amazon\$1Appstream Client | 문자열 | 파일 시스템 리디렉션을 위한 하나 이상의 폴더 경로를 포함하도록 이 값을 설정합니다. '\$1' 기호를 사용하여 여러 폴더 경로를 구분합니다. 기본적으로 다음 폴더 경로가 지정됩니다. %USERPROFILE%\$1Desktop\$1%USERPROFILE%\$1Documents\$1%USERPROFILE%\$1Downloads | 유효한 폴더 경로 | 
| OpenIdpUrlInSystemBrowser | HKCU\$1Software\$1Amazon\$1Appstream Client | 문자열 | WorkSpaces Applications 클라이언트가 시스템 기본 브라우저에서 IdP URL을 열 true 수 있도록 하려면이 값을 로 설정합니다. 이 기능은 클라이언트 버전 1.1.1360 이상에서 지원됩니다. | true/false | 
| DataLossIndicator | HKCU\$1Software\$1Amazon\$1Appstream Client | 문자열 | 스트리밍 데이터 손실이 있을 때 빨간색 경고 표시기를 포함하려면이 값을 SHOW\$1ON\$1LOSSY로 설정합니다. 스트리밍 데이터 손실이 없는 경우 녹색 정상 표시기를 포함하려면이 값을 SHOW\$1ON\$1LOSSLESS로 설정합니다. | DISABLED/SHOW\$1ON\$1LOSSY/SHOW\$1ON\$1LOSSLESS | 

WorkSpaces Applications 클라이언트를 설치한 후 다음 PowerShell 스크립트를 실행하여 이러한 레지스트리 키를 생성할 수 있습니다. 모든 레지스트리 키를 생성하지 않으려면 원하는 레지스트리 키만 만들도록 필요에 따라 스크립트를 수정합니다. 또는 WorkSpaces 애플리케이션 클라이언트 엔터프라이즈 배포 도구에 제공된 관리 템플릿을 사용하여 그룹 정책을 통해 클라이언트를 구성할 수 있습니다.

**참고**  
각 사용자에 대해 다음 항목을 설정해야 합니다.

```
$registryPath="HKCU:\Software\Amazon\AppStream Client"
New-Item -Path "HKCU:\Software\Amazon" -Name "AppStream Client" -Force
New-ItemProperty -Path $registryPath -Name "EULAAccepted" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "AcceptedEULAVersion" -Value "1.0" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "DiagnosticInfoCollectionAllowed" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "USBDriverOptIn" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "HardwareRenderingEnabled" -Value "true" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "FileRedirectionCustomDefaultFolders" -Value "%USERPROFILE%\Desktop|%USERPROFILE%\Documents|%USERPROFILE%\Downloads" -PropertyType String -Force | Out-Null
New-ItemProperty -Path $registryPath -Name "OpenIdpUrlInSystemBrowser" -Value "true" -PropertyType String -Force | Out-Null
```

## 그룹 정책을 사용하여 WorkSpaces 애플리케이션 클라이언트 환경 사용자 지정
<a name="configure-client-with-adm-template-group-policy"></a>

WorkSpaces 애플리케이션 클라이언트 엔터프라이즈 배포 도구에 제공된 관리 템플릿을 사용하여 그룹 정책을 통해 클라이언트를 구성할 수 있습니다. 관리 템플릿을 그룹 정책 관리 콘솔에 로드하는 방법을 알아보려면 Microsoft Support 설명서의 [그룹 정책 관리 템플릿(.adm) 파일 관리에 대한 권장 사항](https://support.microsoft.com/en-us/help/816662/recommendations-for-managing-group-policy-administrative-template-adm)을 참조하십시오.

# WorkSpaces 애플리케이션 엔터프라이즈 배포 도구, 클라이언트 및 USB 드라이버를 수동으로 업데이트
<a name="update-enterprise-deployment-tool-client-usb-driver-manually"></a>

기본적으로 WorkSpaces Applications 클라이언트 및 USB 드라이버는 새 클라이언트 버전이 릴리스될 때 자동으로 업데이트됩니다. 그러나 엔터프라이즈 배포 도구를 사용하여 사용자를 위한 WorkSpaces 애플리케이션 클라이언트를 설치하고 자동 업데이트를 비활성화한 경우 WorkSpaces 애플리케이션 엔터프라이즈 배포 도구, 클라이언트 및 USB 드라이버를 수동으로 업데이트해야 합니다. 이렇게 하려면 다음 단계를 수행하여 사용자 컴퓨터에서 필요한 PowerShell 명령을 실행합니다.

**참고**  
이러한 명령을 실행하려면 해당 컴퓨터에 관리자로 로그인해야 합니다. 또는 시작 시 SYSTEM 계정을 통해 스크립트를 원격으로 실행할 수 있습니다.  
Enterprise Deployment Tool을 사용하여 WorkSpaces Applications macOS 클라이언트를 관리하는 것은 지원되지 않습니다.

1. WorkSpaces Applications Enterprise Deployment Tool을 자동으로 제거합니다.

   ```
   Start-Process msiexec.exe -Wait -ArgumentList '/x AmazonAppStreamClientSetup_<existing_version>.msi /quiet'
   ```

1. WorkSpaces Applications USB 드라이버를 자동으로 제거합니다.

   ```
   Start-Process -Wait AmazonAppStreamUsbDriverSetup_<existing_version>.exe -ArgumentList '/uninstall /quiet /norestart'
   ```

1. WorkSpaces 애플리케이션 클라이언트를 자동으로 제거합니다.

   ```
   Start-Process "$env:LocalAppData\AppStreamClient\Update.exe" -ArgumentList '--uninstall'
   ```
**참고**  
이 프로세스는 WorkSpaces 애플리케이션 클라이언트를 구성하는 데 사용되는 레지스트리 키도 제거합니다. WorkSpaces 애플리케이션 클라이언트를 다시 설치한 후에는 이러한 키를 다시 생성해야 합니다.

1. 애플리케이션 설치 디렉터리 정리:

   ```
   Remove-Item -Path $env:LocalAppData\AppStreamClient -Recurse -Confirm:$false –Force 
   ```

1. 컴퓨터를 다시 시작합니다.

   ```
   Restart-computer
   ```

1. 최신 버전의 WorkSpaces Applications Enterprise Deployment Tool을 자동으로 설치합니다.

   ```
   Start-Process msiexec.exe -Wait -ArgumentList '/i AmazonAppStreamClientSetup_<new_version>.msi /quiet'
   ```

1. 최신 버전의 WorkSpaces Applications USB 드라이버를 자동으로 설치합니다.

   ```
   Start-Process AmazonAppStreamUsbDriverSetup_<new_version>.exe -Wait -ArgumentList '/quiet'
   ```

# 스트리밍 애플리케이션에 사용할 USB 디바이스 승인
<a name="qualify-usb-devices"></a>

사용자가 WorkSpaces 애플리케이션 스트리밍 인스턴스로 리디렉션할 수 있는 USB 디바이스를 지정하는 방법에는 두 가지가 있습니다.

**참고**  
USB 리디렉션은 현재 Windows WorkSpaces 애플리케이션 스트리밍 인스턴스에서만 지원됩니다. macOS 클라이언트에서는 지원되지 않습니다.
+ 이미지에 저장된 구성 파일 내에 USB 디바이스 필터 문자열을 생성할 수 있습니다. 이 방법은 올웨이즈 온 및 온디맨드 플릿에서만 사용할 수 있습니다.
+  AWS 관리 콘솔 또는 `CreateFleet` API를 사용하여 플릿을 생성할 때 USB 디바이스 필터 문자열을 지정할 수 있습니다. 이러한 문자열에 대한 자세한 내용은 아래 섹션을 참조하세요. 이 방법은 탄력적 플릿에서만 사용할 수 있습니다.

사용자가 스트리밍 애플리케이션에 사용할 수 있는 USB 디바이스를 지정하는 파일을 WorkSpaces 애플리케이션 이미지에 생성할 수 있습니다. 스트리밍 애플리케이션에 사용할 수 있도록 사용자의 USB 디바이스를 승인하려면 다음 단계를 따르십시오.

**참고**  
보안을 위해 자격이 부여된 신뢰할 수 있는 출처의 USB 디바이스만 인증하세요. 모든 일반 디바이스 또는 디바이스 클래스에 자격을 부여하면 승인되지 않은 디바이스를 스트리밍 애플리케이션과 함께 사용하도록 허용할 수 있습니다.

1. 아직 설치하지 않았다면 WorkSpaces 애플리케이션 클라이언트를 설치합니다. 자세한 내용은 [WorkSpaces 애플리케이션 클라이언트 설치 및 구성](install-configure-client.md) 단원을 참조하세요.

1. 사용 승인할 USB 디바이스를 컴퓨터에 연결합니다.

1. **C:\$1Users\$1<로그인한 사용자>\$1AppData\$1Local\$1AppStreamClient**로 이동하고 **dcvusblist.exe**를 두 번 클릭합니다.

1. **DCV - USB devices(DCV - USB 디바이스)** 대화 상자에 로컬 컴퓨터에 연결된 USB 디바이스 목록이 표시됩니다. **필터** 열에 모든 USB 디바이스의 필터 문자열이 표시됩니다. 활성화할 USB 디바이스의 목록 항목을 마우스 오른쪽 버튼으로 클릭한 다음 **Copy filter string(필터 문자열 복사)**를 선택합니다.

1. 바탕화면에서 Windows **시작** 버튼을 선택한 후 메모장을 검색합니다. **메모장**을 두 번 클릭하여 새 파일을 열고 해당 파일에 필터 문자열을 복사한 후 저장합니다. 필터 문자열은 나중에 USB 디바이스를 사용 승인할 때 사용됩니다.

1. 새로운 이미지 빌더를 시작합니다. 자세한 내용은 [이미지 빌더를 시작하여 스트리밍 애플리케이션 설치 및 구성](tutorial-image-builder-create.md) 단원을 참조하십시오.

1. 이미지 빌더가 **실행** 중 상태이면 다음 단계를 수행하여 스트리밍 URL을 생성하고 WorkSpaces 애플리케이션 클라이언트를 사용하여 이미지 빌더에 연결합니다.

   1. 목록에서 이미지 빌더를 선택한 상태에서 **작업**, **Create streaming URL(스트리밍 URL 생성)**을 선택합니다.

   1. **Create streaming URL(스트리밍 URL 생성)** 대화 상자에서 **링크 복사**를 선택하고, 웹 주소를 나중에 사용할 수 있도록 복사하여 별도의 파일에 붙여 넣습니다. 이 URL을 사용하여 12단계의 이미지 빌더에 다시 연결합니다.

   1. **Launch in Client(클라이언트에서 시작)**를 선택합니다.

   1. **Launch Application(애플리케이션 시작)** 대화 상자가 열리고 링크를 열 때 사용할 애플리케이션을 선택하라는 메시지가 표시되면 **Amazon AppStream**, **Open link(링크 열기)**를 선택합니다. 다음에 이 단계를 수행하여 이미지 빌더에 연결할 때 이 대화 상자가 표시되지 않도록 하려면 **Remember my choice for amazonappstream links(amazonappstream 링크에 대한 내 선택 기억)** 확인란을 선택합니다.

   1. WorkSpaces 애플리케이션 클라이언트에 AWS 고객 계약, AWS 서비스 약관, AWS 개인 정보 보호 고지 및 타사 고지에 대한 링크가 표시되면이 정보를 검토한 다음 **완료**를 선택합니다.

   1. 클라이언트 로그인 페이지가 표시되면 웹 주소 필드에 스트리밍 URL이 미리 채워집니다. **연결**을 선택합니다.

   1. 메시지가 표시되면 이미지 빌더에 관리자로 로그인합니다.

1. 이미지 빌더에 연결한 후 USB 디바이스에서 사용하기 전에 드라이버를 설치해야 하는 경우 이미지 빌더에 드라이버를 다운로드하여 설치합니다. 예를 들어 Connexion 3D 마우스를 사용하고 있다면 필요한 Connexion 드라이버를 다운로드하여 이미지 빌더에 설치해야 합니다.

1. 이미지 빌더 바탕화면에서 Windows **시작** 버튼을 선택한 후 메모장을 검색합니다. **메모장**을 마우스 오른쪽 버튼으로 클릭한 후 **관리자 권한으로 실행**을 선택합니다.

1. **파일**, **열기**를 선택하고 `C:\ProgramData\Amazon\Photon\DCV\usb_device_allowlist.txt` 파일을 엽니다. 또한 `usb_device_allowlist.txt` 파일에서 와일드카드 표현식을 사용하여 디바이스의 전체 카테고리 또는 특정 제조업체의 모든 디바이스를 허용할 수 있습니다.

1. 로컬 컴퓨터의 필터 문자열을 이미지 빌더로 복사합니다. 특정 USB 디바이스에 대한 필터 문자열은 **이름**, **Base Class(기본 클래스)**, **SubClass(하위 클래스)**, **프로토콜**, **ID Vendor(ID 공급업체)**, **ID Product(ID 제품)**, **Support Autoshare(자동 공유 지원)**, **Skip Reset(재설정 건너뛰기)** 필드의 쉼표로 구분된 문자열입니다. 이러한 문자열에 대한 자세한 내용은 [USB 디바이스 필터 문자열 작업](USB-device-filter-strings.md) 단원을 참조하십시오.

1. WorkSpaces 애플리케이션 클라이언트를 사용하여 이미지 빌더에서 연결을 해제하고 다시 시작한 다음 다시 연결합니다. 이렇게 하려면 WorkSpaces 애플리케이션 클라이언트를 열고 7단계에서 생성한 스트리밍 URL을 클라이언트 로그인 웹 주소 필드에 붙여넣고 **연결을** 선택합니다.

1. 이미지 빌더에서 USB 디바이스를 테스트하여 정상적으로 작동하는지 확인합니다.

1. 사용자가 WorkSpaces 애플리케이션 세션에서 USB 디바이스를 사용하려면 먼저 디바이스를 세션과 공유해야 합니다. 이 작업을 수행하는 데 도움이 되도록 사용자에게 제공할 수 있는 지침은 [USB 디바이스](client-application-windows-how-to-share-usb-devices-user.md) 단원을 참조하십시오.

1. USB 디바이스가 이미지 빌더에서 정상적으로 작동하면 이미지를 생성합니다. 자세한 내용은 [자습서: WorkSpaces 애플리케이션 콘솔을 사용하여 사용자 지정 WorkSpaces 애플리케이션 이미지 생성](tutorial-image-builder.md) 단원을 참조하십시오.

1. 이미지 생성을 완료한 후 새 이미지를 사용하도록 WorkSpaces 애플리케이션 플릿을 업데이트합니다.

# USB 디바이스 필터 문자열 작업
<a name="USB-device-filter-strings"></a>

이 섹션에서는 WorkSpaces 애플리케이션 스트리밍 세션에 적합한 USB 디바이스에 사용할 수 있는 필터 문자열을 설명합니다. 이러한 문자열 작업에 대한 지침을 제공합니다. 다음 필터 문자열을 사용할 수 있습니다.
+ `Name` - 기본적으로 이 필터 문자열의 값은 디바이스 이름이지만 사용자 고유의 값을 지정할 수 있습니다.
+ `Base Class,SubClass,Protocol` - 디바이스의 USB 클래스 코드입니다. 자세한 내용은 [정의된 클래스 코드](https://www.usb.org/defined-class-codes)를 참조하시기 바랍니다.
+ `ID Vendor (VID)` - USB 조직에서 USB 디바이스 제조업체에 할당한 고유 식별자입니다.
+ `ID Product (PID)` - 제조업체가 USB 디바이스에 할당한 고유 식별자입니다.
+ `Support Autoshare` - 스트리밍 세션이 시작될 때 WorkSpaces 애플리케이션 클라이언트가 디바이스를 자동으로 공유할 수 있습니다. 자동 디바이스 공유를 허용하려면 이 값을 `1`로 설정합니다. 자동 디바이스 공유를 허용하지 않으려면 이 값을 `0`으로 설정합니다.
+ `Skip Reset` - 기본적으로 USB 디바이스를 스트리밍 세션과 함께 WorkSpaces 애플리케이션에서 공유하면 디바이스가 올바르게 작동하도록 재설정됩니다. 그러나 일부 USB 디바이스는 재설정될 경우 스트리밍 세션 중에 올바르게 작동하지 않습니다. 이 문제가 발생하지 않도록 하려면이 필터 문자열의 값을 로 설정`1`하여 WorkSpaces 애플리케이션 클라이언트가 스트리밍 세션과 공유하는 동안 디바이스를 재설정하지 않도록 지시합니다. 스트리밍 세션과 공유되는 동안 디바이스가 재설정되도록 하려면 이 값을 `0`으로 설정합니다. `Skip Reset` 값을 설정할 때는 `Support Autoshare`를 `0` 또는 `1`로 설정해야 합니다.

 로컬 컴퓨터에서 복사되는 필터 문자열은 USB 디바이스에만 적용됩니다. 경우에 따라 가능한 모든 USB 디바이스가 아닌 전체 디바이스 클래스를 허용하고 싶을 수도 있습니다. 예를 들어 사용자에게 모든 종류의 Wacom 디자인 태블릿이나 USB 대용량 스토리지 디바이스 사용을 허용하고 싶은 경우입니다. 이러한 시나리오에서는 특정 필터 문자열 필드에 와일드카드 문자를 제공하면 됩니다. USB 디바이스의 VID 및 PID를 모르는 경우 [USB ID 데이터베이스](https://www.the-sz.com/products/usbid/index.php)에서 이 정보를 검색할 수 있습니다.

다음 예는 스트리밍 세션 중에 USB 디바이스 공유를 위해 필터 문자열을 구성하는 방법을 보여줍니다.
+ 스트리밍 세션을 시작할 때 모든 대용량 스토리지 디바이스 자동 허용 - "대용량 스토리지, 8, \$1, \$1, \$1, \$1,1,0"
+ 스트리밍 세션을 시작할 때 모든 Wacom 디바이스 자동 허용 - "Wacom 태블릿, 3, \$1, \$1, 1386, \$1,1,0"
+ 오디오 인터페이스를 제공하는 모든 디바이스 허용 - "오디오, 1, \$1, \$1, \$1, \$1,1,0"
+ 디바이스 X를 허용하지만 디바이스가 공유되는 동안에는 재설정하지 않습니다. 스트리밍 세션을 시작할 때 디바이스를 자동으로 공유하지 않음 - "X, Y, \$1, \$1, 1386, \$1,0,1"

# WorkSpaces 애플리케이션 클라이언트 사용자를 위한 연결 방법 구성
<a name="use-client-start-streaming-session"></a>

사용자의 로컬 컴퓨터에 WorkSpaces 애플리케이션 클라이언트를 설치한 후 WorkSpaces 애플리케이션 클라이언트를 사용하여 스트리밍 세션에 연결할 수 있습니다. 조직 요구 사항에 따라 SAML 2.0을 사용하여 ID 페더레이션 설정, WorkSpaces 애플리케이션 사용자 풀 사용 또는 스트리밍 URL 생성 중 하나를 수행하여 클라이언트 사용자에게 WorkSpaces 애플리케이션에 대한 액세스 권한을 제공할 수 있습니다.

**Topics**
+ [SAML 2.0](use-client-start-streaming-session-SAML.md)
+ [WorkSpaces 애플리케이션 사용자 풀](use-client-start-streaming-session-user-pool.md)
+ [스트리밍 URL](use-client-start-streaming-session-streaming-URL.md)
+ [다음 단계](use-client-start-streaming-session-next-steps.md)

# SAML 2.0
<a name="use-client-start-streaming-session-SAML"></a>

외부 자격 증명 공급자를 사용하여 사용자를 WorkSpaces 애플리케이션 스택에 페더레이션하는 경우 클라이언트가 시작될 때마다 미리 채워진 URL로 WorkSpaces 애플리케이션 클라이언트를 구성하려면 레지스트리 값을 생성해야 합니다. 이 URL은 디바이스에서 신뢰하는 인증서를 사용해야 합니다. 인증서에는 URL의 도메인 이름이 포함된 주체 대체 이름(SAN)을 포함해야 합니다.

자세한 내용은 다음을 참조하세요.
+ [SAML 설정](external-identity-providers-setting-up-saml.md)
+ [WorkSpaces 애플리케이션 클라이언트 사용자의 StartURL 레지스트리 값 설정](install-client-configure-settings.md#set-start-url-registry-value)

# WorkSpaces 애플리케이션 사용자 풀
<a name="use-client-start-streaming-session-user-pool"></a>

WorkSpaces 애플리케이션 사용자 풀에서 새 사용자를 생성하거나 WorkSpaces 애플리케이션 스택에 사용자 풀 사용자를 할당하면 WorkSpaces 애플리케이션은 사용자를 대신하여 사용자에게 이메일을 보냅니다. 사용자는 환영 이메일에 제공된 URL을 입력하고 보안 인증 정보를 입력한 다음 **연결**을 선택합니다.

자세한 내용은 [Amazon WorkSpaces 애플리케이션 사용자 풀](user-pool.md) 단원을 참조하십시오.

# 스트리밍 URL
<a name="use-client-start-streaming-session-streaming-URL"></a>

스트리밍 URL을 만들려면 다음 방법 중 하나를 사용합니다.
+ WorkSpaces 애플리케이션 콘솔
+ [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html) API 작업 
+ [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html) AWS CLI 명령

WorkSpaces 애플리케이션 콘솔을 사용하여 스트리밍 URL을 생성하려면 다음 절차의 단계를 완료합니다.

**WorkSpaces 애플리케이션 콘솔을 사용하여 스트리밍 URL을 생성하려면**

1. [https://console.aws.amazon.com/appstream2/home](https://console.aws.amazon.com/appstream2/home) WorkSpaces 애플리케이션 콘솔을 엽니다.

1. 탐색 창에서 [**Fleets**]를 선택합니다.

1. 플릿 목록에서 스트리밍 URL을 생성할 스택과 연결되는 플릿을 선택합니다. 플릿 상태가 **실행 중**인지 확인합니다.

1. 탐색 창에서 **스택**을 선택합니다. 스택을 선택한 다음 **작업**과 **스트리밍 URL 생성**을 차례대로 선택합니다.

1. **사용자 ID**에 사용자 ID를 입력합니다.

1. **URL 만료**에서 만료 시간을 선택합니다. 이 시간에 따라 생성된 URL이 유효한 기간이 결정됩니다. 이 URL은 최대 7일 동안 유효합니다.

1. **URL 가져오기**를 선택합니다.

1. URL을 복사하여 액세스 가능한 위치에 저장한 다음 사용자에게 제공합니다.

   WorkSpaces 애플리케이션 클라이언트 로그인 페이지에서 사용자는 웹 주소로 생성한 스트리밍 URL을 입력한 다음 **연결을** 선택합니다.

# 다음 단계
<a name="use-client-start-streaming-session-next-steps"></a>

클라이언트 연결 방법을 구성한 후 사용자에게 WorkSpaces 애플리케이션에 연결하고 스트리밍 세션을 시작하는 데 도움이 되는 step-by-step 지침을 제공할 수 있습니다[macOS 클라이언트의 WorkSpaces 애플리케이션에 연결](client-application-mac-start-streaming-session-user.md). [Windows 클라이언트의 WorkSpaces 애플리케이션에 연결](client-application-windows-start-streaming-session-user.md) 또는 .

# 사용자가 USB 디바이스를 WorkSpaces 애플리케이션 스트리밍 세션과 공유하도록 활성화
<a name="share-usb-devices-with-session"></a>

사용자가 USB 디바이스를 WorkSpaces 애플리케이션 세션과 공유하기 전에 USB 디바이스를 검증해야 합니다. 그렇지 않으면 사용자가 스트리밍 세션을 시작하면 WorkSpaces 애플리케이션에서 USB 디바이스를 감지하지 못하여 세션과 공유할 수 없습니다. 자세한 내용은 [스트리밍 애플리케이션에 사용할 USB 디바이스 승인](qualify-usb-devices.md) 단원을 참조하십시오.

**참고**  
macOS 클라이언트에서는 USB 디바이스를 WorkSpaces 애플리케이션 스트리밍 세션과 공유할 수 없습니다.

# 웹 브라우저에서 WorkSpaces 애플리케이션 클라이언트로 스트리밍 세션 리디렉션
<a name="redirect-streaming-session-from-web-to-client"></a>

웹 브라우저에서 WorkSpaces 애플리케이션 클라이언트로 스트리밍 세션을 리디렉션하도록 WorkSpaces 애플리케이션을 구성할 수 있습니다. 이렇게 하면 사용자가 WorkSpaces 애플리케이션에 로그인하고 웹 브라우저에서 스트리밍 세션을 시작하면 해당 세션이 WorkSpaces 애플리케이션 클라이언트로 리디렉션됩니다. 리디렉션하는 단계는 다음과 같습니다.

1. WorkSpaces 애플리케이션 `CreateStreamingURL` API 작업을 사용하여 스트리밍 URL을 생성합니다.

1. 사용자 지정 WorkSpaces Applications 클라이언트 핸들러에 대한 다음 접두사를 스트리밍 URL에 추가합니다. **amazonappstream:** 

   접두사와 스트리밍 URL은 모두 다음가 같은 형식을 따릅니다.

   **amazonappstream:***base64encoded(streamingURL)*
**참고**  
URL을 인코딩할 때 인코딩이 UTF-8인지 확인합니다.  
인코딩할 Powershell 샘플: `[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes("Streaming/IdpURL"))`

1. 사용자가 스트리밍 URL로 리디렉션되면 브라우저는 WorkSpaces 애플리케이션 클라이언트에서 링크를 열어야 함을 감지합니다.

1. WorkSpaces 애플리케이션 클라이언트를 사용하여 스트리밍 세션을 시작할지 여부를 선택하라는 메시지가 표시됩니다.

1. 메시지 표시 이후 다음 중 한 가지가 발생합니다.
   + WorkSpaces 애플리케이션 클라이언트가 설치된 경우 사용자는 WorkSpaces 애플리케이션 클라이언트를 사용하여 스트리밍 세션을 계속하도록 선택할 수 있습니다.
   + WorkSpaces 애플리케이션 클라이언트가 설치되지 않은 경우 브라우저 동작은 다음과 같이 달라집니다.
     + Chrome - 메시지가 표시되지 않습니다.
     + Firefox- Amazon AppStream을 열려면 사용자에게 새 앱이 필요함을 알리는 메시지가 표시됩니다.
     + Microsoft Edge - 메시지가 표시되지 않습니다.
     + Internet Explorer - WorkSpaces 애플리케이션 클라이언트가 설치되지 않았음을 사용자에게 알리는 메시지입니다.

       이 경우 사용자는 **Download AppStream Client(AppStream 클라이언트 다운로드)** 링크를 선택하여 클라이언트를 다운로드할 수 있습니다. 클라이언트를 다운로드하여 설치하고 브라우저를 새로 고치면 해당 클라이언트를 사용해 스트리밍 세션을 시작할 수 있습니다.

## 기본 브라우저를 사용하여 Windows 바탕 화면 바로 가기 생성
<a name="desktop-shortcut"></a>

기본 브라우저를 사용하여 Windows 데스크톱 바로 가기를 생성하여 클라이언트를 시작하려면 다음 샘플 Powershell 스크립트를 사용합니다.

```
$StringToEncode = 'your URL string'

$encodedUrl = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($StringToEncode))

$shortcutContent = "
[{000214A0-0000-0000-C000-000000000046}]
Prop3=19,0
[InternetShortcut]
IDList=
URL=amazonappstream:$encodedUrl
IconIndex=0
HotKey=0
IconFile=$env:USERPROFILE\AppData\Local\AppStreamClient\appstreamclient.exe
"

Set-Content -Path "$env:USERPROFILE\Desktop\AppStream 2.0 Client Launcher.url" -Value $shortcutContent
```

# WorkSpaces 애플리케이션 사용자를 위한 파일 시스템 리디렉션 활성화
<a name="enable-file-system-redirection"></a>

WorkSpaces Applications 파일 시스템 리디렉션을 사용하면 WorkSpaces Applications 클라이언트가 설치된 사용자가 스트리밍 세션 내에서 로컬 컴퓨터에 있는 파일에 액세스할 수 있습니다. 파일 시스템 리디렉션을 활성화하면 사용자가 액세스할 수 있는 로컬 드라이브 및 폴더 목록을 지정할 수 있습니다. 사용자가 WorkSpaces 애플리케이션에 로그인하고 스트리밍 세션을 시작하면 목록에서 액세스하려는 드라이브 또는 폴더를 선택할 수 있습니다. 그런 다음 WorkSpaces 애플리케이션과 드라이브 또는 폴더를 공유할 수 있습니다. 스트리밍 세션 동안 드라이브나 폴더에 액세스할 수 있습니다. 사용자는 언제든 로컬 드라이브 또는 폴더 공유를 중지할 수 있습니다.

**참고**  
파일 시스템 리디렉션은 현재 Linux 기반 플릿 인스턴스 또는 macOS 클라이언트 사용 시 지원되지 않습니다.

**Topics**
+ [파일 시스템 리디렉션 사전 조건](file-system-redirection-prerequisites.md)
+ [파일 시스템 리디렉션을 활성화하는 방법](how-to-enable-file-system-redirection.md)
+ [기본 드라이브 및 폴더를 사용자가 공유할 수 있도록 만들기](prepopulate-drives-folders-system-redirection.md)
+ [WorkSpaces 애플리케이션 사용자에게 파일 시스템 리디렉션 작업 지침 제공](end-user-guidance-file-system-redirection.md)

# 파일 시스템 리디렉션 사전 조건
<a name="file-system-redirection-prerequisites"></a>

WorkSpaces Applications 파일 리디렉션을 활성화하려면:
+ 2019년 8월 8일 이후에 릴리스된 WorkSpaces 애플리케이션 에이전트 버전을 사용하는 이미지를 사용해야 합니다. 자세한 내용은 [WorkSpaces 애플리케이션 에이전트 릴리스 정보](agent-software-versions.md) 단원을 참조하십시오.
+ 사용자는 WorkSpaces Applications 클라이언트 버전 1.0.480 이상이 설치되어 있어야 합니다. 자세한 내용은 [WorkSpaces 애플리케이션 Windows 클라이언트 릴리스 정보](client-release-versions.md) 단원을 참조하십시오.
+ 사용자가 스트리밍 세션을 위해 액세스하는 스택에서 파일 업로드 및 다운로드를 활성화해야 합니다. 다음 절차를 참조하세요.

# 파일 시스템 리디렉션을 활성화하는 방법
<a name="how-to-enable-file-system-redirection"></a>

사용자가 스트리밍 세션을 위해 액세스하는 스택에서 파일 업로드 및 다운로드를 모두 활성화하려면 다음 단계를 수행하십시오.

1. [https://console.aws.amazon.com/appstream2/home](https://console.aws.amazon.com/appstream2/home) WorkSpaces 애플리케이션 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **스택**을 선택합니다.

1. 파일 시스템 리디렉션을 활성화할 스택을 선택하십시오.

1. **User Settings(사용자 설정)** 탭을 선택한 다음 **Clipboard, file transfer, and local print permissions(클립 보드, 파일 전송 및 로컬 인쇄 권한)** 섹션을 확장하십시오.

1. **파일 전송**에서 **업로드 및 다운로드**가 선택되어 있는지 확인합니다. 그렇지 않은 경우 **편집**을 선택한 다음 **Upload and download(업로드 및 다운로드)**를 선택하십시오.

1. **업데이트**를 선택합니다.

# 기본 드라이브 및 폴더를 사용자가 공유할 수 있도록 만들기
<a name="prepopulate-drives-folders-system-redirection"></a>

기본적으로 스택 사용자에 대해 파일 디렉션을 활성화하면 해당 사용자가 스트리밍 세션에서 다음 드라이브 및 폴더를 공유할 수 있게 됩니다.
+ 드라이브:
  + 모든 로컬 하드 디스크(C 드라이브 및 D 드라이브와 같은 물리적 드라이브)
  + 모든 가상 드라이브(매핑된 드라이브 문자, Google 드라이브 및 OneDrive와 같은 가상 드라이브와 네트워크)
  + 모든 로컬 USB 드라이브
+ 폴더:
  + %USERPROFILE%\$1Desktop
  + %USERPROFILE%\$1Documents
  + %USERPROFILE%\$1Downloads

이 드라이브 및 폴더 경로는 **Share your local drives and folders(로컬 드라이브 및 폴더 공유)** 대화 상자에 미리 채워집니다. 이 대화 상자는 사용자가 WorkSpaces 애플리케이션에 로그인하고 스트리밍 세션을 시작한 다음 **설정**, **로컬 리소스**, **로컬 드라이브 및 폴더를** 선택할 때 표시됩니다.

레지스트리를 편집하여 기본 드라이브 및 폴더 경로를 변경하거나 사용자 정의할 수 있습니다. WorkSpaces 애플리케이션 클라이언트 엔터프라이즈 배포 도구에 제공된 관리 템플릿 파일을 사용할 수도 있습니다. 이 템플릿을 사용하면 그룹 정책을 사용하여 클라이언트를 구성할 수 있습니다. 자세한 내용은 [WorkSpaces 애플리케이션 클라이언트 설치 및 구성](install-configure-client.md) 단원을 참조하십시오.

스트리밍 세션 중에 사용자가 공유 로컬 드라이브 및 폴더에 액세스하면 백슬래시로 표기된 해당 경로가 밑줄로 바뀝니다. 또한 로컬 컴퓨터 이름과 드라이브 문자가 접미사로 추가됩니다. 예를 들어, 사용자 이름이 janedoe이고 컴퓨터 이름이 ExampleCorp-123456인 사용자의 경우 기본 데스크톱, 문서 및 다운로드 폴더 경로는 다음과 같이 표시됩니다.

C\$1Users\$1janedoe\$1Desktop (\$1\$1ExampleCorp-123456) (F:)

C\$1Users\$1janedoe\$1Documents (\$1\$1ExampleCorp-123456) (G:)

C\$1Users\$1janedoe\$1Downloads (\$1\$1ExampleCorp-123456) (H:)

# WorkSpaces 애플리케이션 사용자에게 파일 시스템 리디렉션 작업 지침 제공
<a name="end-user-guidance-file-system-redirection"></a>

사용자가 스트리밍 세션 중에 파일 리디렉션을 사용하는 방법을 이해할 수 있도록 [로컬 파일 액세스](client-application-windows-file-system-redirection.md)의 정보를 제공할 수 있습니다.

# WorkSpaces 애플리케이션 사용자에 대해 로컬 프린터 리디렉션 활성화
<a name="enable-local-printer-redirection"></a>

로컬 프린터 리디렉션을 사용하면 WorkSpaces 애플리케이션 사용자는 스트리밍 애플리케이션에서 사용자가 매핑한 네트워크 프린터를 포함하여 로컬 컴퓨터에 연결된 프린터로 인쇄 작업을 리디렉션할 수 있습니다. 사용자가 스트리밍 세션 중에 문서를 인쇄할 수 있도록 WorkSpaces 애플리케이션 스트리밍 인스턴스에 프린터 드라이버를 설치할 필요가 없습니다.

**참고**  
현재 Linux 기반 스택에서는 로컬 프린터 리디렉션 활성화가 지원되지 않습니다.

**Topics**
+ [로컬 프린터 리디렉션을 위한 사전 조건](local-printer-redirection-prerequisites.md)
+ [로컬 프린터 리디렉션을 활성화하는 방법](how-to-enable-disable-local-printer-redirection.md)
+ [로컬 프린터 리디렉션을 비활성화하는 방법](disable-local-printer-redirection.md)

# 로컬 프린터 리디렉션을 위한 사전 조건
<a name="local-printer-redirection-prerequisites"></a>

사용자가 로컬 프린터 리디렉션을 사용할 수 있도록 하려면 다음을 수행해야 합니다.
+ 2020년 7월 30일 또는 그 이후에 릴리스된 WorkSpaces 애플리케이션 에이전트 버전을 사용하는 이미지를 사용합니다. 자세한 내용은 [WorkSpaces 애플리케이션 에이전트 릴리스 정보](agent-software-versions.md) 단원을 참조하십시오.
+ 사용자에게 WorkSpaces Applications 클라이언트 버전 1.1.179 이상이 설치되어 있는지 확인합니다. 자세한 내용은 [WorkSpaces 애플리케이션 Windows 클라이언트 릴리스 정보](client-release-versions.md) 단원을 참조하십시오.
+ 사용자가 스트리밍 세션을 위해 액세스하는 스택에서 프린터 리디렉션이 활성화되어 있는지 확인합니다.

# 로컬 프린터 리디렉션을 활성화하는 방법
<a name="how-to-enable-disable-local-printer-redirection"></a>

기본적으로 WorkSpaces 애플리케이션 클라이언트가 설치되면 로컬 프린터 리디렉션이 활성화됩니다. 그러나 사용자가 스트리밍 세션에 액세스하는 스택에서 로컬 프린터 리디렉션이 활성화되지 않은 경우 다음 단계를 수행하여 WorkSpaces 애플리케이션 콘솔에서 활성화할 수 있습니다.

**WorkSpaces 애플리케이션 콘솔을 사용하여 로컬 프린터 리디렉션을 활성화하려면**

1. [https://console.aws.amazon.com/appstream2/home](https://console.aws.amazon.com/appstream2/home) WorkSpaces 애플리케이션 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **스택**을 선택합니다.

1. 로컬 프린터 리디렉션을 활성화할 스택을 선택하세요.

1. **사용자 설정** 탭을 선택한 다음 **클립 보드, 파일 전송, 로컬 디바이스로 인쇄, 인증 권한** 섹션을 확장합니다.

1. **로컬 디바이스로 인쇄**에서 **활성화됨**이 선택되어 있는지 확인합니다. 선택되지 않은 경우 **편집**을 선택한 다음 **활성화됨**을 선택합니다.

1. **업데이트**를 선택합니다.

또는 WorkSpaces 애플리케이션 API, AWS SDK 또는 AWS Command Line Interface ()를 사용하여 로컬 프린터 리디렉션을 활성화할 수 있습니다AWS CLI.

# 로컬 프린터 리디렉션을 비활성화하는 방법
<a name="disable-local-printer-redirection"></a>

로컬 프린터 리디렉션을 비활성화하려면 다음 단계를 따릅니다.

**로컬 프린터 리디렉션을 비활성화하는 방법**

다음 방법 중 하나를 사용하여 로컬 프린터 리디렉션을 비활성화할 수 있습니다.
+ 관리 대상 디바이스에 클라이언트를 설치하는 동안 비활성화합니다. 자세한 내용은 [로컬 프린터 리디렉션을 비활성화할지 선택](install-client-configure-settings.md#disable-local-printer-redirection-client) 단원을 참조하십시오.
+ WorkSpaces 애플리케이션 콘솔을 사용하여 WorkSpaces 애플리케이션 스택에서이 옵션을 비활성화합니다.
+ WorkSpaces 애플리케이션 API, AWS SDK 또는 AWS Command Line Interface (AWS CLI)를 사용하여 WorkSpaces 애플리케이션 스택에서이 옵션을 비활성화합니다.