Topic Last Modified: 2012-10-06

To create a new Persistent Chat Server Category

Copy Code
New-CsPersistentChatCategory -Name Foo -PersistentChatPoolFqdn client.contoso1b118d91-b4c4-4b2f-b842-b451417ec2c6.com [other parameters]
Important:
PersistentChatPoolFqdn is needed only if there is more than one Persistent Chat Server pool.

To make changes to existing Persistent Chat Server Category

Copy Code
Set-CsPersistentChatCategory -Identity testCat -AllowedMembers @{Add="sip:user1@contoso.com", "CN=container,DC=contoso,DC=com"}  -DeniedMembers @{Add="sip:user2@contoso.com"}
Set-CsPersistentChatCategory -Identity testCat -Creators @{Add="sip:user1@contoso.com"}

Windows PowerShell: AllowedMembers, DeniedMembers, and Creators can be set simultaneously. Creators should be the subset of AllowedMembers minus DeniedMembers. You can also set the properties of a category at the same time as the members and creators.

Create, Get, Set, or Remove a Category

To create a new Category

Copy Code
New-CsPersistentChatCategory -Name <String> [-PersistentChatPoolFqdn <String>] [-Description <String>] [-EnableInvitations<Switch Parameter>] [-EnableFileUpload <Switch Parameter>] [-RemoveChatHistory <Switch Parameter>] [-MaxContentSize <Integer>]

To get a Category

Copy Code
Get-CsPersistentChatCategory -Identity <String>

or

Copy Code
Get-CsPersistentChatCategory -PersistentChatPoolFqdn <String>

To set a Category

Copy Code
Set-CsPersistentChatCategory -Instance <CategoryObject> [-WhatIf] [-Confirm] [<CommonParameters>]

or

Copy Code
Set-CsPersistentChatCategory [-Identity] <string> [-Name <string>] [-Description <string>] [-Invitations <bool>] [-FileUpload <bool>] [-ChatHistory <bool>] [-AllowedMembers <PSListModifier[string]>] [-DeniedMembers <PSListModifier[string]>] [-Creators <PSListModifier[string]>] [-WhatIf] [-Confirm]  [<CommonParameters>]

To remove a Category

Copy Code
Remove-CsPersistentChatCategory -Instance <CategoryObject> [-Force <Switch Parameter>] [-Confirm <Switch Parameter>]

or

Copy Code
Remove-CsPersistentChatCategory -Identity <String> [-Force <Switch Parameter>] [-Confirm <Switch Parameter>]