Get-AzStorageFileContent

Module:

Az.Storage

Hiermee downloadt u de inhoud van een bestand.

Syntaxis

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
   [-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
   [-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
   [-ShareFileClient] <ShareFileClient>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Description

De Get-AzStorageFileContent cmdlet downloadt de inhoud van een bestand en slaat deze vervolgens op 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 "AzureStorageFile"} | 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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CheckMd5

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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]
Aliassen:	ClientTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliassen:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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 Forcerenopgeeft, 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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisAllowTrailingDot

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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 Forcerenopgeeft, 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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PassThru

Geeft aan dat deze cmdlet de AzureStorageFile retourneert object dat wordt gedownload.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Path

Hiermee geeft u het pad van een bestand. 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
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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]
Aliassen:	ServerTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ShareClient

ShareClient-object geeft de share aan waar het bestand zou worden gedownload.

Type:	ShareClient
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ShareDirectoryClient

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

Type:	ShareDirectoryClient
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ShareFileClient

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

Type:	ShareFileClient
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	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
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

ShareClient

ShareDirectoryClient

ShareFileClient

IStorageContext

Uitvoerwaarden

AzureStorageFile

Verwante koppelingen

• Get-AzStorageFile
• Set-AzStorageFileContent