Rename-AzStorageFile

Modulo:

Az.Storage

Rinomina un file.

Sintassi

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

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

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

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

Descrizione

Il cmdlet Rename-Az Archiviazione File rinomina una directory da una condivisione file.

Esempio

Esempio 1: Rinominare un file da una condivisione file

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

Directory: https://myaccount.file.core.windows.net/myshare

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

Questo comando rinomina un file da testfile1 a testfile2 nella condivisione file myshare.

Esempio 2: Rinominare un file da una condivisione file usando la pipeline

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

Directory: https://myaccount.file.core.windows.net/myshare

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

Questo comando ottiene prima un oggetto client di file e rinomina il file da testfile1 a testfile2 usando la pipeline.

Parametri

-AsJob

Eseguire il cmdlet in background

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-ContentType

Imposta il tipo di contenuto MIME del file. Il tipo predefinito è 'application/octet-stream'.

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

-Context

oggetto Context Archiviazione di Azure

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-DestinationPath

Percorso di destinazione in cui rinominare il file.

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

-DisAllowDestTrailingDot

Non consentire il punto finale (.) per il suffisso della directory di destinazione e i nomi dei file di destinazione.

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

-DisAllowSourceTrailingDot

Non consentire il punto finale (.) per il suffisso della directory di origine e dei nomi dei file di origine.

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

-Force

Forzare la sovrascrittura del file esistente.

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

-IgnoreReadonly

Facoltativo. Specifica se l'attributo ReadOnly in un file di destinazione preesistente deve essere rispettato. Se true, la ridenominazione avrà esito positivo; in caso contrario, un file precedente nella destinazione con il set di attributi ReadOnly causerà l'esito negativo della ridenominazione.

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

-Permission

Se è stata specificata l'autorizzazione (descrittore di sicurezza) deve essere impostata per la directory o il file. Valore predefinito: Eredita. Se SDDL viene specificato come input, deve avere proprietario, gruppo e dacl.

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

-ShareClient

ShareClient indica la condivisione in cui dovrebbe essere elencato il file.

Type:	ShareClient
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ShareDirectoryClient

ShareDirectoryClient indica la condivisione in cui verrà elencato il file.

Type:	ShareDirectoryClient
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ShareFileClient

Istanza del file di origine

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

-ShareName

Nome della condivisione file in cui verrà elencato il file.

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

-SourcePath

Percorso di un file esistente.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

ShareFileClient

ShareClient

ShareDirectoryClient

IStorageContext

Output

AzureStorageFile