> ## Documentation Index
> Fetch the complete documentation index at: https://cdktn.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Typescript: LocalExecProvisioner

> CDKTN Core API Reference for LocalExecProvisioner in Typescript.

The local-exec provisioner invokes a local executable after a resource is created.

This invokes a process on the machine running Terraform, not on the resource.

See [local-exec](https://developer.hashicorp.com/terraform/language/resources/provisioners/local-exec)

## Initializer <a name="Initializer" id="cdktn.LocalExecProvisioner.Initializer" />

```typescript theme={null}
import { LocalExecProvisioner } from 'cdktn'

const localExecProvisioner: LocalExecProvisioner = { ... }
```

## Properties <a name="Properties" id="Properties" />

| **Name**                                                                                | **Type**                                 | **Description**                                                                   |
| --------------------------------------------------------------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------- |
| <code><a href="#cdktn.LocalExecProvisioner.property.command">command</a></code>         | <code>string</code>                      | This is the command to execute.                                                   |
| <code><a href="#cdktn.LocalExecProvisioner.property.type">type</a></code>               | <code>string</code>                      | *No description.*                                                                 |
| <code><a href="#cdktn.LocalExecProvisioner.property.environment">environment</a></code> | <code>\{\[ key: string ]: string}</code> | A record of key value pairs representing the environment of the executed command. |
| <code><a href="#cdktn.LocalExecProvisioner.property.interpreter">interpreter</a></code> | <code>string\[]</code>                   | If provided, this is a list of interpreter arguments used to execute the command. |
| <code><a href="#cdktn.LocalExecProvisioner.property.when">when</a></code>               | <code>string</code>                      | If provided, specifies when Terraform will execute the command.                   |
| <code><a href="#cdktn.LocalExecProvisioner.property.workingDir">workingDir</a></code>   | <code>string</code>                      | If provided, specifies the working directory where command will be executed.      |

***

### `command`<sup>Required</sup> <a name="command" id="cdktn.LocalExecProvisioner.property.command" />

```typescript theme={null}
public readonly command: string;
```

* *Type:* string

This is the command to execute.

It can be provided as a relative path to the current working directory or as an absolute path.
It is evaluated in a shell, and can use environment variables or Terraform variables.

***

### `type`<sup>Required</sup> <a name="type" id="cdktn.LocalExecProvisioner.property.type" />

```typescript theme={null}
public readonly type: string;
```

* *Type:* string

***

### `environment`<sup>Optional</sup> <a name="environment" id="cdktn.LocalExecProvisioner.property.environment" />

```typescript theme={null}
public readonly environment: {[ key: string ]: string};
```

* *Type:* \{\[ key: string ]: string}

A record of key value pairs representing the environment of the executed command.

It inherits the current process environment.

***

### `interpreter`<sup>Optional</sup> <a name="interpreter" id="cdktn.LocalExecProvisioner.property.interpreter" />

```typescript theme={null}
public readonly interpreter: string[];
```

* *Type:* string\[]

If provided, this is a list of interpreter arguments used to execute the command.

The first argument is the interpreter itself.
It can be provided as a relative path to the current working directory or as an absolute path
The remaining arguments are appended prior to the command.
This allows building command lines of the form "/bin/bash", "-c", "echo foo".
If interpreter is unspecified, sensible defaults will be chosen based on the system OS.

***

### `when`<sup>Optional</sup> <a name="when" id="cdktn.LocalExecProvisioner.property.when" />

```typescript theme={null}
public readonly when: string;
```

* *Type:* string

If provided, specifies when Terraform will execute the command.

For example, when = destroy specifies that the provisioner will run when the associated resource is destroyed

***

### `workingDir`<sup>Optional</sup> <a name="workingDir" id="cdktn.LocalExecProvisioner.property.workingDir" />

```typescript theme={null}
public readonly workingDir: string;
```

* *Type:* string

If provided, specifies the working directory where command will be executed.

It can be provided as a relative path to the current working directory or as an absolute path.
The directory must exist.

***
