Aracılığıyla paylaş

Get-AzStorageShare

  • Başvuru
Modül:
Az.Storage

Dosya paylaşımlarının listesini alır.

Sözdizimi

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'i bir depolama hesabı için dosya paylaşımlarının listesini alır.

Örnekler

Örnek 1: Dosya paylaşımı alma

Get-AzStorageShare -Name "ContosoShare06"

Bu komut ContosoShare06 adlı dosya paylaşımını alır.

Örnek 2: Bir dize ile başlayan tüm dosya paylaşımlarını alma

Get-AzStorageShare -Prefix "Contoso"

Bu komut, Contoso ile başlayan adlara sahip tüm dosya paylaşımlarını alır.

Örnek 3: Belirtilen bağlamdaki tüm dosya paylaşımlarını alma

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

İlk komut, Local parametresini kullanarak bağlam oluşturmak için New-AzStorageContext cmdlet'ini kullanır ve ardından bu bağlam nesnesini $Context değişkeninde depolar. İkinci komut, $Context depolanan bağlam nesnesi için dosya paylaşımlarını alır.

Örnek 4: Belirli bir paylaşım adına ve SnapshotTime'a sahip bir dosya paylaşımı anlık görüntüsü alma

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

Bu komut, belirli bir paylaşım adına ve SnapshotTime'a sahip bir dosya paylaşımı anlık görüntüsü alır.

Örnek 5: OAuth kimlik doğrulaması ile paylaşım özelliklerini getirmeden dosya paylaşımı nesnesi alma.

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

Bu komut, OAuth kimlik doğrulamasıyla paylaşım özellikleri almadan bir dosya paylaşımı anlık görüntüsü alır. API OAuth'u desteklemediğinden OAuth kimlik doğrulamasıyla paylaşım özelliklerini alma işlemi başarısız olur. Bu nedenle, OAuth kimlik doğrulamasıyla share nesnesini almak için paylaşım özelliklerini getirme işlemini atlamalısınız.

Parametreler

-ClientTimeoutPerRequest

Bir hizmet isteği için istemci tarafı zaman aşımı aralığını saniye cinsinden belirtir. Önceki çağrı belirtilen aralıkta başarısız olursa, bu cmdlet isteği yeniden dener. Bu cmdlet, aralık tamamlanmadan başarılı bir yanıt almazsa, bu cmdlet bir hata döndürür.

Tür:Nullable<T>[Int32]
Diğer adlar:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ConcurrentTaskCount

En fazla eşzamanlı ağ çağrısını belirtir. Eşzamanlı ağ çağrılarının maksimum sayısını belirterek yerel CPU ve bant genişliği kullanımını kısıtlamak için eşzamanlılığı sınırlamak için bu parametreyi kullanabilirsiniz. Belirtilen değer mutlak bir sayıdır ve çekirdek sayısıyla çarpılmaz. Bu parametre, saniyede 100 kilobit gibi düşük bant genişliğine bağlı ortamlardaki ağ bağlantısı sorunlarını azaltmaya yardımcı olabilir. Varsayılan değer 10'dur.

Tür:Nullable<T>[Int32]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Context

Azure Depolama bağlamı belirtir. Bağlam elde etmek için New-AzStorageContext cmdlet'ini kullanın.

Tür:IStorageContext
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IncludeDeleted

Silinen paylaşımları dahil et, varsayılan olarak paylaşım al seçeneği silinen paylaşımları içermez

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

Dosya paylaşımının adını belirtir. Bu cmdlet, bu parametrenin belirttiği dosya paylaşımını alır veya var olmayan bir dosya paylaşımının adını belirtirseniz hiçbir şey almaz.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Prefix

Dosya paylaşımları için ön eki belirtir. Bu cmdlet, bu parametrenin belirttiği ön ekle eşleşen dosya paylaşımlarını alır veya belirtilen ön ekle eşleşen bir dosya paylaşımı yoksa hiçbir dosya paylaşımı alamaz.

Tür:String
Position:0
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ServerTimeoutPerRequest

İsteğin sunucu bölümü için zaman aşımı süresinin uzunluğunu belirtir.

Tür:Nullable<T>[Int32]
Diğer adlar:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SkipGetProperty

Sunucudan paylaşım özellikleri almadan yalnızca yerel bir paylaşım nesnesi oluşturmak için bu parametreyi belirtin.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SnapshotTime

Alınacak dosya paylaşımı anlık görüntüsünün SnapshotTime değeri.

Tür:Nullable<T>[DateTimeOffset]
Position:1
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

IStorageContext

Çıkışlar

AzureStorageFileShare