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.
Start-CBBuild-ProjectName <String>-ArtifactsOverride_ArtifactIdentifier <String>-ArtifactsOverride_BucketOwnerAccess <BucketOwnerAccess>-S3Logs_BucketOwnerAccess <BucketOwnerAccess>-BuildspecOverride <String>-CertificateOverride <String>-ComputeTypeOverride <ComputeType>-BuildStatusConfigOverride_Context <String>-RegistryCredentialOverride_Credential <String>-RegistryCredentialOverride_CredentialProvider <CredentialProviderType>-DebugSessionEnabled <Boolean>-ArtifactsOverride_EncryptionDisabled <Boolean>-S3Logs_EncryptionDisabled <Boolean>-EncryptionKeyOverride <String>-EnvironmentTypeOverride <EnvironmentType>-EnvironmentVariablesOverride <EnvironmentVariable[]>-GitSubmodulesConfigOverride_FetchSubmodule <Boolean>-GitCloneDepthOverride <Int32>-CloudWatchLogs_GroupName <String>-IdempotencyToken <String>-ImageOverride <String>-ImagePullCredentialsTypeOverride <ImagePullCredentialsType>-InsecureSslOverride <Boolean>-ArtifactsOverride_Location <String>-CacheOverride_Location <String>-S3Logs_Location <String>-CacheOverride_Mode <String[]>-ArtifactsOverride_Name <String>-ArtifactsOverride_NamespaceType <ArtifactNamespace>-ArtifactsOverride_OverrideArtifactName <Boolean>-ArtifactsOverride_Packaging <ArtifactPackaging>-ArtifactsOverride_Path <String>-PrivilegedModeOverride <Boolean>-QueuedTimeoutInMinutesOverride <Int32>-ReportBuildStatusOverride <Boolean>-SourceAuthOverride_Resource <String>-SecondaryArtifactsOverride <ProjectArtifacts[]>-SecondarySourcesOverride <ProjectSource[]>-SecondarySourcesVersionOverride <ProjectSourceVersion[]>-ServiceRoleOverride <String>-SourceLocationOverride <String>-SourceTypeOverride <SourceType>-SourceVersion <String>-CloudWatchLogs_Status <LogsConfigStatusType>-S3Logs_Status <LogsConfigStatusType>-CloudWatchLogs_StreamName <String>-BuildStatusConfigOverride_TargetUrl <String>-TimeoutInMinutesOverride <Int32>-ArtifactsOverride_Type <ArtifactsType>-CacheOverride_Type <CacheType>-SourceAuthOverride_Type <SourceAuthType>-Select <String>-PassThru <SwitchParameter>-Force <SwitchParameter>
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) |
type
is set to CODEPIPELINE
, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output locations instead of CodeBuild.type
is set to NO_ARTIFACTS
, this value is ignored if specified, because no build output is produced.type
is set to S3
, this is the name of the output bucket.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
path
and namespaceType
, the pattern that CodeBuild uses to name and store the output artifact:type
is set to CODEPIPELINE
, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.type
is set to NO_ARTIFACTS
, this value is ignored if specified, because no build output is produced.type
is set to S3
, this is the name of the output artifact object. If you set the name to be a forward slash ("/"), the artifact is stored in the root of the output bucket.path
is set to MyArtifacts
, namespaceType
is set to BUILD_ID
, and name
is set to MyArtifact.zip
, then the output artifact is stored in MyArtifacts/<build-ID>/MyArtifact.zip
.path
is empty, namespaceType
is set to NONE
, and name
is set to "/
", the output artifact is stored in the root of the output bucket. path
is set to MyArtifacts
, namespaceType
is set to BUILD_ID
, and name
is set to "/
", the output artifact is stored in MyArtifacts/<build-ID>
. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
path
and name
, the pattern that CodeBuild uses to determine the name and location to store the output artifact:type
is set to CODEPIPELINE
, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.type
is set to NO_ARTIFACTS
, this value is ignored if specified, because no build output is produced.type
is set to S3
, valid values include:BUILD_ID
: Include the build ID in the location of the build output artifact.NONE
: Do not include the build ID. This is the default if namespaceType
is not specified.path
is set to MyArtifacts
, namespaceType
is set to BUILD_ID
, and name
is set to MyArtifact.zip
, the output artifact is stored in MyArtifacts/<build-ID>/MyArtifact.zip
. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
type
is set to CODEPIPELINE
, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output artifacts instead of CodeBuild.type
is set to NO_ARTIFACTS
, this value is ignored if specified, because no build output is produced.type
is set to S3
, valid values include:NONE
: CodeBuild creates in the output bucket a folder that contains the build output. This is the default if packaging
is not specified.ZIP
: CodeBuild creates in the output bucket a ZIP file that contains the build output.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
namespaceType
and name
, the pattern that CodeBuild uses to name and store the output artifact:type
is set to CODEPIPELINE
, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.type
is set to NO_ARTIFACTS
, this value is ignored if specified, because no build output is produced.type
is set to S3
, this is the path to the output artifact. If path
is not specified, path
is not used.path
is set to MyArtifacts
, namespaceType
is set to NONE
, and name
is set to MyArtifact.zip
, the output artifact is stored in the output bucket at MyArtifacts/MyArtifact.zip
. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
CODEPIPELINE
: The build project has build output generated through CodePipeline.The CODEPIPELINE
type is not supported for secondaryArtifacts
.NO_ARTIFACTS
: The build project does not produce any build output.S3
: The build project stores build output in Amazon S3.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
CODEBUILD_SRC_DIR
environment variable, or the path to an S3 bucket. The bucket must be in the same Amazon Web Services Region as the build project. Specify the buildspec file using its ARN (for example, arn:aws:s3:::my-codebuild-sample2/buildspec.yml
). If this value is not provided or is set to an empty string, the source code must contain a buildspec file in its root directory. For more information, see Buildspec File Name and Storage Location. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
name
parameter in the Bitbucket commit status. For more information, see build in the Bitbucket API documentation.context
parameter in the GitHub commit status. For more information, see Create a commit status in the GitHub developer guide.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
url
parameter in the Bitbucket commit status. For more information, see build in the Bitbucket API documentation.target_url
parameter in the GitHub commit status. For more information, see Create a commit status in the GitHub developer guide.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
NO_CACHE
or LOCAL
: This value is ignored.S3
: This is the S3 bucket name/prefix.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
LOCAL
cache types.Possible values are:privileged
flag must be set so that your project has the required Docker permissions. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | CacheOverride_Modes |
NO_CACHE
: The build project does not use any cache.S3
: The build project reads and writes from and to S3.LOCAL
: The build project stores a cache locally on a build host that is only available to that build host.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) |
Aliases | LogsConfigOverride_CloudWatchLogs_GroupName |
ENABLED
: CloudWatch Logs are enabled for this build project.DISABLED
: CloudWatch Logs are not enabled for this build project.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | LogsConfigOverride_CloudWatchLogs_Status |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | LogsConfigOverride_CloudWatchLogs_StreamName |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
alias/<alias-name>
). 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) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | GitSubmodulesConfigOverride_FetchSubmodules |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
SERVICE_ROLE
credentials. When using an CodeBuild curated image, you must use CODEBUILD
credentials. 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) |
Required? | True |
Position? | 1 |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
credential
can use the name of the credentials only if they exist in your current Amazon Web Services Region. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
invalidInputException
is thrown. To be able to report the build status to the source provider, the user associated with the source provider must have write access to the repo. If the user does not have write access, the build status cannot be updated. For more information, see Source provider access in the CodeBuild User Guide. The status of a build triggered by a webhook is always reported to your source provider. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | LogsConfigOverride_S3Logs_BucketOwnerAccess |
Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | LogsConfigOverride_S3Logs_EncryptionDisabled |
my-bucket
, and your path prefix is build-log
, then acceptable formats are my-bucket/build-log
or arn:aws:s3:::my-bucket/build-log
. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | LogsConfigOverride_S3Logs_Location |
ENABLED
: S3 build logs are enabled for this build project.DISABLED
: S3 build logs are not enabled for this build project.Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
Aliases | LogsConfigOverride_S3Logs_Status |
ProjectArtifacts
objects. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
ProjectSource
objects. Required? | False |
Position? | Named |
Accept pipeline input? | True (ByPropertyName) |
ProjectSourceVersion
objects that specify one or more versions of the project's secondary sources to be used for this build only. 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) |
OAUTH
, which represents the OAuth authorization type. 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) |
pr/pull-request-ID
(for example pr/25
). If a branch name is specified, the branch's HEAD commit ID is used. If not specified, the default branch's HEAD commit ID is used.sourceVersion
is specified at the project level, then this sourceVersion
(at the build level) takes precedence. For more information, see Source Version Sample with CodeBuild in the CodeBuild User Guide. 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) |
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