AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
New-OPSStack-Name <String>-StackRegion <String>-AgentVersion <String>-Attribute <Hashtable>-ChefConfiguration_BerkshelfVersion <String>-CustomJson <String>-DefaultAvailabilityZone <String>-DefaultInstanceProfileArn <String>-DefaultOs <String>-DefaultRootDeviceType <RootDeviceType>-DefaultSshKeyName <String>-DefaultSubnetId <String>-HostnameTheme <String>-ChefConfiguration_ManageBerkshelf <Boolean>-ConfigurationManager_Name <String>-CustomCookbooksSource_Password <String>-CustomCookbooksSource_Revision <String>-ServiceRoleArn <String>-CustomCookbooksSource_SshKey <String>-CustomCookbooksSource_Type <SourceType>-CustomCookbooksSource_Url <String>-UseCustomCookbook <Boolean>-UseOpsworksSecurityGroup <Boolean>-CustomCookbooksSource_Username <String>-ConfigurationManager_Version <String>-VpcId <String>-Select <String>-PassThru <SwitchParameter>-Force <SwitchParameter>
LATEST
. AWS OpsWorks Stacks automatically installs new agent versions on the stack's instances as soon as they are available.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | Attributes |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Password
to the appropriate IAM secret access key.Password
to the password.*****FILTERED*****
instead of the actual value. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
*****FILTERED*****
instead of the actual value. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
https://s3.amazonaws.com/opsworks-demo-bucket/opsworks_cookbook_demo.tar.gz
. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Username
to the appropriate IAM access key ID.Username
to the user name.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
"{\"key1\": \"value1\", \"key2\": \"value2\",...}"
For more information about custom JSON, see Use Custom JSON to Modify the Stack Configuration Attributes. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
DefaultSubnetId
, the subnet must be in the same zone. For more information, see the VpcId
parameter description. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | True |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Amazon Linux 2018.03
, Amazon Linux 2017.09
, Amazon Linux 2017.03
, Amazon Linux 2016.09
, Amazon Linux 2016.03
, Amazon Linux 2015.09
, or Amazon Linux 2015.03
.Ubuntu 16.04 LTS
, Ubuntu 14.04 LTS
, or Ubuntu 12.04 LTS
.CentOS Linux 7
Red Hat Enterprise Linux 7
Microsoft Windows Server 2012 R2 Base
, Microsoft Windows Server 2012 R2 with SQL Server Express
, Microsoft Windows Server 2012 R2 with SQL Server Standard
, or Microsoft Windows Server 2012 R2 with SQL Server Web
.Custom
. You specify the custom AMI you want to use when you create instances. For more information, see Using Custom AMIs.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
instance-store
. For more information, see Storage for the Root Device. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
VpcId
parameter. All instances are launched into this subnet unless you specify otherwise when you create the instance. If you also specify a value for DefaultAvailabilityZone
, the subnet must be in that zone. For information on default values and when this parameter is required, see the VpcId
parameter description. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
HostnameTheme
is set to Layer_Dependent
, which creates host names by appending integers to the layer's short name. The other themes are:Baked_Goods
Clouds
Europe_Cities
Fruits
Greek_Deities_and_Titans
Legendary_creatures_from_Japan
Planets_and_Moons
Roman_Deities
Scottish_Islands
US_Cities
Wild_Cats
GetHostNameSuggestion
, which returns a host name based on the current theme. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | True |
Position? | 1 |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | True |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
ap-south-1
. For more information about Amazon regions, see Regions and Endpoints.In the AWS CLI, this API maps to the --stack-region
parameter. If the --stack-region
parameter and the AWS CLI common parameter --region
are set to the same value, the stack uses a regional endpoint. If the --stack-region
parameter is not set, but the AWS CLI --region
parameter is, this also results in a stack with a regional endpoint. However, if the --region
parameter is set to us-east-1
, and the --stack-region
parameter is set to one of the following, then the stack uses a legacy or classic region: us-west-1, us-west-2, sa-east-1, eu-central-1, eu-west-1, ap-northeast-1, ap-southeast-1, ap-southeast-2
. In this case, the actual API endpoint of the stack is in us-east-1
. Only the preceding regions are supported as classic regions in the us-east-1
API endpoint. Because it is a best practice to choose the regional endpoint that is closest to where you manage AWS, we recommend that you use regional endpoints for new stacks. The AWS CLI common --region
parameter always specifies a regional API endpoint; it cannot be used to specify a classic AWS OpsWorks Stacks region. Required? | True |
Position? | 2 |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | UseCustomCookbooks |
UseOpsworksSecurityGroups
you can instead provide your own custom security groups. UseOpsworksSecurityGroups
has the following settings: Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | UseOpsworksSecurityGroups |
no VPC
.DefaultAvailabilityZone
or the DefaultSubnetId
parameter only, AWS OpsWorks Stacks infers the value of the other parameter. If you specify neither parameter, AWS OpsWorks Stacks sets these parameters to the first valid Availability Zone for the specified region and the corresponding default VPC subnet ID, respectively.If you specify a nondefault VPC ID, note the following:DefaultSubnetId
.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | AK |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | AWSProfilesLocation, ProfilesLocation |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | StoredCredentials, AWSProfileName |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | RegionToCall |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | SK, SecretAccessKey |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | ST |
AWS Tools for PowerShell: 2.x.y.z