Start-AzureStorageBlobCopy

Odwołanie

Moduł:: Azure.Storage

Rozpoczyna kopiowanie obiektu blob.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

Start-AzureStorageBlobCopy
     [-SrcBlob] <String>
     -SrcContainer <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -CloudBlob <CloudBlob>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -CloudBlob <CloudBlob>
     -DestCloudBlob <CloudBlob>
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -CloudBlobContainer <CloudBlobContainer>
     [-SrcBlob] <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -SrcShareName <String>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -SrcShare <CloudFileShare>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -SrcDir <CloudFileDirectory>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -SrcFile <CloudFile>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -SrcFile <CloudFile>
     -DestCloudBlob <CloudBlob>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -AbsoluteUri <String>
     -DestContainer <String>
     -DestBlob <String>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Opis

Polecenie cmdlet Start-AzureStorageBlobCopy rozpoczyna kopiowanie obiektu blob.

Przykłady

Przykład 1. Kopiowanie nazwanego obiektu blob

C:\PS>Start-AzureStorageBlobCopy -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

C:\PS>Get-AzureStorageContainer -Name "ContosoUploads" | Start-AzureStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives"

To polecenie pobiera kontener o nazwie ContosoUploads przy użyciu polecenia cmdlet Get-AzureStorageContainer , 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

C:\PS>Get-AzureStorageBlob -Container "ContosoUploads" | Start-AzureStorageBlobCopy -DestContainer "ContosoArchives"

To polecenie pobiera obiekty blob w kontenerze o nazwie ContosoUploads przy użyciu polecenia cmdlet Get-AzureStorageBlob , 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

C:\PS>$SrcBlob = Get-AzureStorageBlob -Container "ContosoUploads" -Blob "ContosoPlanning2015"
C:\PS> $DestBlob = Get-AzureStorageBlob -Container "ContosoArchives" -Blob "ContosoPlanning2015Archived"
C:\PS> Start-AzureStorageBlobCopy -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

C:\PS>$Context = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
C:\PS> Start-AzureStorageBlobCopy -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 w kontekście przechowywanym w $Context.

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

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

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-AzureStorageContainer.

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-AzureStorageContext.

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-AzureStorageContext.

Typ:	IStorageContext
Aliasy:	DestinationContext
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
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]
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-AzureStorageFile.

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-AzureStorageShare.

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

-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

Parametry: SrcFile (ByValue)

String

IStorageContext

Dane wyjściowe

AzureStorageBlob

Udostępnij za pośrednictwem

Start-AzureStorageBlobCopy

Składnia

Opis

Przykłady

Przykład 1. Kopiowanie nazwanego obiektu blob

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

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

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

Przykład 5. Kopiowanie obiektu blob z identyfikatora URI

Parametry

-AbsoluteUri

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Context

-DefaultProfile

-DestBlob

-DestCloudBlob

-DestContainer

-DestContext

-Force

-PremiumPageBlobTier

-ServerTimeoutPerRequest

-SrcBlob

-SrcContainer

-SrcDir

-SrcFile

-SrcFilePath

-SrcShare

-SrcShareName

-WhatIf

Dane wejściowe

Dane wyjściowe

Dodatkowe zasoby

Udostępnij za pośrednictwem

Start-AzureStorageBlobCopy

Składnia

Opis

Przykłady

Przykład 1. Kopiowanie nazwanego obiektu blob

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

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

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

Przykład 5. Kopiowanie obiektu blob z identyfikatora URI

Parametry

-AbsoluteUri

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Context

-DefaultProfile

-DestBlob

-DestCloudBlob

-DestContainer

-DestContext

-Force

-PremiumPageBlobTier

-ServerTimeoutPerRequest

-SrcBlob

-SrcContainer

-SrcDir

-SrcFile

-SrcFilePath

-SrcShare

-SrcShareName

-WhatIf

Dane wejściowe

Dane wyjściowe

Linki powiązane

Dodatkowe zasoby