# UpdateFileStates

**EventNames:**

- UpdateFileStates_Restrictions
- UpdateFileStates_Pre
- UpdateFileStates_Post

**Parameters**

| Type                                                   | Name       | Description                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [File[]](inv:powervault#code_reference/objects/file)  | files      | The updated / updating files for a LifeCycle.<br><br>**Restrictions and Pre:** <br>In *Restrictions* and *Pre* you have the future data set on this object like `_NewComment`, `_NewLifeCycleDefinition` and `_NewState`.<br><br>**Post:**<br>In *POST* you can retrieve the information from previous events by using the properties `_OldComment`, `_OldState` and `_OldLifeCycleDefinition`. |
| bool                                                   | successful | **Post**:<br>The information whether the Web Service call was successful or not is only available in *Post* events.                                                                                                                                                                                                                                                                                               |

**Examples:**\
UpdateFileStates_Restrictions:

```powershell
Register-VaultEvent -EventName UpdateFileStates_Restrictions -Action 'RestrictUpdateFileStates'

function RestrictUpdateFileStates($files) {
	#Write event code here
}
```

UpdateFileStates_Pre:

```powershell
Register-VaultEvent -EventName UpdateFileStates_Pre -Action 'PreUpdateFileStates'

function PreUpdateFileStates($files) {
	#Write event code here
}
```

UpdateFileStates_Post:

```powershell
Register-VaultEvent -EventName UpdateFileStates_Post -Action 'PostUpdateFileStates'

function PostUpdateFileStates($files, $successful) {
	#Write event code here
}
```