en-US/about_AzureConnectionAssistant.help.txt

TOPIC
    about_AzureConnectionAssistant

SHORT DESCRIPTION
    A module to assist with connecting to and validating a connection to an Azure RM Subscription.

LONG DESCRIPTION
    The following functions allows for the saving and retrieving of encrypted credentials from the HKCU
    hive of the , and to validate or connect to an Azure RM Subscription.

    Test-Session: Initiates a check to see if you are have a current Azure Login session, if it
                        finds you don't, it prompts you to select credentials saved in the Registry.

    New-AzureRMLogin: Used by Test-Session to connect to Azure using credentials saved in the
                        Registry of the user.

    Get-SavedCreds: Retrieves a credential that is stored in the registry.

    Show-SavedCreds: Displays credentials that are stored in the registry.

    New-SavedCreds: Used to add a new credential set to the registry.

    Update-SavedCreds: Used to update an exisiting stored credentual.

    Remove-SavedCreds: Used to remove an exisiting stored credential.

    Created by: Scott Thomas - scott@deathbyvegemite.com
    Copyright (c) 2017. All rights reserved.

    THIS CODE IS MADE AVAILABLE AS IS, WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK
    OF THE USE OR THE RESULTS FROM THE USE OF THIS CODE REMAINS WITH THE USER.

EXAMPLES
# Test-Session
    PS C:\> Test-Session
    No session found or No local credentials stored.
    Please select from the following
    1: MyAzureCreds
    2: To enter credentials manually (Needed for any Federated credentials)
    Select: : 1

    Environment : AzureCloud
    Account : scott@examplenotreal.com
    TenantId : 123e7e65-2654-43c1-b123-caf99f844a69
    SubscriptionId : 5095e43d-2fee-4c98-bd73-b7c5c7e01012
    SubscriptionName : Pay-As-You-Go
    CurrentStorageAccount :

    PS C:\>


# Get-SavedCreds
    PS C:\> $creds = Get-SavedCreds MyAzureCreds
    PS C:\> $creds
    UserName Password
    -------- --------
    scott@examplenotreal.com System.Security.SecureString

    PS C:\>

# Show-SavedCredentials
    PS C:\> Show-SavedCreds -ShowPasswords

    Name UserName Password
    ---- -------- --------
    MyAzureCreds scott@examplenotreal.com P@s$W0rd!

    PS C:\>


#New-SavedCreds
    PS C:\> $creds = Get-Credential scott@examplenotreal.com
    PS C:\> New-SavedCreds -CredName MyAzureCreds -Creds $creds
    True
    PS C:\>


#Update-SavedCreds
    PS C:\> $creds = Get-Credential scott@examplenotreal.com
    PS C:\> Set-SavedCreds -CredName MyAzureCreds -Creds $creds
    True
    PS C:\>

$Remove-SavedCreds
    PS C:\> Remove-SavedCreds -CredName MyAzureCreds
    
    Confirm
    Are you sure you want to perform this action?
    Performing the operation "Remove-SavedCreds" on target "Are you sure?".
    [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
    MyAzureCreds has been removed
    True

KEYWORDS
    Login-AzureRmAccount, AzureRM, SavedCreds.