modules/deploy/dsc/ext/PsGallery/xSmbShare.1.1.0.0/DscResources/MSFT_xSmbShare/MSFT_xSmbShare.psm1
|
function Get-TargetResource { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( [parameter(Mandatory = $true)] [System.String] $Name, [parameter(Mandatory = $true)] [System.String] $Path ) $smbShare = Get-SmbShare -Name $Name -ErrorAction SilentlyContinue $changeAccess = @() $readAccess = @() $fullAccess = @() $noAccess = @() if ($smbShare -ne $null) { $smbShareAccess = Get-SmbShareAccess -Name $Name $smbShareAccess | % { $access = $_; if ($access.AccessRight -eq 'Change' -and $access.AccessControlType -eq 'Allow') { $changeAccess += $access.AccountName } elseif ($access.AccessRight -eq 'Read' -and $access.AccessControlType -eq 'Allow') { $readAccess += $access.AccountName } elseif ($access.AccessRight -eq 'Full' -and $access.AccessControlType -eq 'Allow') { $fullAccess += $access.AccountName } elseif ($access.AccessRight -eq 'Full' -and $access.AccessControlType -eq 'Deny') { $noAccess += $access.AccountName } } } else { Write-Verbose "Share with name $Name does not exist" } $returnValue = @{ Name = $smbShare.Name Path = $smbShare.Path Description = $smbShare.Description ConcurrentUserLimit = $smbShare.ConcurrentUserLimit EncryptData = $smbShare.EncryptData FolderEnumerationMode = $smbShare.FolderEnumerationMode ShareState = $smbShare.ShareState ShareType = $smbShare.ShareType ShadowCopy = $smbShare.ShadowCopy Special = $smbShare.Special ChangeAccess = $changeAccess ReadAccess = $readAccess FullAccess = $fullAccess NoAccess = $noAccess Ensure = if($smbShare) {"Present"} else {"Absent"} } $returnValue } function Set-AccessPermission { [CmdletBinding()] Param ( $ShareName, [string[]] $UserName, [string] [ValidateSet("Change","Full","Read","No")] $AccessPermission ) $formattedString = '{0}{1}' -f $AccessPermission,"Access" Write-Verbose -Message "Setting $formattedString for $UserName" if ($AccessPermission -eq "Change" -or $AccessPermission -eq "Read" -or $AccessPermission -eq "Full") { Grant-SmbShareAccess -Name $Name -AccountName $UserName -AccessRight $AccessPermission -Force } else { Block-SmbShareAccess -Name $Name -AccountName $userName -Force } } function Remove-AccessPermission { [CmdletBinding()] Param ( $ShareName, [string[]] $UserName, [string] [ValidateSet("Change","Full","Read","No")] $AccessPermission ) $formattedString = '{0}{1}' -f $AccessPermission,"Access" Write-Debug -Message "Removing $formattedString for $UserName" if ($AccessPermission -eq "Change" -or $AccessPermission -eq "Read" -or $AccessPermission -eq "Full") { Revoke-SmbShareAccess -Name $Name -AccountName $UserName -Force } else { UnBlock-SmbShareAccess -Name $Name -AccountName $userName -Force } } function Set-TargetResource { [CmdletBinding()] param ( [parameter(Mandatory = $true)] [System.String] $Name, [parameter(Mandatory = $true)] [System.String] $Path, [System.String] $Description, [System.String[]] $ChangeAccess, [System.UInt32] $ConcurrentUserLimit, [System.Boolean] $EncryptData, [ValidateSet("AccessBased","Unrestricted")] [System.String] $FolderEnumerationMode, [System.String[]] $FullAccess, [System.String[]] $NoAccess, [System.String[]] $ReadAccess, [ValidateSet("Present","Absent")] [System.String] $Ensure ) $psboundparameters.Remove("Debug") $shareExists = $false $smbShare = Get-SmbShare -Name $Name -ErrorAction SilentlyContinue if($smbShare -ne $null) { Write-Verbose -Message "Share with name $Name exists" $shareExists = $true } if ($Ensure -eq "Present") { if ($shareExists -eq $false) { $psboundparameters.Remove("Ensure") Write-Verbose "Creating share $Name to ensure it is Present" New-SmbShare @psboundparameters } else { # Need to call either Set-SmbShare or *ShareAccess cmdlets if ($psboundparameters.ContainsKey("ChangeAccess")) { $changeAccessValue = $psboundparameters["ChangeAccess"] $psboundparameters.Remove("ChangeAccess") } if ($psboundparameters.ContainsKey("ReadAccess")) { $readAccessValue = $psboundparameters["ReadAccess"] $psboundparameters.Remove("ReadAccess") } if ($psboundparameters.ContainsKey("FullAccess")) { $fullAccessValue = $psboundparameters["FullAccess"] $psboundparameters.Remove("FullAccess") } if ($psboundparameters.ContainsKey("NoAccess")) { $noAccessValue = $psboundparameters["NoAccess"] $psboundparameters.Remove("NoAccess") } # Use Set-SmbShare for performing operations other than changing access $psboundparameters.Remove("Ensure") $psboundparameters.Remove("Path") Set-SmbShare @PSBoundParameters -Force # Use *SmbShareAccess cmdlets to change access $smbshareAccessValues = Get-SmbShareAccess -Name $Name if ($ChangeAccess -ne $null) { # Blow off whatever is in there and replace it with this list $smbshareAccessValues | ? {$_.AccessControlType -eq 'Allow' -and $_.AccessRight -eq 'Change'} ` | % { Remove-AccessPermission -ShareName $Name -UserName $_.AccountName -AccessPermission Change } $changeAccessValue | % { Set-AccessPermission -ShareName $Name -AccessPermission "Change" -Username $_ } } $smbshareAccessValues = Get-SmbShareAccess -Name $Name if ($ReadAccess -ne $null) { # Blow off whatever is in there and replace it with this list $smbshareAccessValues | ? {$_.AccessControlType -eq 'Allow' -and $_.AccessRight -eq 'Read'} ` | % { Remove-AccessPermission -ShareName $Name -UserName $_.AccountName -AccessPermission Read } $readAccessValue | % { Set-AccessPermission -ShareName $Name -AccessPermission "Read" -Username $_ } } $smbshareAccessValues = Get-SmbShareAccess -Name $Name if ($FullAccess -ne $null) { # Blow off whatever is in there and replace it with this list $smbshareAccessValues | ? {$_.AccessControlType -eq 'Allow' -and $_.AccessRight -eq 'Full'} ` | % { Remove-AccessPermission -ShareName $Name -UserName $_.AccountName -AccessPermission Full } $fullAccessValue | % { Set-AccessPermission -ShareName $Name -AccessPermission "Full" -Username $_ } } $smbshareAccessValues = Get-SmbShareAccess -Name $Name if ($NoAccess -ne $null) { # Blow off whatever is in there and replace it with this list $smbshareAccessValues | ? {$_.AccessControlType -eq 'Deny'} ` | % { Remove-AccessPermission -ShareName $Name -UserName $_.AccountName -AccessPermission No } $noAccessValue | % { Set-AccessPermission -ShareName $Name -AccessPermission "No" -Username $_ } } } } else { Write-Verbose "Removing share $Name to ensure it is Absent" Remove-SmbShare -name $Name -Force } } function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( [parameter(Mandatory = $true)] [System.String] $Name, [parameter(Mandatory = $true)] [System.String] $Path, [System.String] $Description, [System.String[]] $ChangeAccess, [System.UInt32] $ConcurrentUserLimit, [System.Boolean] $EncryptData, [ValidateSet("AccessBased","Unrestricted")] [System.String] $FolderEnumerationMode, [System.String[]] $FullAccess, [System.String[]] $NoAccess, [System.String[]] $ReadAccess, [ValidateSet("Present","Absent")] [System.String] $Ensure ) $testResult = $false; $share = Get-TargetResource -Name $Name -Path $Path -ErrorAction SilentlyContinue -ErrorVariable ev if ($Ensure -ne "Absent") { if ($share.Ensure -eq "Absent") { $testResult = $false } elseif ($share.Ensure -eq "Present") { $Params = 'Name', 'Path', 'Description', 'ChangeAccess', 'ConcurrentUserLimit', 'EncryptData', 'FolderEnumerationMode', 'FullAccess', 'NoAccess', 'ReadAccess', 'Ensure' if ($PSBoundParameters.Keys.Where({$_ -in $Params}) | ForEach-Object {Compare-Object -ReferenceObject $PSBoundParameters.$_ -DifferenceObject $share.$_}) { $testResult = $false } else { $testResult = $true } } } else { if ($share.Ensure -eq "Absent") { $testResult = $true } else { $testResult = $false } } $testResult } Export-ModuleMember -Function *-TargetResource |