Aracılığıyla paylaş

Get-AzStorageFileContent

  • Başvuru
Modül:
Az.Storage

Bir dosyanın içeriğini indirir.

Sözdizimi

Get-AzStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-File] <CloudFile>
   [-ShareFileClient <ShareFileClient>]
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Description

Get-AzStorageFileContent cmdlet'i bir dosyanın içeriğini indirir ve ardından belirttiğiniz hedefe kaydeder. Bu cmdlet dosyanın içeriğini döndürmez.

Örnekler

Örnek 1: Klasörden dosya indirme

Get-AzStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

Bu komut ContosoWorkingFolder klasöründeki CurrentDataFile adlı bir dosyayı ContosoShare06 dosya paylaşımından geçerli klasöre indirir.

Örnek 2: Örnek dosya paylaşımı altındaki dosyaları indirir

Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "CloudFile"} | Get-AzStorageFileContent

Bu örnek, örnek dosya paylaşımı altındaki dosyaları indirir

Örnek 3: Bir Azure dosyasını yerel bir dosyaya indirin ve yerel dosyada Azure Dosya SMB özelliklerini (Dosya Attributtes, Dosya Oluşturma Zamanı, Dosya Son Yazma Zamanı) gözlemleyin.

Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute

Bu örnek bir Azure dosyasını yerel bir dosyaya indirir ve yerel dosyadaki Azure Dosya SMB özelliklerine (Dosya Attributtes, Dosya Oluşturma Zamanı, Dosya Son Yazma Zamanı) sahiptir.

Parametreler

-AsJob

Cmdlet'i arka planda çalıştırın.

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

-CheckMd5

İndirilen dosya için Md5 toplamının denetlenip denetlenmeyeceğini belirtir.

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

-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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
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

-Destination

Hedef yolu belirtir. Bu cmdlet, dosya içeriğini bu parametrenin belirttiği konuma indirir. Var olmayan bir dosyanın yolunu belirtirseniz, bu cmdlet bu dosyayı oluşturur ve içeriği yeni dosyaya kaydeder. Zaten var olan bir dosyanın yolunu belirtirseniz ve Zorla parametresini belirtirseniz, cmdlet dosyanın üzerine yazar. Varolan bir dosyanın yolunu belirtirseniz ve Zorla'yı belirtmezseniz, cmdlet devam etmeden önce sizi sorar. Bir klasörün yolunu belirtirseniz, bu cmdlet Azure depolama dosyasının adına sahip bir dosya oluşturmayı dener.

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

-Directory

Bir klasörü CloudFileDirectory nesnesi olarak belirtir. Bu cmdlet, bu parametrenin belirttiği klasördeki bir dosyanın içeriğini alır. Dizin almak için New-AzStorageDirectory cmdlet'ini kullanın. Dizin almak için Get-AzStorageFile cmdlet'ini de kullanabilirsiniz.

Tür:CloudFileDirectory
Diğer adlar:CloudFileDirectory
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DisAllowTrailingDot

Sondaki noktanın (.) sonek dizinine ve dosya adlarına izin verme.

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

-File

Bir dosyayı CloudFile nesnesi olarak belirtir. Bu cmdlet, bu parametrenin belirttiği dosyayı alır. CloudFile nesnesi edinmek için Get-AzStorageFile cmdlet'ini kullanın.

Tür:CloudFile
Diğer adlar:CloudFile
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Force

Var olmayan bir dosyanın yolunu belirtirseniz, bu cmdlet bu dosyayı oluşturur ve içeriği yeni dosyaya kaydeder. Zaten var olan bir dosyanın yolunu belirtirseniz ve Zorla parametresini belirtirseniz, cmdlet dosyanın üzerine yazar. Varolan bir dosyanın yolunu belirtirseniz ve Zorla'yı belirtmezseniz, cmdlet devam etmeden önce sizi sorar. Bir klasörün yolunu belirtirseniz, bu cmdlet Azure depolama dosyasının adına sahip bir dosya oluşturmayı dener.

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

-PassThru

Bu cmdlet'in indirmiş olduğu AzureStorageFile nesnesini döndürdüğünü gösterir.

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

-Path

Bir dosyanın yolunu belirtir. Bu cmdlet, bu parametrenin belirttiği dosyanın içeriğini alır. Dosya yoksa, bu cmdlet bir hata döndürür.

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

-PreserveSMBAttribute

Kaynak Dosya SMB özelliklerini (Dosya Attributtes, Dosya Oluşturma Zamanı, Dosya Son Yazma Zamanı) hedef Dosyada tutun. Bu parametre yalnızca Windows'ta kullanılabilir.

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

-ServerTimeoutPerRequest

İstek için hizmet tarafı zaman aşımı aralığını saniye cinsinden belirtir. Belirtilen aralık hizmetin isteği işlemeden önce geçmesi durumunda depolama hizmeti bir hata döndürür.

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

-Share

CloudFileShare nesnesini belirtir. Bu cmdlet, bu parametrenin belirttiği paylaşımdaki dosyanın içeriğini indirir. CloudFileShare nesnesi edinmek için Get-AzStorageShare cmdlet'ini kullanın. Bu nesne depolama bağlamını içerir. Bu parametreyi belirtirseniz Context parametresini belirtmeyin.

Tür:CloudFileShare
Diğer adlar:CloudFileShare
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ShareClient

CloudFileShare nesnesi, dosyanın indirileceği paylaşımı gösterir.

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

-ShareDirectoryClient

ShareDirectoryClient nesnesi, dosyanın indirileceği bulut dizinini belirtir.

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

-ShareFileClient

ShareFileClient nesnesi, indirilecek bulut dosyasını gösteriyor.

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

-ShareName

Dosya paylaşımının adını belirtir. Bu cmdlet, bu parametrenin belirttiği paylaşımdaki dosyanın içeriğini indirir.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Çıkışlar

AzureStorageFile