Start-AzStorageFileCopy

  • Referenz
Modul:
Az.Storage

Beginnt mit dem Kopieren einer Quelldatei.

Syntax

Start-AzStorageFileCopy
     -SrcBlobName <String>
     -SrcContainerName <String>
     -DestShareName <String>
     -DestFilePath <String>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DisAllowDestTrailingDot]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageFileCopy
     -SrcBlobName <String>
     -SrcContainer <CloudBlobContainer>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageFileCopy
     -SrcBlob <CloudBlob>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageFileCopy
     -SrcBlob <CloudBlob>
     [-DestFile <CloudFile>]
     [-DestShareFileClient <ShareFileClient>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageFileCopy
     -SrcFilePath <String>
     -SrcShareName <String>
     -DestShareName <String>
     -DestFilePath <String>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DisAllowSourceTrailingDot]
     [-DisAllowDestTrailingDot]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageFileCopy
     -SrcFilePath <String>
     -SrcShare <CloudFileShare>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageFileCopy
     -SrcFile <CloudFile>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageFileCopy
     -SrcFile <CloudFile>
     [-DestFile <CloudFile>]
     [-DestShareFileClient <ShareFileClient>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageFileCopy
     -AbsoluteUri <String>
     -DestShareName <String>
     -DestFilePath <String>
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageFileCopy
     -AbsoluteUri <String>
     [-DestFile <CloudFile>]
     [-DestShareFileClient <ShareFileClient>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Das Cmdlet "Start-AzStorageFileCopy " beginnt, eine Quelldatei in eine Zieldatei zu kopieren. Dieses Cmdlet löst eine asynchrone Blobkopie aus, der Kopiervorgang wird vom Server verarbeitet. Wenn es sich um eine kontoübergreifende BLOB-Kopie handelt, gibt es keine SLA für die BLOB-Kopie.

Beispiele

Beispiel 1: Starten des Kopiervorgangs von Datei zu Datei mithilfe des Freigabenamens und des Dateinamens

Start-AzStorageFileCopy -SrcShareName "ContosoShare01" -SrcFilePath "FilePath01" -DestShareName "ContosoShare02" -DestFilePath "FilePath02"

Mit diesem Befehl wird ein Kopiervorgang von Datei zu Datei gestartet. Der Befehl gibt den Freigabenamen und dateinamen an.

Beispiel 2: Starten des Kopiervorgangs von blob zu Datei mithilfe des Containernamens und des Blobnamens

Start-AzStorageFileCopy -SrcContainerName "ContosoContainer01" -SrcBlobName "ContosoBlob01" -DestShareName "ContosoShare" -DestFilePath "FilePath02"

Mit diesem Befehl wird ein Kopiervorgang von BLOB zu Datei gestartet. Der Befehl gibt den Containernamen und den BLOB-Namen an.

Parameter

-AbsoluteUri

Gibt den URI der Quelldatei an. Wenn für den Quellspeicherort eine Anmeldeinformation erforderlich ist, müssen Sie eine angeben.

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

-ClientTimeoutPerRequest

Gibt das clientseitige Timeoutintervall in Sekunden für eine Serviceanfrage an. Wenn der vorherige Aufruf im angegebenen Intervall fehlschlägt, führt dieses Cmdlet die Anforderung erneut aus. Wenn dieses Cmdlet vor Ablauf des Intervalls keine erfolgreiche Antwort erhält, gibt dieses Cmdlet einen Fehler zurück.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Gibt die maximalen gleichzeitigen Netzwerkanrufe an. Mit diesem Parameter können Sie die Parallelität einschränken, um die lokale CPU- und Bandbreitenauslastung zu drosseln, indem Sie die maximale Anzahl gleichzeitiger Netzwerkanrufe angeben. Der angegebene Wert ist eine absolute Anzahl und wird nicht mit der Kernanzahl multipliziert. Dieser Parameter kann dazu beitragen, Netzwerkverbindungsprobleme in Umgebungen mit geringer Bandbreite zu reduzieren, z. B. 100 Kilobit pro Sekunde. Der Standardwert ist 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Context

Gibt einen Azure Storage-Kontext an. Verwenden Sie zum Abrufen eines Kontexts das Cmdlet New-AzStorageContext.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-DestContext

Gibt den Azure Storage-Kontext des Ziels an. Verwenden Sie "New-AzStorageContext", um einen Kontext zu erhalten.

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

-DestFile

Gibt ein CloudFile -Objekt an. Sie können eine Clouddatei erstellen oder mithilfe des Cmdlets "Get-AzStorageFile" abrufen.

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

-DestFilePath

Gibt den Pfad der Zieldatei relativ zur Zielfreigabe an.

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

-DestShareFileClient

Das ShareFileClient-Objekt hat die Dest-Datei angegeben.

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

-DestShareName

Gibt den Namen der Zielfreigabe an.

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

-DisAllowDestTrailingDot

Zulassen des nachfolgenden Punkts (.) zum Suffix des Zielverzeichnisses und der Zieldateinamen.

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

-DisAllowSourceTrailingDot

Verbieten Sie nachgestellten Punkt (.) das Suffix des Quellverzeichnisses und der Quelldateinamen.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-ServerTimeoutPerRequest

Gibt die Länge des Timeoutzeitraums für den Serverteil einer Anforderung an.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SrcBlob

Gibt ein CloudBlob -Objekt an. Sie können ein Cloud-Blob erstellen oder ein Blob abrufen, indem Sie das Cmdlet "Get-AzStorageBlob" verwenden.

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

-SrcBlobName

Gibt den Namen des Quell-BLOB an.

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

-SrcContainer

Gibt ein Cloud-BLOB-Containerobjekt an. Sie können cloud-BLOB-Containerobjekt erstellen oder das Cmdlet Get-AzStorageContainer verwenden.

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

-SrcContainerName

Gibt den Namen des Quellcontainers an.

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

-SrcFile

Gibt ein CloudFile -Objekt an. Sie können eine Clouddatei erstellen oder eine abrufen, indem Sie "Get-AzStorageFile" verwenden.

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

-SrcFilePath

Gibt den Pfad der Quelldatei relativ zum Quellverzeichnis oder zur Quellfreigabe an.

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

-SrcShare

Gibt ein Clouddateifreigabeobjekt an. Mit dem Cmdlet "Get-AzStorageShare" können Sie eine Clouddateifreigabe erstellen oder eine abrufen.

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

-SrcShareName

Gibt den Namen der Quellfreigabe an.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

CloudBlob

CloudFile

IStorageContext

Ausgaben

AzureStorageFile