Get-AzStorageFile
구문
ShareName (기본값)
Get-AzStorageFile
[-ShareName] <String>
[[-Path] <String>]
[-ExcludeExtendedInfo]
[-DisAllowTrailingDot]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Share
Get-AzStorageFile
[-ShareClient] <ShareClient>
[[-Path] <String>]
[-ExcludeExtendedInfo]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Directory
Get-AzStorageFile
[-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에 파이프라인하여 디렉터리를 나열합니다.
예제 3: 공유의 파일 및 디렉터리를 나열하고 확장 정보를 제외합니다.
Get-AzStorageFile -ShareName "ContosoShare06" -ExcludeExtendedInfo
이 명령은 ContosoShare06 공유 아래에 있는 파일 및 폴더를 나열하고 타임스탬프, ETag, 특성, permissionKey와 같은 확장 파일 정보를 목록 파일 및 디렉터리에서 제외합니다.
현재 NFS 파일 공유 또는 NFS 파일 공유의 디렉터리에서 파일 및 디렉터리를 나열하려면 -ExcludeExtendedInfo 가 필요합니다.
매개 변수
-ClientTimeoutPerRequest
하나의 서비스 요청에 대한 클라이언트 쪽 제한 시간 간격(초)을 지정합니다.
이전 호출이 지정된 간격 내에 실패하면 이 cmdlet은 요청을 다시 시도합니다.
이 cmdlet이 간격이 경과하기 전에 성공적인 응답을 받지 못하면 이 cmdlet은 오류를 반환합니다.
매개 변수 속성
형식: Nullable<T> [ Int32 ]
Default value: None
와일드카드 지원: False
DontShow: False
별칭: ClientTimeoutPerRequestInSeconds
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ConcurrentTaskCount
최대 동시 네트워크 호출을 지정합니다.
이 매개 변수를 사용하여 동시 네트워크 호출의 최대 수를 지정하여 로컬 CPU 및 대역폭 사용을 제한하는 동시성을 제한할 수 있습니다.
지정된 값은 절대 개수이며 코어 수를 곱하지 않습니다.
이 매개 변수는 초당 100킬로비트와 같은 낮은 대역폭 환경에서 네트워크 연결 문제를 완화하는 데 도움이 될 수 있습니다.
기본값은 10입니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Context
Azure Storage 컨텍스트를 지정합니다.
스토리지 컨텍스트를 가져오려면 New-AzStorageContext cmdlet을 사용합니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: True
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-DisAllowTrailingDot
접미사 디렉터리 및 파일 이름에 후행 점(.)을 허용하지 않습니다.
매개 변수 속성
매개 변수 집합
ShareName
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ExcludeExtendedInfo
타임스탬프, ETag, 특성, permissionKey와 같은 확장 파일 정보는 목록 파일 및 디렉터리에 포함하지 않습니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Path
폴더의 경로를 지정합니다.
Path 매개 변수를 생략하면 Get-AzStorageFile 은 지정된 파일 공유 또는 디렉터리의 디렉터리와 파일을 나열합니다.
Path 매개 변수를 포함하는 경우 Get-AzStorageFile 은 지정된 경로에 있는 디렉터리 또는 파일의 인스턴스를 반환합니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: 1
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ServerTimeoutPerRequest
요청에 대한 서비스 쪽 시간 제한 간격(초)을 지정합니다.
서비스에서 요청을 처리하기 전에 지정된 간격이 경과하면 Storage 서비스가 오류를 반환합니다.
매개 변수 속성
형식: Nullable<T> [ Int32 ]
Default value: None
와일드카드 지원: False
DontShow: False
별칭: ServerTimeoutPerRequestInSeconds
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ShareClient
ShareClient 개체는 파일/디렉터리를 나열할 공유를 표시했습니다.
매개 변수 속성
형식: ShareClient
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
Share
Position: 0
필수: True
파이프라인의 값: True
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-ShareDirectoryClient
ShareDirectoryClient 개체는 파일/디렉터리가 나열될 기본 폴더를 표시했습니다.
매개 변수 속성
매개 변수 집합
Directory
Position: 0
필수: True
파이프라인의 값: True
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-ShareName
파일 공유의 이름을 지정합니다.
이 cmdlet은 이 매개 변수가 지정하는 파일 공유에서 파일 또는 디렉터리를 가져옵니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
ShareName
Position: 0
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters 를 참조하세요.
출력