Rename-AzStorageFile

Módulo:

Az.Storage Module

Cambia el nombre de un archivo.

Sintaxis

ShareName (valor predeterminado)

Rename-AzStorageFile
    [-ShareName] <String>
    [-SourcePath] <String>
    [[-DestinationPath] <String>]
    [-ContentType <String>]
    [-Permission <String>]
    [-DisAllowSourceTrailingDot]
    [-DisAllowDestTrailingDot]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-IgnoreReadonly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FileObject

Rename-AzStorageFile
    [-ShareFileClient] <ShareFileClient>
    [[-DestinationPath] <String>]
    [-ContentType <String>]
    [-Permission <String>]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-IgnoreReadonly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ShareObject

Rename-AzStorageFile
    [-ShareClient] <ShareClient>
    [-SourcePath] <String>
    [[-DestinationPath] <String>]
    [-ContentType <String>]
    [-Permission <String>]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-IgnoreReadonly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DirecotryObject

Rename-AzStorageFile
    [-ShareDirectoryClient] <ShareDirectoryClient>
    [-SourcePath] <String>
    [[-DestinationPath] <String>]
    [-ContentType <String>]
    [-Permission <String>]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-IgnoreReadonly]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Rename-AzStorageFile cambia el nombre de un directorio de un recurso compartido de archivos.

Ejemplos

Ejemplo 1: Cambiar el nombre de un archivo de un recurso compartido de archivos

Rename-AzStorageFile -SourcePath testfile1 -DestinationPath testfile2 -ShareName myshare

AccountName: myaccount, ShareName: myshare

Type                Length Name
----                ------ ----
File                   512 testfile2

Este comando cambia el nombre de un archivo de testfile1 a testfile2 en el recurso compartido de archivos myshare.

Ejemplo 2: Cambiar el nombre de un archivo de un recurso compartido de archivos mediante la canalización

Get-AzStorageFile -ShareName myshare -Path testfile1 | Rename-AzStorageFile -DestinationPath testfile2

AccountName: myaccount, ShareName: myshare

Type                Length Name
----                ------ ----
File                   512 testfile2

Este comando obtiene primero un objeto de cliente de archivo y cambia el nombre del archivo de testfile1 a testfile2 mediante la canalización.

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	cf

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ContentType

Establece el tipo de contenido MIME del archivo. El tipo predeterminado es "application/octet-stream".

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Context

Objeto de contexto de Azure Storage

Propiedades de parámetro

Tipo:	IStorageContext
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-DefaultProfile

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

Propiedades de parámetro

Tipo:	IAzureContextContainer
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-DestinationPath

Ruta de acceso de destino a la que se va a cambiar el nombre del archivo.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	1
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-DisAllowDestTrailingDot

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ShareName

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-DisAllowSourceTrailingDot

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ShareName

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Force

Forzar a sobrescribir el archivo existente.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-IgnoreReadonly

Optional. Especifica si se debe respetar el atributo ReadOnly en un archivo de destino preexistente. Si es true, el cambio de nombre se realizará correctamente; de lo contrario, un archivo anterior en el destino con el conjunto de atributos ReadOnly hará que se produzca un error en el cambio de nombre.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Permission

Si se especifica el permiso (descriptor de seguridad) se establecerá para el directorio o archivo. Valor predeterminado: hereda. Si SDDL se especifica como entrada, debe tener propietario, grupo y dacl.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ShareClient

ShareClient indicó el recurso compartido donde se enumeraría el archivo.

Propiedades de parámetro

Tipo:	ShareClient
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ShareObject

Posición:	0
Obligatorio:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-ShareDirectoryClient

ShareDirectoryClient indicó el recurso compartido donde se enumeraría el archivo.

Propiedades de parámetro

Tipo:	ShareDirectoryClient
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

DirecotryObject

Posición:	0
Obligatorio:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-ShareFileClient

Instancia de archivo de origen

Propiedades de parámetro

Tipo:	ShareFileClient
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

FileObject

Posición:	0
Obligatorio:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-ShareName

Nombre del recurso compartido de archivos donde se enumeraría el archivo.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ShareName

Posición:	0
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-SourcePath

Ruta de acceso a un archivo existente.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

ShareName

Posición:	1
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

ShareObject

Posición:	1
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

DirecotryObject

Posición:	1
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-WhatIf

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	Wi

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

ShareFileClient

ShareClient

ShareDirectoryClient

IStorageContext

Salidas

AzureStorageFile