

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

# WorkSpaces 애플리케이션 클라이언트를 통해 액세스 제공
<a name="client-application"></a>

사용자는 지원되는 디바이스에 대해 WorkSpaces 애플리케이션 클라이언트 애플리케이션을 사용하거나 웹 브라우저를 사용하여 WorkSpaces 애플리케이션 스트리밍 세션을 시작할 수 있습니다.

WorkSpaces 애플리케이션 클라이언트는 WorkSpaces 애플리케이션 스트리밍 세션 중에 다음 기능이 필요한 사용자를 위해 설계된 네이티브 애플리케이션입니다.
+ 3대 이상의 모니터 또는 4K 해상도 지원이 필요한 사용자
+ WorkSpaces 애플리케이션을 통해 스트리밍되는 애플리케이션에서 USB 디바이스를 사용합니다.
+ 스트리밍 세션 내에서 화상 회의를 위해 로컬 웹캠을 사용하는데 사용 중인 브라우저에서 비디오 또는 오디오 입력을 지원하지 않는 경우
+ 스트리밍 세션에서 키보드 단축키를 사용하는 사용자
+ 스트리밍 세션 중에 로컬 드라이브 및 폴더에 대한 원활한 액세스가 필요한 사용자
+ 스트리밍 애플리케이션에서 로컬 컴퓨터에 연결된 프린터로 인쇄 작업을 리디렉션해야 하는 사용자
+ 로컬에 설치된 애플리케이션과 거의 동일한 방식으로 원격 스트리밍 애플리케이션을 사용하길 원하는 사용자

다음 주제에서는 WorkSpaces 애플리케이션 클라이언트를 통해 사용자 액세스를 제공하는 데 도움이 되는 정보를 제공합니다. 웹 브라우저를 통해 WorkSpaces 애플리케이션에 대한 사용자 액세스를 제공하는 방법에 대한 자세한 내용은 섹션을 참조하세요[웹 브라우저를 통해 액세스 제공](access-through-web-browser-admin.md).

**Topics**
+ [시스템 요구 사항 및 기능 지원(WorkSpaces 애플리케이션 클라이언트)](client-system-requirements-feature-support.md)
+ [WorkSpaces 애플리케이션 클라이언트 설치 및 구성](install-configure-client.md)

# 시스템 요구 사항 및 기능 지원(WorkSpaces 애플리케이션 클라이언트)
<a name="client-system-requirements-feature-support"></a>

이 주제에서는 WorkSpaces Applications 클라이언트 및 지원되는 기능에 대한 요구 사항을 이해하는 데 도움이 되는 정보를 제공합니다.

**Topics**
+ [시스템 요구 사항 및 고려 사항](client-system-requirements.md)
+ [기능 및 디바이스 지원](client-feature-support.md)

# 시스템 요구 사항 및 고려 사항
<a name="client-system-requirements"></a>

WorkSpaces 애플리케이션 클라이언트에는 다음이 필요합니다.
+ WorkSpaces 애플리케이션 클라이언트를 시작할 때 최소 권한 원칙을 따릅니다. 클라이언트는 작업을 완료하는 데 필요한 수준의 권한으로만 실행해야 합니다.
+ 클라이언트 요구 사항
  + Windows 클라이언트
    + 운영 체제 - Windows 10(32비트 또는 64비트), Windows 11(64비트)
    + Microsoft Visual C\$1\$1 2019 버전 14.20.xx Redistributable 이상. 자세한 내용은 Microsoft Support 설명서에서 [최신 Microsoft Visual C\$1\$1 재배포 가능 버전](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170)을 참조하세요.
    + RAM - 최소 2GB
    + 하드 드라이브 공간 - 최소 200MB
  + macOS 클라이언트
    + 운영 체제 - macOS 13(Ventura), macOS 14(Sonoma), macOS 15(Sequoia)
    + 하드 드라이브 공간 - 최소 200MB
+ 로컬 관리자 권한 - USB 드라이버 지원을 위해 WorkSpaces 애플리케이션 USB 드라이버를 설치하려는 경우에 사용됩니다.
**참고**  
macOS 클라이언트에는 로컬 관리자 권한이 지원되지 않습니다.
+ 2018년 11월 14일 이후에 게시된 최신 WorkSpaces 애플리케이션 에이전트 또는 에이전트 버전을 사용하는 WorkSpaces 애플리케이션 WorkSpaces 이미지입니다. WorkSpaces Applications 에이전트 버전에 대한 자세한 내용은 섹션을 참조하세요[WorkSpaces 애플리케이션 에이전트 릴리스 정보](agent-software-versions.md).
+ 클라이언트는 UDP뿐만 아니라 NICE DCV를 통한 기본 TCP 기반 스트리밍을 지원합니다. NICE DCV 및 UDP에 대한 자세한 내용은 [Enabling the QUIC UDP transport protocol](https://docs.aws.amazon.com/dcv/latest/adminguide/enable-quic.html)을 참조하세요. 클라이언트에 대해 UDP 스트리밍을 사용하려는 경우 다음 요구 사항을 충족하는지 확인해야 합니다. 다음 요구 사항을 충족하지 않는 경우 클라이언트는 기본적으로 TCP 기반 스트리밍으로 돌아갑니다.
  + **스트리밍 설정 경험** 섹션에서 스택이 UDP를 선호하도록 구성되었습니다. 자세한 내용은 [Amazon WorkSpaces 애플리케이션 플릿 및 스택 생성](set-up-stacks-fleets.md) 단원을 참조하십시오.
  + 네트워크는 AWS IP 범위에 대해 포트 8433에서 UDP 트래픽을 허용합니다. 자세한 내용은 [AWS IP 주소 범위](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html)를 참조하세요.
  + 플릿을 생성할 때 최신 기본 이미지를 사용하고 있습니다. 자세한 내용은 [WorkSpaces 애플리케이션 기본 이미지 및 관리형 이미지 업데이트 릴리스 정보](base-image-version-history.md) 단원을 참조하십시오.
  + 최종 사용자가 최신 클라이언트를 사용하고 있습니다. 자세한 내용은 [지원 클라이언트](https://clients.amazonappstream.com/)를 참조하세요.

**참고**  
WorkSpaces Applications 클라이언트 설치에는 인터넷 연결을 사용하는 것이 좋습니다. 경우에 따라 인터넷에 연결되지 않은 컴퓨터에 클라이언트를 설치할 수 없거나 USB 디바이스가 WorkSpaces 애플리케이션에서 스트리밍된 애플리케이션에서 작동하지 않을 수 있습니다. 자세한 내용은 [WorkSpaces 애플리케이션 사용자 문제 해결](troubleshooting-user-issues.md) 단원을 참조하십시오.

# 기능 및 디바이스 지원
<a name="client-feature-support"></a>

WorkSpaces 애플리케이션 클라이언트는 다음과 같은 기능과 디바이스를 지원합니다.

**Topics**
+ [네이티브 애플리케이션 모드](feature-support-native-application-mode.md)
+ [자동 및 온디맨드 진단 로그 업로드](feature-support-diagnostic-log-upload.md)
+ [주변 디바이스](feature-support-peripheral-devices.md)

# 네이티브 애플리케이션 모드
<a name="feature-support-native-application-mode"></a>

**참고**  
Linux 인스턴스에서 스트리밍하거나 데스크톱 모드에서 스트리밍하거나 WorkSpaces 애플리케이션 macOS 클라이언트 애플리케이션을 사용할 때는 기본 애플리케이션 모드를 사용할 수 없습니다.

네이티브 애플리케이션 모드는 WorkSpaces 애플리케이션 스트리밍 세션 중에 사용자에게 친숙한 경험을 제공합니다. 사용자가이 모드에서 WorkSpaces 애플리케이션에 연결하면 로컬 컴퓨터에 설치된 애플리케이션과 거의 동일한 방식으로 원격 스트리밍 애플리케이션으로 작업할 수 있습니다. 네이티브 애플리케이션 모드에서는 각 스트리밍 애플리케이션이 자체 창에서 열리고 사용자의 로컬 PC 작업 표시줄에 애플리케이션 아이콘이 나타납니다.

사용자가 클래식 모드에서만 WorkSpaces 애플리케이션에 연결하도록 하려면 기본 애플리케이션 모드를 비활성화하도록 `NativeAppModeDisabled` 레지스트리 값을 구성할 수 있습니다. 자세한 내용은 [네이티브 애플리케이션 모드를 비활성화할지 여부 선택](install-client-configure-settings.md#disable-native-application-mode-client) 단원을 참조하십시오.

네이티브 애플리케이션 모드 및 클래식 모드에 대한 자세한 내용과 사용자에게 제공할 수 있는 지침은 [WorkSpaces 애플리케이션 클라이언트 연결 모드](client-application-windows-connection-modes-user.md) 단원을 참조하십시오.

**기능 요구 사항**

사용자에 대해이 기능을 활성화하려면 2020년 2월 19일 또는 그 이후에 릴리스된 [ WorkSpaces 애플리케이션 에이전트 버전을](agent-software-versions.md) 사용하는 이미지를 사용해야 합니다. 또한 WorkSpaces 애플리케이션 클라이언트 버전 1.1.129 이상이 사용자의 PCs에 설치되어 있어야 합니다. 클라이언트 버전에 대한 자세한 내용은 [WorkSpaces 애플리케이션 Windows 클라이언트 릴리스 정보](client-release-versions.md) 단원을 참조하십시오.

WorkSpaces Applications 클라이언트 버전 1.1.129 이상이 사용자의 컴퓨터에 설치되어 있지만 2020년 2월 19일 이후에 릴리스된 에이전트 버전을 사용하는 이미지를 사용하지 않는 경우 기본 애플리케이션 모드를 선택했더라도 클라이언트는 클래식 모드로 돌아갑니다.

**테스트 요구 사항**

프로덕션 배포 전에 네이티브 애플리케이션 모드에서 애플리케이션을 철저히 테스트해야 합니다. 애플리케이션에 기본 애플리케이션 모드와의 호환성 문제가 있을 수 있으므로 클래식 모드에서 테스트하는 것으로는 충분하지 않습니다. 주요 테스트 영역은 다음과 같습니다.
+ 코어 애플리케이션 기능
+ 네트워크 성능
+ 로컬 디바이스 상호 작용
+ 파일 처리 작업
+ 인쇄 기능
+ 다중 모니터 지원
+ 오디오/동영상 기능

전체 배포 전에 파일럿 사용자 그룹부터 시작하여 애플리케이션별 제한 사항을 문서화하는 것이 좋습니다. 애플리케이션 동작과 성능은 스트리밍 모드마다 다를 수 있습니다. 포괄적인 테스트를 통해 최적의 사용자 환경을 보장하고 프로덕션 롤아웃 전에 잠재적 제한을 식별할 수 있습니다.

**알려진 문제**

사용자가 네이티브 애플리케이션 모드로 스트리밍 세션을 실행하는 중에 한 브라우저 창의 여러 탭을 별도의 창들로 고정하거나 고정 해제하려고 할 경우 원격 스트리밍 브라우저가 로컬 브라우저와 동일한 방식으로 작동하지 않습니다. 네이티브 애플리케이션 모드의 스트리밍 세션 중에 이 작업을 수행하려면 브라우저 탭들이 별도의 브라우저 창들로 고정될 때까지 Alt 키를 눌러야 합니다.

# 자동 및 온디맨드 진단 로그 업로드
<a name="feature-support-diagnostic-log-upload"></a>

사용자가 WorkSpaces 애플리케이션 클라이언트를 사용할 때 발생할 수 있는 문제를 해결하는 데 도움이 되도록 자동 또는 온디맨드 진단 로그 업로드를 활성화하거나 사용자가 직접 업로드하도록 할 수 있습니다.

**참고**  
진단 로그에는 민감한 정보가 포함되어 있지 않습니다. 관리자가 관리하는 사용자 PC에서 자동 및 온디맨드 진단 로그 업로드를 비활성화하거나 사용자가 이러한 기능을 직접 비활성화하도록 할 수 있습니다.

**자동 진단 로그 업로드 **

관리하는 PCs에 클라이언트를 설치할 때 진단 로그를 자동으로 업로드하도록 WorkSpaces 애플리케이션 클라이언트를 구성할 수 있습니다. 이렇게 하면 클라이언트 문제가 발생하면 사용자 상호 작용 없이 로그가 WorkSpaces 애플리케이션(AWS)으로 전송됩니다. 자세한 내용은 [사용자를 위한 추가 WorkSpaces 애플리케이션 클라이언트 설정 구성](install-client-configure-settings.md#configure-client) 단원을 참조하십시오.

또는 사용자가 WorkSpaces 애플리케이션 클라이언트를 설치할 때 또는 클라이언트 설치 후 자동 진단 로그 업로드를 활성화할지 여부를 선택하도록 할 수 있습니다. 이 작업을 수행하는 데 도움이 되도록 사용자에게 제공할 수 있는 지침은 [Windows용 설정](client-application-windows-installation-user.md) 단원을 참조하십시오.

**온디맨드 진단 로그 업로드 **

로깅에 대한 세부적인 제어가 필요한 경우 자동 로깅을 비활성화하고 온디맨드 진단 로그 업로드를 활성화할 수 있습니다. 사용자가 온디맨드로 진단 로그를 업로드하도록 허용하면 예외가 발생하거나 클라이언트가 응답을 중지하는 경우 미니 덤프(오류 보고서)를 WorkSpaces 애플리케이션(AWS)으로 전송할지 여부도 선택할 수 있습니다.

 이러한 작업을 수행하는 데 도움이 되도록 사용자에게 제공할 수 있는 지침은 [로깅](client-application-windows-how-to-enable-diagnostic-logging-user.md) 단원을 참조하십시오.

# 주변 디바이스
<a name="feature-support-peripheral-devices"></a>

WorkSpaces 애플리케이션 클라이언트는 모니터, 웹캠, 마우스, 키보드, 드로잉 태블릿과 같은 주변 디바이스에 대해 다음과 같은 지원을 제공합니다.

**참고**  
특정 예외를 제외하고 WorkSpaces 애플리케이션 클라이언트가 USB 디바이스를 지원하려면 USB 리디렉션이 필요합니다. 또한 대부분의 경우 디바이스에 USB 리디렉션이 필요한 경우 WorkSpaces 애플리케이션 스트리밍 세션과 함께 사용하기 전에 디바이스를 검증해야 합니다. 자세한 내용은 [USB 리디렉션](feature-support-USB-devices-qualified.md#feature-support-USB-devices-USB-redirection) 단원을 참조하십시오.

**Topics**
+ [다중 모니터](feature-support-multiple-monitors.md)
+ [실시간 오디오-비디오](feature-support-real-time-av.md)
+ [USB 디바이스](feature-support-USB-devices-qualified.md)
+ [드로잉 태블릿](feature-support-drawing-tablets.md)
+ [키보드 바로 가기](feature-support-keyboard-shortcuts.md)
+ [상대 마우스 오프셋](feature-support-relative-mouse-offset.md)

# 다중 모니터
<a name="feature-support-multiple-monitors"></a>

WorkSpaces 애플리케이션은 해상도가 다른 모니터를 포함하여 스트리밍 세션 중에 여러 모니터의 사용을 지원합니다. 최적의 스트리밍 환경을 보장하려면 해상도가 다른 모니터를 사용하는 사용자는 모니터의 디스플레이 배율을 100%로 설정하는 것이 좋습니다.

**참고**  
[네이티브 애플리케이션 모드를](feature-support-native-application-mode.md) 사용하는 WorkSpaces 애플리케이션 스트리밍 세션의 경우 최대 4K 해상도의 모니터가 지원됩니다. 스트리밍 세션에 고해상도 모니터를 사용하는 경우 WorkSpaces 애플리케이션 클라이언트는 클래식 모드로 돌아갑니다. 이 시나리오에서 WorkSpaces Applications 클래식 모드 스트리밍 보기는 화면의 4K를 차지하며 화면의 나머지 부분은 검은색입니다.

## 다중 모니터(최대 4K 해상도)
<a name="feature-support-multiple-monitors-4K"></a>

**기본 동작:** 기본적으로 모든 인스턴스 유형은 모니터당 최대 디스플레이 해상도가 4096x2160픽셀인 최대 4개의 모니터를 지원합니다. 단, 크기가 작거나 중간인 인스턴스는 예외입니다.

**중소 규모의 모든 인스턴스 유형:** 성능 제한으로 인해 중소 규모의 인스턴스에서는 4K 해상도를 사용하지 않는 것이 좋지만 이미지를 다음과 같이 변경하여 활성화할 수 있습니다.
+ Windows의 경우: 이미지 빌더에서 다음 레지스트리 설정을 구성합니다.
  + PowerShell 사용:

    ```
    Set-ItemProperty "HKLM:\SOFTWARE\Amazon\AppStream" -Name EnableNonGraphics4K -Value 1
    ```
  + 레지스트리 편집(편집) 사용:
    + 레지스트리 경로: `HKLM:Software\Amazon\AppStream`
    + 레지스트리 값 이름: `EnableNonGraphics4K`
    + 레지스트리 값 데이터: `1`
    + 레지스트리 값 유형: `DWord`
+ Linux의 경우: 다음 `[display]` 구성을 편집`/etc/euc/workspaces-applications.conf`하고 업데이트합니다.

  ```
  EnableNonGraphics4K=1
  ```
+ 이 설정을 사용하여 새 이미지를 생성합니다.
+ 플릿에이 새 이미지를 사용합니다.
+ 최종 사용자는 디바이스의 디스플레이 해상도에 따라 디스플레이 디바이스에서 최대 4K 해상도를 볼 수 있습니다.

**중요**  
고해상도 모니터(예: 4K 디스플레이)에는 디스플레이 구성(해상도 및 모니터 수)과 사용 중인 컴퓨팅 인스턴스에 따라 실제 성능으로 훨씬 더 많은 GPU 및 인코딩 리소스가 필요합니다. 사용자가 4K 모니터에서 성능이 최적화되지 않은 경우 플릿을 더 강력한 인스턴스로 전환하거나 사용자에게 디스플레이 해상도를 줄이도록 권장하여 응답성을 개선합니다.  
어느 차원이든 해상도가 4096픽셀을 초과하는 초광각 모니터(예: 5120x2160)는 지원되는 최대 해상도가 차원당 4096픽셀로 제한되므로 측면에 검은색 막대를 표시합니다.

**그래픽이 아닌 인스턴스의 경우 4K 해상도 비활성화**

그래픽 하드웨어가 없는 인스턴스에서 4K 모니터 해결과 관련된 성능 문제가 발생하는 경우 아래 단계에 따라 해결을 2K(2560x1440)로 제한할 수 있습니다.
+ Windows의 경우: 이미지 빌더에서 다음 레지스트리 설정을 구성합니다.
  + PowerShell 사용:

    ```
    Set-ItemProperty "HKLM:\SOFTWARE\Amazon\AppStream" -Name EnableNonGraphics4K -Value 0
    ```
  + 레지스트리 편집(편집) 사용:
    + 레지스트리 경로: `HKLM:Software\Amazon\AppStream`
    + 레지스트리 값 이름: `EnableNonGraphics4K`
    + 레지스트리 값 데이터: `0`
    + 레지스트리 값 유형: `DWord`
+ Linux의 경우: 다음 `[display]` 구성을 편집`/etc/euc/workspaces-applications.conf`하고 업데이트합니다.

  ```
  EnableNonGraphics4K=0
  ```
+ 이 설정을 사용하여 새 이미지를 생성합니다.
+ 플릿에이 새 이미지를 사용합니다.
+ 최종 사용자는 디스플레이 디바이스에서 최대 2K 해상도를 볼 수 있습니다.

# 실시간 오디오-비디오
<a name="feature-support-real-time-av"></a>

WorkSpaces 애플리케이션은 로컬 웹캠 비디오 입력을 WorkSpaces 애플리케이션 스트리밍 세션으로 리디렉션하여 실시간 오디오-비디오(AV)를 지원합니다. 이 기능을 사용하면 사용자가 WorkSpaces 애플리케이션 스트리밍 세션 내에서 비디오 및 오디오 회의에 로컬 웹캠을 사용할 수 있습니다. 실시간 AV 및 실시간 오디오 지원을 통해 사용자는 WorkSpaces 애플리케이션 스트리밍 세션을 종료하지 않고도 익숙한 비디오 및 오디오 회의 애플리케이션을 사용하여 협업할 수 있습니다.

사용자가 WorkSpaces 애플리케이션 스트리밍 세션 내에서 비디오 회의를 시작하면 WorkSpaces 애플리케이션은이 데이터를 보안 채널을 통해 스트리밍 인스턴스로 전송하기 전에 웹캠 비디오 및 마이크 오디오 입력을 로컬로 압축합니다. 스트리밍 세션 중에 사용자는 WorkSpaces 애플리케이션 도구 모음을 사용하여 오디오 및 비디오 입력을 활성화할 수 있습니다. 사용자가 웹캠을 두 개 이상 사용하는 경우(예: 로컬 컴퓨터에 연결된 USB 웹캠과 내장 웹캠이 있는 경우) 스트리밍 세션 중에 사용할 웹캠을 선택할 수도 있습니다.

**참고**  
다중 세션 플릿의 경우 인/아웃 기능만 사용할 수 있습니다. 비디오 입력(웹캠 지원)은 아직 다중 세션 플릿에서 사용할 수 없습니다.

실시간 AV에 대한 지원을 구성하고 테스트하려면 다음 단계를 완료하세요.

**실시간 AV에 대한 지원 및 테스트**

1. 다음 요구 사항을 충족하는 새 이미지 빌더를 만들거나 기존 이미지 빌더에 연결하세요.
   + 이미지 빌더가 Windows Server 2016 또는 Windows Server 2019를 실행해야 합니다.
   + 이미지 빌더는 2021년 6월 1일 이후에 릴리스된 WorkSpaces 애플리케이션 에이전트 버전을 사용해야 합니다.
   + 2021년 5월 17일 또는 그 이후에 릴리스된 WorkSpaces 애플리케이션 에이전트의 경우 실시간 AV가 기본적으로 활성화됩니다. 테스트용 스트리밍 URL을 만들려면 3\$16단계를 건너뛰고 이미지 빌더와의 연결을 끊으면 됩니다. 실시간 AV를 비활성화해야 하는 경우 모든 단계를 완료하고 4단계에서 웹캠 권한을 비활성화하세요.
   + 웹 브라우저 액세스를 사용하여 연결할 때 비디오를 지원하려면 이미지 빌더가 2021년 6월 24일 또는 그 이후에 릴리스된 WorkSpaces 애플리케이션 에이전트 버전을 사용해야 합니다. 지원되는 웹 브라우저에 대한 자세한 내용은 [웹 브라우저 액세스](web-browser-user.md) 섹션을 참조하세요.

   이미지 빌더 생성에 대한 자세한 내용은 [이미지 빌더를 시작하여 스트리밍 애플리케이션 설치 및 구성](tutorial-image-builder-create.md) 섹션을 참조하세요.

1. 사용할 이미지 빌더에 연결하고 관리자 계정으로 로그인합니다. 이미지 빌더에 연결하려면 다음 중 하나를 수행합니다.
   + [WorkSpaces 애플리케이션 콘솔 사용](managing-image-builders-connect-console.md)(웹 연결에만 해당)
   + [스트리밍 URL 생성](managing-image-builders-connect-streaming-URL.md)(웹 또는 WorkSpaces 애플리케이션 클라이언트 연결용)
**참고**  
연결하려는 이미지 빌더가 Active Directory 도메인에 조인되어 있고 조직에서 스마트 카드 로그인이 필요한 경우 스트리밍 URL을 생성하고 연결에 WorkSpaces 애플리케이션 클라이언트를 사용해야 합니다. 스마트 카드 로그인에 대한 자세한 내용은 [스마트 카드](feature-support-USB-devices-qualified.md#feature-support-USB-devices-qualified-smart-cards) 섹션을 참조하세요.

1. 이미지 빌더에서 레지스트리 편집기를 엽니다. 이렇게 하려면 이미지 빌더 바탕화면의 작업 표시줄에 있는 검색 상자에 **regedit**을 입력합니다. 그런 다음 **레지스트리 편집기**의 최상위 결과를 선택합니다.

1. **HKEY\$1LOCAL\$1MACHINE\$1SOFTWARE\$1Amazon\$1AppStream\$1**에서 다음과 같은 유형, 이름 및 값 데이터를 포함하는 새 레지스트리 값을 생성합니다.
   + 레지스트리 값 유형: DWORD
   + 레지스트리 값 이름: WebcamPermission
   + 레지스트리 값 데이터(16진수): 웹캠 권한을 활성화하려면 1, 비활성화하려면 0

1. 레지스트리 값을 생성한 후에는 **템플릿 사용자** 또는 이미지 빌더에 대한 관리자 권한이 없는 도메인 계정으로 전환하세요. **템플릿 사용자**로 전환하려면 세션 창의 오른쪽 상단에 있는 도구 모음에서 **관리자 명령**, **사용자 전환**, **템플릿 사용자**를 선택합니다.

1. **관리자**로 다시 전환합니다.

1. 이미지 빌더와의 연결을 끊고 이미지 빌더용 스트리밍 URL을 만듭니다. 그렇게 하려면 다음을 수행하세요.

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

   1. 탐색 창에서 **이미지**를 선택하고 **이미지 빌더**를 선택합니다.

   1. 방금 연결을 끊은 이미지 빌더를 선택하고 **작업**, **스트리밍 URL 생성**을 선택합니다.

   1. **링크 복사**를 선택하고 링크를 안전하고 액세스 가능한 위치에 저장합니다. 다음 단계에서 이 링크를 사용하여 이미지 빌더에 연결합니다.

1. 방금 생성한 스트리밍 URL을 사용하여 WorkSpaces 애플리케이션 클라이언트 또는 웹 브라우저 액세스를 사용하여 이미지 빌더에 연결합니다.

1. [화상 및 음성 회의](client-application-windows-how-to-use-local-webcam-user.md)의 단계에 따라 이미지 빌더에서 실시간 AV 경험을 테스트합니다.

1. 실시간 AV가 예상대로 작동하는지 확인한 후 스트리밍 세션에서 연결을 끊고 이미지 빌더에 다시 연결한 다음 Image Assistant에서 필요한 단계를 따라 이미지 생성을 완료합니다. 이미지 생성에 대한 자세한 내용은 [자습서: WorkSpaces 애플리케이션 콘솔을 사용하여 사용자 지정 WorkSpaces 애플리케이션 이미지 생성](tutorial-image-builder.md) 단원을 참조하십시오.

이미지 빌더를 구성하고 실시간 AV를 지원하는 이미지를 생성한 후 WorkSpaces 애플리케이션 플릿에서 사용자가이 기능을 사용할 수 있도록 할 수 있습니다. WorkSpaces 애플리케이션 클라이언트 버전 1.1.257 이상이 사용자의 컴퓨터에 설치되어 있는지 확인합니다.

**참고**  
WorkSpaces 애플리케이션 클라이언트에서 실시간 AV를 사용하려면 WorkSpaces 애플리케이션 기본 이미지 및 에이전트 버전이 2021년 6월 1일 이상이어야 합니다. 최신 WorkSpaces 애플리케이션 클라이언트를 사용하는 것이 좋습니다. 실시간 AV를 사용하는 데 도움이 되도록 사용자에게 제공할 수 있는 지침은 [화상 및 음성 회의](client-application-windows-how-to-use-local-webcam-user.md) 섹션을 참조하세요.  
웹 브라우저 액세스와 함께 실시간 AV를 사용하려면 WorkSpaces 애플리케이션 이미지에서 2021년 6월 24일 이후에 릴리스된 WorkSpaces 애플리케이션 에이전트 버전을 사용해야 합니다. 지원되는 브라우저에 대한 자세한 내용은 [웹 브라우저 액세스](web-browser-user.md) 섹션을 참조하세요.





# USB 디바이스
<a name="feature-support-USB-devices-qualified"></a>

다음 섹션에서는 USB 디바이스에 대한 WorkSpaces 애플리케이션 지원에 대한 정보를 제공합니다.

**Topics**
+ [USB 리디렉션](#feature-support-USB-devices-USB-redirection)
+ [스마트 카드](#feature-support-USB-devices-qualified-smart-cards)

## USB 리디렉션
<a name="feature-support-USB-devices-USB-redirection"></a>

WorkSpaces 애플리케이션 스트리밍 세션 중에 대부분의 로컬 USB 디바이스를 사용하려면 USB 리디렉션이 필요합니다. USB 리디렉션이 필요한 경우 사용자가 WorkSpaces 애플리케이션 스트리밍 세션 중에 디바이스[를 사용하려면 먼저 디바이스를 검증](qualify-usb-devices.md)해야 합니다. 디바이스를 검증한 후 사용자는 [디바이스를 WorkSpaces 애플리케이션과 공유](client-application-windows-how-to-share-usb-devices-user.md)해야 합니다. USB 리디렉션을 사용하면 WorkSpaces 애플리케이션 스트리밍 세션 중에 로컬 애플리케이션에서 사용자의 디바이스에 액세스할 수 없습니다.

다른 경우에는 USB 디바이스가 이미 WorkSpaces 애플리케이션에서 사용하도록 활성화되어 있으므로 추가 구성이 필요하지 않습니다. 예를 들어 WorkSpaces 애플리케이션 클라이언트가 설치되면 스마트 카드 리디렉션이 기본적으로 이미 활성화되어 있습니다. 이 기능을 활성화하면 USB 리디렉션이 사용되지 않으므로 스마트 카드 리더를 검증할 필요가 없으며 사용자는 스트리밍 세션 중에 사용하기 위해 이러한 디바이스를 WorkSpaces 애플리케이션과 공유할 필요가 없습니다.

**참고**  
USB 리디렉션은 현재 Linux 기반 플릿 인스턴스 또는 WorkSpaces 애플리케이션 macOS 클라이언트 애플리케이션을 사용할 때는 지원되지 않습니다.

## 스마트 카드
<a name="feature-support-USB-devices-qualified-smart-cards"></a>

WorkSpaces 애플리케이션은 Active Directory에 조인된 스트리밍 인스턴스에 대한 Windows 로그인 및 스트리밍 애플리케이션에 대한 세션 내 인증을 위한 스마트 카드 사용을 지원합니다. 스마트 카드 리디렉션은 기본적으로 활성화되므로 사용자는 USB 리디렉션 없이 로컬 컴퓨터와 스마트 카드에 연결된 스마트 카드 리더를 사용할 수 있습니다.

**Topics**
+ [Windows 로그인 및 세션 내 인증](#feature-support-USB-devices-qualified-smart-cards-windows-signin-in-session-auth)
+ [스마트 카드 리디렉션](#feature-support-USB-devices-qualified-smart-cards-support)

### Windows 로그인 및 세션 내 인증
<a name="feature-support-USB-devices-qualified-smart-cards-windows-signin-in-session-auth"></a>

WorkSpaces 애플리케이션은 Windows용 [CAC(Common Access Card)](https://www.cac.mil/Common-Access-Card) 및 [PIV(Personal Identity Verification) 스마트 카드와 같은 Active Directory 도메인 암호 또는](https://piv.idmanagement.gov/) 스마트 카드를 WorkSpaces 애플리케이션 스트리밍 인스턴스(플릿 및 이미지 빌더)에 로그인할 수 있도록 지원합니다. 사용자는 로컬 컴퓨터에 연결된 스마트 카드 리더와 스마트 카드를 사용하여 Microsoft Active Directory 도메인에 조인된 WorkSpaces 애플리케이션 스트리밍 인스턴스에 로그인할 수 있습니다. 또한 로컬 스마트 카드 리더와 스마트 카드를 사용하여 스트리밍 세션 내에서 애플리케이션에 로그인할 수 있습니다.

사용자가 Active Directory에 조인된 스트리밍 인스턴스에 대한 Windows 로그인과 스트리밍 애플리케이션을 위한 세션 내 인증에 스마트 카드를 사용할 수 있도록 하려면 다음을 수행해야 합니다.
+ 다음 요구 사항을 충족하는 이미지를 사용합니다.
  + 이미지는 2020년 12월 28일 또는 그 이후에에서 게시한 기본 이미지 AWS 에서 생성해야 합니다. 자세한 내용은 [WorkSpaces 애플리케이션 기본 이미지 및 관리형 이미지 업데이트 릴리스 정보](base-image-version-history.md) 단원을 참조하십시오.
  + 이미지는 2021년 1월 4일 또는 그 이후에 릴리스된 WorkSpaces 애플리케이션 에이전트 버전을 사용해야 합니다. 자세한 내용은 [WorkSpaces 애플리케이션 에이전트 릴리스 정보](agent-software-versions.md) 단원을 참조하십시오.
+ 이 섹션에 설명된 대로 사용자가 스트리밍 세션에 액세스할 수 있는 WorkSpaces 애플리케이션 스택에서 **Active Directory에 스마트 카드 로그인**을 활성화합니다.
**참고**  
이 설정은 WorkSpaces Applications 스트리밍 인스턴스(플릿 또는 이미지 빌더)에 Windows 로그인에 사용할 수 있는 인증 방법만 제어합니다. 사용자가 스트리밍 인스턴스에 로그인한 후 세션 내 인증에 사용할 수 있는 인증 방법은 제어하지 않습니다.
+ 사용자에게 WorkSpaces Applications 클라이언트 버전 1.1.257 이상이 설치되어 있는지 확인합니다. 자세한 내용은 [WorkSpaces 애플리케이션 Windows 클라이언트 릴리스 정보](client-release-versions.md) 단원을 참조하십시오.

기본적으로 Active Directory의 암호 로그인은 WorkSpaces 애플리케이션 스택에서 활성화됩니다. WorkSpaces 애플리케이션 콘솔에서 다음 단계를 수행하여 Active Directory에 대한 스마트 카드 로그인을 활성화할 수 있습니다.

**WorkSpaces 애플리케이션 콘솔을 사용하여 Active Directory에 스마트 카드 로그인을 활성화하려면**

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

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

1. Active Directory에 대해 스마트 카드 인증을 사용하려는 스택을 선택합니다.

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

1. **Active Directory에 대한 스마트 카드 로그인**의 경우 **활성화됨**을 선택합니다.

   **Active Directory에 대한 암호 로그인**이 아직 활성화되지 않은 경우 활성화할 수도 있습니다. 하나 이상의 인증 방법을 활성화해야 합니다.

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

또는 WorkSpaces 애플리케이션 API, AWS SDK 또는 AWS Command Line Interface ()를 사용하여 Active Directory에 스마트 카드 로그인을 활성화할 수 있습니다AWS CLI.

### 스마트 카드 리디렉션
<a name="feature-support-USB-devices-qualified-smart-cards-support"></a>

WorkSpaces 애플리케이션 클라이언트가 설치되면 스마트 카드 리디렉션이 기본적으로 활성화됩니다. 이 기능이 활성화되면 사용자는 USB 리디렉션 없이 WorkSpaces 애플리케이션 스트리밍 세션 중에 로컬 컴퓨터와 스마트 카드에 연결된 스마트 카드 리더를 사용할 수 있습니다. WorkSpaces 애플리케이션 스트리밍 세션 중에 사용자의 스마트 카드 리더와 스마트 카드는 로컬 애플리케이션에서 사용할 수 있도록 계속 액세스할 수 있습니다. WorkSpaces 애플리케이션 클라이언트는 사용자의 스트리밍 애플리케이션에서 로컬 스마트 카드로 스마트 카드 API 호출을 리디렉션합니다.

**참고**  
스마트 카드 리디렉션은 현재 Linux 기반 플릿 인스턴스 또는 다중 세션 플릿 인스턴스 또는 WorkSpaces Applications macOS 클라이언트 애플리케이션을 사용할 때는 지원되지 않습니다.

**참고**  
스마트 카드가 작동하는 데 미들웨어 소프트웨어가 필요한 경우 사용자의 디바이스와 WorkSpaces Applications 스트리밍 인스턴스 모두에 미들웨어 소프트웨어를 설치해야 합니다.

관리형 디바이스에 클라이언트를 설치하는 동안 스마트 카드 리디렉션을 비활성화할 수 있습니다. 자세한 내용은 [스마트 카드 리디렉션을 비활성화할지 선택](install-client-configure-settings.md#disable-local-smart-card-support-client) 단원을 참조하십시오. 스마트 카드 리디렉션을 비활성화하면 사용자는 USB 리디렉션 없이 WorkSpaces 애플리케이션 스트리밍 세션 중에 스마트 카드 리더와 스마트 카드를 사용할 수 없습니다. 이 경우 [디바이스에 자격을 부여](qualify-usb-devices.md)해야 합니다. 디바이스를 검증한 후 사용자는 [디바이스를 WorkSpaces 애플리케이션과 공유](client-application-windows-how-to-share-usb-devices-user.md)해야 합니다. 스마트 카드 리디렉션이 비활성화된 경우 사용자의 WorkSpaces 애플리케이션 스트리밍 세션 중에는 로컬 애플리케이션에서 스마트 카드 리더 및 스마트 카드에 액세스할 수 없습니다.

# 드로잉 태블릿
<a name="feature-support-drawing-tablets"></a>

펜 태블릿이라고도 하는 드로잉 태블릿은 스타일러스(펜)를 사용하여 그림을 그릴 수 있는 컴퓨터 입력 디바이스입니다. WorkSpaces 애플리케이션을 사용하면 Wacom 드로잉 태블릿과 같은 드로잉 태블릿을 로컬 컴퓨터에 연결하고 태블릿을 스트리밍 애플리케이션과 함께 사용할 수 있습니다.

**참고**  
WorkSpaces Applications macOS 클라이언트 애플리케이션을 사용할 때는 드로잉 태블릿이 지원되지 않습니다.

다음은 사용자가 스트리밍 애플리케이션에서 드로잉 태블릿을 사용하기 위한 요구 사항 및 고려 사항입니다.
+ 사용자가이 기능을 사용할 수 있도록 하려면 Windows Server 2019를 실행하는 이미지를 사용하도록 WorkSpaces 애플리케이션 플릿을 구성해야 합니다.
+ 이 기능을 사용하려면 사용자가 WorkSpaces 애플리케이션 클라이언트를 사용하거나 Google Chrome 또는 Mozilla Firefox 브라우저를 통해서만 WorkSpaces 애플리케이션에 액세스해야 합니다.
+ 스트리밍 애플리케이션은 Windows Ink 기술을 지원해야 합니다. 자세한 내용은 [펜 상호 작용 및 Windows 앱의 Windows Ink](https://docs.microsoft.com/en-us/windows/uwp/design/input/pen-and-stylus-interactions)를 참조하십시오.
+ GIMP와 같은 일부 애플리케이션은 압력 민감도를 지원하기 위해 스트리밍 인스턴스에서 드로잉 태블릿을 감지해야 합니다. 이 경우 사용자는 WorkSpaces 애플리케이션 클라이언트를 사용하여 WorkSpaces 애플리케이션에 액세스하고 이러한 애플리케이션을 스트리밍해야 합니다. 또한 사용자의 드로잉 태블릿을 검증해야 하며, 사용자는 새 스트리밍 세션을 시작할 때마다 드로잉 태블릿을 WorkSpaces 애플리케이션과 공유해야 합니다. 자세한 내용은 [스트리밍 애플리케이션에 사용할 USB 디바이스 승인](qualify-usb-devices.md) 단원을 참조하십시오.
+ Chromebook에서는 이 기능이 지원되지 않습니다.

애플리케이션 스트리밍 세션 중에 드로잉 태블릿 사용을 시작하려면 사용자는 USB를 사용하여 드로잉 태블릿을 로컬 컴퓨터에 연결하고, 압력 민감도 감지에 필요한 경우 디바이스를 WorkSpaces 애플리케이션과 공유한 다음 WorkSpaces 애플리케이션 클라이언트 또는 [지원되는 웹 브라우저](drawing-tablet-support-web-access-admin.md)를 사용하여 WorkSpaces 애플리케이션 스트리밍 세션을 시작합니다.

# 키보드 바로 가기
<a name="feature-support-keyboard-shortcuts"></a>

Windows 클라이언트의 경우 운영 체제 키보드 단축키가 지원됩니다. 지원되는 키보드 단축키로는 Alt \$1 Tab, 클립보드 단축키(Ctrl \$1 X, Ctrl \$1 C, Ctrl\$1 V), Esc, Alt \$1 F4가 있습니다.

macOS 클라이언트에서 지원되는 키보드 단축키로는 클립보드 단축키(Command \$1 X, Command \$1 C, Command \$1 V, Command \$1 A, Command-Z)가 포함됩니다.

# 상대 마우스 오프셋
<a name="feature-support-relative-mouse-offset"></a>

기본적으로 사용자의 스트리밍 세션 중에 WorkSpaces 애플리케이션은 절대 좌표를 사용하고 마우스 움직임을 로컬로 렌더링하여 마우스 움직임에 대한 정보를 스트리밍 인스턴스로 전송합니다. 컴퓨터 지원 설계(CAD)/컴퓨터 지원 제조(CAM) 소프트웨어 또는 비디오 게임과 같이 그래픽을 많이 사용하는 애플리케이션의 경우 상대 마우스 모드를 활성화하면 마우스 성능이 향상됩니다. 상대 마우스 모드는 창이나 화면 내의 절대 x-y 좌표 값 대신 마지막 프레임 이후 마우스가 이동한 거리를 나타내는 상대 좌표를 사용합니다. 상대 마우스 모드가 활성화되면 WorkSpaces 애플리케이션은 마우스 움직임을 원격으로 렌더링합니다.

사용자는 다음 중 하나를 수행하여 WorkSpaces 애플리케이션 스트리밍 세션 중에이 기능을 활성화할 수 있습니다.
+ Windows 클라이언트 애플리케이션에서 Ctrl\$1Shift\$1F8을 누르거나 macOS 클라이언트 애플리케이션에서 Ctrl\$1Shift\$1Fn\$1F8을 누릅니다.
+ 스트리밍 세션 창의 왼쪽 상단에 있는 WorkSpaces 애플리케이션 도구 모음의 **설정 **메뉴에서 **상대 마우스 위치[Ctrl\$1Shift\$1F8]**를 선택합니다. 이 방법은 클래식 모드 또는 **데스크톱 뷰**를 사용할 때 사용할 수 있습니다.

# 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 애플리케이션 스택에서이 옵션을 비활성화합니다.