다음을 통해 공유


az storage file copy

Note

이 명령 그룹에는 Azure CLI 및 하나 이상의 확장 모두에 정의된 명령이 있습니다. 확장된 기능을 활용하려면 각 확장을 설치합니다. 확장 프로그램에 대해 자세히 알아보세요.

파일 복사 작업을 관리합니다.

명령

Name Description 형식 상태
az storage file copy cancel

진행 중인 복사 작업을 중단합니다.

Core GA
az storage file copy cancel (storage-preview 확장)

진행 중인 복사 작업을 중단합니다.

Extension GA
az storage file copy start

파일을 비동기적으로 복사합니다.

Core GA
az storage file copy start (storage-preview 확장)

파일을 비동기적으로 복사합니다.

Extension GA
az storage file copy start-batch

여러 파일 또는 Blob을 파일 공유에 복사합니다.

Core GA
az storage file copy start-batch (storage-preview 확장)

여러 파일 또는 Blob을 파일 공유에 복사합니다.

Extension GA

az storage file copy cancel

진행 중인 복사 작업을 중단합니다.

이렇게 하면 길이가 0인 대상 파일과 전체 메타데이터가 남습니다. 복사 작업이 이미 종료된 경우 오류가 발생합니다.

az storage file copy cancel --copy-id
                            --destination-path
                            --destination-share
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--backup-intent --enable-file-backup-request-intent]
                            [--connection-string]
                            [--disallow-trailing-dot {false, true}]
                            [--file-endpoint]
                            [--sas-token]
                            [--timeout]

필수 매개 변수

--copy-id

중단할 복사 작업입니다. ID 또는 FileProperties 인스턴스일 수 있습니다.

--destination-path -p

파일 공유 내의 파일 경로입니다.

--destination-share -s

대상 공유의 이름입니다. 공유가 있어야 합니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--account-key

스토리지 계정 키입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

속성
매개 변수 그룹: Storage Account Arguments
--account-name

스토리지 계정 이름입니다. 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 초과할 수 있습니다.

속성
매개 변수 그룹: Storage Account Arguments
--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

속성
허용되는 값: key, login
--backup-intent --enable-file-backup-request-intent

파일용 OAuth(Azure AD) 인증과 함께 사용하는 데 필요한 매개 변수입니다. 이렇게 하면 해당 파일/디렉터리에 대한 ACL이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.

속성
Default value: False
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

속성
매개 변수 그룹: Storage Account Arguments
--disallow-trailing-dot

true이면 후행 점이 대상 URI에서 잘립니다. 기본값은 False입니다.

속성
Default value: False
허용되는 값: false, true
--file-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. az storage account show사용하여 각 서비스 기본 엔드포인트를 찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

속성
매개 변수 그룹: Storage Account Arguments
--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

속성
매개 변수 그룹: Storage Account Arguments
--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az storage file copy cancel (storage-preview 확장)

진행 중인 복사 작업을 중단합니다.

이렇게 하면 길이가 0인 대상 파일과 전체 메타데이터가 남습니다. 복사 작업이 이미 종료된 경우 오류가 발생합니다.

az storage file copy cancel --copy-id
                            --destination-path
                            --destination-share
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--backup-intent --enable-file-backup-request-intent]
                            [--connection-string]
                            [--disallow-trailing-dot {false, true}]
                            [--sas-token]
                            [--timeout]

필수 매개 변수

--copy-id

중단할 복사 작업입니다. ID 또는 FileProperties 인스턴스일 수 있습니다.

--destination-path -p

파일 공유 내의 파일 경로입니다.

--destination-share -s

대상 공유의 이름입니다. 공유가 있어야 합니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--account-key

스토리지 계정 키입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

속성
매개 변수 그룹: Storage Account Arguments
--account-name

스토리지 계정 이름입니다. 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 초과할 수 있습니다.

속성
매개 변수 그룹: Storage Account Arguments
--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

속성
허용되는 값: key, login
--backup-intent --enable-file-backup-request-intent

파일용 OAuth(Azure AD) 인증과 함께 사용하는 데 필요한 매개 변수입니다. 이렇게 하면 해당 파일/디렉터리에 대한 ACL이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.

속성
Default value: False
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

속성
매개 변수 그룹: Storage Account Arguments
--disallow-trailing-dot

true이면 후행 점이 대상 URI에서 잘립니다. 기본값은 False입니다.

속성
Default value: False
허용되는 값: false, true
--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

속성
매개 변수 그룹: Storage Account Arguments
--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az storage file copy start

파일을 비동기적으로 복사합니다.

az storage file copy start --destination-path
                           --destination-share
                           [--account-key]
                           [--account-name]
                           [--auth-mode {key, login}]
                           [--backup-intent --enable-file-backup-request-intent]
                           [--connection-string]
                           [--disallow-source-trailing-dot --disallow-src-trailing {false, true}]
                           [--disallow-trailing-dot {false, true}]
                           [--file-endpoint]
                           [--file-mode]
                           [--file-mode-copy-mode {override, source}]
                           [--file-snapshot]
                           [--group]
                           [--metadata]
                           [--owner]
                           [--owner-copy-mode {override, source}]
                           [--sas-token]
                           [--source-account-key]
                           [--source-account-name]
                           [--source-blob]
                           [--source-container]
                           [--source-path]
                           [--source-sas]
                           [--source-share]
                           [--source-snapshot]
                           [--source-uri]
                           [--timeout]

예제

파일을 비동기적으로 복사합니다.

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --account-key 00000000

sas 토큰을 사용하여 원본 URI에서 대상 스토리지 계정으로 파일을 비동기적으로 복사합니다.

az storage file copy start --source-uri "https://srcaccount.file.core.windows.net/myshare/mydir/myfile?<sastoken>" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

sas 토큰을 사용하여 파일 스냅샷에서 대상 스토리지 계정으로 파일을 비동기적으로 복사합니다.

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --file-snapshot "2020-03-02T13:51:54.0000000Z" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

원본 파일 모드, 그룹, 소유자를 사용하여 파일을 복사합니다.

az storage file copy start --source-account-name srcaccount --source-path srcpath --source-share srcshare --destination-path dstpath --destination-share dstshare --owner-copy-mode Source --file-mode-copy-mode Source

재정의된 파일 모드, 그룹, 소유자를 사용하여 파일을 복사합니다.

az storage file copy start --source-account-name srcaccount --source-path srcpath --source-share srcshare --destination-path dstpath --destination-share dstshare --owner-copy-mode Override --file-mode-copy-mode Override --file-mode rw-rw-rw- --owner 4 --group 5

필수 매개 변수

--destination-path -p

파일 공유 내의 파일 경로입니다.

--destination-share -s

대상 공유의 이름입니다. 공유가 있어야 합니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--account-key

스토리지 계정 키입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

속성
매개 변수 그룹: Storage Account Arguments
--account-name

스토리지 계정 이름입니다. 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 초과할 수 있습니다.

속성
매개 변수 그룹: Storage Account Arguments
--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

속성
허용되는 값: key, login
--backup-intent --enable-file-backup-request-intent

파일용 OAuth(Azure AD) 인증과 함께 사용하는 데 필요한 매개 변수입니다. 이렇게 하면 해당 파일/디렉터리에 대한 ACL이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.

속성
Default value: False
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

속성
매개 변수 그룹: Storage Account Arguments
--disallow-source-trailing-dot --disallow-src-trailing

true이면 원본 URI에서 후행 점이 잘립니다. 기본값은 False입니다.

속성
Default value: False
허용되는 값: false, true
--disallow-trailing-dot

true이면 후행 점이 대상 URI에서 잘립니다. 기본값은 False입니다.

속성
Default value: False
허용되는 값: false, true
--file-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. az storage account show사용하여 각 서비스 기본 엔드포인트를 찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

속성
매개 변수 그룹: Storage Account Arguments
--file-mode

파일에 설정할 모드 권한입니다. NFS 파일에만 적용됩니다. 매개 변수 --file-mode-copy-mode Override함께 작동합니다. 기호(rwxrw-rw-)가 지원됩니다. 고정 비트도 지원되며 다른 범주의 실행 비트가 각각 설정되었는지 여부에 따라 최종 문자 위치의 t 또는 T로 표현되며 t 또는 T가 없는 경우 고정 비트가 설정되지 않음을 나타냅니다."

--file-mode-copy-mode

NFS 파일에만 적용됩니다. 복사 원본이 파일인 경우에만 적용됩니다. 대상 파일의 모드 비트에 대한 복사 동작을 결정합니다. 채워지지 않으면 대상 파일에 기본 파일 모드가 있습니다.

속성
허용되는 값: override, source
--file-snapshot

원본 스토리지 계정에 대한 파일 스냅샷입니다.

속성
매개 변수 그룹: Copy Source Arguments
--group

NFS 파일에만 적용됩니다. 매개 변수 --owner-copy-mode Override함께 작동합니다. 디렉터리에 설정할 GID(소유자 그룹 식별자)입니다. 기본값은 0(루트 그룹)입니다.

--metadata

공백으로 구분된 키=값 쌍의 메타데이터입니다. 기존 메타데이터를 덮어씁니다.

--owner

NFS 파일에만 적용됩니다. 매개 변수 --owner-copy-mode Override함께 작동합니다. 디렉터리에 설정할 UID(소유자 사용자 식별자)입니다. 기본값은 0(루트)입니다.

--owner-copy-mode

NFS 파일에만 적용됩니다. 복사 원본이 파일인 경우에만 적용됩니다. 대상 파일의 소유자 및 그룹의 복사 동작을 결정합니다. 채워지지 않으면 대상 파일에 기본 소유자 및 그룹이 있습니다.

속성
허용되는 값: override, source
--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

속성
매개 변수 그룹: Storage Account Arguments
--source-account-key

원본 Blob의 스토리지 계정 키입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-account-name

원본 Blob의 스토리지 계정 이름입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-blob

원본 스토리지 계정의 Blob 이름입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-container

원본 스토리지 계정의 컨테이너 이름입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-path

원본 스토리지 계정의 파일 경로입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-sas

원본 스토리지 계정에 대한 공유 액세스 서명입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-share

원본 스토리지 계정의 공유 이름입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-snapshot

원본 스토리지 계정에 대한 Blob 스냅샷입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-uri -u

Azure 파일 또는 Blob을 지정하는 최대 2KB 길이의 URL입니다. 값은 요청 URI에 표시될 때 URL로 인코딩되어야 합니다. 원본이 다른 계정에 있는 경우 원본은 공용이거나 공유 액세스 서명을 통해 인증되어야 합니다. 원본이 공용인 경우 인증이 필요하지 않습니다. 예: https://myaccount.file.core.windows.net/myshare/mydir/myfilehttps://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken.

속성
매개 변수 그룹: Copy Source Arguments
--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az storage file copy start (storage-preview 확장)

파일을 비동기적으로 복사합니다.

az storage file copy start --destination-path
                           --destination-share
                           [--account-key]
                           [--account-name]
                           [--auth-mode {key, login}]
                           [--backup-intent --enable-file-backup-request-intent]
                           [--connection-string]
                           [--disallow-source-trailing-dot --disallow-src-trailing {false, true}]
                           [--disallow-trailing-dot {false, true}]
                           [--file-snapshot]
                           [--metadata]
                           [--sas-token]
                           [--source-account-key]
                           [--source-account-name]
                           [--source-blob]
                           [--source-container]
                           [--source-path]
                           [--source-sas]
                           [--source-share]
                           [--source-snapshot]
                           [--source-uri]
                           [--timeout]

예제

파일을 비동기적으로 복사합니다.

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --account-key 00000000

sas 토큰을 사용하여 원본 URI에서 대상 스토리지 계정으로 파일을 비동기적으로 복사합니다.

az storage file copy start --source-uri "https://srcaccount.file.core.windows.net/myshare/mydir/myfile?<sastoken>" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

sas 토큰을 사용하여 파일 스냅샷에서 대상 스토리지 계정으로 파일을 비동기적으로 복사합니다.

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --file-snapshot "2020-03-02T13:51:54.0000000Z" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

필수 매개 변수

--destination-path -p

파일 공유 내의 파일 경로입니다.

--destination-share -s

대상 공유의 이름입니다. 공유가 있어야 합니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--account-key

스토리지 계정 키입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

속성
매개 변수 그룹: Storage Account Arguments
--account-name

스토리지 계정 이름입니다. 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 초과할 수 있습니다.

속성
매개 변수 그룹: Storage Account Arguments
--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

속성
허용되는 값: key, login
--backup-intent --enable-file-backup-request-intent

파일용 OAuth(Azure AD) 인증과 함께 사용하는 데 필요한 매개 변수입니다. 이렇게 하면 해당 파일/디렉터리에 대한 ACL이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.

속성
Default value: False
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

속성
매개 변수 그룹: Storage Account Arguments
--disallow-source-trailing-dot --disallow-src-trailing

true이면 원본 URI에서 후행 점이 잘립니다. 기본값은 False입니다.

속성
Default value: False
허용되는 값: false, true
--disallow-trailing-dot

true이면 후행 점이 대상 URI에서 잘립니다. 기본값은 False입니다.

속성
Default value: False
허용되는 값: false, true
--file-snapshot

원본 스토리지 계정에 대한 파일 스냅샷입니다.

속성
매개 변수 그룹: Copy Source Arguments
--metadata

공백으로 구분된 키=값 쌍의 메타데이터입니다. 기존 메타데이터를 덮어씁니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

속성
매개 변수 그룹: Storage Account Arguments
--source-account-key

원본 Blob의 스토리지 계정 키입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-account-name

원본 Blob의 스토리지 계정 이름입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-blob

원본 스토리지 계정의 Blob 이름입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-container

원본 스토리지 계정의 컨테이너 이름입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-path

원본 스토리지 계정의 파일 경로입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-sas

원본 스토리지 계정에 대한 공유 액세스 서명입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-share

원본 스토리지 계정의 공유 이름입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-snapshot

원본 스토리지 계정에 대한 Blob 스냅샷입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-uri -u

Azure 파일 또는 Blob을 지정하는 최대 2KB 길이의 URL입니다. 값은 요청 URI에 표시될 때 URL로 인코딩되어야 합니다. 원본이 다른 계정에 있는 경우 원본은 공용이거나 공유 액세스 서명을 통해 인증되어야 합니다. 원본이 공용인 경우 인증이 필요하지 않습니다. 예: https://myaccount.file.core.windows.net/myshare/mydir/myfilehttps://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken.

속성
매개 변수 그룹: Copy Source Arguments
--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az storage file copy start-batch

여러 파일 또는 Blob을 파일 공유에 복사합니다.

az storage file copy start-batch [--account-key]
                                 [--account-name]
                                 [--connection-string]
                                 [--destination-path]
                                 [--destination-share]
                                 [--disallow-source-trailing-dot --disallow-src-trailing {false, true}]
                                 [--disallow-trailing-dot {false, true}]
                                 [--dryrun]
                                 [--file-endpoint]
                                 [--metadata]
                                 [--pattern]
                                 [--sas-token]
                                 [--source-account-key]
                                 [--source-account-name]
                                 [--source-container]
                                 [--source-sas]
                                 [--source-share]
                                 [--source-uri]
                                 [--timeout]

예제

파일 공유의 모든 파일을 다른 스토리지 계정에 복사합니다.

az storage file copy start-batch --source-account-name srcaccount --source-account-key 00000000 --source-share srcshare --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --account-key 00000000

파일 공유의 모든 파일을 다른 스토리지 계정에 복사합니다. sas 토큰을 사용합니다.

az storage file copy start-batch --source-uri "https://srcaccount.file.core.windows.net/myshare?<sastoken>" --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--account-key

스토리지 계정 키입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

속성
매개 변수 그룹: Storage Account Arguments
--account-name

스토리지 계정 이름입니다. 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 초과할 수 있습니다.

속성
매개 변수 그룹: Storage Account Arguments
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

속성
매개 변수 그룹: Storage Account Arguments
--destination-path

원본 데이터가 복사되는 디렉터리입니다. 생략하면 데이터가 루트 디렉터리에 복사됩니다.

--destination-share

원본 데이터가 복사되는 파일 공유입니다.

--disallow-source-trailing-dot --disallow-src-trailing

true이면 원본 URI에서 후행 점이 잘립니다. 기본값은 False입니다.

속성
Default value: False
허용되는 값: false, true
--disallow-trailing-dot

true이면 후행 점이 대상 URI에서 잘립니다. 기본값은 False입니다.

속성
Default value: False
허용되는 값: false, true
--dryrun

복사할 파일 및 Blob을 나열합니다. 실제 데이터 전송은 발생하지 않습니다.

속성
Default value: False
--file-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. az storage account show사용하여 각 서비스 기본 엔드포인트를 찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

속성
매개 변수 그룹: Storage Account Arguments
--metadata

공백으로 구분된 키=값 쌍의 메타데이터입니다. 기존 메타데이터를 덮어씁니다.

--pattern

파일 및 Blob을 globbing하는 데 사용되는 패턴입니다. 지원되는 패턴은 '*', '?', '[seq]' 및 '[!seq]'입니다. 자세한 내용은 https://docs.python.org/3/library/fnmatch.html참조하세요.

--pattern에서 '*'를 사용하면 디렉터리 구분 기호 '/'를 비롯한 모든 문자와 일치합니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

속성
매개 변수 그룹: Storage Account Arguments
--source-account-key

원본 스토리지 계정의 계정 키입니다. 생략하면 활성 로그인을 사용하여 계정 키를 확인합니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-account-name

데이터를 복사할 원본 스토리지 계정입니다. 생략하면 대상 계정이 사용됩니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-container

원본 컨테이너 Blob이 복사됩니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-sas

원본 스토리지 계정에 대한 공유 액세스 서명입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-share

원본 공유 파일이 복사됩니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-uri

원본 파일 공유 또는 Blob 컨테이너를 지정하는 URI입니다.

원본이 다른 계정에 있는 경우 원본은 공용이거나 공유 액세스 서명을 통해 인증되어야 합니다.

속성
매개 변수 그룹: Copy Source Arguments
--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az storage file copy start-batch (storage-preview 확장)

여러 파일 또는 Blob을 파일 공유에 복사합니다.

az storage file copy start-batch [--account-key]
                                 [--account-name]
                                 [--connection-string]
                                 [--destination-path]
                                 [--destination-share]
                                 [--disallow-source-trailing-dot --disallow-src-trailing {false, true}]
                                 [--disallow-trailing-dot {false, true}]
                                 [--dryrun]
                                 [--metadata]
                                 [--pattern]
                                 [--sas-token]
                                 [--source-account-key]
                                 [--source-account-name]
                                 [--source-container]
                                 [--source-sas]
                                 [--source-share]
                                 [--source-uri]
                                 [--timeout]

예제

파일 공유의 모든 파일을 다른 스토리지 계정에 복사합니다.

az storage file copy start-batch --source-account-name srcaccount --source-account-key 00000000 --source-share srcshare --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --account-key 00000000

파일 공유의 모든 파일을 다른 스토리지 계정에 복사합니다. sas 토큰을 사용합니다.

az storage file copy start-batch --source-uri "https://srcaccount.file.core.windows.net/myshare?<sastoken>" --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--account-key

스토리지 계정 키입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

속성
매개 변수 그룹: Storage Account Arguments
--account-name

스토리지 계정 이름입니다. 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 초과할 수 있습니다.

속성
매개 변수 그룹: Storage Account Arguments
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

속성
매개 변수 그룹: Storage Account Arguments
--destination-path

원본 데이터가 복사되는 디렉터리입니다. 생략하면 데이터가 루트 디렉터리에 복사됩니다.

--destination-share

원본 데이터가 복사되는 파일 공유입니다.

--disallow-source-trailing-dot --disallow-src-trailing

true이면 원본 URI에서 후행 점이 잘립니다. 기본값은 False입니다.

속성
Default value: False
허용되는 값: false, true
--disallow-trailing-dot

true이면 후행 점이 대상 URI에서 잘립니다. 기본값은 False입니다.

속성
Default value: False
허용되는 값: false, true
--dryrun

복사할 파일 및 Blob을 나열합니다. 실제 데이터 전송은 발생하지 않습니다.

속성
Default value: False
--metadata

공백으로 구분된 키=값 쌍의 메타데이터입니다. 기존 메타데이터를 덮어씁니다.

--pattern

파일 및 Blob을 globbing하는 데 사용되는 패턴입니다. 지원되는 패턴은 '*', '?', '[seq]' 및 '[!seq]'입니다. 자세한 내용은 https://docs.python.org/3.7/library/fnmatch.html참조하세요.

--pattern에서 '*'를 사용하면 디렉터리 구분 기호 '/'를 비롯한 모든 문자와 일치합니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

속성
매개 변수 그룹: Storage Account Arguments
--source-account-key

원본 스토리지 계정의 계정 키입니다. 생략하면 활성 로그인을 사용하여 계정 키를 확인합니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-account-name

데이터를 복사할 원본 스토리지 계정입니다. 생략하면 대상 계정이 사용됩니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-container

원본 컨테이너 Blob이 복사됩니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-sas

원본 스토리지 계정에 대한 공유 액세스 서명입니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-share

원본 공유 파일이 복사됩니다.

속성
매개 변수 그룹: Copy Source Arguments
--source-uri

원본 파일 공유 또는 Blob 컨테이너를 지정하는 URI입니다.

원본이 다른 계정에 있는 경우 원본은 공용이거나 공유 액세스 서명을 통해 인증되어야 합니다.

속성
매개 변수 그룹: Copy Source Arguments
--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False