The SMB File Service authenticates the administrator through the mechanisms as described in section 2.1.2.3.1. The admin tool contacts the SMB File Service by using the NetrShareAdd method, as described in [MS-SRVS] section 3.1.4.7, to create the share on the file server. The SMB File Service authorizes the administrator through the mechanisms, as described in section 3.1.4.7. The SMB File Service creates the requested share that stores configuration information in an implementation-specific manner. Postcondition The named share is created on the file server. Extensions If the communication channel for the Server Service Remote Protocol [MS-SRVS] cannot be established, or it becomes disconnected: The tool may attempt to establish connection multiple times; ultimately, the use case ends with failure. Depending on when the connection failed, the share may or may not have been created. If user authorization or user authentication fails: The use case ends with failure. If share creation fails: The use case ends with failure. List SMB Shares Goal To list shares on a file server that can be accessed through SMB access protocols. Context of Use The administrator has located and selected a file server and must discover any file shares on it. Actors Admin tool The admin tool is the primary actor. It triggers this use case. The admin tool is a program that offers management functionality to the administrator through the admin client. Typical admin tools are command-line tools and graphical shells, management utilities, and graphical management programs. The purpose of the admin tool is to correctly interpret, execute, and display the results of the commands that are issued by the administrator. Admin client The admin client is a supporting actor that implements client-side protocol components and consumes the file server administration services that are offered by the file server. The admin client is internal to the File Services Management system. SMB File Service
Administrator The administrator is the person who administers the SMB Network Redirector. The administrator has administrative rights and uses the File Services Management system to provide the SMB File Service. Preconditions The administrator has identified a remote computer to which the administrator must disable a transport protocol. A SMB Network Redirector and the implementation of the Workstation Service Remote Protocol, as described in , must be present on the remote computer. Main Success Scenario Trigger: The admin tool receives a request from the administrator to disable a transport protocol on an SMB Network Redirector. The admin tool establishes a communication channel to the Workstation Service, as described in [MS-WKST] section 2.1. The admin tool contacts the Workstation Service by using the NetrWkstaTransportDel method, as described in [MS-WKST] section 3.2.4.6, to disable the SMB Network Redirector to use as transport protocol on a remote computer. If any open file or printer handles are using the transport protocol that this call tries to disable, the server behavior depends on the value of the ForceLevel parameter that is provided by the admin tool. If the admin tool requested a forced deletion, the server forces all open handles to close, and then disables the transport protocol. Postcondition The SMB Network Redirector can use the provided transport protocol. Extensions If any open file or printer handles are using the transport protocol that this call tries to disable, and the admin tool has not requested a forceful deletion: The call fails, and the transport protocol is not deleted. Get Statistics about an SMB Network Redirector Goal To get various statistics about the SMB Network Redirector on a remote computer. Context of Use The administrator is configuring the SMB Network Redirector and must get various statistics. Actors Admin tool The admin tool is the primary actor that triggers this use case. The admin tool is a program that offers management functionality to the administrator through the admin client. Typical admin tools are command-line tools and graphical shells, management utilities, and graphical management programs. The purpose of the admin tool is to correctly interpret, execute, and display the results of the commands that are issued by the administrator. client