Lezen in het Engels

Delen via

Get-AzStorageBlobContent

  • Referentie
Module:
Az.Storage

Hiermee downloadt u een opslagblob.

Syntaxis

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

Description

De Get-AzStorageBlobContent cmdlet downloadt de opgegeven opslag-blob. 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

PowerShell 
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

PowerShell 
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

PowerShell 
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

PowerShell 
$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

PowerShell 
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. Als u een CloudBlob--object wilt verkrijgen, gebruikt u de cmdlet Get-AzStorageBlob.

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

-CloudBlobContainer

Hiermee geeft u een CloudBlobContainer-object 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

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

-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 de details in 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

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

Uitvoerwaarden

Notities

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