---
schema_version: "1"
id: 81a9e01b575989d2dfdc63d91cbfa6d6dfbb3e11ec29dc6f0416c549dac5febb
title: tabcmd 명령
collection: tableau
version: current
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/current/ko-kr/online/tabcmd_cmd.md
canonical_url: https://help.tableau.com/current/online/ko-kr/tabcmd_cmd.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 10cfe8ad404871f6b754d1b134e1d3903c0e2d66817113a11b4e1cdca27c1553
description: Reference for tabcmd commands and their options.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# tabcmd 명령

**중요:** 2024년 8월과 2025년 3월 사이에 Tableau Cloud 사이트가 Salesforce의 [Hyperforce](https://help.salesforce.com/s/articleView?id=000388902&type=1)로 마이그레이션되었습니다. 마이그레이션으로 인해 tabcmd 1.0은 더 이상 지원되지 않습니다. 영향을 받지 않도록 가능한 한 빨리 tabcmd 2.0으로 마이그레이션할 계획을 세우십시오. 이 사용 중지로 인해 Tableau Server가 받는 영향은 없습니다.

**참고:** 대부분의 경우 Tableau Cloud에서는 tabcmd 명령줄 유틸리티 2.0(tabcmd 2.0)을 사용해야 합니다. Tabcmd 2.0은 [Tableau tabcmd](https://tableau.github.io/tabcmd)에서 사용할 수 있습니다. 이 새 버전을 사용하면 MacOS 및 Linux에서 tabcmd 명령을 실행하고 PAT(개인용 액세스 토큰)를 사용한 인증을 통해 MFA(다단계 인증)를 준수할 수 있습니다. 버전 2.0은 Python 기반 TSC(Tableau Server 클라이언트)에서 사용할 수 있는 공개 끝점에 구축됩니다.

Tableau Cloud의 tabcmd 명령줄 도구에서 다음 명령을 사용할 수 있습니다.

[login](#id5fba51c9-5608-4520-8ceb-2caf4846a2be)

[logout](#id8f512aec-57a4-4ed4-94c4-86e91ea9cc9c)

[get _url_](#id7e0a0627-ad89-4135-a1c2-85b1d8472568)

[addusers](#id1999d76f-638e-47d4-86ac-fe8e206ed364)(그룹 대상)

[creategroup](#idbfa546df-2be7-444f-8bb8-07978b127783)

[deletegroup](#id0d009916-bee3-4ef0-a6ac-22188c0e7f30)

[export](#id7cb8d032-a4ff-43da-9990-15bdfe64bcd0)

[createproject](#id5a3316ed-45bb-4da4-b557-58492b2d4ac8)

[deleteproject](#idfdf59712-84ed-4590-9471-541d316917a6)

[publish](#iddf805b62-18ff-4497-9245-adc6905b2084)

[createextracts](#id5a3316ed-45bb-4da4-b557-1111112d4ac8)

[refreshextracts](#id4cdb3410-1c41-4dad-b1d2-306542ac9b32)

[deleteextracts](#id5a3316ed-45bb-4da4-b557-2222222d4ac8)

[delete _workbook-name_ 또는 _datasource-name_](#idfdf59712-84ed-4590-9471-541d316917a6)

[createsiteusers](#idd1b7729f-dd20-475a-96f6-17fcd2577894)

[deletesiteusers](#deletesiteusers)

[removeusers](#id5cc30cba-44b8-48b0-93d6-5707938d157a)

[version](#id825f5d18-529c-408a-b876-57693195bbdd)

## addusers _group-name_

지정된 그룹에 사용자를 추가합니다.

**예**

`tabcmd addusers "Development" --users "users.csv"`

### 옵션

`--users`

주어진 `.csv` 파일의 사용자를 지정된 그룹에 추가합니다. 파일은 라인당 사용자 이름이 하나씩 있는 간단한 목록이어야 합니다. 사용자 이름은 대/소문자를 구분하지 않습니다. 사용자는 이미 Tableau Cloud에서 만들어져 있어야 합니다.

자세한 내용은 [CSV 파일 가져오기 지침](https://help.tableau.com/current/online/ko-kr/csvguidelines.htm)을 참조하십시오.

`--[no-]complete`

이 옵션이 `complete`로 설정되면 모든 행에서 모든 변경 작업이 성공해야 합니다. 이 옵션이 지정되지 않으면 `--complete`가 사용됩니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createextracts

게시된 통합 문서 또는 데이터 원본에 대한 추출을 만듭니다.

### 옵션

`-d`, `--datasource`

추출 만들기를 위한 대상 데이터 원본의 이름입니다.

`--embedded-datasources`

대상 통합 문서에 내장된 데이터 원본 이름의 공백으로 구분된 목록입니다. 데이터 원본 이름에 공백이 있는 경우 큰따옴표로 묶습니다. 통합 문서의 추출을 만들 때만 사용할 수 있습니다.

`--encrypt`

암호화된 추출을 만듭니다.

`--include-all`

대상 통합 문서에 내장된 모든 데이터 원본을 포함합니다. 통합 문서의 추출을 만들 때만 사용할 수 있습니다.

`--parent-project-path`

대상 리소스를 포함하는 프로젝트의 상위 프로젝트에 대한 경로입니다. --project를 사용하여 프로젝트 이름을 지정해야 합니다.

`--project`

대상 리소스를 포함하는 프로젝트 이름입니다. --workbook 또는 --datasource가 지정된 경우에만 필요합니다. 지정되지 않은 경우 기본 프로젝트 'Default'가 사용됩니다.

`-u`, `-url`

URL에 나타나는 리소스의 정규 이름입니다.

`-w`, `-workbook`

추출 만들기를 위한 대상 통합 문서의 이름입니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## creategroup _group-name_

그룹을 만듭니다. 그룹이 만들어진 후에는 `addusers`를 사용하여 사용자를 추가합니다.

**예**

`tabcmd creategroup "Development"`

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createproject _project-name_

프로젝트를 만듭니다.

**예**

`tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing quarterly sales reports."`

### 옵션

`-n`, `--name`

만들 프로젝트의 이름을 지정합니다.

`--parent-project-path`

`-n` 옵션으로 지정된 중첩 프로젝트의 상위 프로젝트 이름을 지정합니다. 예를 들어 "Main" 프로젝트에 존재하는 "Nested" 프로젝트를 지정하려면 `--parent-project-path "Main" -n "Nested"` 구문을 사용합니다.

`-d`, `--description`

프로젝트에 대한 설명을 지정합니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createsiteusers _filename.csv_

CSV(쉼표로 구분된 값) 파일에 제공된 정보를 기반으로 사이트에 사용자를 추가합니다. 서버에 아직 사용자가 생성되지 않은 경우 이 명령은 사이트에 사용자를 추가하기 전에 해당 사용자를 만듭니다.

CSV 파일은 하나 이상의 사용자 이름을 포함해야 하며 (각 사용자에 대한) 암호, 전체 이름, 라이선스 유형, 관리자 수준, 게시자 여부(yes/no) 및 이메일 주소를 포함할 수 있습니다. CSV 파일의 형식에 대한 자세한 내용은 [CSV 파일 가져오기 지침](https://help.tableau.com/current/online/ko-kr/csvguidelines.htm)을 참조하십시오.

CSV 파일에 관리자 수준 및 게시자 사용 권한을 포함시키는 대신 `--role` 옵션을 포함시키고 CSV 파일에 나열된 사용자에게 할당하려는 사이트 역할을 지정하여 액세스 수준 정보를 전달할 수 있습니다.

기본적으로 사용자는 관리자가 로그인한 사이트에 추가됩니다. 사용자를 다른 사이트에 추가하려면 `--site` 전역 옵션을 포함시키고 사이트를 지정합니다. (지정한 사이트에서 사용자를 만들 수 있는 사용 권한이 있어야 합니다.)

**예**

`tabcmd createsiteusers "users.csv" --role "Explorer"`

### 옵션

`--admin-type`

사용 중단되었습니다. 대신 `--role` 옵션을 사용하십시오.

`--auth-type`

`.csv` 파일에 있는 모든 사용자에 대한 인증 유형(`TableauID` 또는 `SAML`)을 설정합니다. 지정되지 않으면 기본값은 `TableauID`입니다.

**참고:** SAML 인증을 사용하려면 사이트 자체도 SAML을 지원해야 합니다. 자세한 내용은 [사이트 또는 TCM에서 SAML 인증 사용](https://help.tableau.com/current/online/ko-kr/saml_config_site.htm)을 참조하십시오.

`--[no-]complete`

사용 중단되었습니다. 기본 오류 동작: 10행 범위 내에 오류가 3개 이상 있으면 명령이 실패합니다.

`--no-publisher`

사용 중단되었습니다. 대신 `--role` 옵션을 사용하십시오.

`--nowait`

비동기 작업이 완료될 때까지 기다리지 않습니다.

`--publisher`

사용 중단되었습니다. 대신 `--role` 옵션을 사용하십시오.

`--role`

`.csv` 파일의 모든 사용자에 대한 사이트 역할을 지정합니다. --role 옵션을 사용하여 사이트 역할을 할당하려면 각 사이트 역할에 대해 별도의 CSV 파일을 만듭니다.

유효한 값은 `ServerAdministrator`, `SiteAdministratorCreator`, `SiteAdministratorExplorer`, `SiteAdministrator`, `Creator`, `ExplorerCanPublish`, `Publisher`, `Explorer`, `Interactor`, `Viewer` 및 `Unlicensed`입니다.

기본값은 새 사용자에 대해서는 `Unlicensed`이며 기존 사용자에 대해 변경되지 않습니다. 사용자 기반 서버 설치 환경에서 `createsiteusers` 명령을 사용하여 새로운 사용자를 만들 때 사용자에 대한 라이선스 수가 한도에 도달한 경우에도 사용자가 라이선스 없음으로 추가됩니다.

**참고:** 다중 사이트 Tableau Server에서 `--role` 옵션을 사용하여 `ServerAdministrator` 사이트 역할을 할당하려면 `createsiteusers` 대신 [`createusers`](#createusers) 명령을 사용하십시오.

`--silent-progress`

명령의 진행률 메시지를 표시하지 않습니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## delete _workbook-name_ 또는 _datasource-name_

서버에서 지정된 통합 문서 또는 데이터 원본을 삭제합니다.

이 명령은 통합 문서 또는 데이터 원본이 게시되었을 때의 파일 이름이 아닌 서버에서 사용되는 통합 문서 또는 데이터 원본의 이름을 그대로 사용합니다.

**예**

`tabcmd delete "Sales_Analysis"`

### 옵션

`-r`, `--project`

삭제할 통합 문서 또는 데이터 원본이 포함된 프로젝트의 이름입니다. 지정되지 않은 경우 "기본" 프로젝트로 간주됩니다.

`--parent-project-path`

`-r` 옵션으로 지정된 중첩 프로젝트의 상위 프로젝트 이름을 지정합니다. 예를 들어 "Main" 프로젝트에 존재하는 "Nested" 프로젝트를 지정하려면 `--parent-project-path "Main" -r "Nested"` 구문을 사용합니다.

`--workbook`

삭제할 통합 문서의 이름입니다.

`--datasource`

삭제할 데이터 원본의 이름입니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deleteextracts

게시된 통합 문서 또는 데이터 원본에 대한 추출을 삭제합니다.

### 옵션

`-d`, `--datasource`

추출 삭제를 위한 대상 데이터 원본의 이름입니다.

`--embedded-datasources`

대상 통합 문서에 내장된 데이터 원본 이름의 공백으로 구분된 목록입니다. 데이터 원본 이름에 공백이 있는 경우 큰따옴표로 묶습니다. 통합 문서의 추출을 삭제할 때만 사용할 수 있습니다.

`--encrypt`

암호화된 추출을 만듭니다.

`--include-all`

대상 통합 문서에 내장된 모든 데이터 원본을 포함합니다.

`--parent-project-path`

대상 리소스를 포함하는 프로젝트의 상위 프로젝트에 대한 경로입니다. --project를 사용하여 프로젝트 이름을 지정해야 합니다.

`--project`

대상 리소스를 포함하는 프로젝트 이름입니다. --workbook 또는 --datasource가 지정된 경우에만 필요합니다. 지정되지 않은 경우 기본 프로젝트 'Default'가 사용됩니다.

`-u`, `-url`

URL에 나타나는 리소스의 정규 이름입니다.

`-w`, `-workbook`

추출 삭제를 위한 대상 통합 문서의 이름입니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deletegroup _group-name_

서버에서 지정된 그룹을 삭제합니다.

**예**

`tabcmd deletegroup "Development"`

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deleteproject _project-name_

서버에서 지정된 프로젝트를 삭제합니다.

`tabcmd`를 사용하여 프로젝트 계층에서 최상위 프로젝트만 지정할 수 있습니다. 상위 프로젝트 내의 프로젝트에 수행할 작업을 자동화하려면 해당하는 Tableau [REST API](https://help.tableau.com/current/api/rest_api/en-us/help.htm#REST/rest_api_ref.htm%23API_Reference "REST API 참조가 새 브라우저 탭에서 열립니다.") 호출을 사용합니다.

**예**

`tabcmd deleteproject "Designs"`

### 옵션

`--parent-project-path`

명령으로 지정된 중첩 프로젝트의 상위 프로젝트 이름을 지정합니다. 예를 들어 "Main" 프로젝트에 존재하는 "Designs" 프로젝트를 지정하려면 `--parent-project-path "Main" "Designs"` 구문을 사용합니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deletesiteusers _filename.csv_

현재 로그인되어 있는 사이트에서 사용자를 제거합니다. 제거될 사용자는 한 줄에 사용자 이름 하나가 있는 간단한 목록을 포함하는 파일에 지정되어 있습니다. (사용자 이름 이외의 어떠한 추가 정보도 필요하지 않습니다.)

서버에 사이트가 하나만 있거나 사용자가 한 사이트에만 속하는 경우 기본적으로 사용자가 서버에서도 제거됩니다. Tableau Server 엔터프라이즈 설치에서 서버에 다중 사이트가 포함된 경우 **서버 관리자** 사이트 역할이 할당된 사용자가 사이트에서 제거되지만 서버에서는 제거되지 않습니다.

사용자가 콘텐츠를 소유하는 경우 사용자의 역할이 **라이선스 없음**으로 변경되고 사용자가 서버 또는 사이트에서 제거되지 않습니다. 콘텐츠는 해당 사용자가 계속 소유합니다. 사용자를 완전히 제거하려면 콘텐츠의 소유자를 변경한 다음 사용자를 다시 제거해야 합니다.

**예**

`tabcmd deletesiteusers "users.csv"`

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## export

Tableau Cloud에서 뷰 또는 통합 문서를 내보내 파일로 저장합니다. 이 명령으로 뷰에 사용된 데이터만 내보낼 수도 있습니다. 뷰 데이터 내보내기는 요약 수준에서 수행됩니다. 세부 수준 데이터를 내보내려면 Tableau Server UI를 사용해야 합니다. 자세한 내용은 [뷰 및 통합 문서 다운로드](https://help.tableau.com/current/pro/desktop/ko-kr/export.htm)를 참조하십시오.

이 명령을 사용할 때는 다음 사항에 유의합니다.

- **사용 권한**: 내보내려면 이미지 내보내기 권한이 있어야 합니다. 기본적으로 이 사용 권한은 모든 역할에 대해 허용되거나 상속되지만 통합 문서 또는 뷰별로 사용 권한을 설정할 수 있습니다.
- **데이터 내보내기**: 뷰에 사용된 데이터만 내보내려면 `--csv` 옵션을 사용합니다. 이 옵션은 뷰에 사용된 요약 데이터를 .csv 파일로 내보냅니다.
- **내보낼 뷰, 통합 문서 또는 데이터 지정**:
    
    - URL 일부를 사용하여 내보낼 대상을 지정합니다. 구체적으로, 통합 문서 또는 뷰의 URL에 나타나는 `"workbook/view"` 문자열을 지정합니다. "식별 이름"을 사용해서는 안 되며 URL 끝에 있는 `:iid=_<n>_` 세션 ID를 제외하십시오.
        
        예를 들어 _슈퍼스토어_ 통합 문서에 있는 Tableau 샘플 뷰 _주문 세부 정보_에는 다음과 유사한 URL이 있습니다. `<server_name>/#/views/Superstore/OrderDetails?:iid=2`
        
        _주문 세부 정보_ 뷰를 내보내려면 문자열 `Superstore/OrderDetails`를 사용하십시오.
        
        `Superstore/Order Details` 또는 `Superstore/OrderDetails?:iid=2`를 사용해서는 _안 됩니다._
    - 서버에서 다중 사이트를 실행 중이며 뷰 또는 통합 문서가 기본값이 아닌 사이트에 있는 경우 `-t <site_id>`를 사용합니다.
    - 통합 문서를 내보내려면 통합 문서의 뷰를 열어 URL 문자열을 얻은 다음 사용하는 문자열에 뷰를 포함시킵니다.
        
        위 예에서 _슈퍼스토어_ 통합 문서를 내보내려면 문자열 `Superstore/OrderDetails`를 사용하십시오.
    - 통합 문서를 내보내려면 Tableau Desktop 게시 대화 상자에서 탭으로 시트 표시를 선택하고 통합 문서를 게시했어야 합니다.
        
        **참고:** [관리 뷰](https://help.tableau.com/current/online/ko-kr/adminview.htm)를 포함하는 Tableau 통합 문서는 내보낼 수 없습니다.
    - 다운로드한 데이터를 필터링하려면 다음 형식을 사용하여 매개 변수 필터를 추가합니다.
        
        ?<filter\_name>=value
        
        또는 매개 변수를 필터링하고 해당 매개 변수에 측정값 또는 차원의 이름과 일치하는 표시 이름이 있는 경우:
        
        `?Parameters.<filter_name>=value`
- 저장된 파일의 형식: 형식 옵션은 내보내는 항목에 따라 결정됩니다. 통합 문서는 `--fullpdf`인수를 사용하여 PDF로만 내보낼 수 있습니다. 뷰를 PDF(`--pdf`) 또는 PNG(`--png`)로 내보낼 수 있습니다.
- **저장된 파일의 이름 및 위치**(선택 사항): 이름을 제공하지 않으면 뷰 또는 통합 문서 이름에서 이름이 파생됩니다. 위치를 제공하지 않으면 파일이 현재 작업 디렉터리에 저장됩니다. 그렇지 않고 전체 경로나 현재 작업 디렉터리에 상대적인 경로를 지정할 수 있습니다.
    
    **참고**: `.csv` 또는 `.pdf` 같은 파일 이름 확장명을 포함시켜야 합니다. 이 명령에서는 사용자가 제공한 파일 이름에 자동으로 확장명을 추가하지 않습니다.
- **대시보드 웹 페이지 개체가 PDF 내보내기에 포함되지 않음**: 필요한 경우 대시보드에 웹 페이지 개체가 포함될 수 있습니다. 웹 페이지 개체가 포함된 대시보드를 PDF로 내보내는 경우 웹 페이지 개체는 PDF에 포함되지 않습니다.
- **ASCII 이외의 문자와 비표준 ASCII 문자 및 PDF 내보내기**: ASCII 문자 집합 외의 문자 또는 비표준 ASCII 문자를 포함하는 이름의 뷰 또는 통합 문서를 내보내는 경우 문자를 URL 인코딩(퍼센트 인코딩)해야 합니다.
    
    예를 들어 명령에 `Zürich` 도시가 포함된 경우 이를 `Z%C3%BCrich`로 URL 인코딩해야 합니다.
    
    `tabcmd export "/Cities/Sheet1?locationCity=Z%C3%BCrich" -fullpdf`

**캐시를 지워 실시간 데이터 사용**

필요한 경우 URL 매개 변수 `?:refresh=yes`를 추가하여 캐시에서 결과를 가져오는 대신 데이터 쿼리를 새로 고칠 수 있습니다. 직접 작성한 스크립트에 tabcmd를 사용하며 `refresh` URL 매개 변수를 많이 사용하는 경우 성능이 저하될 수 있습니다. 예를 들어 전체 통합 문서 대신 단일 대시보드에서 실시간 데이터가 필요한 경우에만 `refresh`를 사용하는 것이 좋습니다.

**예**

_뷰_

`tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report.csv"`

`tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"`

`tabcmd export "Finance/InvestmentGrowth" --png`

`tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png`

_통합 문서_

`tabcmd export "Q1Sales/Sales_Report" --fullpdf`

`tabcmd export "Sales/Sales_Analysis" --fullpdf --pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"`

### 옵션

`-f`, `--filename`

주어진 파일 이름과 확장명으로 파일을 저장합니다.

`--csv`

뷰에만 해당. 뷰의 데이터(요약 데이터)를 `.csv` 형식으로 내보냅니다.

`--pdf`

뷰에만 해당. PDF로 내보냅니다.

`--png`

뷰에만 해당. 이미지를 `.png` 형식으로 내보냅니다.

`--fullpdf`

통합 문서에만 해당. PDF로 내보냅니다. 탭으로 시트 표시를 사용으로 설정한 상태로 통합 문서를 게시했어야 합니다.

`--pagelayout`

내보낸 PDF의 페이지 방향(`landscape` 또는 `portrait`)을 설정합니다. 지정하지 않으면 Tableau Desktop 설정이 사용됩니다.

`--pagesize`

내보낸 PDF의 페이지 크기를 `unspecified`, `letter`, `legal`, `note folio`, `tabloid`, `ledger`, `statement`, `executive`, `a3`, `a4`, `a5`, `b4`, `b5` 또는 `quarto` 중 하나로 설정합니다. 기본값은 `letter`입니다.

`--width`

너비를 픽셀 단위로 설정합니다. 기본값은 800 px입니다.

`--height`

높이를 픽셀 단위로 설정합니다. 기본값은 600 px입니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## get _url_

Tableau Cloud에서 지정된(부분) URL이 나타내는 리소스를 가져옵니다. 결과는 파일로 반환됩니다.

이 명령을 사용할 때는 다음 사항에 유의합니다.

- **사용 권한**: 파일을 가져오려면 다른 이름으로 다운로드/웹 저장 권한이 있어야 합니다. 기본적으로 이 사용 권한은 모든 역할에 대해 허용되거나 상속되지만 통합 문서 또는 뷰별로 사용 권한을 설정할 수 있습니다.
- **가져올 뷰 또는 통합 문서 지정**: 가져올 뷰를 지정할 때는 `"/views/<workbookname>/<viewname>.<extension>"`문자열을 사용하고 가져올 통합 문서를 지정할 때는 `"/workbooks/<workbookname>.<extension>"` 문자열을 사용합니다. `<workbookname>` 및 `<viewname>`을 브라우저에서 뷰를 열 때 URL에 표시되는 통합 문서 및 뷰의 이름으로 바꾸고 <extension>을 저장할 파일의 형식으로 바꿉니다. URL의 끝에 있는 세션 ID(`?:iid=<n>`)나 통합 문서 또는 뷰의 "식별" 이름을 사용하지 마십시오.
    
    예를 들어 _Metrics Summary_이라는 이름의 통합 문서에서 _Regional Totals_라는 뷰를 여는 경우 표시되는 URL은 다음과 유사합니다.
    
    `/views/MetricsSummary_1/RegionalTotals?:iid=1`
    
    뷰를 가져오려면 `/views/MetricsSummary_1/RegionalTotals.<extension>` 문자열을 사용합니다.
    
    통합 문서를 가져오려면 `/workbooks/MetricsSummary_1.<extension>` 문자열을 사용합니다.
    
    Tableau Cloud에서 통합 문서 및 뷰를 다운로드할 때 .twb 또는 .twbx 파일의 콘텐츠는 일반 텍스트로 저장됩니다. 데이터에 의미 있는 단서가 될 수 있는 필터 값을 비롯한 모든 데이터는 파일을 여는 모든 사용자가 읽을 수 있습니다.
- **파일 확장명**: URL에는 파일 확장명이 포함되어야 합니다. 확장명에 따라 반환되는 항목이 결정됩니다. 뷰는 PDF, PNG 또는 CSV(요약 데이터만) 형식으로 반환될 수 있습니다. Tableau 통합 문서는 게시된 데이터 원본에 연결하거나 라이브 연결을 사용할 경우 TWB로 반환되고 데이터 추출에 연결할 경우 TWBX로 반환됩니다.
    
    **참고**: 뷰를 PDF 또는 PNG 파일로 다운로드하려는 경우 .pdf 또는 .png 확장명을 포함하는 `--filename` 매개 변수를 포함시키면 URL에 .pdf 또는 .png 확장명을 포함시킬 필요가 없습니다.
- **저장된 파일의 이름 및 위치**(선택 사항): `--filename`에 사용하는 이름에는 파일 확장명이 포함되어야 합니다. 이름과 파일 확장명을 제공하지 않으면 둘 다 URL 문자열에서 파생됩니다. 위치를 제공하지 않으면 파일이 현재 작업 디렉터리에 저장됩니다. 그렇지 않고 전체 경로나 현재 작업 디렉터리에 상대적인 경로를 지정할 수 있습니다.
- **PNG 크기**(선택 사항): 저장된 파일이 PNG인 경우 URL에 크기(픽셀)를 지정할 수 있습니다.

**캐시를 지워 실시간 데이터 사용**

필요한 경우 URL 매개 변수 `?:refresh=yes`를 추가하여 캐시에서 결과를 가져오는 대신 데이터 쿼리를 새로 고칠 수 있습니다. 직접 작성한 스크립트에 tabcmd를 사용할 경우 `refresh` 매개 변수를 많이 사용하면 성능이 저하될 수 있습니다. 예를 들어 전체 통합 문서 대신 단일 대시보드에서 실시간 데이터가 필요한 경우에만 `refresh`를 사용하는 것이 좋습니다.

**예**

_뷰_

`tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename "Weekly-Report.png"`

`tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f "Q1Growth.pdf"`

`tabcmd get "/views/Finance/InvestmentGrowth" -f "Q1Growth.pdf"`

`tabcmd get "/views/Finance/InvestmentGrowth.csv"`

`tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f growth.png`

`tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f growth.png`

_통합 문서_

`tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_Workbooks\Weekly-Reports.twb"`

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## login

**중요:** tabcmd 1.0은 MFA(다단계 인증)를 지원하지 않습니다. Tableau Cloud에서 tabcmd를 사용하려면 [Tableau tabcmd 2.0](https://tableau.github.io/tabcmd)(새 창)을 사용하십시오. Tableau Cloud 및 MFA에 대한 자세한 내용은 [다단계 인증 및 Tableau Cloud](https://help.tableau.com/current/online/ko-kr/to_security_mfa.htm)를 참조하십시오.

Tableau Cloud 사용자를 로그인합니다.

`--server`, `--site`, `--username`, `--password` 전역 옵션을 사용하여 세션을 만듭니다.

**참고**: 사이트가 SAML을 사용하도록 구성되어 있어도 **tabcmd login** 명령을 사용할 경우 SAML SSO(Single Sign-On)를 사용할 수 없습니다. 로그인하려면 사이트에서 만들어진 사용자의 사용자 이름과 암호를 전달해야 합니다. 그러면 로그인에 사용한 Tableau Cloud 사용자의 사용 권한을 가지게 됩니다.

세션을 만드는 데 이미 사용한 동일한 정보를 사용하여 로그인할 경우 `--password` 옵션만 지정합니다. 쿠키에 저장된 서버 및 사용자 이름이 사용됩니다.

서버에서 80(기본값) 이외의 포트를 사용 중인 경우 해당 포트를 지정해야 합니다.

서버에서 다중 사이트를 실행 중이고 기본 사이트 이외의 사이트에 로그인할 경우에만 `--site`(`-t`) 옵션이 필요합니다. 비밀번호를 제공하지 않는 경우 비밀번호를 제공하라는 메시지가 표시됩니다. `--no-prompt`옵션이 지정되고 암호가 제공되지 않은 경우 명령이 실패합니다.

로그인하면 세션이 서버에서 만료되거나 `logout` 명령을 실행할 때까지 세션이 계속됩니다.

**예**

지정된 사이트 ID로 Tableau Cloud 사이트에 로그인합니다.

`tabcmd login -s https://prod-useast-b.online.tableau.com -t siteID -u user@email.com -p password`

### 옵션

`-s`, `--server`

네트워크에 있는 Tableau Server 컴퓨터에서 명령을 실행하는 경우 `http://localhost`를 사용할 수 있습니다. 그렇지 않은 경우 `http://bigbox.myco.com` 또는 `http://bigbox`와 같이 컴퓨터의 URL을 지정합니다.

서버에서 SSL을 사용 중인 경우 컴퓨터의 URL에 `https://`를 지정해야 합니다.

Tableau Cloud의 경우 포드를 포함하여 사이트가 배포되는 전체 URL을 지정합니다. 예: `https://prod-useast-b.online.tableau.com`.

`-t`, `--site`

서버에 다중 사이트가 있고 기본 사이트 이외의 사이트에 로그인할 경우에는 이 옵션을 포함합니다.

사이트 ID는 사이트를 고유하게 식별하기 위해 URL에 사용됩니다. 예를 들어 이름이 West Coast Sales인 사이트의 사이트 ID는 west-coast-sales일 수 있습니다.

`-u`, `--username`

로그인하는 사용자의 이름입니다. Tableau Cloud의 경우 사용자의 이메일 주소가 사용자 이름입니다.

`-p`, `--password`

에 대해 지정된 사용자의 암호입니다`--username`. 비밀번호를 제공하지 않는 경우 비밀번호를 제공하라는 메시지가 표시됩니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `filename.txt` 파일에 암호를 저장할 수 있습니다.

`-x`, `--proxy`

tabcmd 요청의 HTTP 프록시 서버 및 포트(호스트:포트)를 지정하기 위해 사용합니다.

`--no-prompt`

비밀번호 입력 메시지를 표시하지 않습니다. 비밀번호가 지정되지 않으면 `login` 명령이 실패합니다.

`--cookie`

로그인에 대한 세션 ID를 저장합니다. 이후 명령 실행 시 로그인할 필요가 없습니다. 이 값이 명령의 기본값입니다.

`--no-cookie`

성공적으로 로그인한 후 세션 ID 정보를 저장하지 않습니다. 이후 명령 실행 시 로그인해야 합니다.

`--timeout SECONDS`

`login`명령이 처리될 때까지 서버에서 기다리는 시간(초)입니다. 기본값은 30초입니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## logout

서버에서 로그아웃합니다.

**예**

`tabcmd logout`

## publish _filename.twb(x)_, _filename.tds(x)_ 또는 _filename.hyper_

지정된 통합 문서(.twb(x)), 데이터 원본(.tds(x)) 또는 추출(.hyper)을 Tableau Cloud에 게시합니다.

통합 문서를 게시하는 경우 기본적으로 통합 문서의 모든 시트는 데이터베이스 사용자 이름 또는 비밀번호 없이 게시됩니다.

통합 문서 또는 데이터 원본에 초기에 할당되는 사용 권한은 파일이 게시되는 프로젝트에서 복사됩니다. 파일이 게시된 후 게시된 리소스의 사용 권한을 변경할 수 있습니다. 

통합 문서에 사용자 필터가 포함된 경우 축소판 옵션 중 하나를 지정해야 합니다.

**참고:** 현재 tabcmd를 사용한 확장형 데이터 원본 또는 통합형 데이터 원본 게시는 지원되지 않습니다. tabcmd를 사용하여 통합형 통합 문서 또는 데이터 원본 파일을 게시하면 서버의 상위 파일에 제대로 연결되지 않습니다.

**예**

`tabcmd publish "analysis_sfdc.hyper" -n "Sales Analysis"   --oauth-username "user-name" --save-oauth`

파일이 tabcmd와 동일한 디렉터리에 있지 않은 경우 파일의 전체 경로를 포함하십시오.

**예**

`tabcmd publish "\\computer\volume\Tableau Workbooks\analysis_sfdc.hyper" -n "Sales Analysis" --oauth-username "username" --save-oauth`

### 옵션

`-n`, `--name`

서버의 통합 문서 또는 데이터 원본 이름입니다. 생략할 경우 통합 문서, 데이터 원본 또는 데이터 추출의 이름은 파일 이름을 따라 지정됩니다.

`-o`, `--overwrite`

서버에 이미 있는 통합 문서, 데이터 원본 또는 데이터 추출을 덮어씁니다.

`-r`, `--project`

통합 문서, 데이터 원본 또는 데이터 추출을 지정된 프로젝트에 게시합니다. 지정되지 않은 경우 "기본" 프로젝트에 게시합니다.

`--parent-project-path`

`-r` 옵션으로 지정된 중첩 프로젝트의 상위 프로젝트 이름을 지정합니다. 예를 들어 "Main" 프로젝트에 존재하는 "Nested" 프로젝트를 지정하려면 `--parent-project-path "Main" -r "Nested"` 구문을 사용합니다.

`--db-username`

이 옵션을 사용하여 통합 문서, 데이터 원본 또는 데이터 추출과 함께 데이터베이스 사용자 이름을 게시합니다.

보호된 OAuth 연결 및 접근 토큰을 통해 데이터에 연결한 경우 `--oauth-username` 옵션을 대신 사용합니다.

`--db-password`

이 옵션을 사용하여 통합 문서, 데이터 원본 또는 추출과 함께 데이터베이스 암호를 게시합니다.

`--save-db-password`

제공된 데이터베이스 암호를 서버에 저장합니다.

`--oauth-username`

사용자 계정의 이메일 주소입니다. 사용자에게 `--name`에 지정된 클라우드 데이터 원본에 대해 저장된 액세스 토큰이 이미 있는 경우 미리 구성된 OAuth 인증을 통해 사용자를 연결합니다. 액세스 토큰은 사용자 기본 설정에서 관리됩니다.

데이터 원본에 대한 기존 OAuth 연결의 경우 `--db-username` 및 `--db-password` 대신 이 옵션을 사용합니다.

`--save-oauth`

`--oauth-username`에 지정된 자격 증명을 게시된 통합 문서 또는 데이터 원본과 함께 내장된 자격 증명으로 저장합니다.

그런 다음 게시자 또는 서버 관리자가 서버에 로그인하여 해당 통합 문서 또는 데이터 원본에 대한 연결을 편집할 때 콘텐츠에 내장된 이 OAuth 자격 증명이 연결 설정에 표시됩니다.

게시 후에 추출 새로 고침을 예약하려면 `--oauth-username`에 이 옵션을 포함해야 합니다. 이는 기존 데이터베이스 연결에서 `--save-db-password`를 사용하는 것과 같습니다.

`--thumbnail-username`

통합 문서에 사용자 필터가 포함된 경우 지정된 사용자가 볼 수 있는 항목을 기준으로 축소판이 생성됩니다. `--thumbnail-group` 옵션이 설정된 경우에는 이 옵션을 지정할 수 없습니다.

`--thumbnail-group`

통합 문서에 사용자 필터가 포함된 경우 지정된 그룹이 볼 수 있는 항목을 기준으로 축소판이 생성됩니다. `--thumbnail-username` 옵션이 설정된 경우에는 이 옵션을 지정할 수 없습니다.

`--tabbed`

탭 보기를 포함하는 통합 문서를 게시하면 각 시트가 Viewer(뷰어)가 통합 문서를 탐색하는 데 사용할 수 있는 탭이 됩니다. 이 설정은 시트 수준 보안을 재정의합니다.

`--append`

기존 데이터 원본에 추출 파일을 추가합니다.

`--replace`

추출 파일을 사용하여 기존 데이터 원본을 대체합니다.

`--disable-uploader`

증분 파일 업로더를 사용하지 않습니다.

`--restart`

파일 업로드를 다시 시작합니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## refreshextracts _workbook-name_ 또는 _datasource-name_

지정된 통합 문서나 데이터 원본에 속해 있는 추출 항목의 전체 또는 증분 새로 고침을 수행합니다.

이 명령은 통합 문서 또는 데이터 원본이 게시되었을 때의 파일 이름이 아닌 서버에서 나타나는 통합 문서 또는 데이터 원본의 이름을 그대로 사용합니다. 관리자 또는 통합 문서나 데이터 원본의 소유자만 이 작업을 수행할 수 있습니다.

**참고:** 

- 서버 관리자가 사이트에서 **지금 실행** 설정을 사용하지 않도록 설정한 경우 이 방법이 실패하고 오류가 발생합니다. 자세한 내용은 [Tableau Server 설정](https://help.tableau.com/current/server/ko-kr/maintenance_set.htm)을 참조하십시오.
- tabcmd를 사용하여 클라우드에서 호스팅되는 지원 데이터 원본을 새로 고칠 수 있습니다. 예를 들어 클라우드 플랫폼 Google Analytics에서 SQL Server, MySQL, PostgreSQL 등이 지원됩니다.
- tabcmd를 사용하여 온프레미스 데이터를 새로 고치려면 데이터 원본이 Tableau Bridge [권장 일정](https://help.tableau.com/current/online/ko-kr/to_sync_schedule.htm)에 대해 구성할 수 있는 유형이어야 합니다. 온프레미스 데이터에 연결하는 다른 모든 데이터 원본의 경우 Bridge 또는 명령줄 데이터 추출 유틸리티를 사용할 수 있습니다. 자세한 내용은 [Bridge를 사용하여 데이터를 최신 상태로 유지](https://help.tableau.com/current/online/ko-kr/qs_refresh_local_data.htm) 및 [명령줄에서 추출 새로 고침 작업 자동화](https://help.tableau.com/current/online/ko-kr/to_refresh_extract_commandline.htm)를 참조하십시오.

**예**

tabcmd refreshextracts --datasource sales\_ds

tabcmd refreshextracts --project "Sales External" --datasource sales\_ds

tabcmd refreshextracts --project "Sales External" --parent-project-path "Main" --project "Sales External" --datasource sales\_ds

tabcmd refreshextracts --workbook "My Workbook"

tabcmd refreshextracts --url SalesAnalysis

tabcmd refreshextracts --workbook "My Workbook" --addcalculations

tabcmd refreshextracts --datasource sales\_ds --removecalculations

### 옵션

`--incremental`

증분 새로 고침 작업을 실행합니다.

`--synchronous`

전체 새로 고침 작업을 백그라운더 프로세스에 사용되는 큐에 추가하여 백그라운더 프로세스를 사용할 수 있게 되는 즉시 실행되게 합니다. 백그라운더 프로세스를 사용할 수 있는 경우 작업이 즉시 실행됩니다. 새로 고침 작업이 백그라운드 작업 보고서에 나타납니다.

동기식 새로 고침 중에 `tabcmd`는 새로 고침 작업이 진행되는 동안 서버와 라이브 연결을 유지하며, 백그라운드 작업이 완료될 때까지 1초에 한 번씩 폴링합니다.

**참고:** Tableau Bridge에서 새로 고친 데이터 원본에는 `--synchronous` 옵션을 사용할 수 없습니다.

`--workbook`

새로 고칠 추출 항목이 들어 있는 통합 문서의 이름입니다. 통합 문서의 이름에 공백이 있으면 이름을 따옴표로 묶습니다.

`--datasource`

새로 고칠 추출 항목이 들어 있는 데이터 원본의 이름입니다.

`--project`

`--workbook`또는 `--datasource`와 함께 사용하여 _기본_ 프로젝트 이외의 프로젝트에 있는 통합 문서나 데이터 원본을 식별합니다. 지정되지 않은 경우 기본 프로젝트로 간주됩니다.

`--parent-project-path`

`--project` 옵션으로 지정된 중첩 프로젝트의 상위 프로젝트 이름을 지정합니다.

예를 들면 다음과 같습니다.

- "Main" 프로젝트에 존재하는 "Nested" 프로젝트를 지정하려면 다음 구문을 사용합니다.
- \--parent-project-path "Main" --project "Nested"
- "Nested" 프로젝트 안에 중첩되어 있는 "Nested2" 프로젝트를 지정하려면 다음 구문을 사용합니다.
- \--parent-project-path "Main/Nested" --project "Nested2"

`--url`

URL에 나타나는 통합 문서의 이름입니다. "Sales Analysis"로 게시된 통합 문서의 URL 이름은 "SalesAnalysis"입니다.

`--addcalculations`

`--workbook`을 함께 사용하여 통합 문서의 내장된 추출에서 계산을 구체화하거나 `--datasource`를 사용하여 추출 데이터 원본의 계산을 구체화합니다. 백그라운더 프로세스에 사용되는 대기열에 작업을 추가합니다. 백그라운더 프로세스를 사용할 수 있는 경우 작업이 즉시 실행됩니다. 이 작업은 [추출용 백그라운드 작업](https://help.tableau.com/current/online/ko-kr/adminview_backgrnd.htm) 관리 뷰에 표시됩니다.

`--removecalculations`

이전에 구체화된 계산을 제거하려면 `--workbook` 또는 `--datasource`를 함께 사용합니다. 백그라운더 프로세스에 사용되는 대기열에 작업을 추가합니다. 백그라운더 프로세스를 사용할 수 있는 경우 작업이 즉시 실행됩니다. 이 작업은 [추출용 백그라운드 작업](https://help.tableau.com/current/online/ko-kr/adminview_backgrnd.htm) 관리 뷰에 표시됩니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## removeusers _group-name_

지정된 그룹에서 사용자를 제거합니다.

**예**

`tabcmd removeusers "Development" --users "users.csv"`

### 옵션

`--users`

지정된 그룹에서 주어진 `.csv` 파일에 있는 사용자를 제거합니다. 파일은 라인당 사용자 이름이 하나씩 있는 간단한 목록이어야 합니다.

`--[no-]complete`

모든 행이 유효해야만 변경됩니다. 이 옵션이 지정되지 않으면 `--complete`가 사용됩니다.

전역 옵션

다음 옵션은 모든 `tabcmd` 명령에서 사용됩니다. 세션을 시작하려면 `--server`, `--user` 및 `--password` 옵션이 최소 한 번은 필요합니다. 이러한 옵션을 포함하지 않고 후속 명령을 실행할 수 있도록 인증 토큰이 저장됩니다. 이 토큰은 토큰이 사용된 마지막 명령 이후 5분 동안 유효한 상태를 유지합니다.

`-h`, `--help`

명령에 대한 도움말을 표시합니다.

**참고:** 나열된 명령 중 일부는 Tableau Cloud에서 tabcmd를 사용할 때 적용할 수 없습니다.

`-s`, `--server`

Tableau Cloud URL이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-u`, `--user`

Tableau Cloud 사용자 이름이며 세션을 시작하려면 최소 한 번은 필요합니다.

`-p`, `--password`

Tableau Cloud 암호이며 세션을 시작하려면 최소 한 번은 필요합니다.

`--password-file`

보안 강화를 위해 명령줄이 아닌 주어진 `.txt` 파일에 암호를 저장할 수 있습니다.

`-t`, `--site`

명령이 작은따옴표나 큰따옴표로 묶인 Tableau Cloud 사이트 ID로 지정된 사이트에 적용됨을 나타냅니다. 지정된 사용자가 둘 이상의 사이트에 연결된 경우에만 이 옵션을 사용합니다. 캐시된 인증 토큰 사용 시 사이트 ID는 대/소문자를 구분합니다. 대/소문자가 일치하지 않는 경우 토큰이 여전히 유효한 경우에도 암호를 묻는 메시지가 나타날 수 있습니다.

`--no-prompt`

이 옵션이 지정되면 명령에서 암호를 묻는 메시지를 표시하지 않습니다. 올바른 암호가 제공되지 않으면 명령이 실패합니다.

`--[no-]cookie`

이 옵션이 지정되면 로그인 시 세션 ID가 저장되므로 후속 명령에서 로그인을 필요로 하지 않습니다. 세션 ID를 저장하지 않으려면 `no-` 접두사를 사용합니다. 기본적으로 세션이 저장됩니다.

`--timeout`

서버에서 명령 처리를 완료할 때까지 지정된 시간(초) 동안 기다립니다. 기본적으로 프로세스는 서버가 응답할 때까지 기다립니다.

`--`

명령줄에서 옵션의 끝을 지정합니다. `--`을 사용하면 `tabcmd`에 `--` 다음에 나오는 모든 항목을 옵션 설정으로 해석하는 것이 아니라 명령의 값으로 해석하도록 지정할 수 있습니다. 명령에 하이픈을 포함하는 값을 지정해야 할 경우 유용합니다. 다음 예에서는 `-430105/Sheet1`이 `export` 명령에 필요한 값인 `tabcmd` 명령에서 `--`을 사용하는 방법을 보여 줍니다.

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

**팁**: Tableau Server에서 사용할 수 있는 Tabcmd 1.0 명령은 [tabcmd 명령](https://help.tableau.com/current/server/ko-kr/tabcmd_cmd.htm)을 참조하십시오.