Get-AzStorageFileContent

Bir dosyanın içeriğini indirir.

Syntax

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-Az Depolama FileContent 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckMd5

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

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

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-Az Depolama Directory cmdlet'ini kullanın. Dizin almak için Get-Az Depolama File cmdlet'ini de kullanabilirsiniz.

Type:CloudFileDirectory
Aliases:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisAllowTrailingDot

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-File

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

Type:CloudFile
Aliases:CloudFile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-Az Depolama Share cmdlet'ini kullanın. Bu nesne depolama bağlamını içerir. Bu parametreyi belirtirseniz Context parametresini belirtmeyin.

Type:CloudFileShare
Aliases:CloudFileShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareClient

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

Type:ShareClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareDirectoryClient

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

Type:ShareDirectoryClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareFileClient

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

Type:ShareFileClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareName

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Çıkışlar

AzureStorageFile