Close-SmbOpenFile

Close-SmbOpenFile

Forcibly closes a file that is open by one of the clients of the Server Message Block (SMB) server.

語法

Parameter Set: Query (cdxml)
Close-SmbOpenFile [[-FileId] <UInt64[]> ] [-AsJob] [-CimSession <CimSession[]> ] [-ClientComputerName <String[]> ] [-ClientUserName <String[]> ] [-ClusterNodeName <String[]> ] [-Force] [-PassThru] [-ScopeName <String[]> ] [-SessionId <UInt64[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Close-SmbOpenFile -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-Force] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細描述

The Close-SMBOpenFile cmdlet forcibly closes a file that is open by one of the clients of the Server Message Block (SMB) server. This cmdlet should be used with care as it may result in data loss to the client for which the file is being closed if the client has not flushed all of the file modifications back to the server before the file is closed.

參數

-AsJob

-CimSession<CimSession[]>

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件，例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。預設為本機電腦上的目前工作階段。

-ClientComputerName<String[]>

Specifies the client computer name to filter the returned open files so that only the matching files are opened.

-ClientUserName<String[]>

Specifies the name of the user for which the open files are retrieved.

-ClusterNodeName<String[]>

Specifies, if a share is hosted by a windows cluster, the name of the server which is hosting the open files to be retrieved.

-FileId<UInt64[]>

Specifies the file identifier (ID) of the file to forcibly close.

-Force

強制命令執行而不要求使用者確認。

-InputObject<CimInstance[]>

指定對這個 Cmdlet 的輸入。您可以使用這個參數，或是透過管道提供輸入給這個 Cmdlet。

-PassThru

將表示您正在使用的項目的物件傳回。根據預設，此 Cmdlet 不會產生任何輸出。

-ScopeName<String[]>

Specifies the scope of the open files to be retrieved.

-SessionId<UInt64[]>

Specifies a session ID. Only files that have been opened in the specified session will be returned.

-ThrottleLimit<Int32>

指定為執行此 Cmdlet 可建立的最大同時作業數。如果省略這個參數或輸入 0 的值，則 Windows PowerShell® 會根據在電腦上執行的 CIM Cmdlet 數目，計算 Cmdlet 的最佳節流限制。節流限制僅適用於目前 Cmdlet，不適用於工作階段或電腦。

-Confirm

執行 Cmdlet 之前先提示您確認。

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

<CommonParameters>

此 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 與 -OutVariable。如需詳細資訊，請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

輸入

輸入類型是您可以使用管線處理方式傳遞給 Cmdlet 的物件類型。

• None

輸出

輸出類型是 Cmdlet 所發出的物件類型。

• None

範例

EXAMPLE 1

This example closes a file identified as 4415226383589 that is open by one of the clients of the SMB server.

PS C:\> Close-SmbOpenFile -FileId 4415226383589

EXAMPLE 2

This example closes one or more files that are open by one of the client identified with the session identifier (ID) 4415226380393 of the SMB server.

PS C:\> Close-SmbOpenFile -SessionId 4415226380393

EXAMPLE 3

This example closes, without user confirmation, one or more files that are open by one of the clients of the SMB server and that match the file extension ".DOCX".

PS C:\> Get-SmbOpenFile | Where-Object -Property ShareRelativePath -Match ".DOCX" | Close-SmbOpenFile –Force

相關主題

Get-SmbOpenFile