Udostępnij za pośrednictwem

Copy-AzStorageBlob

  • Odwołanie
Moduł:
Az.Storage

Skopiuj obiekt blob synchronicznie.

Składnia

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>]

Opis

Polecenie cmdlet Copy-AzStorageBlob kopiuje obiekt blob synchronicznie, obecnie obsługuje tylko blokowy obiekt blob.

Przykłady

Przykład 1. Kopiowanie nazwanego obiektu blob do innego

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

To polecenie kopiuje obiekt blob z kontenera źródłowego do kontenera docelowego z nową nazwą obiektu blob.

Przykład 2. Kopiowanie obiektu blob z obiektu blob

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

To polecenie kopiuje obiekt blob z obiektu źródłowego obiektu blob do kontenera docelowego o nowej nazwie obiektu blob.

Przykład 3. Kopiowanie obiektu blob z identyfikatora URI obiektu 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"

Pierwsze polecenie tworzy identyfikator URI obiektu blob źródłowego obiektu blob z tokenem sas uprawnienia "rt". Drugie polecenie kopiuje identyfikator URI źródłowego obiektu blob do docelowego obiektu blob.

Przykład 4. Aktualizowanie zakresu szyfrowania blokowych obiektów blob

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

To polecenie aktualizuje zakres szyfrowania blokowych obiektów blob, kopiując go do samego siebie przy użyciu nowego zakresu szyfrowania.

Przykład 5. Kopiowanie obiektu blob do nowego uzupełnialnych obiektów 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

Identyfikator URI źródłowego obiektu blob

Typ:String
Aliasy:SrcUri, SourceUri
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-AsJob

Uruchamianie polecenia cmdlet w tle

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-BlobBaseClient

Obiekt BlobBaseClient

Typ:BlobBaseClient
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Context

Źródłowy obiekt kontekstu usługi Azure Storage

Typ:IStorageContext
Aliasy:SrcContext, SourceContext
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DestBlob

Nazwa docelowego obiektu blob

Typ:String
Aliasy:DestinationBlob
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DestBlobType

Docelowy typ obiektu blob

Typ:String
Dopuszczalne wartości:Block, Page, Append
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DestContainer

Nazwa kontenera docelowego

Typ:String
Aliasy:DestinationContainer
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DestContext

Docelowy obiekt kontekstu magazynu

Typ:IStorageContext
Aliasy:DestinationContext
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EncryptionScope

Zakres szyfrowania, który ma być używany podczas podejmowania żądań do dest blob.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymuszanie zastąpienia istniejącego obiektu blob lub pliku

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RehydratePriority

Blokowy obiekt blob RehydratePriority. Wskazuje priorytet, za pomocą którego ma być przywracany zarchiwizowany obiekt blob. Prawidłowe wartości to Wysoka/Standardowa.

Typ:RehydratePriority
Dopuszczalne wartości:Standard, High
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SrcBlob

Nazwa obiektu blob

Typ:String
Aliasy:SourceBlob
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SrcContainer

Nazwa kontenera źródłowego

Typ:String
Aliasy:SourceContainer
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StandardBlobTier

Warstwa blokowych obiektów blob, prawidłowe wartości to Gorąca/Chłodna/Archiwum/Zimno. Zobacz szczegóły w https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-storage-tiers

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TagCondition

Opcjonalna instrukcja wyrażenia tagu w celu sprawdzenia warunku dopasowania. Żądanie obiektu blob zakończy się niepowodzeniem, gdy tagi obiektów blob nie są zgodne z danym wyrażeniem. Zobacz szczegóły w https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

Dane wyjściowe