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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Accepted values:	Block, Page, Append
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CloudBlob

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

Type:	CloudBlob
Aliases:	ICloudBlob
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	CloudBlobContainer
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Container

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IStorageContext
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-File

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

Type:	String
Aliases:	FullName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Metadata

Specifica i metadati per il BLOB caricato.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PremiumPageBlobTier

Livello BLOB di pagine

Type:	PremiumPageBlobTier
Accepted values:	Unknown, P4, P6, P10, P20, P30, P40, P50, P60
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Properties

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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

String

CloudBlobContainer

CloudBlob

IStorageContext

Output

AzureStorageBlob