{"id":6121,"date":"2015-05-16T00:01:00","date_gmt":"2015-05-16T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2015\/05\/16\/weekend-scripter-get-started-with-powershell-for-amazon-web-services\/"},"modified":"2020-01-29T20:58:20","modified_gmt":"2020-01-30T04:58:20","slug":"weekend-scripter-get-started-with-powershell-for-amazon-web-services","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/weekend-scripter-get-started-with-powershell-for-amazon-web-services\/","title":{"rendered":"Weekend Scripter: Get Started with PowerShell for Amazon Web Services"},"content":{"rendered":"

Summary<\/b>: Windows PowerShell MVP, Mike F Robbins, walks through a setup to manage an Amazon Web Services environment with Windows PowerShell.<\/span><\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. Welcome back Mike F Robbins to talk about Windows PowerShell for Amazon Web Services.<\/p>\n

\"Photo<\/a><\/p>\n

Mike F Robbins is a Microsoft MVP for Windows PowerShell and for SAPIEN Technologies. He is a co-author of Windows PowerShell TFM 4th<\/sup> Edition,<\/i> and he is the contributing author of a chapter in PowerShell Deep Dives<\/i>. Mike has written guest posts for PowerShell Magazine, PowerShell.org, and the Hey, Scripting Guy! Blog (to read more of Mike’s guest posts, see these Hey, Scripting Guy! Blog posts<\/a>). He is the winner of the advanced category in the 2013 Windows PowerShell Scripting Games. Mike is also the leader and cofounder of the Mississippi PowerShell User Group<\/a>. He blogs at Mike F Robbins Computing Solutions<\/a>, he\u00a0and can be found on twitter at\u00a0@mikefrobbins<\/a>.<\/p>\n

Now, here’s Mike…<\/p>\n

Let me first say that this certainly isn\u2019t a marketing post for Amazon (or any cloud provider, for that matter), and this blog post isn\u2019t meant to endorse one cloud provider over another. I currently work with a mix of Azure and Amazon cloud environments, and I manage both of them (and multiple datacenters with on premise infrastructures) with Windows PowerShell.<\/p>\n

The first thing that you\u2019ll need to get started with Amazon Web Services is an AWS account. See Amazon Web Services<\/a> for more information about creating an account if you don\u2019t already have one.<\/p>\n

When you have an AWS account, visit AWS Tools for Windows PowerShell<\/a> to download the tools. There\u2019s also an online reference for the AWS cmdlets on that webpage.<\/p>\n

Windows PowerShell can be used to download the AWS Tools for Windows PowerShell:<\/p>\n

$Uri = ‘http:\/\/sdk-for-net.amazonwebservices.com\/latest\/AWSToolsAndSDKForNet.msi’<\/p>\n

Invoke-WebRequest -Uri $Uri -OutFile “$env:HOMEPATH\\downloads\\$($Uri -replace ‘^.*\/’)”<\/p>\n

Unblock-File -Path “$env:HOMEPATH\\downloads\\$($Uri -replace ‘^.*\/’)”<\/p>\n

The AWS Tools for Windows PowerShell require that the script execution policy be set to RemoteSigned<\/b> or less so that script execution is allowed on the system that they\u2019re being installed on:<\/p>\n

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Force<\/p>\n

\"Image<\/a><\/p>\n

If you\u2019re only installing the AWS Tools so you can manage your AWS environment with Windows PowerShell, you\u2019ll only need to install the AWS Tools for Windows PowerShell, as shown here:<\/p>\n

\"Image<\/a><\/p>\n

This will add the installation location to your $env:PSModulePath<\/b>, and if you\u2019re running Windows PowerShell 3.0 or higher, there is no need to manually import the module.<\/p>\n

From the services section of your online AWS account dashboard, create an IAM user account and assign it the appropriate permissions. The AccessKey<\/b> and SecretKey<\/b> will be needed. These credentials should be kept secure. After the first account is created, additional IAM user accounts can be created in Windows PowerShell by using the New-IAMUser<\/b> cmdlet.<\/p>\n

Set the AWS credentials for your current Windows PowerShell session or save them persistently as I\u2019ve done in the following example:<\/p>\n

Set-AWSCredentials -AccessKey MYACCESSKEYFORAWS123 -SecretKey AWS1234567890abcdefghijklmnopqrstuvwxyz -StoreAs myprofile<\/p>\n

\"Image<\/a><\/p>\n

List the stored credentials:<\/p>\n

Get-AWSCredentials -ListStoredCredentials<\/p>\n

\"Image<\/a><\/p>\n

The stored credentials can be removed by using the Clear-AWSCredentials<\/b> cmdlet, if desired.<\/p>\n

The next step is to set the default AWS region, but first let\u2019s determine what the valid regions are:<\/p>\n

Get-AWSRegion<\/p>\n

\"Image<\/a><\/p>\n

To set the default region, use:<\/p>\n

Initialize-AWSDefaults -ProfileName myprofile -Region us-east-1<\/p>\n

\"Image<\/a><\/p>\n

Verify that the default region was indeed set correctly:<\/p>\n

Get-DefaultAWSRegion<\/p>\n

\"Image<\/a><\/p>\n

The default region can be cleared by using the Clear-DefaultAWSRegion<\/b> cmdlet, if needed.<\/p>\n

You\u2019re now set up to use Windows PowerShell to manage the products associated with your AWS account. That was easy enough, wasn\u2019t it?<\/p>\n

Now I\u2019ll demonstrate how to retrieve a list of and remove snapshots created by an AWS storage gateway.<\/p>\n

First, I\u2019ll query a list of storage gateways that are set up on AWS for this particular account:<\/p>\n

Get-SGGateway | Format-Table -AutoSize<\/p>\n

\"Image<\/a><\/p>\n

To retrieve a list of all the volumes for the storage gateway returned in the previous results, use:<\/p>\n

Get-SGGateway | Get-SGVolume | Format-Table -AutoSize<\/p>\n

\"Image<\/a><\/p>\n

I\u2019ve written a Windows PowerShell script module named MrAWS<\/b>. It contains a couple of functions that are designed to help make managing the storage gateway snapshots on AWS much easier without having to know all of the intricacies of working with the AWS cmdlets.<\/p>\n

To see all of the snapshots for all of the volumes on a particular AWS storage gateway that are older than 14 days, simply use the Get-MrAWSSGSnapshot<\/b> function (which is part of my MrAWS<\/b> module) and specify the gateway name with the number 14 for the Days<\/b> parameter:<\/p>\n

Get-MrAWSSGSnapShot -GatewayName abcde -Days 14<\/p>\n

\"Image<\/a><\/p>\n

The Remove-MrAWSSGGateway<\/b> function (also part of my MrAWS<\/b> module) is designed to remove all snapshots from all volumes older than the specified number of days from the specified AWS storage gateway. By default, to prevent accidentally deleting all snapshots, it only deletes snapshots that are older than 14 days if the Days<\/b> parameter is not specified. This function supports the Confirm<\/b> and WhatIf<\/b> parameters. I recommend trying it with the WhatIf<\/b> parameter first to see what it will do before actually deleting any snapshots:<\/p>\n

Remove-MrAWSSGSnapShot -GatewayName abcde -Days 14 -WhatIf<\/p>\n

\"Image<\/a><\/p>\n

Not specifying the Confirm<\/b> or WhatIf<\/b> parameter will permanently delete the snapshots that are older than the specified number of days:<\/p>\n

Remove-MrAWSSGSnapShot -GatewayName abcde -Days 14<\/p>\n

\"Image<\/a><\/p>\n

When an attempt is made to retrieve the snapshots that are older than 14 days, nothing is returned because all of the snapshots that were older than 14 days were previously deleted.<\/p>\n

Get-MrAWSSGSnapShot -GatewayName abcde -Days 14<\/p>\n

\"Image<\/a><\/p>\n

By default, the Get-MrAWSSGGateway<\/b> function returns all snapshots for all volumes of the specified AWS storage gateway. By not specifying the Days<\/b> parameter, you can see that there are still 42 snapshots available and those are the ones that have been created within the past 14 days:<\/p>\n

\"Image<\/a><\/p>\n

I hope you\u2019ve enjoyed this blog post, but keep in mind that I really haven\u2019t scratched the surface when it comes to all of the cmdlets available for managing your AWS environment. Use the following command to view all of the cmdlets that are available in the AWSPowerShell module:<\/p>\n

Get-Command -Module AWSPowerShell<\/p>\n

\"Image<\/a><\/p>\n

As of this writing, there are a total of 1142 cmdlets in the AWSPowerShell module:<\/p>\n

(Get-Command -Module AWSPowerShell).count<\/p>\n

\"Image<\/a><\/p>\n

You can download the MrAWS<\/b> module demonstrated in this post from GitHub: mikefrobbins\/AWS<\/a>.<\/p>\n

Thanks, Mike, for sharing your time and knowledge.<\/p>\n

I invite you to follow me on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.<\/p>\n

Ed Wilson, Microsoft Scripting Guy<\/b>\u00a0<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Windows PowerShell MVP, Mike F Robbins, walks through a setup to manage an Amazon Web Services environment with Windows PowerShell. Microsoft Scripting Guy, Ed Wilson, is here. Welcome back Mike F Robbins to talk about Windows PowerShell for Amazon Web Services. Mike F Robbins is a Microsoft MVP for Windows PowerShell and for SAPIEN […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[458,56,344,3,582,61,45],"class_list":["post-6121","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-applications","tag-guest-blogger","tag-mike-f-robbins","tag-scripting-guy","tag-server-applications","tag-weekend-scripter","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Windows PowerShell MVP, Mike F Robbins, walks through a setup to manage an Amazon Web Services environment with Windows PowerShell. Microsoft Scripting Guy, Ed Wilson, is here. Welcome back Mike F Robbins to talk about Windows PowerShell for Amazon Web Services. Mike F Robbins is a Microsoft MVP for Windows PowerShell and for SAPIEN […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/6121","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=6121"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/6121\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=6121"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=6121"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=6121"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}