다음을 통해 공유


Get-AzureStorageFileContent

파일의 내용을 다운로드합니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.

AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.

구문

Get-AzureStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Share] <CloudFileShare>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-File] <CloudFile>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Get-AzureStorageFileContent cmdlet은 파일의 내용을 다운로드한 다음 지정한 대상에 저장합니다. 이 cmdlet은 파일의 내용을 반환하지 않습니다.

예제

예제 1: 폴더에서 파일 다운로드

PS C:\>Get-AzureStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

이 명령은 ContosoWorkingFolder 폴더의 CurrentDataFile이라는 파일을 ContosoShare06 파일 공유에서 현재 폴더로 다운로드합니다.

예제 2: 샘플 파일 공유에서 파일 다운로드

PS C:\>Get-AzureStorageFile -ShareName sample | ? {$_.GetType().Name -eq "CloudFile"} | Get-AzureStorageFileContent

이 예제에서는 샘플 파일 공유에서 파일을 다운로드합니다.

매개 변수

-CheckMd5

존재하지 않는 파일의 경로를 지정하는 경우 이 cmdlet은 해당 파일을 만들고 내용을 새 파일에 저장합니다. 이미 있는 파일의 경로를 지정하고 Force 매개 변수를 지정하면 cmdlet이 파일을 덮어씁니다. 기존 파일의 경로를 지정하고 Force를 지정하지 않으면 cmdlet에서 계속하기 전에 메시지를 표시합니다. 폴더의 경로를 지정하는 경우 이 cmdlet은 Azure Storage 파일의 이름을 가진 파일을 만들려고 시도합니다.

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

-ClientTimeoutPerRequest

존재하지 않는 파일의 경로를 지정하는 경우 이 cmdlet은 해당 파일을 만들고 내용을 새 파일에 저장합니다. 이미 있는 파일의 경로를 지정하고 Force 매개 변수를 지정하면 cmdlet이 파일을 덮어씁니다. 기존 파일의 경로를 지정하고 Force를 지정하지 않으면 cmdlet에서 계속하기 전에 메시지를 표시합니다. 폴더의 경로를 지정하는 경우 이 cmdlet은 Azure Storage 파일의 이름을 가진 파일을 만들려고 시도합니다.

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

-ConcurrentTaskCount

존재하지 않는 파일의 경로를 지정하는 경우 이 cmdlet은 해당 파일을 만들고 내용을 새 파일에 저장합니다. 이미 있는 파일의 경로를 지정하고 Force 매개 변수를 지정하면 cmdlet이 파일을 덮어씁니다. 기존 파일의 경로를 지정하고 Force를 지정하지 않으면 cmdlet에서 계속하기 전에 메시지를 표시합니다. 폴더의 경로를 지정하는 경우 이 cmdlet은 Azure Storage 파일의 이름을 가진 파일을 만들려고 시도합니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-Context

존재하지 않는 파일의 경로를 지정하는 경우 이 cmdlet은 해당 파일을 만들고 내용을 새 파일에 저장합니다. 이미 있는 파일의 경로를 지정하고 Force 매개 변수를 지정하면 cmdlet이 파일을 덮어씁니다. 기존 파일의 경로를 지정하고 Force를 지정하지 않으면 cmdlet에서 계속하기 전에 메시지를 표시합니다. 폴더의 경로를 지정하는 경우 이 cmdlet은 Azure Storage 파일의 이름을 가진 파일을 만들려고 시도합니다.

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

-DefaultProfile

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

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

-Destination

대상 경로를 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 위치에 파일 콘텐츠를 다운로드합니다. 존재하지 않는 파일의 경로를 지정하는 경우 이 cmdlet은 해당 파일을 만들고 내용을 새 파일에 저장합니다. 이미 있는 파일의 경로를 지정하고 Force 매개 변수를 지정하면 cmdlet이 파일을 덮어씁니다. 기존 파일의 경로를 지정하고 Force를 지정하지 않으면 cmdlet에서 계속하기 전에 메시지를 표시합니다. 폴더의 경로를 지정하는 경우 이 cmdlet은 Azure Storage 파일의 이름을 가진 파일을 만들려고 시도합니다.

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

-Directory

폴더를 CloudFileDirectory 개체로 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 폴더의 파일에 대한 콘텐츠를 가져옵니다. 디렉터리를 가져오려면 New-AzureStorageDirectory cmdlet을 사용합니다. Get-AzureStorageFile cmdlet을 사용하여 디렉터리를 가져올 수도 있습니다.

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

-File

파일을 CloudFile 개체로 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 파일을 가져옵니다. CloudFile 개체를 가져오려면 Get-AzureStorageFile cmdlet을 사용합니다.

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

-Force

존재하지 않는 파일의 경로를 지정하는 경우 이 cmdlet은 해당 파일을 만들고 내용을 새 파일에 저장합니다. 이미 있는 파일의 경로를 지정하고 Force 매개 변수를 지정하면 cmdlet이 파일을 덮어씁니다. 기존 파일의 경로를 지정하고 Force를 지정하지 않으면 cmdlet에서 계속하기 전에 메시지를 표시합니다. 폴더의 경로를 지정하는 경우 이 cmdlet은 Azure Storage 파일의 이름을 가진 파일을 만들려고 시도합니다.

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

-PassThru

존재하지 않는 파일의 경로를 지정하는 경우 이 cmdlet은 해당 파일을 만들고 내용을 새 파일에 저장합니다. 이미 있는 파일의 경로를 지정하고 Force 매개 변수를 지정하면 cmdlet이 파일을 덮어씁니다. 기존 파일의 경로를 지정하고 Force를 지정하지 않으면 cmdlet에서 계속하기 전에 메시지를 표시합니다. 폴더의 경로를 지정하는 경우 이 cmdlet은 Azure Storage 파일의 이름을 가진 파일을 만들려고 시도합니다.

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

-Path

파일의 경로를 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 파일의 내용을 가져옵니다. 파일이 없으면 이 cmdlet은 오류를 반환합니다.

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

-ServerTimeoutPerRequest

존재하지 않는 파일의 경로를 지정하는 경우 이 cmdlet은 해당 파일을 만들고 내용을 새 파일에 저장합니다. 이미 있는 파일의 경로를 지정하고 Force 매개 변수를 지정하면 cmdlet이 파일을 덮어씁니다. 기존 파일의 경로를 지정하고 Force를 지정하지 않으면 cmdlet에서 계속하기 전에 메시지를 표시합니다. 폴더의 경로를 지정하는 경우 이 cmdlet은 Azure Storage 파일의 이름을 가진 파일을 만들려고 시도합니다.

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

-Share

CloudFileShare 개체를 지정합니다. 이 cmdlet은 이 매개 변수가 지정한 공유에 있는 파일의 내용을 다운로드합니다. CloudFileShare 개체를 가져오려면 Get-AzureStorageShare cmdlet을 사용합니다. 이 개체는 스토리지 컨텍스트를 포함합니다. 이 매개 변수를 지정하는 경우 Context 매개 변수를 지정하지 마세요.

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

-ShareName

파일 공유의 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정한 공유에 있는 파일의 내용을 다운로드합니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

CloudFileShare

매개 변수: 공유(ByValue)

CloudFileDirectory

매개 변수: 디렉터리(ByValue)

CloudFile

매개 변수: 파일(ByValue)

IStorageContext

출력

CloudFile