DSCResources/MSFT_xOfflineDomainJoin/MSFT_xOfflineDomainJoin.psm1
|
[Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidGlobalVars", "", Scope="Function")] param ( ) Import-Module -Name (Join-Path -Path (Split-Path -Path $PSScriptRoot -Parent) ` -ChildPath 'CommonResourceHelper.psm1') $script:localizedData = Get-LocalizedData -ResourceName 'MSFT_xOfflineDomainJoin' function Get-TargetResource { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( [Parameter(Mandatory = $true)] [ValidateSet('Yes')] [System.String] $IsSingleInstance, [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [System.String] $RequestFile ) Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.GettingOfflineDomainJoinMessage) ) -join '') <# It is not possible to read the ODJ file that was used to join a domain So it has to always be returned as blank. #> $returnValue = @{ IsSingleInstance = 'Yes' RequestFile = '' } return $returnValue } # Get-TargetResource function Set-TargetResource { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [ValidateSet('Yes')] [System.String] $IsSingleInstance, [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [System.String] $RequestFile ) Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.ApplyingOfflineDomainJoinMessage) ) -join '') # Check the ODJ Request file exists if (-not (Test-Path -Path $RequestFile)) { $errorId = 'RequestFileNotFoundError' $errorCategory = [System.Management.Automation.ErrorCategory]::ObjectNotFound $errorMessage = $($script:localizedData.RequestFileNotFoundError) ` -f $RequestFile $exception = New-Object -TypeName System.ArgumentException ` -ArgumentList $errorMessage $errorRecord = New-Object -TypeName System.Management.Automation.ErrorRecord ` -ArgumentList $exception, $errorId, $errorCategory, $null $PSCmdlet.ThrowTerminatingError($errorRecord) } # if <# Don't need to check if the domain is already joined because Set-TargetResource wouldn't fire unless it wasn't. #> Join-Domain -RequestFile $RequestFile } # Set-TargetResource function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( [Parameter(Mandatory = $true)] [ValidateSet('Yes')] [System.String] $IsSingleInstance, [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [System.String] $RequestFile ) # Flag to signal whether settings are correct [System.Boolean] $desiredConfigurationMatch = $true Write-Verbose -Message ( @("$($MyInvocation.MyCommand): " $($script:localizedData.CheckingOfflineDomainJoinMessage) ) -join '') # Check the ODJ Request file exists if (-not (Test-Path -Path $RequestFile)) { $errorId = 'RequestFileNotFoundError' $errorCategory = [System.Management.Automation.ErrorCategory]::ObjectNotFound $errorMessage = $($script:localizedData.RequestFileNotFoundError) ` -f $RequestFile $exception = New-Object -TypeName System.ArgumentException ` -ArgumentList $errorMessage $errorRecord = New-Object -TypeName System.Management.Automation.ErrorRecord ` -ArgumentList $exception, $errorId, $errorCategory, $null $PSCmdlet.ThrowTerminatingError($errorRecord) } # if $CurrentDomainName = Get-DomainName if($CurrentDomainName) { # Domain is already joined. Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.DomainAlreadyJoinedMessage) ` -f $CurrentDomainName ` ) -join '' ) } else { # Domain is not joined, so change is required. Write-Verbose -Message ( @("$($MyInvocation.MyCommand): " $($script:localizedData.DomainNotJoinedMessage) ) -join '') $desiredConfigurationMatch = $false } # if return $desiredConfigurationMatch } # Test-TargetResource <# .SYNOPSIS Uses DJoin.exe to join a Domain using a ODJ Request File. #> function Join-Domain { [CmdletBinding()] param( [Parameter(Mandatory=$true)] [System.String] $RequestFile ) Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.AttemptingDomainJoinMessage) ` -f $RequestFile ` ) -join '' ) $Result = & djoin.exe @( '/REQUESTODJ' '/LOADFILE' $RequestFile '/WINDOWSPATH' $ENV:SystemRoot '/LOCALOS') if ($LASTEXITCODE -eq 0) { # Notify DSC that a reboot is required. $global:DSCMachineStatus = 1 } else { Write-Verbose -Message $Result $errorId = 'DjoinError' $errorCategory = [System.Management.Automation.ErrorCategory]::ObjectNotFound $errorMessage = $($script:localizedData.DjoinError) ` -f $LASTEXITCODE $exception = New-Object -TypeName System.ArgumentException ` -ArgumentList $errorMessage $errorRecord = New-Object -TypeName System.Management.Automation.ErrorRecord ` -ArgumentList $exception, $errorId, $errorCategory, $null $PSCmdlet.ThrowTerminatingError($errorRecord) } # if Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.DomainJoinedMessage) ` -f $RequestFile ` ) -join '' ) } # function Join-Domain <# .SYNOPSIS Returns the name of the Domain the computer is joined to or $null if not domain joined. #> function Get-DomainName { [CmdletBinding()] [OutputType([System.String])] param() # Use CIM to detect the domain name so that this will work on Nano Server. $computerSystem = Get-CimInstance -ClassName 'Win32_ComputerSystem' -Namespace root\cimv2 if ($computerSystem.Workgroup) { return $null } else { $computerSystem.Domain } } # function Get-DomainName Export-ModuleMember -Function *-TargetResource |