Rename-AzStorageFile
Sintaxe
ShareName (Predefinição)
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
O cmdlet Rename-AzStorageFile renomeia um diretório de um compartilhamento de arquivos.
Exemplos
Exemplo 1: Renomear um arquivo de um compartilhamento de arquivos
Rename-AzStorageFile -SourcePath testfile1 -DestinationPath testfile2 -ShareName myshare
AccountName: myaccount, ShareName: myshare
Type Length Name
---- ------ ----
File 512 testfile2
Este comando renomeia um arquivo de testfile1 para testfile2 em file share myshare.
Exemplo 2: Renomear um arquivo de um compartilhamento de arquivos usando pipeline
Get-AzStorageFile -ShareName myshare -Path testfile1 | Rename-AzStorageFile -DestinationPath testfile2
AccountName: myaccount, ShareName: myshare
Type Length Name
---- ------ ----
File 512 testfile2
Este comando obtém um objeto de cliente de arquivo primeiro e renomeia o arquivo de testfile1 para testfile2 usando pipeline.
Parâmetros
-AsJob
Executar cmdlet em segundo plano
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Cf.
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ContentType
Define o tipo de conteúdo MIME do arquivo.
O tipo padrão é 'application/octet-stream'.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Context
Armazenamento do Azure Context Object
Propriedades dos parâmetros
Tipo: IStorageContext
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DestinationPath
O caminho de destino para o qual renomear o arquivo.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: 1 Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DisAllowDestTrailingDot
Não permita que o ponto à direita (.) sufixe o diretório de destino e os nomes dos arquivos de destino.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ShareName
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DisAllowSourceTrailingDot
Não permitir que o ponto à direita (.) sufixe o diretório de origem e os nomes dos arquivos de origem.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ShareName
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Force
Força a substituir o arquivo existente.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-IgnoreReadonly
Opcional.
Especifica se o atributo ReadOnly em um arquivo de destino preexistente deve ser respeitado.
Se true, a renomeação terá êxito, caso contrário, um arquivo anterior no destino com o atributo ReadOnly definido fará com que a renomeação falhe.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Permission
Se especificado, a permissão (descritor de segurança) deve ser definida para o diretório/arquivo.
Valor padrão: herdar.
Se SDDL é especificado como entrada, ele deve ter proprietário, grupo e dacl.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ShareClient
ShareClient indicou o compartilhamento onde o arquivo seria listado.
Propriedades dos parâmetros
Tipo: ShareClient
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ShareObject
Position: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ShareDirectoryClient
ShareDirectoryClient indicou o compartilhamento onde o arquivo seria listado.
Propriedades dos parâmetros
Conjuntos de parâmetros
DirecotryObject
Position: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ShareFileClient
Instância do arquivo de origem
Propriedades dos parâmetros
Tipo: ShareFileClient
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
FileObject
Position: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ShareName
Nome do compartilhamento de arquivos onde o arquivo seria listado.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ShareName
Position: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-SourcePath
Caminho para um arquivo existente.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ShareName
Position: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
ShareObject
Position: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
DirecotryObject
Position: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Wi
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
