Skip to main content

New-AtriaWorkSpaceCustomerItem

SYNOPSIS​

Creates a new customer workspace item.

SYNTAX​

New-AtriaWorkSpaceCustomerItem -displayName <String> [-description <String>] [-environmentId <Int>] [-locationId <Int>] [-iconReference <String>] [-iconId <Int>] [-sku <String>] [-configuration <String>] [-isDefaultSelect] [-tags <String[]>] [-itemTypeId <Int> | -itemTypeName <String>] [-isCreateGroupItem <Boolean>] [-isCustomerOnlyItem <Boolean>] [-dirResName <String>] [-dirUserGroupName <String>] [<CommonParameters>]

DESCRIPTION​

Creates a new workspace item tailored for customers, either by specifying an item type ID or an item type name. Supports advanced configurations, including directory resource groups, custom icons, SKU, tagging, and more.

PARAMETERS​

Detailed descriptions of all parameters can be found within the function documentation itself (see PowerShell help comments).

EXAMPLES​

Example 1 (By Type ID)​

PS> New-AtriaWorkSpaceCustomerItem -displayName "Standard App" -itemTypeId 1001 -dirResName "ResGroup1" -dirUserGroupName "UserGroup1"

Creates a workspace item named "Standard App" using item type ID 1001.

Example 2 (By Type Name, Customer-Only)​

PS> New-AtriaWorkSpaceCustomerItem -displayName "Premium App" -itemTypeName "PremiumType" -description "A premium workspace application." -isCustomerOnlyItem $true

Creates a new customer-only workspace item named "Premium App" using the item type "PremiumType".

OUTPUTS​

Returns the newly created workspace item object.

NOTES​

Ensure you've authenticated using Connect-AtriaApi before invoking this function.