New-RedgateMonitorAwsIamUserCredential
Published 11 March 2026
Creates a new temporary object that holds information about an AWS IAM user credential.
Syntax
New-RedgateMonitorAwsIamUserCredential [-BaseMonitor] <BaseMonitor> [-Name] <string> [-Region] <string> [-AccessKeyId] <string> [-SecretAccessKey] <string> [<CommonParameters>]
Description
The New-RedgateMonitorAwsIamUserCredential cmdlet creates a new temporary object that holds information about an AWS IAM user credential. The returned object needs to be passed to Add-RedgateMonitorCloudProviderCredential, as it does not add anything to Redgate Monitor on its own.
Parameters
-BaseMonitor
<BaseMonitor>
The base monitor to add the credential to.
| Aliases | None |
| Required? | true |
| Position? | 1 |
| Default Value | None |
| Accept Pipeline Input | False |
| Accept Wildcard Characters | false |
-Name
<String>
A display name for the credential.
| Aliases | None |
| Required? | true |
| Position? | 2 |
| Default Value | None |
| Accept Pipeline Input | False |
| Accept Wildcard Characters | false |
-Region
<String>
The AWS region (e.g. "eu-west-2").
| Aliases | None |
| Required? | true |
| Position? | 3 |
| Default Value | None |
| Accept Pipeline Input | False |
| Accept Wildcard Characters | false |
-AccessKeyId
<String>
The AWS IAM Access Key Id.
| Aliases | None |
| Required? | true |
| Position? | 4 |
| Default Value | None |
| Accept Pipeline Input | False |
| Accept Wildcard Characters | false |
-SecretAccessKey
<String>
The AWS IAM Secret Access Key.
| Aliases | None |
| Required? | true |
| Position? | 5 |
| Default Value | None |
| Accept Pipeline Input | False |
| Accept Wildcard Characters | false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable, and -ProgressAction. For more information, see http://technet.microsoft.com/en-us/library/hh847884.aspx.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
-
None.
You cannot pipe input to this cmdlet.
Examples
-------------------------- EXAMPLE 1 --------------------------
New-RedgateMonitorAwsIamUserCredential -BaseMonitor $BaseMonitor -Name "my-aws-credentials" -Region "eu-west-2" -AccessKeyId "AKIAIOSFODNN7EXAMPLE" -SecretAccessKey "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" | Add-RedgateMonitorCloudProviderCredential
-------------------------- EXAMPLE 2 --------------------------
$credential = New-RedgateMonitorAwsIamUserCredential -BaseMonitor $BaseMonitor -Name "my-aws-credentials" -Region "eu-west-2" -AccessKeyId "AKIAIOSFODNN7EXAMPLE" -SecretAccessKey "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" $credential | Add-RedgateMonitorCloudProviderCredential