Scripts/Get-NFSv3ExtendedGroups.ps1
|
<#
.SYNOPSIS Lists NFSv3 extended groups stored in Azure DB. .DESCRIPTION This command lists NFSv3 extended groups stored in Azure DB for all the Uids. If Uid is provided, it will just list the groups for that Uid. .PARAMETER ResourceGroupName The name of the Resource Group in Azure where the storage account resides. .PARAMETER StorageAccountName The name of the Azure storage account. .PARAMETER Uid Optional, Uid of user whose supplementary groups needs to listed. .EXAMPLE Get-NFSv3ExtendedGroups -ResourceGroupName "MyRG" -StorageAccountName "MyStorage" -Uid "1001" .NOTES Written by: [Azure Blob NFS] Date: [October 10, 2024] #> function Get-NFSv3ExtendedGroups{ [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string]$ResourceGroupName, [Parameter(Mandatory=$true)] [string]$StorageAccountName, [Parameter(Mandatory=$false)] [string]$Uid ) $logMessage = @" Get-NFSv3ExtendedGroups started, ResourceGroupName : $ResourceGroupName, StorageAccountName : $StorageAccountName "@ if ($Uid) { $logMessage += ",`n Uid : $Uid" } Write-NFSv3ExtendedGroupsLog $logMessage $prefix = "nfsv3_" if ($PSBoundParameters.ContainsKey('Uid')) { if ([string]::IsNullOrEmpty($Uid)) { Write-NFSv3ExtendedGroupsLog -Message "Uid can not be null or empty." -LogLevel "ERROR" return } # Get specific user if $Uid is provided. $userName = $prefix + $Uid # Get localuser with given UID from storage server. $user = Get-AzStorageLocalUser -ResourceGroupName $ResourceGroupName -StorageAccountName $StorageAccountName -UserName $userName $user.ExtendedGroups -join ", " } else { # List all the users if $Uid is not provided. # Get all the LocalUsers from storage server for the given account. $users = Get-AzStorageLocalUser -ResourceGroupName $ResourceGroupName -StorageAccountName $StorageAccountName -IncludeNFSv3 $users | Select-Object @{ Name = 'Uid' Expression = { $_.Name -replace "^$prefix", "" } }, @{ Name = 'ExtendedGroups' Expression = { $_.ExtendedGroups -join ", " } } | Format-Table -AutoSize } Write-NFSv3ExtendedGroupsLog "Get-NFSv3ExtendedGroups completed" } |