Delen via

Get-AzStorageBlobContent

  • Referentie
Module:
Az.Storage

Hiermee downloadt u een opslagblob.

Syntaxis

Get-AzStorageBlobContent
   [-Blob] <String>
   [-Container] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   -CloudBlob <CloudBlob>
   [-BlobBaseClient <BlobBaseClient>]
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   -CloudBlobContainer <CloudBlobContainer>
   [-Blob] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   [-Destination <String>]
   -AbsoluteUri <String>
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De cmdlet Get-AzStorageBlobContent downloadt de opgegeven opslagblob. Als de blobnaam niet geldig is voor de lokale computer, wordt deze door deze cmdlet automatisch omgezet als dit mogelijk is.

Voorbeelden

Voorbeeld 1: Blob-inhoud op naam downloaden

Get-AzStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"

Met deze opdracht wordt een blob op naam gedownload.

Voorbeeld 2: Blob-inhoud downloaden met behulp van de pijplijn

Get-AzStorageBlob -Container containername -Blob blobname | Get-AzStorageBlobContent

Met deze opdracht wordt de pijplijn gebruikt om blob-inhoud te zoeken en te downloaden.

Voorbeeld 3: Blob-inhoud downloaden met behulp van de pijplijn en een jokerteken

Get-AzStorageContainer container* | Get-AzStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"

In dit voorbeeld wordt het jokerteken sterretje en de pijplijn gebruikt om blob-inhoud te zoeken en te downloaden.

Voorbeeld 4: Een blobobject ophalen en opslaan in een variabele en vervolgens blob-inhoud downloaden met het blobobject

$blob = Get-AzStorageBlob -Container containername -Blob blobname 
Get-AzStorageBlobContent -CloudBlob $blob.ICloudBlob -Destination "C:\test"

In dit voorbeeld wordt eerst een blobobject opgehaald en opgeslagen in een variabele en vervolgens blob-inhoud met het blobobject gedownload.

Voorbeeld 5: Een blob-inhoud downloaden met blob-URI

Get-AzStorageBlobContent -Uri $blobUri -Destination "C:\test" -Force

In dit voorbeeld wordt een blob-inhoud met Uri gedownload. De URI kan een URI met sas-token zijn. Als de blob zich op een beheerd schijfaccount bevindt en de server een Bearer-token vereist naast Sas Uri om te downloaden, probeert de cmdlet een bearer-token te genereren met een door de server geretourneerde doelgroep en de aanmeldingS-AAD-gebruiker credentail. Download vervolgens blob met zowel Sas Uri als bearer-token.

Parameters

-AbsoluteUri

Blob-URI waaruit u wilt downloaden.

Type:String
Aliassen:Uri, BlobUri
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-AsJob

Voer de cmdlet op de achtergrond uit.

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

-Blob

Hiermee geeft u de naam van de blob die moet worden gedownload.

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

-BlobBaseClient

BlobBaseClient-object

Type:BlobBaseClient
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
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

-CloudBlob

Hiermee geeft u een cloud-blob op. Gebruik de cmdlet Get-AzStorageBlob om een CloudBlob-object te verkrijgen.

Type:CloudBlob
Aliassen:ICloudBlob
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-CloudBlobContainer

Hiermee geeft u een CloudBlobContainer-object op uit de Azure Storage-clientbibliotheek. U kunt deze maken of de cmdlet Get-AzStorageContainer gebruiken.

Type:CloudBlobContainer
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
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

-Container

Hiermee geeft u de naam van de container met de blob die u wilt downloaden.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Context

Hiermee geeft u het Azure-opslagaccount op waaruit u blob-inhoud wilt downloaden. U kunt de cmdlet New-AzStorageContext gebruiken om een opslagcontext te maken.

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 de locatie voor het opslaan van het gedownloade bestand.

Type:String
Aliassen:Path
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Overschrijft een bestaand bestand zonder bevestiging.

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

-TagCondition

Optionele tagexpressie-instructie om overeenkomstvoorwaarde te controleren. De blobaanvraag mislukt wanneer de blobtags niet overeenkomen met de opgegeven expressie. Zie voor details https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Type:String
Position:Named
Default value:None
Vereist:False
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

CloudBlob

CloudBlobContainer

IStorageContext

Uitvoerwaarden

AzureStorageBlob

Notities

  • Als de blobnaam ongeldig is voor de lokale computer, wordt deze met deze cmdlet automatisch hersteld, indien mogelijk.