다음을 통해 공유


Get-AzureStorageShare

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

Warning

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

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

구문

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

Description

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

예제

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

PS C:\>Get-AzureStorageShare -Name "ContosoShare06"

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

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

PS C:\>Get-AzureStorageShare -Prefix "Contoso"

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

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

PS C:\>$Context = New-AzureStorageContext -Local
PS C:\> Get-AzureStorageShare -Context $Context

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

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

PS C:\>Get-AzureStorageShare -Name "ContosoShare06" -SnapshotTime "6/16/2017 9:48:41 AM +00:00"

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

매개 변수

-ClientTimeoutPerRequest

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

형식:Nullable<T>[Int32]
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-AzureStorageContext cmdlet을 사용합니다.

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

-DefaultProfile

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

형식:IAzureContextContainer
별칭:AzureRmContext, AzureCredential
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]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SnapshotTime

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

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

입력

IStorageContext

출력

CloudFileShare