Start-AzStorageBlobCopy

Odwołanie

Moduł:: Az.Storage

Rozpoczyna kopiowanie obiektu blob.

Składnia

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

Opis

Polecenie cmdlet Start-AzStorageBlobCopy rozpoczyna kopiowanie obiektu blob.

Przykłady

Przykład 1. Kopiowanie nazwanego obiektu blob

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

To polecenie uruchamia operację kopiowania obiektu blob o nazwie ContosoPlanning2015 z kontenera o nazwie ContosoUploads do kontenera o nazwie ContosoArchives.

Przykład 2. Pobieranie kontenera w celu określenia obiektów blob do skopiowania

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

To polecenie pobiera kontener o nazwie ContosoUploads przy użyciu polecenia cmdlet Get-AzStorageContainer , a następnie przekazuje kontener do bieżącego polecenia cmdlet przy użyciu operatora potoku. To polecenie cmdlet uruchamia operację kopiowania obiektu blob o nazwie ContosoPlanning2015. Poprzednie polecenie cmdlet udostępnia kontener źródłowy. Parametr DestContainer określa contosoArchives jako kontener docelowy.

Przykład 3. Pobieranie wszystkich obiektów blob w kontenerze i kopiowanie ich

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

To polecenie pobiera obiekty blob w kontenerze o nazwie ContosoUploads przy użyciu polecenia cmdlet Get-AzStorageBlob , a następnie przekazuje wyniki do bieżącego polecenia cmdlet przy użyciu operatora potoku. To polecenie cmdlet uruchamia operację kopiowania obiektów blob do kontenera o nazwie ContosoArchives.

Przykład 4. Kopiowanie obiektu blob określonego jako obiektu

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

Pierwsze polecenie pobiera obiekt blob o nazwie ContosoPlanning2015 w kontenerze o nazwie ContosoUploads. Polecenie przechowuje ten obiekt w zmiennej $SrcBlob. Drugie polecenie pobiera obiekt blob o nazwie ContosoPlanning2015Archived w kontenerze o nazwie ContosoArchives. Polecenie przechowuje ten obiekt w zmiennej $DestBlob. Ostatnie polecenie uruchamia operację kopiowania z kontenera źródłowego do kontenera docelowego. Polecenie używa standardowej notacji kropkowej, aby określić obiekty ICloudBlob dla $SrcBlob i $DestBlob obiektów blob.

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

To polecenie tworzy kontekst dla konta o nazwie ContosoGeneral, który używa określonego klucza, a następnie przechowuje ten klucz w zmiennej $Context. Drugie polecenie kopiuje plik z określonego identyfikatora URI do obiektu blob o nazwie ContosoPlanning w kontenerze o nazwie ContosoArchive. Polecenie uruchamia operację kopiowania do kontekstu docelowego przechowywanego w $Context. Nie ma kontekstu magazynu źródłowego, więc źródłowy identyfikator URI musi mieć dostęp do obiektu źródłowego. Na przykład: jeśli źródło nie jest publicznym obiektem blob platformy Azure, identyfikator URI powinien zawierać token SAS, który ma dostęp do odczytu do obiektu blob.

Przykład 6: Kopiowanie blokowego obiektu blob do kontenera docelowego z nową nazwą obiektu blob i ustawianie docelowego obiektu blob StandardBlobTier jako Gorąca, Ponowne wypełnianiepriority jako Wysoka

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

To polecenie uruchamia operację kopiowania blokowego obiektu blob do kontenera docelowego z nową nazwą obiektu blob i ustawia docelowy obiekt blob StandardBlobTier jako Gorąca, RehydratePriority jako Wysoki

Parametry

-AbsoluteUri

Określa bezwzględny identyfikator URI pliku do skopiowania do obiektu blob usługi Azure Storage.

Typ:	String
Aliasy:	SrcUri, SourceUri
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
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

-ClientTimeoutPerRequest

Określa interwał limitu czasu po stronie klienta w sekundach dla jednego żądania obsługi. Jeśli poprzednie wywołanie zakończy się niepowodzeniem w określonym interwale, to polecenie cmdlet ponawia próbę żądania. Jeśli to polecenie cmdlet nie otrzyma pomyślnej odpowiedzi przed upływem interwału, to polecenie cmdlet zwróci błąd.

Typ:	Nullable<T>[Int32]
Aliasy:	ClientTimeoutPerRequestInSeconds
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CloudBlob

Określa obiekt CloudBlob z biblioteki klienta usługi Azure Storage. Aby uzyskać obiekt CloudBlob , użyj polecenia cmdlet Get-AzStorageBlob.

Typ:	CloudBlob
Aliasy:	SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-CloudBlobContainer

Określa obiekt CloudBlobContainer z biblioteki klienta usługi Azure Storage. To polecenie cmdlet kopiuje obiekt blob z kontenera, który określa ten parametr. Aby uzyskać obiekt CloudBlobContainer , użyj polecenia cmdlet Get-AzStorageContainer.

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

-ConcurrentTaskCount

Określa maksymalne współbieżne wywołania sieciowe. Tego parametru można użyć, aby ograniczyć współbieżność w celu ograniczenia użycia lokalnego procesora CPU i przepustowości, określając maksymalną liczbę współbieżnych wywołań sieciowych. Określona wartość jest liczbą bezwzględną i nie jest mnożona przez liczbę rdzeni. Ten parametr może pomóc w zmniejszeniu problemów z połączeniem sieciowym w środowiskach o niskiej przepustowości, takich jak 100 kilobitów na sekundę. Wartość domyślna to 10.

Typ:	Nullable<T>[Int32]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Context

Określa kontekst usługi Azure Storage. Aby uzyskać kontekst magazynu, użyj polecenia cmdlet New-AzStorageContext.

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

Określa nazwę 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

-DestCloudBlob

Określa docelowy obiekt CloudBlob

Typ:	CloudBlob
Aliasy:	DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DestContainer

Określa nazwę 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

Określa kontekst usługi Azure Storage. Aby uzyskać kontekst magazynu, użyj polecenia cmdlet New-AzStorageContext.

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

-DestTagCondition

Opcjonalna instrukcja wyrażenia tagu w celu sprawdzenia warunku dopasowania w docelowym obiekcie blob. Żądanie obiektu blob zakończy się niepowodzeniem, gdy docelowe tagi obiektów blob nie są zgodne z danym wyrażeniem. Zobacz szczegóły na stronie 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

-Force

Wskazuje, że to polecenie cmdlet zastępuje docelowy obiekt blob bez monitowania o potwierdzenie.

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

-PremiumPageBlobTier

Warstwa stronicowego obiektu blob w warstwie Premium

Typ:	PremiumPageBlobTier
Dopuszczalne wartości:	Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
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

-ServerTimeoutPerRequest

Określa interwał limitu czasu po stronie usługi w sekundach dla żądania. Jeśli określony interwał upłynie, zanim usługa przetworzy żądanie, usługa magazynu zwróci błąd.

Typ:	Nullable<T>[Int32]
Aliasy:	ServerTimeoutPerRequestInSeconds
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SrcBlob

Określa nazwę źródłowego 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

Określa nazwę 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

-SrcDir

Określa obiekt CloudFileDirectory z biblioteki klienta usługi Azure Storage.

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

-SrcFile

Określa obiekt CloudFile z biblioteki klienta usługi Azure Storage. Można go utworzyć lub użyć polecenia cmdlet Get-AzStorageFile.

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

-SrcFilePath

Określa ścieżkę względną pliku źródłowego katalogu źródłowego lub udziału źródłowego.

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

-SrcShare

Określa obiekt CloudFileShare z biblioteki klienta usługi Azure Storage. Możesz go utworzyć lub użyć polecenia cmdlet Get-AzStorageShare.

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

-SrcShareName

Określa nazwę udziału źródłowego.

Typ:	String
Aliasy:	SourceShareName
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/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

-Tag

Tagi obiektów blob

Typ:	Hashtable
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 w źródłowym obiekcie blob. Żądanie obiektu blob zakończy się niepowodzeniem, gdy źródłowe tagi obiektów blob nie są zgodne z danym wyrażeniem. Zobacz szczegóły na stronie 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 po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

CloudBlob

CloudBlobContainer

CloudFile

String

IStorageContext

Dane wyjściowe

AzureStorageBlob

Udostępnij za pośrednictwem