{"id":93617,"date":"2022-03-28T17:00:10","date_gmt":"2022-03-28T17:00:10","guid":{"rendered":"https:\/\/www.red-gate.com\/simple-talk\/?p=93617"},"modified":"2022-05-05T23:56:57","modified_gmt":"2022-05-05T23:56:57","slug":"azure-storage-mapping-file-shares-and-powershell-drives","status":"publish","type":"post","link":"https:\/\/www.red-gate.com\/simple-talk\/blogs\/azure-storage-mapping-file-shares-and-powershell-drives\/","title":{"rendered":"Azure Storage: Mapping File Shares and Powershell drives"},"content":{"rendered":"

Storage Accounts<\/strong> allow you to create blob containers or file shares. These are two different services provided by them, but you probably already know that. The main difference between these services is the protocol used to access them. While blob containers use REST<\/strong>, file shares can use REST<\/strong> and SMB<\/strong>.<\/p>\n

This means when we use file shares we can map them directly to our file system and work with them using Windows Explorer<\/strong>, as any other network share.<\/p>\n

Of course, this is an oversimplification. There are some tricks when mapping an azure file share to the local machine. If you do it wrong, it can cause a lot of trouble.<\/p>\n

File Share Quota<\/h2>\n

Each file share has a quota. The default quota is 6GB, which is quite small. Using the file share menu you can click the option Edit Quota to change this limit.<\/p>\n

\"\"<\/p>\n

\"\"<\/p>\n

\"\"<\/p>\n

The storage account also has a quota for all the file shares. This quota has only two possible files: 5tb or 100tb.<\/p>\n

\"\"<\/p>\n

 <\/p>\n

\"\"<\/p>\n

Creating the Mapping<\/h2>\n

Create the mapping is very easy. On the file share menu, we can select the option Connect. Azure itself will provide us with a script to create the mapping on Windows, Linux or Mac.<\/p>\n

\"\"<\/p>\n

 <\/p>\n

For windows, it’s a powershell script. We can open PowerShell ISE<\/strong>, copy\/paste the script from the portal to ISE and execute. We will immediately have a new network mapping pointing to our file share on Azure.<\/p>\n

There are two configuration options we can choose. Once we choose these options, the script is changed to use our choices.<\/p>\n

Authentication:<\/strong> We can choose if we will use Azure AD<\/strong> authentication or the storage account key. Azure Authentication is way better option than the storage key. However, Azure AD doesn’t work with SMB<\/strong> out-of-the-box. We need to provision an Azure AD Directory Services<\/strong> to use Azure authentication with SMB<\/strong>.<\/p>\n

Drive letter:<\/strong> You can choose the drive letter which will be used for the mapping on your machine.<\/p>\n

\nFile Share Mapping Internals<\/h2>\n

There are some interesting internal tricks related to the file share mapping. Let’s analyse this and discover how to avoid some mistakes.<\/p>\n

It’s not your regular Network Mapping<\/h3>\n

This mapping created through the PowerShell code is not your regular network mapping. You can’t managed it using the regular tools for a network mapping. It needs to be managed using Powershell.<\/p>\n

These mappings are called Powershell drives. You can discover more about Powershell drives on this link https:\/\/docs.microsoft.com\/en-us\/powershell\/scripting\/samples\/managing-windows-powershell-drives?view=powershell-7.2<\/a><\/p>\n

It’s specially important to remember you can’t delete or disconnect the mapping using traditional OS tools, you need to use Remove-PSDrive<\/em><\/strong> cmdlet in Powershell<\/p>\n

It’s not for everyone<\/h3>\n

The mapping is created for the user who executes the script and only for this user. One example is that if you execute the script with powershell running as administrator, you will not see it in a regular windows explorer window.<\/p>\n

Big Mistake – be aware and never do this<\/h2>\n

What gave me the idea to write this article was exactly the fact I faced a huge error when handling the mappings in a wrong way. I found almost no information about how to fix this, so here it is.<\/p>\n

The problem: You should never attempt to delete the mappings using regular OS statements. For example:<\/p>\n

NET USE <drive> \/DELETE \/YES<\/strong><\/p>\n

Is a complete error – don’t do this. I did.<\/p>\n

When this is done, the mappings are not removed. The OS, on the other hand, becomes a bit crazy, slow. Windows explorer hangs sometimes, not understanding very well the mappings.<\/p>\n

So, it’s just about opening powershell and executing Remove-PSDrive<\/em><\/strong>, right?<\/p>\n

Unfortunately not. Powershell also goes crazy and doesn’t open anymore, showing the error message Attempt to perform the InitializeDefaultDrives operation on the FileSystem’ provider failed<\/em>.<\/p>\n

\"\"<\/p>\n

No work-around:<\/p>\n