Amazon FSx for Windows File Server
Windows User Guide

File Shares

You can manage file shares and perform the following tasks.

  • Create a new file share

  • Modify a file share

  • Remove a file share

You can use the Windows-native Shared Folders GUI and the Amazon FSx CLI for remote management on PowerShell to manage file shares on your Amazon FSx for Windows File Server file system.

Using the GUI to Manage File Shares

To manage file shares on your Amazon FSx file system, you can use the Shared Folders GUI. The Shared Folders GUI provides a central location for managing all shared folders on a Windows server. The following procedures detail how to manage your file shares.

To connect Shared Folders to your FSx file system

  1. Launch your Amazon EC2 instance and connect it to the Microsoft Active Directory that your Amazon FSx file system is joined to. To do this, choose one of the following procedures from the AWS Directory Service Administration Guide:

  2. Connect to your instance as a user that is a member of the file system administrators group. In AWS Managed AD, this group is called AWS Delegated FSx Administrators. In your self-managed Microsoft AD, this group is called Domain Admins or the custom name for the administrators group that you provided during creation. For more information, see Connecting to Your Windows Instance in the Amazon EC2 User Guide for Windows Instances.

  3. Open the Start menu and run fsmgmt.msc using Run As Administrator. Doing this opens the Shared Folders GUI tool.

  4. For Action, choose Connect to another computer.

  5. For Another computer, enter the Domain Name System (DNS) name of your Amazon FSx file system, filesystem-Id.ad-domain.com, for example: fs-0123456789abcdef0.example.com

  6. Choose OK. An entry for your Amazon FSx file system then appears in the list for the Shared Folders tool.

Now that Shared Folders is connected to your Amazon FSx file system, you can manage the Windows file shares on the file system. You can do so with the following actions:

  • Create a new file share – In the Shared Folders tool, choose Shares in the left pane to see the active shares for your Amazon FSx file system. Choose New Share and complete the Create a Shared Folder wizard.

  • Modify a file share – In the Shared Folders tool, open the context (right-click) menu for the file share that you want to modify in the right pane, and choose Properties. Modify the properties and choose OK.

  • Remove a file share – In the Shared Folders tool, open the context (right-click) menu for the file share that you want to remove in the right pane, and then choose Stop Sharing.

Using PowerShell to Manage File Shares

You can manage file shares using custom remote-management commands for PowerShell. These commands can help you more easily automate these tasks:

  • Migration of file shares on existing file servers to Amazon FSx

  • Synchronization of file shares across AWS Regions for disaster recovery

  • Programmatic management of file shares for ongoing workflows, such as team file-share provisioning

To learn how to use the Amazon FSx CLI for remote management on PowerShell, see Getting Started with the Amazon FSx CLI for Remote Management on PowerShell.

Note

File share management using PowerShell is available only on Amazon FSx for Windows File Server file systems created after 10:00 AM PST, November 20, 2019. Customers with existing file systems will get this support during an upcoming weekly maintenance window.

Creating a Continuously Available Share

You can only create continuously available (CA) shares using the Amazon FSx CLI for Remote Management on PowerShell on Multi-AZ file systems only. This is because CA shares require a clustered file server set up, available only with Multi-AZ file systems. Use the New-FSxSmbShare with the -ContinuouslyAvailable option set to $True to specify that the share is a continuously available share. The following is an example command to create a CA share.

New-FSxSmbShare -Name "New CA Share" -Path "D:\share\Marketing" -Description "CA share" -ContinuouslyAvailable $True -FolderEnumerationMode AccessBased -EncryptData $true

Following are custom remote-management PowerShell commands that you can use.

Share Management Command Description

New-FSxSmbShare

Creates a new file share.

Remove-FSxSmbShare

Removes a file share.

Get-FSxSmbShare

Retrieves existing file shares.

Set-FSxSmbShare

Sets properties for a share.

Get-FSxSmbShareAccess

Retrieves the access control list (ACL) of a share.

Grant-FSxSmbShareAccess

Adds an allow access control entry (ACE) for a trustee to the security descriptor of a share.

Remove-FSxSmbShareAccess

Removes all of the allow ACEs for a trustee from the security descriptor of a share.

Block-FSxSmbShareAccess

Adds a deny ACE for a trustee to the security descriptor of a share.

Unblock-FSxSmbShareAccess

Removes all of the deny ACEs for a trustee from the security descriptor of a share.

The online help for each command provides a reference of all command options. To access this help, run the command with a -?, for example New-FSxSmbShare -?.