{"id":79855,"date":"2016-09-16T00:01:04","date_gmt":"2016-09-16T07:01:04","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/?p=79855"},"modified":"2019-02-18T09:10:28","modified_gmt":"2019-02-18T16:10:28","slug":"use-powershell-to-integrate-with-the-lync-2013-sdk-for-skype-for-business-part-2","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/use-powershell-to-integrate-with-the-lync-2013-sdk-for-skype-for-business-part-2\/","title":{"rendered":"Use PowerShell to integrate with the Lync 2013 SDK for Skype for Business \u2013 Part 2"},"content":{"rendered":"

Summary<\/strong>: Learn how to extend PowerShell with Lync 2013 SDK to explore groups and contacts information in Skype for Business 2016 client.<\/p>\n

MVP Chendrayan Venkatesan is back again to show us how to get started with the Lync 2013 SDK to enable us to do some cool stuff with PowerShell and Skype for Business!<\/p>\n

Take it away Chen!<\/p>\n

Skype for Business 2016 client is great for business users for quick chat, sharing, presentation, organizing meetings, calls etc. Here is the Skype for Business client quick start guide<\/a>. Please refer to it to understand and manage groups, contacts, and status (presence information). It\u2019s a very good document collection for Skype for Business beginners, and it contains information about the Skype for Business client.<\/p>\n

This blog post is about exploring groups and contacts in Skype for Business client by extending PowerShell with the Lync 2013 SDK and how to toggle privacy relationship. To begin, let\u2019s retrieve all the Skype for Business group information, like name, type, and count of contacts, in our Skype for Business client. To get the information, we need to retrieve information from the Groups<\/strong> property from the ContactManager<\/strong> class.<\/p>\n

Import-Module 'C:\\Program Files (x86)\\Microsoft Office 2013\\LyncSDK\\Assemblies\\Desktop\\Microsoft.Lync.Model.dll'\ntry\n{<\/code><\/p>\n

$Client = [Microsoft.Lync.Model.LyncClient]::GetClient()\n$Groups = $Client.ContactManager.Groups\n$Groups | Select Name , Type , Count<\/code><\/p>\n

}\ncatch\n{\n$_.Exception.Message\n}<\/code><\/p>\n

Groups<\/strong> returns group collections. The output is illustrated in the following image. Most Used Contacts<\/strong> is the FrequentContacts<\/strong> type. Favorites<\/strong> is the FavoriteContacts<\/strong> type. The rest are a CustomGroup<\/strong> type, which is created by a user. Other Contacts<\/strong> is created when you add a contact and skip to choose the group.<\/p>\n

\"Illustration<\/a><\/p>\n

Let\u2019s try to retrieve information, like display name, primary email address, company, status, tag information etc., for a single contact.<\/p>\n

try\n{<\/code><\/p>\n

$Client = [Microsoft.Lync.Model.LyncClient]::GetClient()\n$Contact = $Client.ContactManager.GetContactByUri(\"Chendrayan.Venkatesan@contoso.com\")\n[pscustomobject]@{\nDisplayName = $Contact.GetContactInformation([Microsoft.Lync.Model.ContactInformationType]::DisplayName)\nStatus = $Contact.GetContactInformation([Microsoft.Lync.Model.ContactInformationType]::Activity)\nCompany = $Contact.GetContactInformation([Microsoft.Lync.Model.ContactInformationType]::Company)\nEmail = $Contact.GetContactInformation([Microsoft.Lync.Model.ContactInformationType]::PrimaryEmailAddress)\nIsTagged = $Contact.Settings.GetValueAt(0)\n}<\/code><\/p>\n

}\ncatch\n{<\/code><\/p>\n

$_.Exception.Message<\/code><\/p>\n

}<\/code><\/p>\n

The following screenshot shows a demo of information that we retrieved for minimal information of a single contact from the Skype for Business client.<\/p>\n

\"Demo<\/a><\/p>\n

It\u2019s time to proceed one step ahead to retrieve all possible Contact Information<\/strong> in each group. Download the full script from the TechNet Gallery<\/a> . Yes, its Contact Information<\/strong> that we see in the contact card! We can retrieve valid or required information from the ContactInformationType<\/a> enumeration by modifying the script.<\/p>\n

#Retrieves all the external contacts\nGet-xSKBContact | ? {$_.PrivacyRelationShip -eq \"External\"}<\/code><\/p>\n

\"All<\/a><\/p>\n

It seems strange that the TimeZone<\/strong> information has the \u201cW. Europe Standard Time\u201d ID. Instead, let\u2019s show the current date-time of the users TimeZone<\/strong>.<\/p>\n

Note<\/strong>: The TimeZone<\/strong> ID should show your local system time zone information; if not, it returns nothing.<\/p>\n

Get-xSKBContact |\nSelect Uri , Company, Status , PrivacyRelationShip , @{n=\"TimeZone\";E={[System.TimeZoneInfo]::ConvertTimeBySystemTimeZoneId([datetime]::Now,$_.TimeZone)}}<\/code><\/p>\n

\"Results<\/a><\/p>\n

In Skype for Business, client contacts are organized as Groups<\/strong> and can filtered as Status<\/strong>, Relationships<\/strong>, and New<\/strong> in each view. For example, STATUS<\/strong> view organizes and groups the contacts by presence information where the UNAVAILABLE<\/strong> group shows offline and Out of office contacts. Using the PowerShell script, we can retrieve users who have enabled out of office as shown in the following example.<\/p>\n

Get-xSKBContact | ? {$_.IsOutofOffice} | Select GroupName , IsOutofOffice<\/code><\/p>\n

\"Users<\/a><\/p>\n

Note: ?<\/strong> is an alias of Where-Object<\/strong> and the IsOutofOffice<\/strong> note property is a bool<\/strong> type. By default, it\u2019s True<\/strong>, so need to query like $_.IsOutofOffice -eq $true<\/code>.<\/p>\n

Let\u2019s share another cool trick by using the same PowerShell script! The ContactInformationType<\/a> enumeration that we used in our script to retrieve the contacts information has NextCalendarState<\/strong> and NextCalendarStateStartTime<\/strong> properties that fetch the users outlook calendar information. Using these properties, we can see the next availability for users.<\/p>\n

Get-xSKBContact| ? {$_.NextCalendarState -ne \"NotAvailable\"} |\nselect Displayname , Status , NextCalendarStateStartTime , NextCalendarState<\/code><\/p>\n

\"Users<\/a><\/p>\n

Check the highlighted contact in the preceding image. The Status<\/strong> shows the current presence information. At 10:30:00, the user has an appointment where the calendar state changes to busy, that is, \u201cFree Until 10:30:00\u201d, and that appears in the Skype for Business client UI as in the following illustration.<\/p>\n

\"Free<\/a><\/p>\n

Now, it\u2019s time to see a programmatic approach to change the privacy relationship. For more information about how to control presence information, see Control access to your presence information in Lync<\/a>. In Skype for Business, each contact has an access level, which is nothing but a privacy relationship chosen by us. For example, go to Groups<\/strong> in the Skype for Business client and right-click a contact to\u00a0show the Change Privacy Relationship<\/strong> option and different levels like Friends and Family<\/strong>, Workgroup<\/strong>, Colleagues<\/strong>, External Contacts<\/strong>, Blocked Contacts<\/strong>, and Auto-Assign relationship<\/strong>. When we choose Auto-Assign relationship<\/strong>, Skype for Business automatically sets the access level. In the Skype for Business client UI, it appears as shown in the following screenshot.<\/p>\n

\"Change<\/a><\/p>\n

To retrieve the contacts in our groups and the privacy relationship status like External<\/strong>, use the following snippet.<\/p>\n

Get-xSKBContact | ? {$_.PrivacyRelationShip -eq \"External\"} | Select GroupName , Source , PrivacyRelationShip<\/code><\/p>\n

\"Groups<\/a><\/p>\n

Consider the following scenario. A user messed up the Skype for Business contacts by choosing the wrong privacy relationship option. For example, a contact in enterprise is Colleague<\/strong> by default. Accidentally, a user might have pinned one more enterprise contacts as External<\/strong>. Look at the following image where a contact in our enterprise shows as External<\/strong> because it\u2019s pinned as External<\/strong> in the Change Privacy Relationship<\/strong> option. (For demo)<\/p>\n

\"Example<\/a><\/p>\n

We should retrieve all the contacts that have source network as Enterprise<\/strong> and map them to Colleague<\/strong> by using a simple PowerShell trick as shown in the following example. By changing the value of [Microsoft.Lync.Model.AccessLevel]<\/strong>, it\u2019s easy to toggle the privacy relationship<\/strong>.<\/p>\n

Import-Module 'C:\\Program Files (x86)\\Microsoft Office 2013\\LyncSDK\\Assemblies\\Desktop\\Microsoft.Lync.Model.dll'\n$Client = [Microsoft.Lync.Model.LyncClient]::GetClient()\n$Users = @(\"SIP1\" , \"SIP2\")\nforeach($User in $Users)\n{<\/code><\/p>\n

$contact = $Client.ContactManager.GetContactByUri($User)<\/code><\/p>\n

if([Microsoft.Lync.Model.SourceNetworkType]$contact.GetContactInformation([Microsoft.Lync.Model.ContactInformationType]::SourceNetwork) -eq [Microsoft.Lync.Model.SourceNetworkType]::Enterprise)<\/code><\/p>\n

{<\/code><\/p>\n

if($contact.CanChangeSetting([Microsoft.Lync.Model.ContactSetting]::AccessLevel))\n{<\/code><\/p>\n

$AR = $contact.BeginChangeSetting([Microsoft.Lync.Model.ContactSetting]::AccessLevel,[<\/strong>Microsoft.Lync.Model.AccessLevel]::Colleague<\/strong>,$null,$null)\n$contact.EndChangeSetting($AR)\n$contact.Uri + \" privacy relationship changed to \" + [Microsoft.Lync.Model.AccessLevel]$contact.Settings.GetValueAt(2)<\/code><\/p>\n

}<\/code><\/p>\n

}<\/code><\/p>\n

}<\/code><\/p>\n

How does this work?<\/strong> The script retrieves the contact information to check the source network type. If the type is Enterprise<\/strong>, the script determines whether the settings for the contact can be changed. If a change is allowed, the script changes the access level (Privacy Relationship) to Colleague<\/strong> from External<\/strong>.<\/p>\n

Note<\/strong>: We can choose the Source Network Type as Default to make the type Auto-Assign relationship<\/strong>. It\u2019s not required here because it changes other contacts privacy relationship settings.<\/p>\n

\"Result<\/a><\/p>\n

In this post, we showed a few tips and tricks to retrieve group and contact information by using a tiny PowerShell script with Lync 2013 SDK. In the next blog post, we\u2019ll talk about how to register events, add groups, remove groups, rename groups, and organize contacts by integrating PowerShell with Lync 2013 SDK.<\/p>\n

I invite you to follow the Scripting Guys on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to them at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow.<\/p>\n

Until then always remember that with Great PowerShell comes Great Responsibility.<\/p>\n

Sean Kearney<\/strong>\nHonorary Scripting Guy\nCloud and Datacenter Management MVP<\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Learn how to extend PowerShell with Lync 2013 SDK to explore groups and contacts information in Skype for Business 2016 client. MVP Chendrayan Venkatesan is back again to show us how to get started with the Lync 2013 SDK to enable us to do some cool stuff with PowerShell and Skype for Business! Take […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[568,685,641],"tags":[696,56,59,45],"class_list":["post-79855","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-hey-scripting-guy","category-scripting-techniques","category-windows-powershell","tag-chendrayan-venkatesan","tag-guest-blogger","tag-sharepoint","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Learn how to extend PowerShell with Lync 2013 SDK to explore groups and contacts information in Skype for Business 2016 client. MVP Chendrayan Venkatesan is back again to show us how to get started with the Lync 2013 SDK to enable us to do some cool stuff with PowerShell and Skype for Business! Take […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/79855","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=79855"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/79855\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=79855"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=79855"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=79855"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}