# Using the Cmdlets

```{image} img/flc_console.png
:align: right
:width: 250px
```

## Start the powershell environment

In order to get started either open any powershell IDE and load the powerFLC Module by calling `Import-Module powerFLC` or open the *powerFLC Console* shortcut in the start menu, which already loads the powerFLC module for you.

## Connect with Fusion 360 Manage

Before you are able to work with the Fusion 360 Manage tenant in your PowerShell environment you have to make sure that the {ref}`tenant is configured <getting_started:configuration in fusion 360 manage>` correctly!

Next retrieve the [Client ID and Secret](https://forge.autodesk.com/en/docs/oauth/v2/tutorials/create-app/#step-3-note-down-your-client-id-and-secret) of your registered *powerPLM* app from the [Forge portal](https://forge.autodesk.com/).

Find your tenants name by copying the first part of the URL from your browser, after you sign in to your Fusion 360 Manage Site.\
For `https://previewcoolorange.autodeskplm360.net/plm/mainDashboard` the tenant name would be `previewcoolorange`.

Now you can authenticate using {doc}`/code_reference/commandlets/Connect-FLC` and all the previously retrieved information.

```powershell
$connected = Connect-FLC -Tenant 'your_tenant_name' -ClientId 'your_client_id' -ClientSecret 'your_client_secret' -UserId 'your_email@example.com'
```

## Get multiple items from Fusion 360 Manage

After successfully connecting to the Fusion 360 Manage tenant you can start using the cmdlets to interact with FLC items and workspaces.\
To retrieve a collection of specific items from a Fusion 360 Manage workspace you can use the {doc}`/code_reference/commandlets/Get-FLCItems` cmdlet.

```{note}
{doc}`/code_reference/commandlets/Get-FLCItems` has the optional
parameter **-Filter** that allows you to specify a string in the same
format as [Fusion 360 Manage searches](http://help.autodesk.com/view/PLM/ENU/?guid=PLM_360_User_Search_html) to filter the result.
```

Get all items from the **workspace** `Products` that are in the **workflow state** `Concept` and have a **field** named `Number` with the exact value `900-00010`:

```powershell
$items = Get-FLCItems -Workspace 'Products' -Filter 'workflowState=Concept AND ITEM_DETAILS:NUMBER="900-00010"'
```

## Update a Field of an Item

One of the previously retrieved Fusion 360 Manage Items can now be picked and updated using the {doc}`update-flcitem </code_reference/commandlets/Update-FLCItem>` cmdlet.\
By navigating to the [Workspace Manager](http://help.autodesk.com/view/PLM/ENU/?guid=GUID-39C93918-EA0A-4DB7-813D-39EDFE521D09) in Fusion 360 Manage we can find a [Item Details Form](http://help.autodesk.com/view/PLM/ENU/?guid=GUID-C2A1AEAB-227E-4A89-8972-CE779B7AFFA9) that provides us a list of possible **Item Details Fields** that can be edited.

In following example we edit the value of a simple Text Field with the name *'Description'* by just extending the value with a suffix.

```powershell
$itemToUpdate = $items[0]

$itemToUpdate| Update-FLCItem -Properties @{'Description'= "$($itemToUpdate.Description) - Edited"}
```

After executing the commandlet, it will return an Item with the updated *'Description'* Field.