Copy-AzStorageBlob

Reference

Modul:: Az.Storage

Synchronně zkopírujte objekt blob.

Syntaxe

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 kopíruje objekt blob synchronně, 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

Typ:	String
Aliasy:	SrcUri, SourceUri
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-AsJob

Spuštění rutiny na pozadí

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-BlobBaseClient

Objekt BlobBaseClient

Typ:	BlobBaseClient
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Context

Zdrojový objekt kontextu služby Azure Storage

Typ:	IStorageContext
Aliasy:	SrcContext, SourceContext
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Aliasy:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DestBlob

Název cílového objektu blob

Typ:	String
Aliasy:	DestinationBlob
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DestBlobType

Typ cílového objektu blob

Typ:	String
Přípustné hodnoty:	Block, Page, Append
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DestContainer

Název cílového kontejneru

Typ:	String
Aliasy:	DestinationContainer
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DestContext

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

Typ:	IStorageContext
Aliasy:	DestinationContext
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EncryptionScope

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Force

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RehydratePriority

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

Typ:	RehydratePriority
Přípustné hodnoty:	Standard, High
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SrcBlob

Název objektu blob

Typ:	String
Aliasy:	SourceBlob
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SrcContainer

Název zdrojového kontejneru

Typ:	String
Aliasy:	SourceContainer
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StandardBlobTier

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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-operations.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

BlobBaseClient

String

IStorageContext

Výstupy

AzureStorageBlob

Sdílet prostřednictvím