Get-AzStorageFileContent

Hiermee downloadt u de inhoud van een bestand.

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

Met de cmdlet Get-AzStorageFileContent wordt de inhoud van een bestand gedownload en vervolgens opgeslagen op een bestemming die u opgeeft. Met deze cmdlet wordt de inhoud van het bestand niet geretourneerd.

Voorbeelden

Voorbeeld 1: Een bestand downloaden uit een map

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

Met deze opdracht wordt een bestand met de naam CurrentDataFile gedownload in de map ContosoWorkingFolder van de bestandsshare ContosoShare06 naar de huidige map.

Voorbeeld 2: De bestanden downloaden onder voorbeeldbestandsshare

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

In dit voorbeeld worden de bestanden gedownload onder de voorbeeldbestandsshare

Voorbeeld 3: Een Azure-bestand downloaden naar een lokaal bestand en de SMB-eigenschappen van Azure File (File Attributtes, File Creation Time, File Last Write Time) in het lokale bestand reserveren.

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

In dit voorbeeld wordt een Azure-bestand gedownload naar een lokaal bestand en worden de SMB-eigenschappen van Azure File (File Attributtes, File Creation Time, File Last Write Time) in het lokale bestand geplaatst.

Parameters

-AsJob

Voer de cmdlet op de achtergrond uit.

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

-CheckMd5

Hiermee geeft u op of de md5-som voor het gedownloade bestand moet worden gecontroleerd.

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

-ClientTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de clientzijde op, in seconden, voor één serviceaanvraag. Als de vorige aanroep mislukt in het opgegeven interval, probeert deze cmdlet de aanvraag opnieuw uit te voeren. Als deze cmdlet geen geslaagd antwoord ontvangt voordat het interval is verstreken, retourneert deze cmdlet een fout.

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

-ConcurrentTaskCount

Hiermee geeft u het maximum aantal gelijktijdige netwerkaanroepen op. U kunt deze parameter gebruiken om de gelijktijdigheid te beperken om het lokale CPU- en bandbreedtegebruik te beperken door het maximum aantal gelijktijdige netwerkaanroepen op te geven. De opgegeven waarde is een absoluut aantal en wordt niet vermenigvuldigd met het aantal kernen. Deze parameter kan helpen bij het verminderen van netwerkverbindingsproblemen in omgevingen met lage bandbreedte, zoals 100 kilobits per seconde. De standaardwaarde is 10.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Context

Hiermee geeft u een Azure Storage-context op. Gebruik de cmdlet New-AzStorageContext om een context te verkrijgen.

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

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Destination

Hiermee geeft u het doelpad. Met deze cmdlet wordt de bestandsinhoud gedownload naar de locatie die door deze parameter wordt opgegeven. Als u het pad opgeeft van een bestand dat niet bestaat, maakt deze cmdlet dat bestand en slaat u de inhoud op in het nieuwe bestand. Als u een pad opgeeft van een bestand dat al bestaat en u de parameter Force opgeeft, overschrijft de cmdlet het bestand. Als u een pad opgeeft van een bestaand bestand en u geen Force opgeeft, wordt u door de cmdlet gevraagd voordat het doorgaat. Als u het pad van een map opgeeft, probeert deze cmdlet een bestand te maken met de naam van het Azure-opslagbestand.

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

-Directory

Hiermee geeft u een map op als een CloudFileDirectory-object . Met deze cmdlet wordt inhoud opgehaald voor een bestand in de map die met deze parameter wordt opgegeven. Gebruik de cmdlet New-AzStorageDirectory om een map te verkrijgen. U kunt ook de Cmdlet Get-AzStorageFile gebruiken om een map op te halen.

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

-DisAllowTrailingDot

Volg punt (.) niet toe om achtervoegselmap en bestandsnamen te achtervoegsel.

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

-File

Hiermee geeft u een bestand op als een CloudFile-object . Deze cmdlet haalt het bestand op dat met deze parameter wordt opgegeven. Gebruik de cmdlet Get-AzStorageFile om een CloudFile-object op te halen.

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

-Force

Als u het pad opgeeft van een bestand dat niet bestaat, maakt deze cmdlet dat bestand en slaat u de inhoud op in het nieuwe bestand. Als u een pad opgeeft van een bestand dat al bestaat en u de parameter Force opgeeft, overschrijft de cmdlet het bestand. Als u een pad opgeeft van een bestaand bestand en u geen Force opgeeft, wordt u door de cmdlet gevraagd voordat het doorgaat. Als u het pad van een map opgeeft, probeert deze cmdlet een bestand te maken met de naam van het Azure-opslagbestand.

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

-PassThru

Geeft aan dat deze cmdlet het AzureStorageFile-object retourneert dat wordt gedownload.

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

-Path

Hiermee geeft u het pad van een bestand op. Met deze cmdlet wordt de inhoud van het bestand dat met deze parameter wordt opgegeven, opgeslagen. Als het bestand niet bestaat, retourneert deze cmdlet een fout.

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

-PreserveSMBAttribute

Behoud de SMB-broneigenschappen (bestandsdistributies, tijd voor het maken van bestanden, tijd voor laatste schrijfbewerking) in het doelbestand. Deze parameter is alleen beschikbaar in Windows.

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

-ServerTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de servicezijde op, in seconden, voor een aanvraag. Als het opgegeven interval is verstreken voordat de service de aanvraag verwerkt, retourneert de opslagservice een fout.

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

-Share

Hiermee geeft u een CloudFileShare-object . Met deze cmdlet wordt de inhoud van het bestand in de share gedownload die met deze parameter wordt opgegeven. Gebruik de cmdlet Get-AzStorageShare om een CloudFileShare-object op te halen. Dit object bevat de opslagcontext. Als u deze parameter opgeeft, geeft u de contextparameter niet op.

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

-ShareClient

Het CloudFileShare-object heeft de share aangegeven waar het bestand zou worden gedownload.

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

-ShareDirectoryClient

ShareDirectoryClient-object heeft de cloudmap aangegeven waar het bestand zou worden gedownload.

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

-ShareFileClient

ShareFileClient-object geeft aan dat het cloudbestand moet worden gedownload.

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

-ShareName

Hiermee geeft u de naam van de bestandsshare. Met deze cmdlet wordt de inhoud van het bestand in de share gedownload die met deze parameter wordt opgegeven.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Uitvoerwaarden

AzureStorageFile