다음을 통해 공유

Get-AzStorageShare

  • 참조
모듈:
Az.Storage

파일 공유 목록을 가져옵니다.

구문

Get-AzStorageShare
   [[-Prefix] <String>]
   [-IncludeDeleted]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageShare
   [-Name] <String>
   [[-SnapshotTime] <DateTimeOffset>]
   [-SkipGetProperty]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

Get-AzStorageShare cmdlet은 스토리지 계정에 대한 파일 공유 목록을 가져옵니다.

예제

예제 1: 파일 공유 가져오기

Get-AzStorageShare -Name "ContosoShare06"

이 명령은 ContosoShare06이라는 파일 공유를 가져옵니다.

예제 2: 문자열로 시작하는 모든 파일 공유 가져오기

Get-AzStorageShare -Prefix "Contoso"

이 명령은 Contoso로 시작하는 이름이 있는 모든 파일 공유를 가져옵니다.

예제 3: 지정된 컨텍스트에서 모든 파일 공유 가져오기

$Context = New-AzStorageContext -Local
Get-AzStorageShare -Context $Context

첫 번째 명령은 New-AzStorageContext cmdlet을 사용하여 Local 매개 변수를 사용하여 컨텍스트를 만든 다음 해당 컨텍스트 개체를 $Context 변수에 저장합니다. 두 번째 명령은 $Context 저장된 컨텍스트 개체의 파일 공유를 가져옵니다.

예제 4: 특정 공유 이름과 SnapshotTime을 사용하여 파일 공유 스냅샷 가져오기

Get-AzStorageShare -Name "ContosoShare06" -SnapshotTime "6/16/2017 9:48:41 AM +00:00"

이 명령은 특정 공유 이름 및 SnapshotTime을 사용하여 파일 공유 스냅샷을 가져옵니다.

예제 5: OAuth 인증을 사용하여 공유 속성을 페치하지 않고 파일 공유 개체를 가져옵니다.

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
$share = Get-AzStorageShare -Name "ContosoShare06" -SkipGetProperty -Context $ctx

이 명령은 OAuth 인증을 사용하여 공유 속성을 가져오지 않고 파일 공유 스냅샷을 가져옵니다. API가 OAuth를 지원하지 않으므로 OAuth 인증을 사용한 공유 속성 가져오기가 실패합니다. 따라서 OAuth 인증을 사용하여 공유 개체를 가져오려면 페치 공유 속성을 건너뛰어야 합니다.

매개 변수

-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

-IncludeDeleted

삭제된 공유 포함, 기본적으로 공유 가져오기에는 삭제된 공유가 포함되지 않습니다.

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

-Name

파일 공유의 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 파일 공유를 가져오거나 존재하지 않는 파일 공유의 이름을 지정하는 경우 아무 것도 가져오지 않습니다.

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

-Prefix

파일 공유의 접두사를 지정합니다. 이 cmdlet은 이 매개 변수가 지정한 접두사와 일치하는 파일 공유를 가져오거나 지정된 접두사와 일치하는 파일 공유가 없는 경우 파일 공유를 가져옵니다.

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

-ServerTimeoutPerRequest

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

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

-SkipGetProperty

서버에서 공유 속성을 얻지 않고 로컬 공유 개체만 생성하려면 이 매개 변수를 지정합니다.

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

-SnapshotTime

수신할 파일 공유 스냅샷의 SnapshotTime입니다.

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

입력

IStorageContext

출력

AzureStorageFileShare