msp360

0.11.0

public/cbb/Get-MBSNetworkCredential.ps1

function Get-MBSNetworkCredential {
    <#
    .SYNOPSIS
    Lists existing network credentials.
     
    .DESCRIPTION
    Lists existing network credentials and performs availability test if -TestCredentials parameter is specified.
     
    .PARAMETER TestCredentials
    Lists network credentials and performs availability test
     
    .PARAMETER MasterPassword
    Master password. Should be specified if configuration is protected by master password. Use -MasterPassword (ConvertTo-SecureString -string "Your_Password" -AsPlainText -Force)
     
    .EXAMPLE
    Get-MBSNetworkCredential
 
    List network credentials
 
    .EXAMPLE
    Get-MBSNetworkCredential -TestCredentials
 
    List network credentials and performs availability test
 
    .EXAMPLE
    Get-MBSNetworkCredential -MasterPassword (ConvertTo-SecureString -string "Your_Password" -AsPlainText -Force)
 
    List network credentials from backup agent protected with master password
     
    .INPUTS
    None.
 
    .OUTPUTS
    System.Management.Automation.PSCustomObject
 
    .NOTES
    Author: Ivan Skorin
 
    .LINK
    https://kb.msp360.com/managed-backup-service/powershell-module/cmdlets/backup-agent/get-mbsnetworkcredential/
    #>
    [CmdletBinding()]
    param (
        # Parameter - Lists network credentials and performs availability test
        [Parameter(Mandatory=$false, HelpMessage="Lists network credentials and performs availability test")]
        [switch]
        $TestCredentials,
        # Parameter - Master password
        [Parameter(Mandatory=$false, HelpMessage="Specify Master password. Use -MasterPassword (ConvertTo-SecureString -string ""Your_Password"" -AsPlainText -Force)")]
        [SecureString]
        $MasterPassword
    )
    
    begin {
        if (-not($CBB = Get-MBSAgent)) {
            Break
        }
        try {
            if ((Get-MBSAgentSetting -ErrorAction SilentlyContinue).MasterPassword -ne "" -and $null -ne (Get-MBSAgentSetting -ErrorAction SilentlyContinue).MasterPassword -and -not $MasterPassword) {
                $MasterPassword = Read-Host Master Password -AsSecureString
            }
        }
        catch {
        }
    }
    
    process {
        if ($TestCredentials) {
            $Arguments = "nwcList -t"
        } else {
            $Arguments = "nwcList -s"
        }
        $result = Start-MBSProcess -cmdpath $CBB.CBBCLIPath -cmdarguments $Arguments -output json -MasterPassword $MasterPassword
        if ($result.Result -eq "Success") {
            $result.Shares
        }
    }
    
    end {
        
    }
}