Copy-AzStorageBlob

Reference

Modul:: Az.Storage

Synchronně zkopírujte objekt blob.

Syntax

Copy-AzStorageBlob
    [-SrcBlob] <String>
    -SrcContainer <String>
    -DestContainer <String>
    [-DestBlob <String>]
    [-DestBlobType <String>]
    [-StandardBlobTier <String>]
    [-RehydratePriority <RehydratePriority>]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DestContext <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Copy-AzStorageBlob
    [-BlobBaseClient <BlobBaseClient>]
    -DestContainer <String>
    [-DestBlob <String>]
    [-DestBlobType <String>]
    [-StandardBlobTier <String>]
    [-RehydratePriority <RehydratePriority>]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DestContext <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Copy-AzStorageBlob
    -AbsoluteUri <String>
    -DestContainer <String>
    -DestBlob <String>
    [-DestBlobType <String>]
    [-StandardBlobTier <String>]
    [-RehydratePriority <RehydratePriority>]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DestContext <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Rutina Copy-AzStorageBlob synchronně kopíruje objekt blob, aktuálně podporuje pouze objekt blob bloku.

Příklady

Příklad 1: Zkopírování pojmenovaného objektu blob do jiného

$destBlob = Copy-AzStorageBlob -SrcContainer "sourcecontainername" -SrcBlob "srcblobname" -DestContainer "destcontainername" -DestBlob "destblobname"

Tento příkaz zkopíruje objekt blob ze zdrojového kontejneru do cílového kontejneru s novým názvem objektu blob.

Příklad 2: Kopírování objektu blob z objektu blob

$srcBlob = Get-AzStorageBlob -Container $containerName -Blob $blobName  -Context $ctx 
$destBlob =  $srcBlob | Copy-AzStorageBlob  -DestContainer "destcontainername" -DestBlob "destblobname"

Tento příkaz zkopíruje objekt blob ze zdrojového objektu blob do cílového kontejneru s novým názvem objektu blob.

Příklad 3: Kopírování objektu blob z identifikátoru URI objektu blob

$srcBlobUri = New-AzStorageBlobSASToken -Container $srcContainerName -Blob $srcBlobName -Permission rt -ExpiryTime (Get-Date).AddDays(7) -FullUri 
$destBlob = Copy-AzStorageBlob -AbsoluteUri $srcBlobUri -DestContainer "destcontainername" -DestBlob "destblobname"

První příkaz vytvoří identifikátor URI objektu blob zdrojového objektu blob s tokenem SAS s oprávněním rt. Druhý příkaz zkopíruje z identifikátoru URI zdrojového objektu blob do cílového objektu blob.

Příklad 4: Aktualizace oboru šifrování objektu blob bloku

$blob = Copy-AzStorageBlob -SrcContainer $containerName -SrcBlob $blobname -DestContainer $containername -EncryptionScope $newScopeName -Force

Tento příkaz aktualizuje obor šifrování objektů blob bloku tak, že ho zkopíruje do sebe s novým oborem šifrování.

Příklad 5: Zkopírování objektu blob do nového doplňovacího objektu blob

$srcBlob = Get-AzStorageBlob -Container $containerName -Blob $blobName  -Context $ctx 
$destBlob = Copy-AzStorageBlob -SrcContainer "sourcecontainername" -SrcBlob "srcblobname" -DestContainer "destcontainername" -DestBlob "destblobname" -DestBlobType "Append" -DestContext $destCtx

Parametry

-AbsoluteUri

Identifikátor URI zdrojového objektu blob

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

-AsJob

Spuštění rutiny na pozadí

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

-BlobBaseClient

Objekt BlobBaseClient

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Context

Zdrojový objekt kontextu služby Azure Storage

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

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

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

-DestBlob

Název cílového objektu blob

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

-DestBlobType

Typ cílového objektu blob

Type:	String
Accepted values:	Block, Page, Append
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DestContainer

Název cílového kontejneru

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

-DestContext

Objekt kontextu cílového úložiště

Type:	IStorageContext
Aliases:	DestinationContext
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionScope

Obor šifrování, který se má použít při provádění požadavků na objekt blob dest.

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

-Force

Vynucení přepsání existujícího objektu blob nebo souboru

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

-RehydratePriority

RehydratePriority objektu blob bloku. Určuje prioritu, se kterou se má dosadit archivovaný objekt blob. Platné hodnoty jsou High/Standard.

Type:	RehydratePriority
Accepted values:	Standard, High
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SrcBlob

Název objektu blob

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

-SrcContainer

Název zdrojového kontejneru

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

-StandardBlobTier

Úroveň objektu blob bloku, platné hodnoty jsou horká, studená, archivní/ studená. Zobrazit podrobnosti v tématu https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-storage-tiers

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

-TagCondition

Volitelný příkaz výrazu Tag pro kontrolu podmínky shody. Požadavek na objekt blob selže, pokud značky objektů blob neodpovídají danému výrazu. Podrobnosti najdete v https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operationstématu .

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

BlobBaseClient

String

IStorageContext

Výstupy

AzureStorageBlob