Bagikan melalui

Get-AzStorageShare

  • Referensi
Modul:
Az.Storage

Mendapatkan daftar berbagi file.

Sintaks

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>]

Deskripsi

Cmdlet Get-AzStorageShare mendapatkan daftar berbagi file untuk akun penyimpanan.

Contoh

Contoh 1: Mendapatkan berbagi file

Get-AzStorageShare -Name "ContosoShare06"

Perintah ini mendapatkan berbagi file bernama ContosoShare06.

Contoh 2: Mendapatkan semua berbagi file yang dimulai dengan string

Get-AzStorageShare -Prefix "Contoso"

Perintah ini mendapatkan semua berbagi file yang memiliki nama yang dimulai dengan Contoso.

Contoh 3: Mendapatkan semua berbagi file dalam konteks tertentu

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

Perintah pertama menggunakan cmdlet New-AzStorageContext untuk membuat konteks dengan menggunakan parameter Lokal, lalu menyimpan objek konteks tersebut dalam variabel $Context. Perintah kedua mendapatkan berbagi file untuk objek konteks yang disimpan di $Context.

Contoh 4: Mendapatkan rekam jepret berbagi file dengan nama berbagi dan SnapshotTime tertentu

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

Perintah ini mendapatkan rekam jepret berbagi file dengan nama berbagi tertentu dan SnapshotTime.

Contoh 5: Dapatkan objek berbagi file tanpa mengambil properti berbagi dengan autentikasi OAuth.

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

Perintah ini mendapatkan rekam jepret berbagi file tanpa mendapatkan properti berbagi dengan autentikasi OAuth. Dapatkan properti berbagi dengan autentikasi OAuth akan gagal karena API tidak mendukung OAuth. Jadi untuk mendapatkan objek berbagi dengan autentikasi OAuth harus melewati ambil properti berbagi.

Parameter

-ClientTimeoutPerRequest

Menentukan interval waktu habis sisi klien, dalam hitungan detik, untuk satu permintaan layanan. Jika panggilan sebelumnya gagal dalam interval yang ditentukan, cmdlet ini akan mencoba kembali permintaan. Jika cmdlet ini tidak menerima respons yang berhasil sebelum interval berlalu, cmdlet ini mengembalikan kesalahan.

Jenis:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ConcurrentTaskCount

Menentukan panggilan jaringan bersamaan maksimum. Anda dapat menggunakan parameter ini untuk membatasi konkurensi untuk membatasi penggunaan CPU dan bandwidth lokal dengan menentukan jumlah maksimum panggilan jaringan bersamaan. Nilai yang ditentukan adalah jumlah absolut dan tidak dikalikan dengan jumlah inti. Parameter ini dapat membantu mengurangi masalah koneksi jaringan di lingkungan bandwidth rendah, seperti 100 kilobit per detik. Nilai defaultnya adalah 10.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Context

Menentukan konteks Azure Storage. Untuk mendapatkan konteks, gunakan cmdlet New-AzStorageContext.

Jenis:IStorageContext
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-IncludeDeleted

Sertakan berbagi yang dihapus, secara default dapatkan berbagi tidak akan menyertakan berbagi yang dihapus

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Name

Menentukan nama berbagi file. Cmdlet ini mendapatkan berbagi file yang ditentukan parameter ini, atau tidak ada jika Anda menentukan nama berbagi file yang tidak ada.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Prefix

Menentukan awalan untuk berbagi file. Cmdlet ini mendapatkan berbagi file yang cocok dengan awalan yang ditentukan parameter ini, atau tidak ada berbagi file jika tidak ada berbagi file yang cocok dengan awalan yang ditentukan.

Jenis:String
Position:0
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ServerTimeoutPerRequest

Menentukan lamanya periode waktu habis untuk bagian server dari permintaan.

Jenis:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SkipGetProperty

Tentukan parameter ini untuk hanya menghasilkan objek berbagi lokal, tanpa mendapatkan properti berbagi dari server.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SnapshotTime

SnapshotTime rekam jepret berbagi file yang akan diterima.

Jenis:Nullable<T>[DateTimeOffset]
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

Output