Start-AzStorageBlobCopy

Référence

Module:: Az.Storage

Commence à copier un objet blob.

Syntaxe

Start-AzStorageBlobCopy
     [-SrcBlob] <String>
     -SrcContainer <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -CloudBlob <CloudBlob>
     [-BlobBaseClient <BlobBaseClient>]
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -CloudBlob <CloudBlob>
     [-BlobBaseClient <BlobBaseClient>]
     -DestCloudBlob <CloudBlob>
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -CloudBlobContainer <CloudBlobContainer>
     [-SrcBlob] <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -SrcShareName <String>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -SrcShare <CloudFileShare>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -SrcDir <CloudFileDirectory>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -SrcFile <CloudFile>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -SrcFile <CloudFile>
     -DestCloudBlob <CloudBlob>
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzStorageBlobCopy
     -AbsoluteUri <String>
     -DestContainer <String>
     -DestBlob <String>
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

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

Exemples

Exemple 1 : Copier un objet blob nommé

Start-AzStorageBlobCopy -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

Get-AzStorageContainer -Name "ContosoUploads" | Start-AzStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives"

Cette commande obtient le conteneur nommé ContosoUploads, à l’aide de l’applet de commande Get-AzStorageContainer , 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

Get-AzStorageBlob -Container "ContosoUploads" | Start-AzStorageBlobCopy -DestContainer "ContosoArchives"

Cette commande obtient les objets blob dans le conteneur nommé ContosoUploads, à l’aide de l’applet de commande Get-AzStorageBlob , 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

$SrcBlob = Get-AzStorageBlob -Container "ContosoUploads" -Blob "ContosoPlanning2015"
$DestBlob = Get-AzStorageBlob -Container "ContosoArchives" -Blob "ContosoPlanning2015Archived"
Start-AzStorageBlobCopy -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

$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
Start-AzStorageBlobCopy -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 de destination stocké dans $Context. Il n’existe aucun contexte de stockage source. L’URI source doit donc avoir accès à l’objet source. Par exemple, si la source n’est pas un objet blob Azure public, l’URI doit contenir un jeton SAP qui a accès en lecture à l’objet blob.

Exemple 6 : Copier un objet blob de blocs dans un conteneur de destination avec un nouveau nom d’objet blob et définir l’objet blob de destination StandardBlobTier comme Hot, RehydratePriority en tant que High

Start-AzStorageBlobCopy -SrcContainer "ContosoUploads" -SrcBlob "BlockBlobName" -DestContainer "ContosoArchives" -DestBlob "NewBlockBlobName" -StandardBlobTier Hot -RehydratePriority High

Cette commande démarre l’opération de copie d’un objet blob de blocs vers un conteneur de destination avec un nouveau nom d’objet blob et définit l’objet blob de destination StandardBlobTier comme Hot, RehydratePriority as High

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

-BlobBaseClient

Objet BlobBaseClient

Type:	BlobBaseClient
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
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]
Alias:	ClientTimeoutPerRequestInSeconds
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-AzStorageBlob.

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

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 la commande cmdlet.

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

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

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

-DestTagCondition

Instruction d’expression tag facultative pour vérifier la condition de correspondance sur l’objet blob de destination. La demande d’objet blob échoue lorsque les balises d’objet blob de destination 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.

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

-RehydratePriority

Block Blob RehydratePriority. Indique la priorité avec laquelle réalimenter un objet blob archivé. Les valeurs valides sont High/Standard.

Type:	RehydratePriority
Valeurs acceptées:	Standard, High
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]
Alias:	ServerTimeoutPerRequestInSeconds
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

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

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

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

-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

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

-Tag

Balises d’objets blob

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

-TagCondition

Instruction d’expression tag facultative pour vérifier la condition de correspondance sur l’objet blob source. La demande d’objet blob échoue lorsque les balises d’objet blob source 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.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
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

String

IStorageContext

Sorties

AzureStorageBlob

Partager via