Public/Utilities/Get-JCBackup.ps1
|
function Get-JCBackup { [CmdletBinding(DefaultParameterSetName = 'None')] param ( [Parameter(HelpMessage = 'A switch parameter that when called tells the command to back up JumpCloud user, system user, system, user group, and system group information to CSV files.')][switch] $All, [Parameter(HelpMessage = 'A switch parameter that when called backs up JumpCloud user information to CSV.')][switch] $Users, [Parameter(HelpMessage = 'A switch parameter that when called backs up JumpCloud system user information to CSV.')][switch] $SystemUsers, [Parameter(HelpMessage = 'A switch parameter that when called backs up JumpCloud system information to CSV.')][switch] $Systems, [Parameter(HelpMessage = 'A switch parameter that when called backs up JumpCloud user group membership to CSV.')][switch] $UserGroups, [Parameter(HelpMessage = 'A switch parameter that when called backs up JumpCloud system group membership to CSV.')][switch] $SystemGroups ) begin { Write-Verbose 'Verifying JCAPI Key' if ($JCAPIKEY.length -ne 40) { Connect-JCOnline } if ($All) { $Users = $true $SystemUsers = $true $Systems = $true $UserGroups = $true $SystemGroups = $true } if ((-not $All) -and (-not $Users) -and (-not $SystemUsers) -and (-not $Systems -and (-not $UserGroups) -and (-not $SystemGroups))) { Write-Error "You must select item(s) to backup to CSV by setting parameter(s). Options include '-Users', '-SystemUsers', '-Systems','-UserGroups', '-SystemGroups', or '-All' to backup all items" -ErrorAction Stop } $Banner = @" __ ______ __ __ / /__ __ ____ ___ ____ / ____// /____ __ __ ____/ / __ / // / / // __ __ \ / __ \ / / / // __ \ / / / // __ / / /_/ // /_/ // / / / / // /_/ // /___ / // /_/ // /_/ // /_/ / \____/ \____//_/ /_/ /_// ____/ \____//_/ \____/ \____/ \____/ /_/ CSV Backup "@ } process { If (!(Get-PSCallStack | Where-Object { $_.Command -match 'Pester' })) { Clear-Host } $StartTime = Get-Date -Format:('yyyyMMddTHHmmss') Write-Host $Banner -ForegroundColor Green Write-Host "`n============= Backup Status ============`n" if ($Users) { Write-Host -NoNewline "Backing up JumpCloud user information..." try { Get-JCUser | Select-Object * , ` @{Name = 'attributes'; Expression = { $_.attributes | ConvertTo-Json } }, ` @{Name = 'addresses'; Expression = { $_.addresses | ConvertTo-Json } }, ` @{Name = 'phonenumbers'; Expression = { $_.phonenumbers | ConvertTo-Json } }, ` @{Name = 'ssh_keys'; Expression = { $_.ssh_keys | ConvertTo-Json } } ` -ExcludeProperty attributes, addresses, phonenumbers, ssh_keys | Export-Csv -Path "JumpCloudUsers_$($StartTime).CSV" -NoTypeInformation -Force Write-Host "JumpCloudUsers_$($StartTime).CSV created.`n" -ForegroundColor Green } catch { Write-Host $_ } } if ($SystemUsers) { Write-Host -NoNewline "Backing up JumpCloud system user information..." try { Get-JCObject -Type:('system') -Fields:('_id') | ` Get-JCAssociation -TargetType:('user') -IncludeInfo | ` ForEach-Object { $_ | Select-Object -Property @{Name = 'DisplayName'; Expression = { $_.info.displayName } } ` , @{Name = 'HostName'; Expression = { $_.info.hostname } } ` , @{Name = 'SystemID'; Expression = { $_.info._id } } ` , @{Name = 'Username'; Expression = { $_.targetInfo.username } } ` , @{Name = 'Administrator'; Expression = { If ($_.compiledAttributes.sudo.enabled -eq 'true') { $true } Else { $false } } } ` , @{Name = 'DirectBind'; Expression = { If ($_.associationType -like '*direct*') { $true }Else { $false } } } ` , @{Name = 'BindGroups'; Expression = { $_.compiledAttributes.ldapGroups.name -join ', ' } } ` | Export-Csv -Path "JumpCloudSystemUsers_$($StartTime).CSV" -NoTypeInformation -Force -Append } Write-Host "JumpCloudSystemUsers_$($StartTime).CSV created.`n" -ForegroundColor Green; } catch { Write-Host $_ } } if ($Systems) { Write-Host -NoNewline "Backing up JumpCloud system information..." try { Get-JCSystem | Select-Object *, ` @{Name = 'networkInterfaces'; Expression = { $_.networkInterfaces | ConvertTo-Json } }, ` @{Name = 'sshdParams'; Expression = { $_.sshdParams | ConvertTo-Json } } ` -ExcludeProperty networkInterfaces, sshdParams, connectionHistory | Export-Csv -Path "JumpCloudSystems_$($StartTime).CSV" -NoTypeInformation -Force Write-Host "JumpCloudSystems_$($StartTime).CSV created.`n" -ForegroundColor Green } catch { Write-Host $_ } } if ($UserGroups) { Write-Host -NoNewline "Backing up JumpCloud user group membership..." try { Get-JCObject -Type:('user_group') -Fields:('id') | ` Get-JCAssociation -TargetType:('user') -IncludeNames | ` ForEach-Object { $_ | Select-Object -Property @{Name = 'GroupName'; Expression = { $_.name } } ` , @{Name = 'Username'; Expression = { $_.targetName } } ` , @{Name = 'UserID'; Expression = { $_.targetId } } ` | Export-Csv -Path "JumpCloudUserGroupMembers_$($StartTime).CSV" -NoTypeInformation -Force -Append } Write-Host "JumpCloudUserGroupMembers_$($StartTime).CSV created.`n" -ForegroundColor Green } catch { Write-Host $_ } } if ($SystemGroups) { Write-Host -NoNewline "Backing up JumpCloud system group membership..." try { Get-JCObject -Type:('system_group') -Fields:('id') | ` Get-JCAssociation -TargetType:('system') -IncludeNames | ` ForEach-Object { $_ | Select-Object -Property @{Name = 'GroupName'; Expression = { $_.name } } ` , @{Name = 'displayName'; Expression = { $_.targetName } } ` , @{Name = 'SystemID'; Expression = { $_.targetId } } ` | Export-Csv -Path "JumpCloudSystemGroupMembers_$($StartTime).CSV" -NoTypeInformation -Force -Append } Write-Host "JumpCloudSystemGroupMembers_$($StartTime).CSV created.`n" -ForegroundColor Green } catch { Write-Host $_ } } } end { } } |