Start-AzStorageBlobCopy

Begint met het kopiëren van een blob.

Syntax

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 cmdlet Get-AzStorageContainer 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 de 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 Get-AzStorageBlob-cmdlet 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
Aliases:SrcUri, SourceUri
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BlobBaseClient

BlobBaseClient-object

Type:BlobBaseClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CloudBlob

Hiermee geeft u een CloudBlob-object op uit de Azure Storage-clientbibliotheek. Gebruik de cmdlet Get-AzStorageBlob om een CloudBlob-object te verkrijgen.

Type:CloudBlob
Aliases:SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CloudBlobContainer

Hiermee geeft u een CloudBlobContainer-object op uit de Azure Storage-clientbibliotheek. Met deze cmdlet wordt een blob gekopieerd uit de container die met deze parameter wordt opgegeven. Gebruik de cmdlet Get-AzStorageContainer om een CloudBlobContainer-object op te halen.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Context

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

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

-DefaultProfile

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

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

-DestBlob

Hiermee geeft u de naam van de doel-blob.

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

-DestCloudBlob

Hiermee geeft u een doel CloudBlob-object

Type:CloudBlob
Aliases:DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DestContainer

Hiermee geeft u de naam van de doelcontainer.

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

-DestContext

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

Type:IStorageContext
Aliases:DestinationContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 voor details 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PremiumPageBlobTier

Premium-pagina-bloblaag

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

-RehydratePriority

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

Type:RehydratePriority
Accepted values:Standard, High
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SrcBlob

Hiermee geeft u de naam van de bron-blob.

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

-SrcContainer

Hiermee geeft u de naam van de broncontainer.

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

-SrcDir

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

Type:CloudFileDirectory
Aliases:SourceDir
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SrcFile

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

Type:CloudFile
Aliases:SourceFile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SrcFilePath

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

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

-SrcShare

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

Type:CloudFileShare
Aliases:SourceShare
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SrcShareName

Hiermee geeft u de naam van de bronshare.

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

-StandardBlobTier

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

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

-Tag

Blobtags

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

CloudBlob

CloudBlobContainer

CloudFile

String

IStorageContext

Uitvoerwaarden

AzureStorageBlob