# Get-VaultItem

Retrieves an Item from Vault.

## Syntax

```powershell
Get-VaultItem [-Number <String>] [-ItemId <Long>] [-Properties <Hashtable>] [<CommonParameters>]
```

## Parameters

```{eval-rst}
.. csv-table::
	:header: "Type","Name","Description","Optional"

	"String","Number","Number of the item","yes"
	"Long","ItemId","Id or MasterId of the item","yes"
	"Hashtable","Properties","Search for the item with matching properties","yes"

```

## Return type

[Item](/code_reference/objects/item) ← on success\
**empty** ← on failure

## Remarks

If the search criteria's passed to the **-Properties** argument matches more than one item, then *only the first* item is returned.

## Examples

**Get Item via Number**

```powershell
$item = Get-VaultItem -Number '100001'
```

**Get Item via Id**

```powershell
$item = Get-VaultItem -ItemId 142
```

**Get Item that matches certain search criteria's**

```powershell
$item = Get-VaultItem -Properties @{"Description (Item,CO)" = "PAD LOCK ASSEMBLY"; "Lifecycle Definition" = "Item Release Process"}
```