Set-AzureStorageBlobContent

  • Riferimento
Modulo:
Azure.Storage

Carica un file locale in un BLOB Archiviazione di Azure.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Set-AzureStorageBlobContent
   [-File] <String>
   [-Container] <String>
   [-Blob <String>]
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   [-Blob <String>]
   -CloudBlobContainer <CloudBlobContainer>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   -CloudBlob <CloudBlob>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-Azure Archiviazione BlobContent carica un file locale in un BLOB Archiviazione di Azure.

Esempio

Esempio 1: Caricare un file denominato

PS C:\>Set-AzureStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"

Questo comando carica il file denominato PlanningData in un BLOB denominato Planning2015.

Esempio 2: Caricare tutti i file nella cartella corrente

PS C:\>Get-ChildItem -File -Recurse | Set-AzureStorageBlobContent -Container "ContosoUploads"

Questo comando usa il cmdlet principale di Windows PowerShell Get-ChildItem per ottenere tutti i file nella cartella corrente e nelle sottocartelle e quindi li passa al cmdlet corrente usando l'operatore pipeline. Il cmdlet Set-Azure Archiviazione BlobContent carica i file nel contenitore denominato ContosoUploads.

Esempio 3: Sovrascrivere un BLOB esistente

PS C:\>Get-AzureStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzureStorageBlobContent -File "ContosoPlanning"

Questo comando ottiene il BLOB denominato Planning2015 nel contenitore ContosoUploads usando il cmdlet Get-Azure Archiviazione Blob e quindi passa tale BLOB al cmdlet corrente. Il comando carica il file denominato ContosoPlanning come Planning2015. Questo comando non specifica il parametro Force . Il comando richiede la conferma. Se si conferma il comando, il cmdlet sovrascrive il BLOB esistente.

Esempio 4: Caricare un file in un contenitore usando la pipeline

PS C:\>Get-AzureStorageContainer -Container "ContosoUpload*" | Set-AzureStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

Questo comando ottiene il contenitore che inizia con la stringa ContosoUpload usando il cmdlet Get-Azure Archiviazione Container e quindi passa tale BLOB al cmdlet corrente. Il comando carica il file denominato ContosoPlanning come Planning2015.

Esempio 5: Caricare un file nel BLOB di pagine con metadati e PremiumPageBlobTier come P10

PS C:\>$Metadata = @{"key" = "value"; "name" = "test"}
PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10

Il primo comando crea una tabella hash che contiene metadati per un BLOB e archivia tale tabella hash nella variabile $Metadata. Il secondo comando carica il file denominato ContosoPlanning nel contenitore denominato ContosoUploads. Il BLOB include i metadati archiviati in $Metadata e ha PremiumPageBlobTier come P10.

Esempio 6: Caricare un file nel BLOB con le proprietà del BLOB specificate

PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Properties @{"ContentType" = "image/jpeg"; "ContentMD5" = "i727sP7HigloQDsqadNLHw=="}

Questo comando carica il file denominato ContosoPlanning nel contenitore denominato ContosoUploads con le proprietà del BLOB specificate.

Parametri

-Blob

Specifica il nome di un BLOB. Questo cmdlet carica un file nel BLOB Archiviazione di Azure specificato da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BlobType

Specifica il tipo per il BLOB caricato da questo cmdlet. I valori validi per questo parametro sono:

  • Blocca
  • Page Il valore predefinito è Block.
Tipo:String
Valori accettati:Block, Page, Append
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClientTimeoutPerRequest

Specifica l'intervallo di timeout lato client, espresso in secondi, per una richiesta di servizio. Se la chiamata precedente ha esito negativo nell'intervallo specificato, questo cmdlet ritenta la richiesta. Se questo cmdlet non riceve una risposta corretta prima della scadenza dell'intervallo, questo cmdlet restituisce un errore.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CloudBlob

Specifica un oggetto CloudBlob . Per ottenere un oggetto CloudBlob, usare il cmdlet Get-Azure Archiviazione Blob.

Tipo:CloudBlob
Alias:ICloudBlob
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-CloudBlobContainer

Specifica un oggetto CloudBlobContainer dalla libreria client Archiviazione di Azure. Questo cmdlet carica il contenuto in un BLOB nel contenitore specificato da questo parametro. Per ottenere un oggetto CloudBlobContainer, usare il cmdlet Get-Azure Archiviazione Container.

Tipo:CloudBlobContainer
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ConcurrentTaskCount

Specifica il numero massimo di chiamate di rete simultanee. È possibile usare questo parametro per limitare la concorrenza per limitare l'utilizzo della CPU e della larghezza di banda locali specificando il numero massimo di chiamate di rete simultanee. Il valore specificato è un conteggio assoluto e non viene moltiplicato per il numero di core. Questo parametro consente di ridurre i problemi di connessione di rete in ambienti a larghezza di banda ridotta, ad esempio 100 kilobit al secondo. Il valore predefinito è 10.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Container

Specifica il nome di un contenitore. Questo cmdlet carica un file in un BLOB nel contenitore specificato da questo parametro.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Context

Specifica un contesto di archiviazione di Azure. Per ottenere un contesto di archiviazione, usare il cmdlet New-Azure Archiviazione Context. Per usare un contesto di archiviazione creato da un token di firma di accesso condiviso senza autorizzazione di lettura, è necessario aggiungere il parametro -Force per ignorare l'esistenza del BLOB di controllo.

Tipo:IStorageContext
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-File

Specifica un percorso di file locale per il caricamento di un file come contenuto BLOB.

Tipo:String
Alias:FullName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Force

Indica che questo cmdlet sovrascrive un BLOB esistente senza chiedere conferma.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Metadata

Specifica i metadati per il BLOB caricato.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PremiumPageBlobTier

Livello BLOB di pagine

Tipo:PremiumPageBlobTier
Valori accettati:Unknown, P4, P6, P10, P20, P30, P40, P50, P60
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Properties

Specifica le proprietà per il BLOB caricato. Le proprietà supportate sono: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServerTimeoutPerRequest

Specifica l'intervallo di timeout sul lato servizio, espresso in secondi, per una richiesta. Se l'intervallo specificato è trascorso prima che il servizio elabori la richiesta, il servizio di archiviazione restituisce un errore.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

CloudBlobContainer

CloudBlob

IStorageContext

Output

AzureStorageBlob