PowerCommander

0.9.21

FolderCommands.ps1

                                #requires -Version 5.1

function Add-KeeperFolder {

    <#

    .Synopsis

    Creates a Keeper folder.

    .Parameter Name

    Folder name

    .Parameter ParentFolderUid

    Parent Folder UID. Use current folder if omitted

    .Parameter Shared

    Create a shared folder

    .Parameter CanEdit

    Anyone can edit records by default

    .Parameter CanShare

    Anyone can share records by default

    .Parameter ManageUsers

    Anyone can manage users by default

    .Parameter ManageRecords

    Anyone can manage records by default

#>

    [CmdletBinding(DefaultParameterSetName = 'Default')]

    Param (

        [Parameter(Position = 0, Mandatory = $true)][string] $Name,

        [Parameter()][string] $ParentFolderUid,

        [Parameter()][switch] $Shared,

        [Parameter()][switch] $CanEdit,

        [Parameter()][switch] $CanShare,

        [Parameter()][switch] $ManageUsers,

        [Parameter()][switch] $ManageRecords

    )

    [KeeperSecurity.Vault.VaultOnline]$vault = getVault

    $objs = Get-KeeperChildItem -ObjectType Folder | Where-Object Name -eq $Name

    if ($objs.Length -gt 0 ) {

        Write-Error -Message "Folder `"$Name`" already exists" -ErrorAction Stop

    }

    $parentUid = $Script:Context.CurrentFolder

    if ($ParentFolderUid) {

        [KeeperSecurity.Vault.FolderNode]$folder = $null

        if (-not $vault.TryGetFolder($ParentFolderUid, [ref]$folder)) {

            Write-Error -Message "Folder UID `"$ParentFolderUid`" does not exist" -ErrorAction Stop

        }

        $parentUid = $ParentFolderUid

    }

    $options = $null

    if ($Shared.IsPresent) {

        $options = New-Object KeeperSecurity.Vault.SharedFolderOptions

        if ($CanEdit.IsPresent) {

            $options.CanEdit = $true

        }

        if ($CanShare.IsPresent) {

            $options.CanShare = $true

        }

        if ($ManageUsers.IsPresent) {

            $options.ManageUsers = $true

        }

        if ($ManageRecords.IsPresent) {

            $options.ManageRecords = $true

        }

    }

    $vault.CreateFolder($Name, $parentUid, $options).GetAwaiter().GetResult()

}

New-Alias -Name kmkdir -Value Add-KeeperFolder

function Remove-KeeperFolder {

    <#

    .Synopsis

    Delete Keeper folder.

    .Parameter Name

    Folder name or Folder UID

#>

    [CmdletBinding(DefaultParameterSetName = 'Default')]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseShouldProcessForStateChangingFunctions", "")]

    Param (

        [Parameter(Position = 0, Mandatory = $true)][string] $Name

    )

    [KeeperSecurity.Vault.VaultOnline]$vault = getVault

    $folderUid = $null

    $folder = $null

    if ($vault.TryGetFolder($Name, [ref]$folder)) {

        $folderUid = $folder.FolderUid

    }

    if (-not $folderUid) {

        $objs = Get-KeeperChildItem -ObjectType Folder | Where-Object Name -eq $Name

        if (-not $objs) {

            Write-Error -Message "Folder `"$Name`" does not exist" -ErrorAction Stop

        }

        if ($objs.Length -gt 1) {

            Write-Error -Message "There are more than one folders with name `"$Name`". Use Folder UID do delete the correct one." -ErrorAction Stop

        }

        $folderUid = $objs[0].Uid

    }

    $vault.DeleteFolder($folderUid).GetAwaiter().GetResult() | Out-Null

}

New-Alias -Name krmdir -Value Remove-KeeperFolder

function Edit-KeeperFolder {

    <#

    .Synopsis

    Edits a Keeper folder.

    .Parameter Uid

    Folder UID or Name

    .Parameter Name

    Folder new name 

    .Parameter CanEdit

    Anyone can edit records by default (Shared Folder only)

    .Parameter CanShare

    Anyone can share records by default (Shared Folder only)

    .Parameter ManageUsers

    Anyone can manage users by default (Shared Folder only)

    .Parameter ManageRecords

    Anyone can manage records by default (Shared Folder only)

#>

    [CmdletBinding(DefaultParameterSetName = 'Default')]

    Param (

        [Parameter(Position=0, Mandatory = $true)] [string] $Uid,

        [Parameter()][string] $Name,

        [Parameter()][switch] $CanEdit,

        [Parameter()][switch] $CanShare,

        [Parameter()][switch] $ManageUsers,

        [Parameter()][switch] $ManageRecords

    )

    [KeeperSecurity.Vault.VaultOnline]$vault = getVault

    $folderUid = $null

    $folder = $null

    if ($vault.TryGetFolder($Uid, [ref]$folder)) {

        $folderUid = $folder.FolderUid

    }

    if (-not $folderUid) {

        $objs = Get-KeeperChildItem -ObjectType Folder | Where-Object Name -eq $Uid

        if (-not $objs) {

            Write-Error -Message "Folder `"$Uid`" does not exist" -ErrorAction Stop

        }

        if ($objs.Length -gt 1) {

            Write-Error -Message "There are more than one folders with name `"$Uid`". Use Folder UID do delete the correct one." -ErrorAction Stop

        }

        $folderUid = $objs[0].Uid

    }    

    $options = $null

    if ($CanEdit.IsPresent -or $CanShare.IsPresent -or $ManageUsers.IsPresent -or $ManageRecords.IsPresent) {

        $options = New-Object KeeperSecurity.Vault.SharedFolderOptions

        if ($CanEdit.IsPresent) {

            $options.CanEdit = $true

        }

        if ($CanShare.IsPresent) {

            $options.CanShare = $true

        }

        if ($ManageUsers.IsPresent) {

            $options.ManageUsers = $true

        }

        if ($ManageRecords.IsPresent) {

            $options.ManageRecords = $true

        }

    }

    $vault.UpdateFolder($folderUid, $Name, $options).GetAwaiter().GetResult()

}

# SIG # Begin signature block

# MIIR1wYJKoZIhvcNAQcCoIIRyDCCEcQCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUedMsFNfli/EeEACbk5WFWP5G

# IFiggg4jMIIGsDCCBJigAwIBAgIQCK1AsmDSnEyfXs2pvZOu2TANBgkqhkiG9w0B

# AQwFADBiMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD

# VQQLExB3d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVk

# IFJvb3QgRzQwHhcNMjEwNDI5MDAwMDAwWhcNMzYwNDI4MjM1OTU5WjBpMQswCQYD

# VQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lD

# ZXJ0IFRydXN0ZWQgRzQgQ29kZSBTaWduaW5nIFJTQTQwOTYgU0hBMzg0IDIwMjEg

# Q0ExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA1bQvQtAorXi3XdU5

# WRuxiEL1M4zrPYGXcMW7xIUmMJ+kjmjYXPXrNCQH4UtP03hD9BfXHtr50tVnGlJP

# DqFX/IiZwZHMgQM+TXAkZLON4gh9NH1MgFcSa0OamfLFOx/y78tHWhOmTLMBICXz

# ENOLsvsI8IrgnQnAZaf6mIBJNYc9URnokCF4RS6hnyzhGMIazMXuk0lwQjKP+8bq

# HPNlaJGiTUyCEUhSaN4QvRRXXegYE2XFf7JPhSxIpFaENdb5LpyqABXRN/4aBpTC

# fMjqGzLmysL0p6MDDnSlrzm2q2AS4+jWufcx4dyt5Big2MEjR0ezoQ9uo6ttmAaD

# G7dqZy3SvUQakhCBj7A7CdfHmzJawv9qYFSLScGT7eG0XOBv6yb5jNWy+TgQ5urO

# kfW+0/tvk2E0XLyTRSiDNipmKF+wc86LJiUGsoPUXPYVGUztYuBeM/Lo6OwKp7AD

# K5GyNnm+960IHnWmZcy740hQ83eRGv7bUKJGyGFYmPV8AhY8gyitOYbs1LcNU9D4

# R+Z1MI3sMJN2FKZbS110YU0/EpF23r9Yy3IQKUHw1cVtJnZoEUETWJrcJisB9IlN

# Wdt4z4FKPkBHX8mBUHOFECMhWWCKZFTBzCEa6DgZfGYczXg4RTCZT/9jT0y7qg0I

# U0F8WD1Hs/q27IwyCQLMbDwMVhECAwEAAaOCAVkwggFVMBIGA1UdEwEB/wQIMAYB

# Af8CAQAwHQYDVR0OBBYEFGg34Ou2O/hfEYb7/mF7CIhl9E5CMB8GA1UdIwQYMBaA

# FOzX44LScV1kTN8uZz/nupiuHA9PMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAK

# BggrBgEFBQcDAzB3BggrBgEFBQcBAQRrMGkwJAYIKwYBBQUHMAGGGGh0dHA6Ly9v

# Y3NwLmRpZ2ljZXJ0LmNvbTBBBggrBgEFBQcwAoY1aHR0cDovL2NhY2VydHMuZGln

# aWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5jcnQwQwYDVR0fBDwwOjA4

# oDagNIYyaHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJv

# b3RHNC5jcmwwHAYDVR0gBBUwEzAHBgVngQwBAzAIBgZngQwBBAEwDQYJKoZIhvcN

# AQEMBQADggIBADojRD2NCHbuj7w6mdNW4AIapfhINPMstuZ0ZveUcrEAyq9sMCcT

# Ep6QRJ9L/Z6jfCbVN7w6XUhtldU/SfQnuxaBRVD9nL22heB2fjdxyyL3WqqQz/WT

# auPrINHVUHmImoqKwba9oUgYftzYgBoRGRjNYZmBVvbJ43bnxOQbX0P4PpT/djk9

# ntSZz0rdKOtfJqGVWEjVGv7XJz/9kNF2ht0csGBc8w2o7uCJob054ThO2m67Np37

# 5SFTWsPK6Wrxoj7bQ7gzyE84FJKZ9d3OVG3ZXQIUH0AzfAPilbLCIXVzUstG2MQ0

# HKKlS43Nb3Y3LIU/Gs4m6Ri+kAewQ3+ViCCCcPDMyu/9KTVcH4k4Vfc3iosJocsL

# 6TEa/y4ZXDlx4b6cpwoG1iZnt5LmTl/eeqxJzy6kdJKt2zyknIYf48FWGysj/4+1

# 6oh7cGvmoLr9Oj9FpsToFpFSi0HASIRLlk2rREDjjfAVKM7t8RhWByovEMQMCGQ8

# M4+uKIw8y4+ICw2/O/TOHnuO77Xry7fwdxPm5yg/rBKupS8ibEH5glwVZsxsDsrF

# hsP2JjMMB0ug0wcCampAMEhLNKhRILutG4UI4lkNbcoFUCvqShyepf2gpx8GdOfy

# 1lKQ/a+FSCH5Vzu0nAPthkX0tGFuv2jiJmCG6sivqf6UHedjGzqGVnhOMIIHazCC

# BVOgAwIBAgIQAnNTGQOIer82vZ1cJyDJDjANBgkqhkiG9w0BAQsFADBpMQswCQYD

# VQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lD

# ZXJ0IFRydXN0ZWQgRzQgQ29kZSBTaWduaW5nIFJTQTQwOTYgU0hBMzg0IDIwMjEg

# Q0ExMB4XDTIyMDIwMjAwMDAwMFoXDTI1MDIwMTIzNTk1OVowcDELMAkGA1UEBhMC

# VVMxETAPBgNVBAgTCElsbGlub2lzMRAwDgYDVQQHEwdDaGljYWdvMR0wGwYDVQQK

# ExRLZWVwZXIgU2VjdXJpdHkgSW5jLjEdMBsGA1UEAxMUS2VlcGVyIFNlY3VyaXR5

# IEluYy4wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDNgTqmksdjUyKF

# 5zWkDyghf0PLWJWdzG0TX2j8B4J55xwt+B17zd4Xc3n0dvmSVAyPQANeN+mP1chf

# 4LTRn9h4jWb8Jsfn+JzyRhj/gYINYvBnpRpqoM0z7QC9Ebwj5T61Cogm9EKGcrG+

# Ujh+Z7pTqfSUrHD8NMXhDL/UpVn+w0Pb4qg7o7AH2o94n7u/qTlMGZCs+VCAvhNr

# wPABxvFY07YGb9t5/IZlPE8vG3p1vw2SbgREgFWSEQFj6X2CIhSrbiFCW/766/Mq

# EX6qm+RyF71fD4d3yShg39guaE9o+TBl1MqVCje4bK/wGoNxCho0I6Z1fBBKloyp

# vlx3gPpU7tJJ+KpuIiel9R9dGQuscqKzehPtbRc9Abr9ThN/HrLg1sFFVMdn2oMR

# 63QCUdz+B1NuS7Ap8Ti7XvAPJHzEuQDcdMcRbkIfllJVqrb9UXEFwOPzvRU2KrcQ

# 42Jlnn4T+WenPx5Nr3o/o08WLhLTicEK1OacEowyRLBmih4Gxpdk3fUAVCEkdvmq

# TSydQpl1Bk8V88dxCkB1wMZyFYLNcddBL4kUbwjso/z6f2TtfAVYs/iIRWqs7Xqt

# 4F2BBqobOGMymwg6VgVjjzDIgJCZSbjpq2IoVTci5vli6vxgSoZ01fccSaKa4Izm

# B7DbobIkIjLgPqpnCkqlHuJj5hQ9twIDAQABo4ICBjCCAgIwHwYDVR0jBBgwFoAU

# aDfg67Y7+F8Rhvv+YXsIiGX0TkIwHQYDVR0OBBYEFCZd3/KEdT2t5WTIFb3TUaM4

# sTikMA4GA1UdDwEB/wQEAwIHgDATBgNVHSUEDDAKBggrBgEFBQcDAzCBtQYDVR0f

# BIGtMIGqMFOgUaBPhk1odHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRU

# cnVzdGVkRzRDb2RlU2lnbmluZ1JTQTQwOTZTSEEzODQyMDIxQ0ExLmNybDBToFGg

# T4ZNaHR0cDovL2NybDQuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0Q29k

# ZVNpZ25pbmdSU0E0MDk2U0hBMzg0MjAyMUNBMS5jcmwwPgYDVR0gBDcwNTAzBgZn

# gQwBBAEwKTAnBggrBgEFBQcCARYbaHR0cDovL3d3dy5kaWdpY2VydC5jb20vQ1BT

# MIGUBggrBgEFBQcBAQSBhzCBhDAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGln

# aWNlcnQuY29tMFwGCCsGAQUFBzAChlBodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5j

# b20vRGlnaUNlcnRUcnVzdGVkRzRDb2RlU2lnbmluZ1JTQTQwOTZTSEEzODQyMDIx

# Q0ExLmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQAGyDM3Cbxq

# Auhr8O2xwOoCSVKmFkXqicwlrugwLW44Y4WX+imvTrGfjj2S99k/4D5H8DgtW/u8

# tOxcCoehTOCIEwP5TLrieHppsqAR4jaJRcdAHOWiJ1bmwQBv/cBU9vaelL0oXxxf

# TwD9oDaQNuyq6p+nIJMqbKv33b8AWGe3zq4JwblaFjRDL5lUDNhPx3g/pm7JhnbX

# 7QTKydAJvpbuP5cqUH1GEeVMjc5vEELtGNy/fy7Ekm4dndX4IZcFXW5L0Lx8cReB

# hIZwA+pzdzTWQYvfxgRMb/j2uY+Tkb6Wz2x9BBS1UXiP2qrs3rhQv8DZRkUSqnko

# YD4uJP8gk8BXcIXIThgEF2YCq2hBiwna5Ijbwkmjn1lWwGv15SznTOTnrVApJqB1

# tB2s2ovUNV4CyKDPVr+9/CS6IQJfEZeHYcYLsIga2q5NZCrqZAasBfCwALVkALos

# DIWhs33vYLfETMSuk5Hd5JC+hLjVM3ZJwslvnc/wec2r0GNAiZ3a1aweC7NYuzRz

# 29Mi/eR/4ylmCltyZqYJ1JcC/g6eY2Q0xkdWc8P0yHfQ/3fe7+AKXXKNjfv858GW

# lg1Ck2lvwPdLqJWqj1FwJPiGRCB+WulPe0csTyWnf+ed45TXx69tZ6BZr0Xr2jXu

# ybBdJtg0NN0a62xxWrmX42CgsrzHzRm7OzGCAx4wggMaAgEBMH0waTELMAkGA1UE

# BhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2Vy

# dCBUcnVzdGVkIEc0IENvZGUgU2lnbmluZyBSU0E0MDk2IFNIQTM4NCAyMDIxIENB

# MQIQAnNTGQOIer82vZ1cJyDJDjAJBgUrDgMCGgUAoHgwGAYKKwYBBAGCNwIBDDEK

# MAigAoAAoQKAADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3

# AgELMQ4wDAYKKwYBBAGCNwIBFTAjBgkqhkiG9w0BCQQxFgQUgqILncKy//blc18k

# jYRh2/wnuj4wDQYJKoZIhvcNAQEBBQAEggIAIWxR2RXW4/+J29Lu6Q5dru/R6O8V

# xA7Un8jYczUWNJ4t1QiCbrtjjYQo5KXcuAVZsUlgLgYLtsYjTB6mrkcWV7VFhdVd

# 4kafhPJkrinDH0bEK1tMGeNo/6QsvOG6fvaQWyh1LAYNgqRLtXKPOoNwKLzKzj0s

# DOFAuJL5Q+z5TvX/2DhI6R6au2tNSXR4mdOBIaL+wiKxPgC3jzhbG5u26vFzecxw

# yKBzC1zW071z2hxhzmLVHEntSFQsxgL1AA2Ni8rPOQqx1kzKpoWt8ajmcYiubwMO

# p5xBib0rS7R9vDYWahytdk18+hF4SccoeWvC8pGcTCXnQsRUB9WcIZMgTtHUMqPb

# 5CLpOlrsbayxVQkgnwSiAbZjxCvw9er1N30JmlTf/eTIAkIlkPionlXABqu31TFg

# Ilj6ok2AEJJxIjoSFACVB+2sTi86G+qV+qFHNZ3hVW6HXUirw2geDCTZcL90PndB

# RzPXTQyQUqijB6aHwL+11SqgAXGb1dgtlROcPI71Q6+aeX5peaqqrZ4p8+bTsVEf

# GG9ev063o69C/dGOv6QMUw46zvecIZq71oODohyWIp5w55KphX3EKw0JUxbJSPjf

# CiTU+EeykHVAtFShd/bTAXHPIh5YOao+XVani+7BioL3gJ3F/DeEUA/+ooRTLJEv

# vwEIwKIM2IXQjxI=

# SIG # End signature block