DSCResources/DSC_DFSReplicationGroupMembership/DSC_DFSReplicationGroupMembership.psm1
|
$modulePath = Join-Path -Path (Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent) -ChildPath 'Modules' # Import the DFSDsc.Common Module Import-Module -Name (Join-Path -Path $modulePath -ChildPath 'DscResource.Common') # Import Localization Strings $script:localizedData = Get-LocalizedData -DefaultUICulture 'en-US' <# .SYNOPSIS Returns the current state of a DFS Replication Group Membership. .PARAMETER GroupName The name of the DFS Replication Group. .PARAMETER FolderName The name of the DFS Replication Group Folder. .PARAMETER ComputerName The computer name of the Replication Group member. This can be specified using either the ComputerName or FQDN name for the member. If an FQDN name is used and the DomainName parameter is set, the FQDN domain name must match. .PARAMETER DomainName The name of the AD Domain the DFS Replication Group this replication group is in. #> function Get-TargetResource { [OutputType([System.Collections.Hashtable])] param ( [Parameter(Mandatory = $true)] [System.String] $GroupName, [Parameter(Mandatory = $true)] [System.String] $FolderName, [Parameter(Mandatory = $true)] [System.String] $ComputerName, [Parameter()] [System.String] $DomainName ) Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.GettingReplicationGroupMembershipMessage) ` -f $GroupName,$FolderName,$ComputerName ) -join '' ) # Lookup the existing Replication Group $membershipParameters = @{ GroupName = $GroupName ComputerName = $ComputerName } $returnValue = $membershipParameters if ($DomainName) { $membershipParameters += @{ DomainName = $DomainName } } $returnValue += @{ FolderName = $FolderName } $replicationGroupMembership = Get-DfsrMembership @membershipParameters ` -ErrorAction Stop ` | Where-Object { $_.FolderName -eq $FolderName } if ($replicationGroupMembership) { Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.ReplicationGroupMembershipExistsMessage) ` -f $GroupName,$FolderName,$ComputerName ) -join '' ) $returnValue.ComputerName = $replicationGroupMembership.ComputerName $returnValue += @{ ContentPath = $replicationGroupMembership.ContentPath StagingPath = $replicationGroupMembership.StagingPath StagingPathQuotaInMB = $replicationGroupMembership.StagingPathQuotaInMB ConflictAndDeletedPath = $replicationGroupMembership.ConflictAndDeletedPath ReadOnly = $replicationGroupMembership.ReadOnly PrimaryMember = $replicationGroupMembership.PrimaryMember DomainName = $replicationGroupMembership.DomainName } } else { # The Rep Group membership doesn't exist New-InvalidOperationException ` -Message ($($script:localizedData.ReplicationGroupMembershipMissingError) ` -f $GroupName,$FolderName,$ComputerName) } return $returnValue } # Get-TargetResource <# .SYNOPSIS Sets DFS Replication Group Membership. .PARAMETER GroupName The name of the DFS Replication Group. .PARAMETER FolderName The name of the DFS Replication Group Folder. .PARAMETER ComputerName The computer name of the Replication Group member. This can be specified using either the ComputerName or FQDN name for the member. If an FQDN name is used and the DomainName parameter is set, the FQDN domain name must match. .PARAMETER ContentPath The local content path for the DFS Replication Group Folder. .PARAMETER StagingPath The local staging path for the DFS Replication Group Folder. .PARAMETER StagingPathQuotaInMB The local staging path quota size in MB. .PARAMETER ReadOnly Specify if this content path should be read only. .PARAMETER PrimaryMember Used to configure this as the Primary Member. Every folder must have at least one primary member for initial replication to take place. .PARAMETER DomainName The name of the AD Domain the DFS Replication Group this replication group is in. #> function Set-TargetResource { param ( [Parameter(Mandatory = $true)] [System.String] $GroupName, [Parameter(Mandatory = $true)] [System.String] $FolderName, [Parameter(Mandatory = $true)] [System.String] $ComputerName, [Parameter()] [System.String] $ContentPath, [Parameter()] [System.String] $StagingPath, [Parameter()] [System.UInt32] $StagingPathQuotaInMB, [Parameter()] [System.Boolean] $ReadOnly, [Parameter()] [System.Boolean] $PrimaryMember, [Parameter()] [System.String] $DomainName ) Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.SettingRegGroupMembershipMessage) ` -f $GroupName,$FolderName,$ComputerName ) -join '' ) # Now apply the changes Set-DfsrMembership @PSBoundParameters ` -ErrorAction Stop Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.ReplicationGroupMembershipUpdatedMessage) ` -f $GroupName,$FolderName,$ComputerName ) -join '' ) } # Set-TargetResource <# .SYNOPSIS Tests DFS Replication Group Membership. .PARAMETER GroupName The name of the DFS Replication Group. .PARAMETER FolderName The name of the DFS Replication Group Folder. .PARAMETER ComputerName The computer name of the Replication Group member. This can be specified using either the ComputerName or FQDN name for the member. If an FQDN name is used and the DomainName parameter is set, the FQDN domain name must match. .PARAMETER ContentPath The local content path for the DFS Replication Group Folder. .PARAMETER StagingPath The local staging path for the DFS Replication Group Folder. .PARAMETER StagingPathQuotaInMB The local staging path quota size in MB. .PARAMETER ReadOnly Specify if this content path should be read only. .PARAMETER PrimaryMember Used to configure this as the Primary Member. Every folder must have at least one primary member for initial replication to take place. .PARAMETER DomainName The name of the AD Domain the DFS Replication Group this replication group is in. #> function Test-TargetResource { [OutputType([System.Boolean])] param ( [Parameter(Mandatory = $true)] [System.String] $GroupName, [Parameter(Mandatory = $true)] [System.String] $FolderName, [Parameter(Mandatory = $true)] [System.String] $ComputerName, [Parameter()] [System.String] $ContentPath, [Parameter()] [System.String] $StagingPath, [Parameter()] [System.UInt32] $StagingPathQuotaInMB, [Parameter()] [System.Boolean] $ReadOnly, [Parameter()] [System.Boolean] $PrimaryMember, [Parameter()] [System.String] $DomainName ) # Flag to signal whether settings are correct [System.Boolean] $desiredConfigurationMatch = $true Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.TestingRegGroupMembershipMessage) ` -f $GroupName,$FolderName,$ComputerName ) -join '' ) # Lookup the existing Replication Group $membershipParameters = @{ GroupName = $GroupName ComputerName = $ComputerName } if ($DomainName) { $membershipParameters += @{ DomainName = $DomainName } } $replicationGroupMembership = Get-DfsrMembership @membershipParameters ` -ErrorAction Stop ` | Where-Object { $_.FolderName -eq $FolderName } if ($replicationGroupMembership) { # The rep group folder is found Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.ReplicationGroupMembershipExistsMessage) ` -f $GroupName,$FolderName,$ComputerName ) -join '' ) # Check the ContentPath if (($PSBoundParameters.ContainsKey('ContentPath')) ` -and ($replicationGroupMembership.ContentPath -ne $ContentPath)) { Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.ReplicationGroupMembershipContentPathMismatchMessage) ` -f $GroupName,$FolderName,$ComputerName ) -join '' ) $desiredConfigurationMatch = $false } # if # Check the StagingPath if (($PSBoundParameters.ContainsKey('StagingPath')) ` -and ($replicationGroupMembership.StagingPath -ne $StagingPath)) { Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.ReplicationGroupMembershipStagingPathMismatchMessage) ` -f $GroupName,$FolderName,$ComputerName ) -join '' ) $desiredConfigurationMatch = $false } # if # Check the StagingPathQuota if (($PSBoundParameters.ContainsKey('StagingPathQuotaInMB')) ` -and ($replicationGroupMembership.StagingPathQuotaInMB -ne $StagingPathQuotaInMB)) { Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.ReplicationGroupMembershipStagingPathQuotaMismatchMessage) ` -f $GroupName,$FolderName,$ComputerName ) -join '' ) $desiredConfigurationMatch = $false } # if # Check the ReadOnly if (($PSBoundParameters.ContainsKey('ReadOnly')) ` -and ($replicationGroupMembership.ReadOnly -ne $ReadOnly)) { Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.ReplicationGroupMembershipReadOnlyMismatchMessage) ` -f $GroupName,$FolderName,$ComputerName ) -join '' ) $desiredConfigurationMatch = $false } # if # Check the PrimaryMember if (($PSBoundParameters.ContainsKey('PrimaryMember')) ` -and ($replicationGroupMembership.PrimaryMember -ne $PrimaryMember)) { Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.ReplicationGroupMembershipPrimaryMemberMismatchMessage) ` -f $GroupName,$FolderName,$ComputerName ) -join '' ) $desiredConfigurationMatch = $false } # if } else { # The Rep Group membership doesn't exist New-InvalidOperationException ` -Message ($($script:localizedData.ReplicationGroupMembershipMissingError) ` -f $GroupName,$FolderName,$ComputerName) } # if return $desiredConfigurationMatch } # Test-TargetResource Export-ModuleMember -Function *-TargetResource |