Get-AzStorageFileContent
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
[-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-AzStorageFileContentIn 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 -PreserveSMBAttributeIn 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
Hiermee wordt u 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 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 |
| Aliassen: | CloudFileDirectory |
| Position: | 0 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| 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 |
-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 |
| Aliassen: | CloudFile |
| Position: | 0 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| 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 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-PassThru
Geeft aan dat deze cmdlet het AzureStorageFile-object retourneert 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 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 |
| 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 |
-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 |
| Aliassen: | CloudFileShare |
| Position: | 0 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ShareClient
Het CloudFileShare-object heeft de share aangegeven waar het bestand zou worden gedownload.
| Type: | ShareClient |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ShareDirectoryClient
ShareDirectoryClient-object heeft de cloudmap aangegeven waar het bestand zou worden gedownload.
| Type: | ShareDirectoryClient |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ShareFileClient
ShareFileClient-object geeft aan dat het cloudbestand moet worden gedownload.
| Type: | ShareFileClient |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| 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
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
| Type: | SwitchParameter |
| Aliassen: | wi |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Invoerwaarden
Uitvoerwaarden
Verwante koppelingen
Azure PowerShell
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor