From 653c1fd5fe1ea0bad1e468d920f9fe707bebcbba Mon Sep 17 00:00:00 2001
From: Alistair Mackay <34012094+fireflycons@users.noreply.github.com>
Date: Sun, 12 Jan 2020 10:21:37 +0000
Subject: [PATCH] Update docs

---
 .../IAM/Set-ATIAMCliExternalCredentials.ps1   |  8 ++
 docs/en-US/Set-ATIAMCliExternalCredentials.md | 87 +++++++++++++++++++
 docs/en-US/aws-toolbox.md                     |  5 +-
 3 files changed, 99 insertions(+), 1 deletion(-)
 create mode 100644 docs/en-US/Set-ATIAMCliExternalCredentials.md

diff --git a/aws-toolbox/Public/IAM/Set-ATIAMCliExternalCredentials.ps1 b/aws-toolbox/Public/IAM/Set-ATIAMCliExternalCredentials.ps1
index c6b09d0..487ebc5 100644
--- a/aws-toolbox/Public/IAM/Set-ATIAMCliExternalCredentials.ps1
+++ b/aws-toolbox/Public/IAM/Set-ATIAMCliExternalCredentials.ps1
@@ -16,6 +16,14 @@ function Set-ATIAMCliExternalCredentials
     .PARAMETER CliProfileName
         Name of profile to create in CLI credentials file. If omitted, then the name
         passed to ProfileName will be used.
+
+    .EXAMPLE
+        Set-ATIAMCliExternalCredentials -ProfileName MySamlProfile
+        Creates an AWS CLI external credential profile named 'MySamlProfile' that maps onto the PowerShell profile named 'MySamlProfile'
+
+    .EXAMPLE
+        Set-ATIAMCliExternalCredentials -ProfileName MySamlProfile -CliProfileName MyCliSamlProfile
+        Creates an AWS CLI external credential profile named 'MyCliSamlProfile' that maps onto the PowerShell profile named 'MySamlProfile'
 #>
     [CmdletBinding()]
     param
diff --git a/docs/en-US/Set-ATIAMCliExternalCredentials.md b/docs/en-US/Set-ATIAMCliExternalCredentials.md
new file mode 100644
index 0000000..bdb08ac
--- /dev/null
+++ b/docs/en-US/Set-ATIAMCliExternalCredentials.md
@@ -0,0 +1,87 @@
+---
+external help file: aws-toolbox-help.xml
+Module Name: aws-toolbox
+online version: https://github.com/fireflycons/aws-toolbox/tree/master/docs/en-US/Set-ATCFNStackProtectionPolicy.md
+schema: 2.0.0
+---
+
+# Set-ATIAMCliExternalCredentials
+
+## SYNOPSIS
+Configue aws-toolbox as an AWS CLI Credential Process
+
+## SYNTAX
+
+```
+Set-ATIAMCliExternalCredentials [[-CliProfileName] <String>] -ProfileName <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+This cmdlet maps a PowerShell stored profile into the AWS CLI credential file
+as a provider of external credentials.
+This is useful to get AWS CLI to use a
+saved SAML profile when e.g.
+you use Active Directory integration to authenticate
+with AWS
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Set-ATIAMCliExternalCredentials -ProfileName MySamlProfile
+```
+
+Creates an AWS CLI external credential profile named 'MySamlProfile' that maps onto the PowerShell profile named 'MySamlProfile'
+
+### EXAMPLE 2
+```
+Set-ATIAMCliExternalCredentials -ProfileName MySamlProfile -CliProfileName MyCliSamlProfile
+```
+
+Creates an AWS CLI external credential profile named 'MyCliSamlProfile' that maps onto the PowerShell profile named 'MySamlProfile'
+
+## PARAMETERS
+
+### -CliProfileName
+Name of profile to create in CLI credentials file.
+If omitted, then the name
+passed to ProfileName will be used.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ProfileName
+Name of PowerShell stored profile to use
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.
+For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+
+## RELATED LINKS
diff --git a/docs/en-US/aws-toolbox.md b/docs/en-US/aws-toolbox.md
index 4032124..cb5bf13 100644
--- a/docs/en-US/aws-toolbox.md
+++ b/docs/en-US/aws-toolbox.md
@@ -67,4 +67,7 @@ Use SSM to set up an admin user on one or more Windows instances
 Set configurable items for this module
 
 ### [Invoke-ATDiffTool](Invoke-ATDiffTool)
-Runs the configured diff tool on a pair of files
\ No newline at end of file
+Runs the configured diff tool on a pair of files
+
+### [Set-ATIAMCliExternalCredentials](Set-ATIAMCliExternalCredentials.md)
+Configue aws-toolbox as an AWS CLI Credential Process