about_bConnectV2.help.txt

bConnectV2 PowerShell Module
 
Import the module
 
    After you installed the module, you can import it with the following command:
    powershell-code:
    Import-Module bConnectV2
 
    If you downloaded the module instead of installing, you can import it from a directory instead:
    powershell-code:
    $Path = "Path\To\bConnectV2"
    Import-Module "$Path\bConnectV2.psd1"
 
    To test if the module was imported, run the following command:
    powershell-code:
    Get-Module -Name bConnectV2
 
    If there is a module with the name `bConnectV2` then the import was successful
 
Authentication
    To authenticate with the module, we support the following methods:
    - Basic authentication with username (type `string`) and password (type `SecureString`)
    - Authentication with an API key (type `SecureString`)
 
    It is required to run the `Set-bConnectConfig` at least once or repeat the command(s) if you want to update or change your authentication method
 
    The authentication method `Set-bConnectConfig` takes following parameters(powershell-code):
    -Hostname "YourbConnectFQDN"
    -Username "YourUsername"
    -Password $YourPasswordAsSecureString
    -ApiKey $YourApiKeyAsSecureString
 
    With the following parameter sets (powershell-code):
    Set-bConnectConfig -Username "YourUsername" -Password $YourPasswordAsSecureString -Hostname "YourbConnectFQDN"
    Set-bConnectConfig -ApiKey $YourApiKeyAsSecureString -Hostname "YourbConnectFQDN"
 
powershell-code examples:
 
    $YourPasswordAsSecureString = Read-Host -Prompt "Enter your Password" -AsSecureString
    $YourApiKeyAsSecureString = Read-Host -Prompt "Enter your API key" -AsSecureString
    # Option Basic authentication
    Set-bConnectConfig -Password $YourPasswordAsSecureString -Username "YourUsername" -Hostname "bServer.domain.net"
 
    # Option API key authentication
    Set-bConnectConfig -ApiKey $YourApiKeyAsSecureString -Hostname "bServer.domain.net"
 
    # Specified port by appending to hostname
    Set-bConnectConfig -ApiKey $YourApiKeyAsSecureString -Hostname "bServer.domain.net:8443"
 
Sample scripts
    Sample scripts are provided in the samples directory of the module.
 
bConnectV2 and powershell module
 
    The functions are prefixed with their corresponding bConnectV2 context.
    See bConnectV2 documentation (https://docs.baramundi.com/helpsetid=m_t_configuration&externalid=i_configuration_interfaces_bConnect&Language=en-us).
 
    examples given in powershell-code:
    # ActiveDirectory Context
    Get-bCActivedirectoryADGroups
    # Endpoints Context
    Get-bCEndpointsEndpoints