Merge pull request #18 from exactmike/DirectConnect

Direct connect merge

Author: exactmike

Functions/Add-RequiredMember.ps1

@@ -0,0 +1,38 @@
+    Function Add-RequiredMember
+    {
+        
+    <#
+    .PARAMETER RequiredMember
+    An Array of strings which designate the names of the required members for the input object
+    .PARAMETER InputObject
+    An Array of strings which designate the names of the required members for the input object
+    #>
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory, Position = 1)]
+        [AllowNull()]
+        [AllowEmptyCollection()]
+        [string[]]$RequiredMember
+        ,
+        [Parameter(Mandatory, ValueFromPipeline, Position = 2)]
+        [psobject[]]$InputObject
+    )
+    Process
+    {
+        foreach ($io in $InputObject)
+        {
+            foreach ($rm in $RequiredMember)
+            {
+                if ($null -ne $rm -and -not [string]::IsNullOrEmpty($rm))
+                {
+                    if (-not (Test-Member -InputObject $io -Name $rm))
+                    {
+                        Add-Member -InputObject $io -MemberType NoteProperty -Name $rm -Value $null
+                    }
+                }
+            }
+        }
+    }
+
+    }
+

Functions/AddServiceTypeAttributesToGenericOrgSystemObject.ps1

@@ -0,0 +1,35 @@
+    Function AddServiceTypeAttributesToGenericOrgSystemObject
+    {
+        
+    [CmdletBinding()]
+    param
+    (
+        [parameter(Mandatory)]
+        $OrgSystemObject
+        ,
+        [parameter(Mandatory)]
+        $ServiceType
+        ,
+        [parameter()]
+        $dictionary
+    )#end param
+    #Get-CallerPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState
+    if ($null -ne $dictionary)
+    {
+        Set-DynamicParameterVariable -dictionary $dictionary
+    }
+    $ServiceTypeDefinition = Get-OneShellServiceTypeDefinition -ServiceType $ServiceType
+    Write-Verbose -Message "Using ServiceTypeDefinition $($ServiceTypeDefinition.name)"
+    if ($null -ne $ServiceTypeDefinition.ServiceTypeAttributes.System -and $ServiceTypeDefinition.ServiceTypeAttributes.System.count -ge 1)
+    {
+        foreach ($a in $ServiceTypeDefinition.ServiceTypeAttributes.System.name)
+        {
+            $Value = $(Get-Variable -Name $a -Scope Local).Value
+            Write-Verbose -Message "Value for $a is $($value -join ',')"
+            $OrgSystemObject.ServiceTypeAttributes | Add-Member -MemberType NoteProperty -Name $a -Value $Value
+        }
+    }
+    $OrgSystemObject
+
+    }
+

Functions/AddUserProfileFolder.ps1

@@ -0,0 +1,26 @@
+    Function AddUserProfileFolder
+    {
+        
+    [cmdletbinding()]
+    param
+    (
+        $UserProfile
+    )
+    $profileFolder = $UserProfile.ProfileFolder
+    if ($null -eq $profileFolder -or [string]::IsNullOrEmpty($profileFolder))
+    {throw("User Profile $($UserProfile.Identity) Profile Folder is invalid.")}
+    if (-not (Test-Path -Path $profileFolder))
+    {
+        [void](New-Item -Path $profileFolder -ItemType Directory -ErrorAction Stop)
+    }
+    $profileSubfolders = $(join-path $profilefolder 'Logs'), $(join-path $profilefolder 'Export'), $(join-path $profileFolder 'InputFiles')
+    foreach ($folder in $profileSubfolders)
+    {
+        if (-not (Test-Path -Path $folder))
+        {
+            [void](New-Item -Path $folder -ItemType Directory -ErrorAction Stop)
+        }
+    }
+
+    }
+

Functions/Connect-OneShellSystem.ps1

@@ -0,0 +1,17 @@
+    Function Convert-CredentialToUserProfileCredential
+    {
+        
+    [cmdletbinding()]
+    param
+    (
+        [pscredential]$credential
+        ,
+        [string]$Identity
+    )
+    if ($null -eq $Identity -or [string]::IsNullOrWhiteSpace($Identity))
+    {$Identity = $(New-OneShellGuid).guid}
+    $credential | Add-Member -MemberType NoteProperty -Name 'Identity' -Value $Identity
+    $credential | Select-Object -Property @{n = 'Identity'; e = {$_.Identity}}, @{n = 'UserName'; e = {$_.UserName}}, @{n = 'Password'; e = {$_.Password | ConvertFrom-SecureString}}
+
+    }
+

Functions/Convert-CredentialToUserProfileCredential.ps1

@@ -0,0 +1,56 @@
+    Function Convert-HashtableToObject
+    {
+        
+    [CmdletBinding()]
+    PARAM
+    (
+        [Parameter(ValueFromPipeline, Mandatory)]
+        [HashTable]$hashtable
+        ,
+        [switch]$Combine
+        ,
+        [switch]$Recurse
+    )
+    BEGIN
+    {
+        $output = @()
+    }
+    PROCESS
+    {
+        if ($recurse)
+        {
+            $keys = $hashtable.Keys | ForEach-Object { $_ }
+            Write-Verbose -Message "Recursing $($Keys.Count) keys"
+            foreach ($key in $keys)
+            {
+                if ($hashtable.$key -is [HashTable])
+                {
+                    $hashtable.$key = Convert-HashtableToObject -hashtable $hashtable.$key -Recurse # -Combine:$combine
+                }
+            }
+        }
+        if ($combine)
+        {
+            $output += @(New-Object -TypeName PSObject -Property $hashtable)
+            Write-Verbose -Message "Combining Output = $($Output.Count) so far"
+        }
+        else
+        {
+            New-Object -TypeName PSObject -Property $hashtable
+        }
+    }
+    END
+    {
+        if ($combine -and $output.Count -gt 1)
+        {
+            Write-Verbose -Message "Combining $($Output.Count) cached outputs"
+            $output | Join-Object
+        }
+        else
+        {
+            $output
+        }
+    }
+
+    }
+

Functions/Convert-HashtableToObject.ps1

@@ -0,0 +1,17 @@
+    Function ConvertFrom-FQDN
+    {
+
+    [cmdletbinding()]
+    param(
+        [parameter(Mandatory,ValueFromPipeline,ValueFromPipelineByPropertyName)]
+        [string[]]$FQDN
+    )
+    process
+    {
+        foreach ($f in $FQDN)
+        {
+            "DC=$($f.replace(".", ",DC="))"
+        }
+    }
+
+    }

Functions/ConvertFrom-FQDN.ps1

@@ -0,0 +1,143 @@
+Function Export-OneShellData
+{
+    [cmdletbinding(DefaultParameterSetName = 'delimited')]
+    param(
+        $ExportFolderPath = $script:ExportDataPath
+        ,
+        [string]$DataToExportTitle
+        ,
+        $DataToExport
+        ,
+        [parameter(ParameterSetName = 'xml/json')]
+        [int]$Depth = 2
+        ,
+        [parameter(ParameterSetName = 'delimited')]
+        [parameter(ParameterSetName = 'xml/json')]
+        [ValidateSet('xml', 'csv', 'json', 'clixml')]
+        [string]$DataType
+        ,
+        [parameter(ParameterSetName = 'delimited')]
+        [switch]$Append
+        ,
+        [parameter(ParameterSetName = 'delimited')]
+        [string]$Delimiter = ','
+        ,
+        [switch]$ReturnExportFilePath
+        ,
+        [parameter()]
+        [ValidateSet('Unicode', 'BigEndianUnicode', 'Ascii', 'Default', 'UTF8', 'UTF8NOBOM', 'UTF7', 'UTF32')]
+        [string]$Encoding = 'Ascii'
+    )
+    #Determine Export File Path
+    #validate append
+    if ($Append -eq $true -and $DataType -ne 'csv')
+    {
+        throw("-Append is not supported with data type $DataType.  It is only supported with data type 'csv'")
+    }
+    Function GetTimeStamp
+    {
+        [string]$Stamp = Get-Date -Format yyyyMMdd-HHmmss
+        #$([DateTime]::Now.ToShortDateString()) $([DateTime]::Now.ToShortTimeString()) #check if this is faster to use than Get-Date
+        $Stamp
+    }
+    $stamp = GetTimeStamp
+    #Build the ExportFilePath value
+    switch ($DataType)
+    {
+        'xml'
+        {
+            $ExportFilePath = Join-Path -Path $exportFolderPath -ChildPath $($Stamp + $DataToExportTitle + '.xml')
+        }#xml
+        'clixml'
+        {
+            $ExportFilePath = Join-Path -Path $exportFolderPath -ChildPath $($Stamp + $DataToExportTitle + '.xml')
+        }#xml
+        'json'
+        {
+            $ExportFilePath = Join-Path -Path $exportFolderPath  -ChildPath $($Stamp + $DataToExportTitle + '.json')
+        }#json
+        'csv'
+        {
+            if ($Append)
+            {
+                $mostrecent = @(get-childitem -Path $ExportFolderPath -Filter "*$DataToExportTitle.csv" | Sort-Object -Property CreationTime -Descending | Select-Object -First 1)
+                if ($mostrecent.count -eq 1)
+                {
+                    $ExportFilePath = $mostrecent[0].fullname
+                }#if
+                else {$ExportFilePath = Join-Path -Path $exportFolderPath -ChildPath $($Stamp + $DataToExportTitle + '.csv')}#else
+            }#if
+            else {$ExportFilePath = Join-Path -Path $exportFolderPath -ChildPath $($Stamp + $DataToExportTitle + '.csv')}#else
+        }#csv
+    }#switch $dataType
+    #Attempt Export of Data to File
+    $message = "Export of $DataToExportTitle as Data Type $DataType to File $ExportFilePath"
+    Write-OneShellLog -Message $message -EntryType Attempting
+    Try
+    {
+        $formattedData = $(
+            switch ($DataType)
+            {
+                'xml'
+                {
+                    $DataToExport | ConvertTo-Xml -Depth $Depth -ErrorAction Stop -NoTypeInformation -As String
+                }#xml
+                'clixml'
+                {
+                    #$DataToExport | ConvertTo-CliXML -Depth -errorAction Stop -Encoding $Encoding #not supported in Windows PowerShell, also need to handle Encoding if UTF8NOBOM is specified
+                }#xml
+                'json'
+                {
+                    $DataToExport | ConvertTo-Json -Depth $Depth -ErrorAction Stop
+                }#json
+                'csv'
+                {
+                    $DataToExport | ConvertTo-Csv -ErrorAction Stop -NoTypeInformation -Delimiter $Delimiter
+                }#csv
+            }
+        )
+        $outFileParams = @{
+            ErrorAction = 'Stop'
+            LiteralPath = $ExportFilePath
+        }
+        switch ($Encoding)
+        {
+            'UTF8NOBOM'
+            {
+                if ($Append)
+                {
+                    $outFileParams.Append = $true
+                    $outFileParams.InputObject = $formattedData
+                }
+                Out-FileUtf8NoBom @outFileParams
+            }
+            Default
+            {
+                $outFileParams.Encoding = $Encoding
+                if ($DataType -eq 'clixml')
+                {
+                    $outFileParams.Depth = $Depth
+                    $outFileParams.InputObject = $DataToExport
+                    Export-Clixml @outFileParams
+                }
+                else
+                {
+                    $outFileParams.InputObject = $formattedData
+                    if ($append)
+                    {
+                        $outFileParams.Append = $true
+                    }
+                    Out-File @outFileParams
+                }
+            }
+        }
+        if ($ReturnExportFilePath) {$ExportFilePath}
+        Write-OneShellLog -Message $message -EntryType Succeeded
+    }#try
+    Catch
+    {
+        Write-OneShellLog -Message "FAILED: Export of $DataToExportTitle as Data Type $DataType to File $ExportFilePath" -Verbose -ErrorLog
+        Write-OneShellLog -Message $_.tostring() -ErrorLog
+    }#catch
+
+}

Functions/Export-OneShellData.ps1

@@ -0,0 +1,48 @@
+Function Export-OneShellOrgProfile
+{
+    [cmdletbinding(SupportsShouldProcess)]
+    param
+    (
+        [parameter(Mandatory)]
+        [psobject]$profile
+        ,
+        [parameter(Mandatory)]
+        [AllowNull()]
+        [ValidateScript( {Test-DirectoryPath -path $_})]
+        $Path
+    )
+    $name = [string]$($profile.Identity.tostring()) + '.json'
+    if ($null -eq $Path)
+    {
+        Write-Verbose -Message "Using Default Profile Location"
+        $FilePath = Join-Path $script:OneShellOrgProfilePath[0] $name
+    }
+    else
+    {
+        $FilePath = Join-Path $Path $name
+    }
+    Write-Verbose -Message "Profile File Export Path is $FilePath"
+    $profile | Remove-Member -Member DirectoryPath
+    $JSONparams = @{
+        InputObject = $profile
+        ErrorAction = 'Stop'
+        Depth       = 10
+    }
+    $OutParams = @{
+        ErrorAction = 'Stop'
+        FilePath    = $FilePath
+        Encoding    = 'ascii'
+    }
+    if ($whatifPreference -eq $false)
+    {$OutParams.Force = $true}
+    try
+    {
+        ConvertTo-Json @JSONparams | Out-File @OutParams
+    }#end try
+    catch
+    {
+        $_
+        throw "FAILED: Could not write Org Profile data to $FilePath"
+    }#end catch
+}
+#end Function Export-OneShellOrgProfile