Get-AzStorageFile

모듈:

Az.Storage

경로에 대한 디렉터리 및 파일을 나열합니다.

구문

Get-AzStorageFile
   [-ShareName] <String>
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzStorageFile
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzStorageFile
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [[-Path] <String>]
   [-ExcludeExtendedInfo]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

Get-AzStorageFile cmdlet은 지정한 공유 또는 디렉터리에 대한 디렉터리 및 파일을 나열합니다. 지정된 경로에서 디렉터리 또는 파일의 인스턴스를 가져올 Path 매개 변수를 지정합니다. 이 cmdlet은 AzureStorageFile 및 AzureStorageDirectory 개체를 반환합니다. IsDirectory 속성을 사용하여 폴더와 파일을 구분할 수 있습니다.

예제

예제 1: 공유의 디렉터리 나열

Get-AzStorageFile -ShareName "ContosoShare06" | Where-Object {$_.GetType().Name -eq "AzureStorageFileDirectory"}

이 명령은 공유 ContosoShare06의 디렉터리만 나열합니다. 먼저 파일과 디렉터리를 모두 검색하고 파이프라인 연산자를 사용하여 where 연산자에 전달한 다음 형식이 "AzureStorageFileDirectory"가 아닌 모든 개체를 삭제합니다.

예제 2: 파일 디렉터리 나열

Get-AzStorageFile -ShareName "ContosoShare06" -Path "ContosoWorkingFolder" | Get-AzStorageFile

이 명령은 ContosoShare06 공유 아래의 ContosoWorkingFolder 디렉터리에 있는 파일 및 폴더를 나열합니다. 먼저 디렉터리 인스턴스를 가져오고 Get-AzStorageFile cmdlet에 파이프라인하여 디렉터리를 나열합니다.

매개 변수

-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

-Directory

폴더를 CloudFileDirectory 개체로 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 폴더를 가져옵니다. 디렉터리를 가져오려면 New-AzStorageDirectory cmdlet을 사용합니다. Get-AzStorageFile cmdlet을 사용하여 디렉터리를 가져올 수도 있습니다.

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

-DisAllowTrailingDot

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

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

-ExcludeExtendedInfo

타임스탬프, ETag, 특성, permissionKey와 같은 확장 파일 정보는 목록 파일 및 디렉터리에 포함하지 않습니다.

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

-Path

폴더의 경로를 지정합니다. Path 매개 변수를 생략하면 Get-AzStorageFile은 지정된 파일 공유 또는 디렉터리의 디렉터리와 파일을 나열합니다. Path 매개 변수를 포함하는 경우 Get-AzStorageFile은 지정된 경로에 있는 디렉터리 또는 파일의 인스턴스를 반환합니다.

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

-ServerTimeoutPerRequest

요청에 대한 서비스 쪽 시간 제한 간격(초)을 지정합니다. 서비스에서 요청을 처리하기 전에 지정된 간격이 경과하면 Storage 서비스가 오류를 반환합니다.

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

-Share

CloudFileShare 개체를 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 파일 공유에서 파일 또는 디렉터리를 가져옵니다. CloudFileShare 개체를 가져오려면 Get-AzStorageShare cmdlet을 사용합니다. 이 개체는 Storage 컨텍스트를 포함합니다. 이 매개 변수를 지정하는 경우 Context 매개 변수를 지정하지 마세요.

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

-ShareClient

ShareClient 개체는 파일/디렉터리를 나열할 공유를 표시했습니다.

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

-ShareDirectoryClient

ShareDirectoryClient 개체는 파일/디렉터리가 나열될 기본 폴더를 표시했습니다.

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

-ShareName

파일 공유의 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 파일 공유에서 파일 또는 디렉터리를 가져옵니다.

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

입력

CloudFileShare

CloudFileDirectory

IStorageContext

출력

AzureStorageFile

관련 링크

• Get-AzStorageFileContent
• New-AzStorageDirectory
• Remove-AzStorageDirectory
• Remove-AzStorageFile
• Set-AzStorageFileContent