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-ECSCluster-ClusterName <String>-CapacityProvider <String[]>-LogConfiguration_CloudWatchEncryptionEnabled <Boolean>-LogConfiguration_CloudWatchLogGroupName <String>-DefaultCapacityProviderStrategy <CapacityProviderStrategyItem[]>-ExecuteCommandConfiguration_KmsKeyId <String>-ExecuteCommandConfiguration_Logging <ExecuteCommandLogging>-ServiceConnectDefaults_Namespace <String>-LogConfiguration_S3BucketName <String>-LogConfiguration_S3EncryptionEnabled <Boolean>-LogConfiguration_S3KeyPrefix <String>-Setting <ClusterSetting[]>-Tag <Tag[]>-Select <String>-PassThru <SwitchParameter>-Force <SwitchParameter>-ClientConfig <AmazonECSConfig>
default
cluster when you launch your first container instance. However, you can create your own cluster with a unique name with the CreateCluster
action.
When you call the CreateCluster API operation, Amazon ECS attempts to create the Amazon ECS service-linked role for your account. This is so that it can manage required resources in other Amazon Web Services services on your behalf. However, if the user that makes the call doesn't have permissions to create the service-linked role, it isn't created. For more information, see Using service-linked roles for Amazon ECS in the Amazon Elastic Container Service Developer Guide. FARGATE
or FARGATE_SPOT
capacity providers. The Fargate capacity providers are available to all accounts and only need to be associated with a cluster to be used.The PutCapacityProvider API operation is used to update the list of available capacity providers for a cluster after the cluster is created. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | CapacityProviders |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
default
. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed. Required? | False |
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) |
Aliases | Configuration_ExecuteCommandConfiguration_KmsKeyId |
NONE
: The execute command session is not logged.DEFAULT
: The awslogs
configuration in the task definition is used. If no logging parameter is specified, it defaults to this value. If no awslogs
log driver is configured in the task definition, the output won't be logged.OVERRIDE
: Specify the logging details as a part of logConfiguration
. If the OVERRIDE
logging option is specified, the logConfiguration
is required.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | Configuration_ExecuteCommandConfiguration_Logging |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | Configuration_ExecuteCommandConfiguration_LogConfiguration_CloudWatchEncryptionEnabled |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | Configuration_ExecuteCommandConfiguration_LogConfiguration_CloudWatchLogGroupName |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | Configuration_ExecuteCommandConfiguration_LogConfiguration_S3BucketName |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | Configuration_ExecuteCommandConfiguration_LogConfiguration_S3EncryptionEnabled |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | Configuration_ExecuteCommandConfiguration_LogConfiguration_S3KeyPrefix |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
""
for the namespace name, the cluster configuration for Service Connect is removed. Note that the namespace will remain in Cloud Map and must be deleted separately.For more information about Cloud Map, see Working with Services in the Cloud Map Developer Guide. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
containerInsights
value set with PutAccountSetting or PutAccountSettingDefault. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | Settings |
aws:
, AWS:
, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | Tags |
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 |
New-ECSCluster -ClusterName "LAB-ECS-CL" -Setting @{Name="containerInsights"; Value="enabled"}
ActiveServicesCount : 0
Attachments : {}
AttachmentsStatus :
CapacityProviders : {}
ClusterArn : arn:aws:ecs:us-west-2:012345678912:cluster/LAB-ECS-CL
ClusterName : LAB-ECS-CL
DefaultCapacityProviderStrategy : {}
PendingTasksCount : 0
RegisteredContainerInstancesCount : 0
RunningTasksCount : 0
Settings : {containerInsights}
Statistics : {}
Status : ACTIVE
Tags : {}This cmdlet creates a new Amazon ECS cluster.
AWS Tools for PowerShell: 2.x.y.z