Partager via


Set-AzStorageBlobContent

Charge un fichier local dans un objet blob stockage Azure.

Syntaxe

SendManual (Par défaut)

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>]

ContainerPipeline

Set-AzStorageBlobContent
    [-File] <String>
    -CloudBlobContainer <CloudBlobContainer>
    [-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>]

BlobPipeline

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>]

Description

L’applet de commande Set-AzStorageBlobContent charge un fichier local dans un objet blob Stockage Azure.

Exemples

Exemple 1 : Charger un fichier nommé

Set-AzStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"

Cette commande charge le fichier nommé PlanningData dans un objet blob nommé Planning2015.

Exemple 2 : Charger tous les fichiers sous le dossier actif

Get-ChildItem -File -Recurse | Set-AzStorageBlobContent -Container "ContosoUploads"

Cette commande utilise l’applet de commande Windows PowerShell principale Get-ChildItem pour obtenir tous les fichiers dans le dossier actif et dans les sous-dossiers, puis les transmet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande Set-AzStorageBlobContent charge les fichiers dans le conteneur nommé ContosoUploads.

Exemple 3 : Remplacer un objet blob existant

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

Cette commande obtient l’objet blob nommé Planning2015 dans le conteneur ContosoUploads à l’aide de l’applet de commande Get-AzStorageBlob, puis transmet cet objet blob à l’applet de commande actuelle. La commande charge le fichier nommé ContosoPlanning comme Planning2015. Cette commande ne spécifie pas le paramètre Force . La commande vous invite à confirmer. Si vous confirmez la commande, l’applet de commande remplace l’objet blob existant.

Exemple 4 : Charger un fichier dans un conteneur à l’aide du pipeline

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

Cette commande obtient le conteneur qui commence par la chaîne ContosoUpload à l’aide de l’applet de commande Get-AzStorageContainer , puis transmet cet objet blob à l’applet de commande actuelle. La commande charge le fichier nommé ContosoPlanning comme Planning2015.

Exemple 5 : Charger un fichier dans un objet blob de pages avec des métadonnées et PremiumPageBlobTier en tant que P10

$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10

La première commande crée une table de hachage qui contient des métadonnées pour un objet blob et stocke cette table de hachage dans la variable $Metadata. La deuxième commande charge le fichier nommé ContosoPlanning dans le conteneur nommé ContosoUploads. L’objet blob inclut les métadonnées stockées dans $Metadata et a PremiumPageBlobTier comme P10.

Exemple 6 : Charger un fichier dans un objet blob avec des propriétés d’objet blob spécifiées et définir StandardBlobTier comme Cool

$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

Cette commande charge le fichier c :\temp\index.html dans le conteneur nommé contosouploads avec les propriétés d’objet blob spécifiées et définit StandardBlobTier comme Cool. Cette commande obtient la valeur ContentType définie sur les propriétés d’objet blob par l’API [System.Web.MimeMapping] ::GetMimeMapping().

Exemple 7 : Charger un fichier dans un objet blob avec étendue de chiffrement

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

$blob.BlobProperties.EncryptionScope
myencryptscope

Cette commande charge un fichier dans un objet blob avec l’étendue de chiffrement.

Paramètres

-AsJob

Exécutez l’applet de commande en arrière-plan.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Blob

Spécifie le nom d’un objet blob. Cette applet de commande charge un fichier dans l’objet blob Stockage Azure spécifié par ce paramètre.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SendManual
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
ContainerPipeline
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-BlobType

Spécifie le type de l’objet blob que cette applet de commande charge. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Block
  • Page
  • Append

La valeur par défaut est Block.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:Block, Page, Append
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ClientTimeoutPerRequest

Spécifie l’intervalle de délai d’attente côté client, en secondes, pour une demande de service. Si l’appel précédent échoue dans l’intervalle spécifié, cette applet de commande retente la requête. Si cette applet de commande ne reçoit pas de réponse réussie avant l’expiration de l’intervalle, cette applet de commande retourne une erreur.

Propriétés du paramètre

Type:

Nullable<T>[Int32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-CloudBlob

Spécifie un objet CloudBlob . Pour obtenir un objet CloudBlob , utilisez l’applet de commande Get-AzStorageBlob.

Propriétés du paramètre

Type:Microsoft.Azure.Storage.Blob.CloudBlob
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ICloudBlob

Jeux de paramètres

BlobPipeline
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-CloudBlobContainer

Spécifie un objet CloudBlobContainer à partir de la bibliothèque cliente stockage Azure. Cette applet de commande charge le contenu dans un objet blob dans le conteneur spécifié par ce paramètre. Pour obtenir un objet CloudBlobContainer , utilisez l’applet de commande Get-AzStorageContainer.

Propriétés du paramètre

Type:Microsoft.Azure.Storage.Blob.CloudBlobContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ContainerPipeline
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ConcurrentTaskCount

Spécifie le nombre maximal d’appels réseau simultanés. Vous pouvez utiliser ce paramètre pour limiter l’accès concurrentiel pour limiter l’utilisation du processeur local et de la bande passante en spécifiant le nombre maximal d’appels réseau simultanés. La valeur spécifiée est un nombre absolu et n’est pas multipliée par le nombre de cœurs. Ce paramètre peut aider à réduire les problèmes de connexion réseau dans des environnements à faible bande passante, tels que 100 kilobits par seconde. La valeur par défaut est 10.

Propriétés du paramètre

Type:

Nullable<T>[Int32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Container

Spécifie le nom d’un conteneur. Cette applet de commande charge un fichier dans un objet blob dans le conteneur spécifié par ce paramètre.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SendManual
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Context

Spécifie un contexte de stockage Azure. Pour obtenir un contexte de stockage, utilisez l’applet de commande New-AzStorageContext. Pour utiliser un contexte de stockage créé à partir d’un jeton SAP sans autorisation de lecture, vous devez ajouter -Force paramètre pour ignorer l’existence de l’objet blob.

Propriétés du paramètre

Type:IStorageContext
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EncryptionScope

Étendue de chiffrement à utiliser lors de l’établissement de requêtes adressées à l’objet blob.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-File

Spécifie un chemin d’accès de fichier local pour qu’un fichier soit chargé en tant que contenu d’objet blob.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:FullName

Jeux de paramètres

SendManual
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Force

Indique que cette applet de commande remplace un objet blob existant sans vous inviter à confirmer.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Metadata

Spécifie les métadonnées de l’objet blob chargé.

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PremiumPageBlobTier

Niveau d’objet blob de page

Propriétés du paramètre

Type:Microsoft.Azure.Storage.Blob.PremiumPageBlobTier
Valeur par défaut:None
Valeurs acceptées:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Properties

Spécifie les propriétés de l’objet blob chargé. Les propriétés prises en charge sont : CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ServerTimeoutPerRequest

Spécifie l’intervalle de délai d’expiration côté service, en secondes, pour une demande. Si l’intervalle spécifié s’écoule avant que le service traite la requête, le service de stockage retourne une erreur.

Propriétés du paramètre

Type:

Nullable<T>[Int32]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StandardBlobTier

Niveau d’objet blob de blocs, les valeurs valides sont Hot/Cool/Archive/Cold. Voir les détails dans https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Tag

Balises d’objets blob

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-TagCondition

Instruction d’expression tag facultative pour vérifier la condition de correspondance. La demande d’objet blob échoue lorsque les balises d’objet blob ne correspondent pas à l’expression donnée. Voir les détails dans https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Microsoft.Azure.Storage.Blob.CloudBlobContainer

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Sorties

AzureStorageBlob