Поделиться через


Rename-AzStorageFile

Переименовывает файл.

Синтаксис

ShareName (по умолчанию)

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

Описание

Командлет Rename-AzStorageFile переименовывает каталог из общей папки.

Примеры

Пример 1. Переименование файла из общей папки

Rename-AzStorageFile -SourcePath testfile1 -DestinationPath testfile2 -ShareName myshare
AccountName: myaccount, ShareName: myshare

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

Эта команда переименовывает файл из testfile1 в testfile2 в общей папке myshare.

Пример 2. Переименование файла из общей папки с помощью конвейера

Get-AzStorageFile -ShareName myshare -Path testfile1 | Rename-AzStorageFile -DestinationPath testfile2
AccountName: myaccount, ShareName: myshare

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

Эта команда сначала получает объект клиента файла и переименовывает файл из testfile1 в testfile2 с помощью конвейера.

Параметры

-AsJob

Запуск командлета в фоновом режиме

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ContentType

Задает тип контента MIME файла. Тип по умолчанию — application/octet-stream.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Context

Объект контекста службы хранилища Azure

Свойства параметра

Тип:IStorageContext
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DestinationPath

Путь назначения для переименования файла в.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisAllowDestTrailingDot

Запретить конечные точки (.) на суффикс целевой каталог и имена целевых файлов.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ShareName
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisAllowSourceTrailingDot

Запретить конечные точки (.) на суффикс исходный каталог и имена исходных файлов.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ShareName
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

Принудительно перезаписать существующий файл.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IgnoreReadonly

Необязательно. Указывает, следует ли учитывать атрибут ReadOnly в предварительном целевом файле. Если значение true, переименование завершится успешно, в противном случае предыдущий файл в назначении с набором атрибутов ReadOnly приведет к сбою переименования.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Permission

Если задано разрешение (дескриптор безопасности), необходимо задать для каталога или файла. Значение по умолчанию: наследование. Если SDDL указан в качестве входных данных, он должен иметь владельца, группу и dacl.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ShareClient

ShareClient указал общий ресурс, в котором будет указан файл.

Свойства параметра

Тип:ShareClient
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ShareObject
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ShareDirectoryClient

ShareDirectoryClient указал общий ресурс, в котором будет указан файл.

Свойства параметра

Тип:ShareDirectoryClient
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

DirecotryObject
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ShareFileClient

Экземпляр исходного файла

Свойства параметра

Тип:ShareFileClient
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

FileObject
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ShareName

Имя общей папки, в которой будет указан файл.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ShareName
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SourcePath

Путь к существующему файлу.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ShareName
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ShareObject
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
DirecotryObject
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

ShareFileClient

ShareClient

ShareDirectoryClient

IStorageContext

Выходные данные

AzureStorageFile