Start-AzStorageBlobCopy

Referentie

Module:: Az.Storage

Begint met het kopiëren van een blob.

Syntaxis

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

De cmdlet Start-AzStorageBlobCopy begint een blob te kopiëren.

Voorbeelden

Voorbeeld 1: Een benoemde blob kopiëren

Start-AzStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives" -SrcContainer "ContosoUploads"

Met deze opdracht start u de kopieerbewerking van de blob met de naam ContosoPlanning2015 van de container ContosoUploads naar de container met de naam ContosoArchives.

Voorbeeld 2: Een container ophalen om blobs op te geven die moeten worden gekopieerd

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

Met deze opdracht haalt u de container contosoUploads op met behulp van de Get-AzStorageContainer cmdlet en geeft u de container vervolgens door aan de huidige cmdlet met behulp van de pijplijnoperator. Deze cmdlet start de kopieerbewerking van de blob met de naam ContosoPlanning2015. De vorige cmdlet biedt de broncontainer. De parameter DestContainer specificeert ContosoArchives als doelcontainer.

Voorbeeld 3: Alle blobs in een container ophalen en kopiëren

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

Met deze opdracht worden de blobs opgehaald in de container met de naam ContosoUploads, met behulp van de cmdlet Get-AzStorageBlob en worden de resultaten vervolgens doorgegeven aan de huidige cmdlet met behulp van de pijplijnoperator. Met deze cmdlet wordt de kopieerbewerking van de blobs gestart naar de container met de naam ContosoArchives.

Voorbeeld 4: Een blob kopiëren die is opgegeven als een object

$SrcBlob = Get-AzStorageBlob -Container "ContosoUploads" -Blob "ContosoPlanning2015"
$DestBlob = Get-AzStorageBlob -Container "ContosoArchives" -Blob "ContosoPlanning2015Archived"
Start-AzStorageBlobCopy -ICloudBlob $SrcBlob.ICloudBlob -DestICloudBlob $DestBlob.ICloudBlob

De eerste opdracht haalt de blob met de naam ContosoPlanning2015 op in de container met de naam ContosoUploads. Met de opdracht wordt dat object opgeslagen in de $SrcBlob variabele. Met de tweede opdracht wordt de blob met de naam ContosoPlanning2015Archived opgehaald in de container met de naam ContosoArchives. Met de opdracht wordt dat object opgeslagen in de variabele $DestBlob. Met de laatste opdracht wordt de kopieerbewerking van de broncontainer naar de doelcontainer gestart. De opdracht maakt gebruik van standaard punt notatie om de ICloudBlob objecten voor de $SrcBlob en $DestBlob blobs op te geven.

Voorbeeld 5: Een blob kopiëren vanuit een 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

Met deze opdracht maakt u een context voor het account met de naam ContosoGeneral dat gebruikmaakt van de opgegeven sleutel en slaat u die sleutel vervolgens op in de $Context variabele. De tweede opdracht kopieert het bestand van de opgegeven URI naar de blob met de naam ContosoPlanning in de container met de naam ContosoArchive. Met de opdracht wordt de kopieerbewerking gestart naar de doelcontext die is opgeslagen in $Context. Er is geen bronopslagcontext, dus de bron-URI moet toegang hebben tot het bronobject. Bijvoorbeeld: als de bron een openbare Azure-blob is, moet de URI SAS-token bevatten dat leestoegang heeft tot de blob.

Voorbeeld 6: Een blok-blob kopiëren naar de doelcontainer met een nieuwe blobnaam en doelblob StandardBlobTier instellen als Dynamisch, RehydratePriority als Hoog

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

Met deze opdracht start u de kopieerbewerking van een blok-blob naar de doelcontainer met een nieuwe blobnaam en stelt u de doel-blob StandardBlobTier in als Dynamisch, RehydratePriority als Hoog

Parameters

-AbsoluteUri

Hiermee geeft u de absolute URI van een bestand dat moet worden gekopieerd naar een Azure Storage-blob.

Type:	String
Aliassen:	SrcUri, SourceUri
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-BlobBaseClient

BlobBaseClient-object

Type:	BlobBaseClient
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ClientTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de clientzijde op, in seconden, voor één serviceaanvraag. Als de vorige aanroep mislukt in het opgegeven interval, probeert deze cmdlet de aanvraag opnieuw uit te voeren. Als deze cmdlet geen geslaagd antwoord ontvangt voordat het interval is verstreken, retourneert deze cmdlet een fout.

Type:	Nullable<T>[Int32]
Aliassen:	ClientTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CloudBlob

Hiermee geeft u een CloudBlob-object uit de Azure Storage-clientbibliotheek. Als u een CloudBlob--object wilt verkrijgen, gebruikt u de cmdlet Get-AzStorageBlob.

Type:	CloudBlob
Aliassen:	SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-CloudBlobContainer

Hiermee geeft u een CloudBlobContainer-object uit de Azure Storage-clientbibliotheek. Met deze cmdlet wordt een blob gekopieerd uit de container die met deze parameter wordt opgegeven. Als u een CloudBlobContainer-object wilt verkrijgen, gebruikt u de cmdlet Get-AzStorageContainer.

Type:	CloudBlobContainer
Aliassen:	SourceCloudBlobContainer
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ConcurrentTaskCount

Hiermee geeft u het maximum aantal gelijktijdige netwerkaanroepen op. U kunt deze parameter gebruiken om de gelijktijdigheid te beperken om het lokale CPU- en bandbreedtegebruik te beperken door het maximum aantal gelijktijdige netwerkaanroepen op te geven. De opgegeven waarde is een absoluut aantal en wordt niet vermenigvuldigd met het aantal kernen. Deze parameter kan helpen bij het verminderen van netwerkverbindingsproblemen in omgevingen met lage bandbreedte, zoals 100 kilobits per seconde. De standaardwaarde is 10.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Context

Hiermee geeft u een Azure-opslagcontext op. Gebruik de cmdlet New-AzStorageContext om een opslagcontext te verkrijgen.

Type:	IStorageContext
Aliassen:	SrcContext, SourceContext
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DestBlob

Hiermee geeft u de naam van de doel-blob.

Type:	String
Aliassen:	DestinationBlob
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DestCloudBlob

Hiermee geeft u een doel CloudBlob-object

Type:	CloudBlob
Aliassen:	DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DestContainer

Hiermee geeft u de naam van de doelcontainer.

Type:	String
Aliassen:	DestinationContainer
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DestContext

Hiermee geeft u een Azure-opslagcontext op. Gebruik de cmdlet New-AzStorageContext om een opslagcontext te verkrijgen.

Type:	IStorageContext
Aliassen:	DestinationContext
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DestTagCondition

Optionele tagexpressie-instructie om de overeenkomstvoorwaarde op de doel-blob te controleren. De blobaanvraag mislukt wanneer de doel-blobtags niet overeenkomen met de opgegeven expressie. Zie de details in https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Force

Geeft aan dat deze cmdlet de doel-blob overschrijft zonder dat u om bevestiging wordt gevraagd.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PremiumPageBlobTier

Premium-pagina-bloblaag

Type:	PremiumPageBlobTier
Geaccepteerde waarden:	Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RehydratePriority

Blok-blobrehydratePriority. Geeft de prioriteit aan waarmee een gearchiveerde blob moet worden gerehydrateerd. Geldige waarden zijn Hoog/Standaard.

Type:	RehydratePriority
Geaccepteerde waarden:	Standard, High
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ServerTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de servicezijde op, in seconden, voor een aanvraag. Als het opgegeven interval is verstreken voordat de service de aanvraag verwerkt, retourneert de opslagservice een fout.

Type:	Nullable<T>[Int32]
Aliassen:	ServerTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SrcBlob

Hiermee geeft u de naam van de bron-blob.

Type:	String
Aliassen:	SourceBlob
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SrcContainer

Hiermee geeft u de naam van de broncontainer.

Type:	String
Aliassen:	SourceContainer
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SrcDir

Hiermee geeft u een CloudFileDirectory-object uit de Azure Storage-clientbibliotheek.

Type:	CloudFileDirectory
Aliassen:	SourceDir
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SrcFile

Hiermee geeft u een CloudFile-object uit de Azure Storage-clientbibliotheek. U kunt deze maken of Get-AzStorageFile cmdlet gebruiken.

Type:	CloudFile
Aliassen:	SourceFile
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SrcFilePath

Hiermee geeft u het relatieve pad van het bronbestand van de bronmap of bronshare.

Type:	String
Aliassen:	SourceFilePath
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SrcShare

Hiermee geeft u een CloudFileShare-object uit de Azure Storage-clientbibliotheek. U kunt deze maken of Get-AzStorageShare cmdlet gebruiken.

Type:	CloudFileShare
Aliassen:	SourceShare
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SrcShareName

Hiermee geeft u de naam van de bronshare.

Type:	String
Aliassen:	SourceShareName
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-StandardBlobTier

Blok-bloblaag, geldige waarden zijn dynamisch/statisch/archief/koud. Zie de details in https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Tag

Blobtags

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-TagCondition

Optionele tagexpressie-instructie om de overeenkomstvoorwaarde op de bron-blob te controleren. De blobaanvraag mislukt wanneer de bron-blobtags niet overeenkomen met de opgegeven expressie. Zie de details in https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

CloudBlob

CloudBlobContainer

CloudFile

String

IStorageContext

Uitvoerwaarden

AzureStorageBlob

Delen via