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


Close-AzStorageFileHandle

Закрывает дескриптор файлового ресурса, каталог файлов или файл.

Синтаксис

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

Close-AzStorageFileHandle
    [-ShareName] <String>
    [[-Path] <String>]
    [-Recursive]
    [-CloseAll]
    [-DisAllowTrailingDot]
    [-PassThru]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ShareNameCloseSingle

Close-AzStorageFileHandle
    [-ShareName] <String>
    -FileHandle <PSFileHandle>
    [-DisAllowTrailingDot]
    [-PassThru]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ShareCloseAll

Close-AzStorageFileHandle
    [-ShareClient] <ShareClient>
    [[-Path] <String>]
    [-Recursive]
    [-CloseAll]
    [-PassThru]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ShareCloseSingle

Close-AzStorageFileHandle
    [-ShareClient] <ShareClient>
    -FileHandle <PSFileHandle>
    [-PassThru]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DirectoryCloseAll

Close-AzStorageFileHandle
    [-ShareDirectoryClient] <ShareDirectoryClient>
    [[-Path] <String>]
    [-Recursive]
    [-CloseAll]
    [-PassThru]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FileCloseAll

Close-AzStorageFileHandle
    [-ShareFileClient] <ShareFileClient>
    [-CloseAll]
    [-PassThru]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет Close-AzStorageFileHandle закрывает дескрипторы файлового ресурса, каталога файлов или файла.

Примеры

Пример 1. Закрытие всех дескрипторов файлов в файле

Close-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2/test.txt' -CloseAll

Эта команда закрывает все дескриптора файлов в файле.

Пример 2. Закрытие всех дескрипторов файлов, открытых 1 день назад в каталоге файлов

Get-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2' -Recursive | Where-Object {$_.OpenTime.DateTime.AddDays(1) -lt (Get-Date)} | Close-AzStorageFileHandle -ShareName "mysharename"

Эта команда выводит список всех дескрипторов файлов в каталоге файлов рекурсивно, отфильтровывает дескриптор, открытый 1 день назад, а затем закрывает их.

Пример 3. Закрытие всех дескрипторов файлов в каталоге файлов рекурсивно и отображение количества дескрипторов закрытого файла

Close-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2' -Recursive -CloseAll -PassThru
10

Эта команда закрывает все дескрипторы файлов в каталоге файлов и показывает количество закрытых дескрипторов файлов.

Пример 4. Закрытие всех дескрипторов файлов в общей папке

Close-AzStorageFileHandle -ShareName "mysharename" -CloseAll -Recursive

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

Параметры

-AsJob

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

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

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

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

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

-ClientTimeoutPerRequest

Максимальное время выполнения на стороне клиента для каждого запроса в секундах.

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

Тип:

Nullable<T>[Int32]

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

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

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

-CloseAll

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

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

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

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

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

-ConcurrentTaskCount

Общий объем параллельных асинхронных задач. Значение по умолчанию — 10.

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

Тип:

Nullable<T>[Int32]

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

-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

-DisAllowTrailingDot

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

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

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

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

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

-FileHandle

Дескриптор файла, который нужно закрыть.

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

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

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

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

-PassThru

Возвращает количество закрытых дескрипторов файлов.

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

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

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

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

-Path

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

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

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

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

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

-Recursive

Список обрабатывает рекурсивно. Работает только в каталоге файлов.

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

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

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

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

-ServerTimeoutPerRequest

Время ожидания сервера для каждого запроса в секундах.

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

Тип:

Nullable<T>[Int32]

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

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

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

-ShareClient

Объект ShareClient указывает общую папку, содержащую файлы или каталоги для закрытого дескриптора.

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

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

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

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

-ShareDirectoryClient

Объект ShareDirectoryClient указывает базовую папку, содержащую файлы и каталоги для закрытого дескриптора.

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

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

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

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

-ShareFileClient

Объект ShareFileClient указал файл для закрытия дескриптора.

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

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

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

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

-ShareName

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

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

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

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

ShareNameCloseAll
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ShareNameCloseSingle
Position:0
Обязательно: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.

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

ShareClient

ShareDirectoryClient

ShareFileClient

PSFileHandle

IStorageContext

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

Int32