Share via


Start-AzureStorageFileCopy

Beginnt mit dem Kopieren einer Quelldatei.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

Das Cmdlet "Start-AzureStorageFileCopy " beginnt, eine Quelldatei in eine Zieldatei zu kopieren.

Beispiele

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

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

PS C:\>Start-AzureStorageFileCopy -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]
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-AzureStorageContext.

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-AzureStorageContext", 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 eine abrufen, indem Sie das Cmdlet Get-AzureStorageFile verwenden.

Type:CloudFile
Position:Named
Default value:None
Required:True
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

-DestShareName

Gibt den Namen der Zielfreigabe an.

Type:String
Position:Named
Default value:None
Required:True
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]
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 mithilfe des Cmdlets "Get-AzureStorageBlob" abrufen.

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-AzureStorageContainer 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 mit Get-AzureStorageFile abrufen.

Type: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-AzureStorageShare" können Sie eine Clouddateifreigabe erstellen oder eine abrufen.

Type: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

Parameter: SrcFile (ByValue)

IStorageContext

Ausgaben

Void