你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Close-AzStorageFileHandle

关闭文件共享、文件目录或文件的文件句柄。

语法

Close-AzStorageFileHandle
     [-ShareName] <String>
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-Context <IStorageContext>]
     [-DisAllowTrailingDot]
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Close-AzStorageFileHandle
     [-ShareName] <String>
     -FileHandle <PSFileHandle>
     [-Context <IStorageContext>]
     [-DisAllowTrailingDot]
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Close-AzStorageFileHandle
     [-Share] <CloudFileShare>
     [-ShareClient <ShareClient>]
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Close-AzStorageFileHandle
     [-Share] <CloudFileShare>
     [-ShareClient <ShareClient>]
     -FileHandle <PSFileHandle>
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Close-AzStorageFileHandle
     [-Directory] <CloudFileDirectory>
     [-ShareDirectoryClient <ShareDirectoryClient>]
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Close-AzStorageFileHandle
     [-File] <CloudFile>
     [-ShareFileClient <ShareFileClient>]
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

Close-AzStorageFileHandle cmdlet 关闭文件共享或文件目录或文件的文件句柄。

示例

示例 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

在后台运行 cmdlet

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClientTimeoutPerRequest

客户端每个请求的最大执行时间(以秒为单位)。

类型:Nullable<T>[Int32]
别名:ClientTimeoutPerRequestInSeconds
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CloseAll

强制关闭所有文件句柄。

类型:SwitchParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ConcurrentTaskCount

并发异步任务的总数。 默认值为 10。

类型:Nullable<T>[Int32]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Context

Azure 存储上下文对象

类型:IStorageContext
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Directory

CloudFileDirectory 对象指示将列出文件/目录的基文件夹。

类型:CloudFileDirectory
别名:CloudFileDirectory
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-DisAllowTrailingDot

禁止尾随点 (.) 后缀目录和文件名。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-File

CloudFile 对象指示要关闭句柄的文件。

类型:CloudFile
别名:CloudFile
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-FileHandle

要关闭的文件句柄。

类型:PSFileHandle
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-PassThru

返回已关闭的文件句柄计数。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Path

现有文件/目录的路径。

类型:String
Position:1
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Recursive

列表以递归方式处理。 仅适用于文件目录。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ServerTimeoutPerRequest

服务器为每个请求超时(以秒为单位)。

类型:Nullable<T>[Int32]
别名:ServerTimeoutPerRequestInSeconds
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Share

CloudFileShare 对象指示将列出文件/目录的共享。

类型:CloudFileShare
别名:CloudFileShare
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ShareClient

ShareClient 对象指示包含要关闭句柄的文件/目录的共享。

类型:ShareClient
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ShareDirectoryClient

ShareDirectoryClient 对象指示包含要关闭句柄的文件/目录的基文件夹。

类型:ShareDirectoryClient
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ShareFileClient

ShareFileClient 对象指示要关闭句柄的文件。

类型:ShareFileClient
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-ShareName

将列出文件/目录的文件共享的名称。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

CloudFileShare

CloudFileDirectory

IStorageContext

输出

CloseFileHandleResultSegment