Get-AzStorageFileCopyState

모듈:

Az.Storage

복사 작업의 상태를 가져옵니다.

구문

Get-AzStorageFileCopyState
   [-ShareName] <String>
   [-FilePath] <String>
   [-WaitForComplete]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzStorageFileCopyState
   [-File] <CloudFile>
   [-ShareFileClient <ShareFileClient>]
   [-WaitForComplete]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

Get-AzStorageFileCopyState cmdlet은 Azure Storage 파일 복사 작업의 상태를 가져옵니다. 복사 대상 파일에서 실행해야 합니다.

예제

예제 1: 파일 이름으로 복사 상태 가져오기

Get-AzStorageFileCopyState -ShareName "ContosoShare" -FilePath "ContosoFile"

이 명령은 지정된 이름을 가진 파일에 대한 복사 작업의 상태를 가져옵니다.

예제 2: 복사 및 파이프라인을 시작하여 복사 상태를 가져옵니다.

$destfile = Start-AzStorageFileCopy -SrcShareName "contososhare" -SrcFilePath "contosofile" -DestShareName "contososhare2" -destfilepath "contosofile_copy"  

$destfile | Get-AzStorageFileCopyState

첫 번째 명령은 "contosofile" 파일을 "contosofile_copy"에 복사하고 destiantion 파일 개체를 출력합니다. 두 번째 명령 파이프라인은 파일 복사 상태를 가져오기 위해 Get-AzStorageFileCopyState에 대한 destiantion 파일 개체입니다.

매개 변수

-ClientTimeoutPerRequest

하나의 서비스 요청에 대한 클라이언트 쪽 제한 시간 간격(초)을 지정합니다. 이전 호출이 지정된 간격으로 실패하면 이 cmdlet은 요청을 다시 시도합니다. 이 cmdlet이 간격이 경과하기 전에 성공적인 응답을 받지 못하면 이 cmdlet은 오류를 반환합니다.

형식:	Nullable<T>[Int32]
별칭:	ClientTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ConcurrentTaskCount

최대 동시 네트워크 호출을 지정합니다. 이 매개 변수를 사용하여 동시 네트워크 호출의 최대 수를 지정하여 로컬 CPU 및 대역폭 사용을 제한하는 동시성을 제한할 수 있습니다. 지정된 값은 절대 개수이며 코어 수를 곱하지 않습니다. 이 매개 변수는 초당 100킬로비트와 같은 낮은 대역폭 환경에서 네트워크 연결 문제를 줄이는 데 도움이 될 수 있습니다. 기본값은 10입니다.

형식:	Nullable<T>[Int32]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Context

Azure Storage 컨텍스트를 지정합니다. 컨텍스트를 가져오려면 New-AzStorageContext cmdlet을 사용합니다.

형식:	IStorageContext
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:	IAzureContextContainer
별칭:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisAllowTrailingDot

접미사 디렉터리 및 파일 이름에 후행 점(.)을 허용하지 않습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-File

CloudFile 개체를 지정합니다. Get-AzStorageFile cmdlet을 사용하여 클라우드 파일을 만들거나 가져올 수 있습니다.

형식:	CloudFile
별칭:	CloudFile
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-FilePath

Azure Storage 공유를 기준으로 파일의 경로를 지정합니다.

형식:	String
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ServerTimeoutPerRequest

요청의 서버 부분에 대한 시간 제한 기간의 길이를 지정합니다.

형식:	Nullable<T>[Int32]
별칭:	ServerTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ShareFileClient

ShareFileClient 개체가 복사 상태를 가져올 파일을 표시했습니다.

형식:	ShareFileClient
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ShareName

공유의 이름을 지정합니다.

형식:	String
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WaitForComplete

이 cmdlet이 복사본이 완료될 때까지 대기하고 있음을 나타냅니다. 이 매개 변수를 지정하지 않으면 이 cmdlet은 결과를 즉시 반환합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

CloudFile

IStorageContext

출력

CopyState

관련 링크

• Get-AzStorageFile
• New-AzStorageContext
• Start-AzStorageFileCopy
• Stop-AzStorageFileCopy