Condividi tramite

Set-AzStorageBlobContent

  • Riferimento
Modulo:
Az.Storage

Carica un file locale in un BLOB Archiviazione di Azure.

Sintassi

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

Descrizione

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

Esempio

Esempio 1: Caricare un file denominato

Set-AzStorageBlobContent -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

Get-ChildItem -File -Recurse | Set-AzStorageBlobContent -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-AzStorageBlobContent carica i file nel contenitore denominato ContosoUploads.

Esempio 3: Sovrascrivere un BLOB esistente

Get-AzStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzStorageBlobContent -File "ContosoPlanning"

Questo comando ottiene il BLOB denominato Planning2015 nel contenitore ContosoUploads usando il cmdlet Get-AzStorageBlob 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

Get-AzStorageContainer -Container "ContosoUpload*" | Set-AzStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

Questo comando ottiene il contenitore che inizia con la stringa ContosoUpload usando il cmdlet Get-AzStorageContainer 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

$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -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 e impostare StandardBlobTier come sporadico

$filepath = "c:\temp\index.html"
Set-AzStorageBlobContent -File $filepath -Container "contosouploads" -Properties @{"ContentType" = [System.Web.MimeMapping]::GetMimeMapping($filepath); "ContentMD5" = "i727sP7HigloQDsqadNLHw=="} -StandardBlobTier Cool

AccountName: storageaccountname, ContainerName: contosouploads

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
index.html           BlockBlob 403116          text/html                      2020-09-22 08:06:53Z Cool                                    False

Questo comando carica il file c:\temp\index.html nel contenitore denominato contosouploads con le proprietà del BLOB specificate e imposta StandardBlobTier come sporadico. Questo comando ottiene il valore ContentType impostato su proprietà BLOB dall'API [System.Web.MimeMapping]::GetMimeMapping().

Esempio 7: Caricare un file in un BLOB con ambito di crittografia

$blob = Set-AzStorageBlobContent  -File "mylocalfile" -Container "mycontainer" -Blob "myblob"  -EncryptionScope "myencryptscope"

$blob.BlobProperties.EncryptionScope

myencryptscope

Questo comando carica un file in un BLOB con ambito di crittografia.

Parametri

-AsJob

Eseguire il cmdlet in background.

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

-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
  • Pagina
  • Aggiunta

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]
Alias:ClientTimeoutPerRequestInSeconds
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-AzStorageBlob.

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-AzStorageContainer.

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-AzStorageContext. 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

-EncryptionScope

Ambito di crittografia da usare quando si effettuano richieste al BLOB.

Tipo:String
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, P70, P80
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]
Alias:ServerTimeoutPerRequestInSeconds
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StandardBlobTier

Livello BLOB in blocchi, i valori validi sono ad accesso frequente/sporadico/archivio/accesso sporadico. Vedere i dettagli in https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

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

-Tag

Tag BLOB

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

-TagCondition

Istruzione di espressione tag facoltativa per controllare la condizione di corrispondenza. La richiesta BLOB avrà esito negativo quando i tag BLOB non corrispondono all'espressione specificata. Vedere i dettagli in https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Tipo:String
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