AWS ec2: Restructure specialized Windows AMIs page with new sections and CLI examples
Summary
Reorganizes the specialized Windows AMIs documentation: converts bold labels into markdown headings (SQL Server, STIG Hardened, NitroTPM, Language-specific, EC2Launch v2, BIOS AMIs), adds AWS CLI and PowerShell retrieval examples for each category, and consolidates CloudShell notes. Content is largely reformatted/reordered rather than newly introduced.
Security assessment
The diff is a documentation restructuring (headings, section reordering, added CLI/PowerShell examples). The STIG and NitroTPM/UEFI Secure Boot references are pre-existing content merely reformatted, not new security guidance, and no vulnerability, CVE, or incident is referenced.
Evidence
STIG Hardened EC2 Windows Server AMIs are pre-configured with over 160 required security settings to help ensure that the instances that you launch follow the latest guidelines for STIG compliance. See [STIG Hardened AWS Windows Server AMIs](./ami-windows-stig.html) for more information.
Diff
diff --git a/ec2/latest/windows-ami-reference/specialized-windows-amis.md b/ec2/latest/windows-ami-reference/specialized-windows-amis.md index 0fe6717..a08e3f3 100644 --- a//ec2/latest/windows-ami-reference/specialized-windows-amis.md +++ b//ec2/latest/windows-ami-reference/specialized-windows-amis.md @@ -7 +7 @@ -Find an AWS Windows AMI +SQL Server license-included AMIsSTIG Hardened AMIsNitroTPM-enabled AMIsLanguage-specific AMIsEC2Launch v2 AMIsBIOS AMIs @@ -11 +11 @@ Find an AWS Windows AMI -In addition to its standard operating system version AMIs, Amazon creates the following types of specialized AWS Windows AMIs: +In addition to its standard operating system version AMIs, Amazon creates several types of specialized AWS Windows AMIs. @@ -13 +13 @@ In addition to its standard operating system version AMIs, Amazon creates the fo -**SQL Server license-included AMIs** +You can also create your own customized AMI from one of the AWS Windows AMIs with EC2 Image Builder. For more information, see the [EC2 Image Builder User Guide](https://docs.aws.amazon.com/imagebuilder/latest/userguide/). @@ -14,0 +15 @@ In addition to its standard operating system version AMIs, Amazon creates the fo +###### Note @@ -16 +17 @@ In addition to its standard operating system version AMIs, Amazon creates the fo -Launching an instance from a Windows AMI with Microsoft SQL Server enables you to run the instance as a database server. For more information, see [AWS Windows Server license-included SQL Server AMIs](./ami-windows-sql.html). +Not all AMIs are available in all Regions. @@ -18 +19 @@ Launching an instance from a Windows AMI with Microsoft SQL Server enables you t -**STIG Hardened AMIs** +## SQL Server license-included AMIs @@ -19,0 +21 @@ Launching an instance from a Windows AMI with Microsoft SQL Server enables you t +Launching an instance from a Windows AMI with Microsoft SQL Server enables you to run the instance as a database server. See [AWS Windows Server license-included SQL Server AMIs](./ami-windows-sql.html) for more information. @@ -21 +23 @@ Launching an instance from a Windows AMI with Microsoft SQL Server enables you t -STIG Hardened EC2 Windows Server AMIs are pre-configured with over 160 required security settings to help ensure that the instances that you launch follow the latest guidelines for STIG compliance. For more information, see [STIG Hardened AWS Windows Server AMIs](./ami-windows-stig.html). +## STIG Hardened AMIs @@ -23 +25 @@ STIG Hardened EC2 Windows Server AMIs are pre-configured with over 160 required -**NitroTPM enabled AMIs** +STIG Hardened EC2 Windows Server AMIs are pre-configured with over 160 required security settings to help ensure that the instances that you launch follow the latest guidelines for STIG compliance. See [STIG Hardened AWS Windows Server AMIs](./ami-windows-stig.html) for more information. @@ -24,0 +27 @@ STIG Hardened EC2 Windows Server AMIs are pre-configured with over 160 required +## NitroTPM-enabled AMIs @@ -26 +29 @@ STIG Hardened EC2 Windows Server AMIs are pre-configured with over 160 required -Amazon creates a set of AMIs that are pre-configured with NitroTPM and UEFI Secure Boot requirements. For more information, see [AWS Windows Server NitroTPM enabled AMIs](./ami-windows-tpm.html). +Amazon creates a set of AMIs that are pre-configured with NitroTPM and UEFI Secure Boot requirements. See [AWS Windows Server NitroTPM enabled AMIs](./ami-windows-tpm.html) for more information. @@ -28 +31 @@ Amazon creates a set of AMIs that are pre-configured with NitroTPM and UEFI Secu -You can also create your own customized AMI from one of the AWS Windows AMIs with EC2 Image Builder. For more information, see the [EC2 Image Builder User Guide](https://docs.aws.amazon.com/imagebuilder/latest/userguide/). +## Language-specific AMIs @@ -30 +33 @@ You can also create your own customized AMI from one of the AWS Windows AMIs wit -We recommend PowerShell for the command line examples in this section. To install PowerShell in your environment, see the [Installation](https://docs.aws.amazon.com/powershell/v4/userguide/pstools-getting-set-up.html) page in the _AWS Tools for PowerShell (version 4) User Guide_. +AWS Windows AMIs are available in Chinese, Czech, Dutch, English, French, German, Hungarian, Italian, Japanese, Korean, Polish, Portuguese, Russian, Spanish, Swedish, and Turkish. @@ -32 +35 @@ We recommend PowerShell for the command line examples in this section. To instal -###### Note +AWS CLI @@ -34 +36,0 @@ We recommend PowerShell for the command line examples in this section. To instal -Not all AMIs are available in all Regions. @@ -36 +38 @@ Not all AMIs are available in all Regions. -## Find an AWS Windows AMI +Use the [get-parameters-by-path](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameters-by-path.html) command to retrieve the latest English-language AWS Windows AMIs. @@ -38 +39,0 @@ Not all AMIs are available in all Regions. -Each of the specialized AMI pages linked above has its own filtered search examples, as follows: @@ -40 +41,5 @@ Each of the specialized AMI pages linked above has its own filtered search examp - * [Find Windows Server AMIs with Microsoft SQL Server](./ami-windows-sql.html#ami-windows-sql-find) + aws ssm get-parameters-by-path \ + --path "/aws/service/ami-windows-latest" \ + --recursive \ + --query 'Parameters[*].{Name:Name,Value:Value}' \ + --output text | grep ".*Windows_Server-.*English.*" | sort @@ -42 +47 @@ Each of the specialized AMI pages linked above has its own filtered search examp - * [Find a STIG Hardened AMI](./ami-windows-stig.html#find-windows-stig-ami) +PowerShell @@ -44 +48,0 @@ Each of the specialized AMI pages linked above has its own filtered search examp - * [Find Windows Server AMIs configured with NitroTPM and UEFI Secure Boot](./ami-windows-tpm.html#ami-windows-tpm-find) @@ -46,4 +50 @@ Each of the specialized AMI pages linked above has its own filtered search examp - - - -You can also search for the latest Windows AMIs that include the EC2Launch v2 agent, as shown in the following PowerShell example: +Use the [Get-SSMLatestEC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-SSMLatestEC2Image.html) cmdlet to retrieve the latest English-language AWS Windows AMIs. @@ -54 +55 @@ You can also search for the latest Windows AMIs that include the EC2Launch v2 ag - -ImageName EC2LaunchV2-Windows* | ` + -ImageName *Windows_Server-*English* | @@ -56,0 +58 @@ You can also search for the latest Windows AMIs that include the EC2Launch v2 ag +## EC2Launch v2 AMIs @@ -58,3 +60 @@ You can also search for the latest Windows AMIs that include the EC2Launch v2 ag -###### Note - -If this command doesn't run in your environment, you might be missing a PowerShell module. For more information about this command, see [Get-SSMLatestEC2Image Cmdlet](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-SSMLatestEC2Image.html). +Windows Server 2016 and 2019 AMIs include the EC2Launch v1 agent. Amazon also provides these AMIs repackaged with the EC2Launch v2 agent. @@ -62 +62 @@ If this command doesn't run in your environment, you might be missing a PowerShe -Alternatively, you can use the [CloudShell console](https://console.aws.amazon.com/cloudshell/home) and run `pwsh` to bring up a PowerShell prompt that already has all of the AWS tools installed. For more information, see the [AWS CloudShell User Guide](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html). +AWS CLI @@ -64 +63,0 @@ Alternatively, you can use the [CloudShell console](https://console.aws.amazon.c -### Find an AWS Windows AMI in a specific language @@ -66 +65 @@ Alternatively, you can use the [CloudShell console](https://console.aws.amazon.c -The following language-specific AWS Windows AMIs are included in the monthly release: +Use the [get-parameters-by-path](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameters-by-path.html) command to retrieve the latest AWS Windows AMIs that include the EC2Launch v2 agent. @@ -68 +66,0 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * English @@ -70 +68,5 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * Japanese + aws ssm get-parameters-by-path \ + --path "/aws/service/ami-windows-latest" \ + --recursive \ + --query 'Parameters[*].{Name:Name,Value:Value}' \ + --output text | grep "EC2LaunchV2-Windows" | sort @@ -72 +74 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * Chinese +PowerShell @@ -74 +75,0 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * Korean @@ -76 +77 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * Czech +Use the [Get-SSMLatestEC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-SSMLatestEC2Image.html) cmdlet to retrieve the latest AWS Windows AMIs that include the EC2Launch v2 agent. @@ -78 +78,0 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * Dutch @@ -80,7 +80,4 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * French - - * German - - * Hungarian - - * Italian + Get-SSMLatestEC2Image ` + -Path ami-windows-latest ` + -ImageName EC2LaunchV2-Windows* | + Sort-Object Name @@ -88 +85 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * Polish +## BIOS AMIs @@ -90 +87 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * Russian +Windows Server 2025 AMIs use UEFI boot mode by default, which is not supported on EC2 metal instance sizes and some instance types. For those instances, use the BIOS AMIs, which use legacy BIOS boot mode. @@ -92 +89 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * Portuguese +AWS CLI @@ -94 +90,0 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * Spanish @@ -96 +92 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * Swedish +Use the [get-parameters-by-path](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-parameters-by-path.html) command to retrieve the latest BIOS AWS Windows AMIs. @@ -98 +93,0 @@ The following language-specific AWS Windows AMIs are included in the monthly rel - * Turkish @@ -99,0 +95,5 @@ The following language-specific AWS Windows AMIs are included in the monthly rel + aws ssm get-parameters-by-path \ + --path "/aws/service/ami-windows-latest" \ + --recursive \ + --query 'Parameters[*].{Name:Name,Value:Value}' \ + --output text | grep "BIOS-Windows" | sort @@ -100,0 +101 @@ The following language-specific AWS Windows AMIs are included in the monthly rel +PowerShell @@ -103 +104 @@ The following language-specific AWS Windows AMIs are included in the monthly rel -The following example uses PowerShell to search for the latest English language AWS Windows AMIs: +Use the [Get-SSMLatestEC2Image](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-SSMLatestEC2Image.html) cmdlet to retrieve the latest BIOS AWS Windows AMIs. @@ -108 +109 @@ The following example uses PowerShell to search for the latest English language - -ImageName *Windows_Server-*English* | ` + -ImageName BIOS-Windows* | @@ -111,6 +112 @@ The following example uses PowerShell to search for the latest English language - -###### Note - -If this command doesn't run in your environment, you might be missing a PowerShell module. For more information about this command, see [Get-SSMLatestEC2Image Cmdlet](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-SSMLatestEC2Image.html). - -Alternatively, you can use the [CloudShell console](https://console.aws.amazon.com/cloudshell/home) and run `pwsh` to bring up a PowerShell prompt that already has all of the AWS tools installed. For more information, see the [AWS CloudShell User Guide](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html). +You can run the preceding commands from [AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html), which comes with the [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) and [AWS Tools for PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-welcome.html) pre-installed. AWS CloudShell automatically configures your credentials. To run the PowerShell commands, run `pwsh`.