Start-AzureStorageBlobCopy

  • Référence
Module:
Azure.Storage

Commence à copier un objet blob.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

Start-AzureStorageBlobCopy
     [-SrcBlob] <String>
     -SrcContainer <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -CloudBlob <CloudBlob>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -CloudBlob <CloudBlob>
     -DestCloudBlob <CloudBlob>
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -CloudBlobContainer <CloudBlobContainer>
     [-SrcBlob] <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -SrcShareName <String>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -SrcShare <CloudFileShare>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -SrcDir <CloudFileDirectory>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -SrcFile <CloudFile>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -SrcFile <CloudFile>
     -DestCloudBlob <CloudBlob>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzureStorageBlobCopy
     -AbsoluteUri <String>
     -DestContainer <String>
     -DestBlob <String>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

L’applet de commande Start-AzureStorageBlobCopy commence à copier un objet blob.

Exemples

Exemple 1 : Copier un objet blob nommé

C:\PS>Start-AzureStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives" -SrcContainer "ContosoUploads"

Cette commande démarre l’opération de copie de l’objet blob nommé ContosoPlanning2015 à partir du conteneur nommé ContosoUploads vers le conteneur nommé ContosoArchives.

Exemple 2 : Obtenir un conteneur pour spécifier des objets blob à copier

C:\PS>Get-AzureStorageContainer -Name "ContosoUploads" | Start-AzureStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives"

Cette commande obtient le conteneur nommé ContosoUploads, à l’aide de l’applet de commande Get-AzureStorageContainer , puis transmet le conteneur à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. Cette applet de commande démarre l’opération de copie de l’objet blob nommé ContosoPlanning2015. L’applet de commande précédente fournit le conteneur source. Le paramètre DestContainer spécifie ContosoArchives comme conteneur de destination.

Exemple 3 : Obtenir tous les objets blob dans un conteneur et les copier

C:\PS>Get-AzureStorageBlob -Container "ContosoUploads" | Start-AzureStorageBlobCopy -DestContainer "ContosoArchives"

Cette commande obtient les objets blob dans le conteneur nommé ContosoUploads, à l’aide de l’applet de commande Get-AzureStorageBlob , puis transmet les résultats à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. Cette applet de commande démarre l’opération de copie des objets blob dans le conteneur nommé ContosoArchives.

Exemple 4 : Copier un objet blob spécifié en tant qu’objet

C:\PS>$SrcBlob = Get-AzureStorageBlob -Container "ContosoUploads" -Blob "ContosoPlanning2015"
C:\PS> $DestBlob = Get-AzureStorageBlob -Container "ContosoArchives" -Blob "ContosoPlanning2015Archived"
C:\PS> Start-AzureStorageBlobCopy -ICloudBlob $SrcBlob.ICloudBlob -DestICloudBlob $DestBlob.ICloudBlob

La première commande obtient l’objet blob nommé ContosoPlanning2015 dans le conteneur nommé ContosoUploads. La commande stocke cet objet dans la variable $SrcBlob. La deuxième commande obtient l’objet blob nommé ContosoPlanning2015Archived dans le conteneur nommé ContosoArchives. La commande stocke cet objet dans la variable $DestBlob. La dernière commande démarre l’opération de copie du conteneur source vers le conteneur de destination. La commande utilise la notation par points standard pour spécifier les objets ICloudBlob pour les objets blob $SrcBlob et $DestBlob.

Exemple 5 : Copier un objet blob à partir d’un URI

C:\PS>$Context = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
C:\PS> Start-AzureStorageBlobCopy -AbsoluteUri "http://www.contosointernal.com/planning" -DestContainer "ContosoArchive" -DestBlob "ContosoPlanning2015" -DestContext $Context

Cette commande crée un contexte pour le compte nommé ContosoGeneral qui utilise la clé spécifiée, puis stocke cette clé dans la variable $Context. La deuxième commande copie le fichier de l’URI spécifié dans l’objet blob nommé ContosoPlanning dans le conteneur nommé ContosoArchive. La commande démarre l’opération de copie dans le contexte stocké dans $Context.

Paramètres

-AbsoluteUri

Spécifie l’URI absolu d’un fichier à copier dans un objet blob Stockage Azure.

Type:String
Alias:SrcUri, SourceUri
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CloudBlob

Spécifie un objet CloudBlob de Stockage Azure bibliothèque cliente. Pour obtenir un objet CloudBlob , utilisez l’applet de commande Get-AzureStorageBlob.

Type:CloudBlob
Alias:SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-CloudBlobContainer

Spécifie un objet CloudBlobContainer de la bibliothèque cliente Stockage Azure. Cette applet de commande copie un objet blob à partir du conteneur spécifié par ce paramètre. Pour obtenir un objet CloudBlobContainer , utilisez l’applet de commande Get-AzureStorageContainer.

Type:CloudBlobContainer
Alias:SourceCloudBlobContainer
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Context

Spécifie un contexte de stockage Azure. Pour obtenir un contexte de stockage, utilisez l’applet de commande New-AzureStorageContext.

Type:IStorageContext
Alias:SrcContext, SourceContext
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

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

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestBlob

Spécifie le nom de l’objet blob de destination.

Type:String
Alias:DestinationBlob
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestCloudBlob

Spécifie un objet CloudBlob de destination

Type:CloudBlob
Alias:DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestContainer

Spécifie le nom du conteneur de destination.

Type:String
Alias:DestinationContainer
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestContext

Spécifie un contexte de stockage Azure. Pour obtenir un contexte de stockage, utilisez l’applet de commande New-AzureStorageContext.

Type:IStorageContext
Alias:DestinationContext
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Indique que cette applet de commande remplace l’objet blob de destination sans vous inviter à confirmer.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PremiumPageBlobTier

Niveau d’objet blob de pages Premium

Type:PremiumPageBlobTier
Valeurs acceptées:Unknown, P4, P6, P10, P20, P30, P40, P50, P60
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SrcBlob

Spécifie le nom de l’objet blob source.

Type:String
Alias:SourceBlob
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SrcContainer

Spécifie le nom du conteneur source.

Type:String
Alias:SourceContainer
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SrcDir

Spécifie un objet CloudFileDirectory de Stockage Azure bibliothèque cliente.

Type:CloudFileDirectory
Alias:SourceDir
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SrcFile

Specifes a CloudFile object from Stockage Azure Client library. Vous pouvez le créer ou utiliser l’applet de commande Get-AzureStorageFile.

Type:CloudFile
Alias:SourceFile
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SrcFilePath

Spécifie le chemin relatif du fichier source du répertoire source ou du partage source.

Type:String
Alias:SourceFilePath
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SrcShare

Spécifie un objet CloudFileShare de Stockage Azure bibliothèque cliente. Vous pouvez le créer ou utiliser l’applet de commande Get-AzureStorageShare.

Type:CloudFileShare
Alias:SourceShare
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SrcShareName

Spécifie le nom du partage source.

Type:String
Alias:SourceShareName
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

CloudBlob

CloudBlobContainer

CloudFile

Paramètres : SrcFile (ByValue)

String

IStorageContext

Sorties

AzureStorageBlob