Start-AzStorageFileCopy

  • Referencia
Módulo:
Az.Storage

Comienza a copiar un archivo de origen.

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

Description

El cmdlet Start-AzStorageFileCopy comienza a copiar un archivo de origen en un archivo de destino. Este cmdlet desencadenará la copia asincrónica del blob, el servidor controla el proceso de copia. Si se trata de una copia de blobs entre cuentas, no hay ningún Acuerdo de Nivel de Servicio para la copia del blob.

Ejemplos

Ejemplo 1: Iniciar la operación de copia del archivo al archivo mediante el nombre del recurso compartido y el nombre de archivo

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

Este comando inicia una operación de copia del archivo al archivo. El comando especifica el nombre del recurso compartido y el nombre de archivo.

Ejemplo 2: Iniciar la operación de copia del blob al archivo mediante el nombre del contenedor y el nombre del blob

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

Este comando inicia una operación de copia del blob al archivo. El comando especifica el nombre del contenedor y el nombre del blob.

Parámetros

-AbsoluteUri

Especifica el URI del archivo de origen. Si la ubicación de origen requiere una credencial, debe proporcionar una.

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

-ClientTimeoutPerRequest

Especifica el intervalo de tiempo de espera del lado cliente, en segundos, para una solicitud de servicio. Si se produce un error en la llamada anterior en el intervalo especificado, este cmdlet reintenta la solicitud. Si este cmdlet no recibe una respuesta correcta antes de que transcurre el intervalo, este cmdlet devuelve un error.

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

-ConcurrentTaskCount

Especifica el número máximo de llamadas de red simultáneas. Puede usar este parámetro para limitar la simultaneidad para limitar el uso de ancho de banda y CPU local especificando el número máximo de llamadas de red simultáneas. El valor especificado es un recuento absoluto y no se multiplica por el recuento de núcleos. Este parámetro puede ayudar a reducir los problemas de conexión de red en entornos de ancho de banda bajo, como 100 kilobits por segundo. El valor predeterminado es 10.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Context

Especifica un contexto de Azure Storage. Para obtener un contexto, use el cmdlet New-AzStorageContext.

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

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

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

-DestContext

Especifica el contexto de Azure Storage del destino. Para obtener un contexto, use New-AzStorageContext.

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

-DestFile

Especifica un objeto CloudFile . Puede crear un archivo en la nube o obtener uno mediante el cmdlet Get-AzStorageFile.

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

-DestFilePath

Especifica la ruta de acceso del archivo de destino en relación con el recurso compartido de destino.

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

-DestShareFileClient

El objeto ShareFileClient indica el archivo Dest.

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

-DestShareName

Especifica el nombre del recurso compartido de destino.

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

-DisAllowDestTrailingDot

No permitir el punto final (.) al directorio de destino de sufijo y los nombres de archivo de destino.

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

-DisAllowSourceTrailingDot

No permitir el punto final (.) al directorio de origen del sufijo y los nombres de archivo de origen.

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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

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

-ServerTimeoutPerRequest

Especifica el período de tiempo de espera para la parte del servidor de una solicitud.

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

-SrcBlob

Especifica un objeto CloudBlob . Puede crear un blob en la nube o obtener uno mediante el cmdlet Get-AzStorageBlob.

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

-SrcBlobName

Especifica el nombre del blob de origen.

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

-SrcContainer

Especifica un objeto contenedor de blobs en la nube. Puede crear un objeto contenedor de blobs en la nube o usar el cmdlet Get-AzStorageContainer.

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

-SrcContainerName

Especifica el nombre del contenedor de origen.

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

-SrcFile

Especifica un objeto CloudFile . Puede crear un archivo en la nube o obtener uno mediante Get-AzStorageFile.

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

-SrcFilePath

Especifica la ruta de acceso del archivo de origen en relación con el directorio de origen o el recurso compartido de origen.

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

-SrcShare

Especifica un objeto de recurso compartido de archivos en la nube. Puede crear un recurso compartido de archivos en la nube o obtener uno mediante el cmdlet Get-AzStorageShare.

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

-SrcShareName

Especifica el nombre del recurso compartido de origen.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

CloudBlob

CloudFile

IStorageContext

Salidas

AzureStorageFile