Microsoft Defaults
------------------
The Lync/Microsoft Default settings provide a mechanism for ensuring that the Quick Add Subscriber and Subscriber Management automation templates apply the settings that are appropriate for a specific environment (i.e. site or customer).
When adding a subscriber using the Quick Add Subscriber automation template the Quick Add Groups are applied once the Lync/Microsoft details are applied.
More particularly the settings that are applied to Microsoft Lync / Skype for Business users can be defined:
* By Lync/Microsoft Defaults instances at a higher level of the VOSS hierarchy (e.g. customer) level,
* Overridden(1) with Lync/Microsoft Defaults instances at a lower (e.g. country, site, department, etc depending on how the hierarchy has been configured) level, or
* Overridden(1) by Quick Add Groups selected in Quick Add Subscriber templates.
**(1) Overridden**: When a policy is defined in the Lync/Microsoft Defaults it will be overwritten if defined in an instance at site level or in the Quick add groups.
**NOTE**: This mechanism will be referred to as the policy applicable to the user or just applicable policy.
Default Lync / Skype for Business Polices
-----------------------------------------
VOSS can be used to configure the following Lync/Skype for Business policies based on the business hierarchy of the user.
**Enterprise Voice Configuration:**
* Dialplan
* Voice Policy
**Advanced Policies:**
* Conferencing Policy
* Persistent Chat Policy
* Mobility Policy
* External Access Policy
* Client Version Policy
* PIN Policy
* Location Policy
* Archiving Policy
* Client Policy
Default Voicemail Policies
--------------------------
Quick Add Subscriber operations with the Voicemail option selected operate as follows:
* When 'Exchange UM for Voicemail' is checked
* An Exhange Mailbox is created if it does not exist and
* The Exchange Mailbox is enabled for Unified Messaging (UM) using the Skype for Business Line URI provided it is not already enabled.
* Otherwise Cisco Unity Connection is used for voicemail in a multi-vendor solution.
**NOTE**: The user will only see Voicemail in the Quick Add Subscriber user interface and the defaults will define whether Unity Connect mailbox or Exchange UM is provisioned.
The default Exchange UM Mailbox Policy used when enabling Exchange UM can be specified unless overridden by Quick Add Groups.
Extension Length
----------------
The |VOSS-4-UC| Number Inventory can be used to manage Direct Inward Dialling Numbers (DIDs) and/or Extension Numbers.
Numbers in the Number Inventory that start with a '+' are considered DIDs.
Features that make use of the |VOSS-4-UC| Number Inventory selector can derive the Extension at the selected site from the selected DID using the **Extension Length** configured by the Microsoft Defaults of the site.
|VOSS-4-UC| supports Extension Lengths between 3 to 7 digits.
Using Extension Length in Microsoft Defaults to derive Extension Numbers from DID numbers
-----------------------------------------------------------------------------------------
When editing Microsoft Lync / Skype for Business LineURI of users or other features such as Conference Dial-in Access Numbers the **Extension Length** setting in **Microsoft defaults** in is handled as follows:
* When user selects an Extension from the |VOSS-4-UC| Number Inventory the LineURI is set to **tel:+<EXT>;ext=<EXT>**
* When he user selects a DID from the |VOSS-4-UC| Number Inventory the LineURI is set to **tel:<DID>;ext=<Last 'Extension Length' digits of the DID>**
* When does not change anything or enters the LineURI according to the Microsoft Lync / Skype for Business format (i.e. starting with 'T' or 't') no further processing of the LineURI will take place. This allows control of
* the users DID (e.g. **tel:+27215252020;Ext=2020**) as the user's E164 phone number or,
* the Operator Number (also called PSTN published number) as the user's E164 phone number.
**Examples**:
* A user with a LineURI of **tel:+27215252020;Ext=2020** has been assigned a DID of +27215252020 and an Extension Number 2020.
* A user with a LineURI of **tel:+27215252000;Ext=2020** has been assigned Extension Number 2020 while the switchboard operator's number +27215252000 will be presented as the user's caller ID when the user makes PSTN phone calls.
* A user with a LineURI of **tel:+27215252025** has been assigned DID of +27215252025.
Updating the |VOSS-4-UC| Number Inventory
-----------------------------------------
When DIDs and/or Extension Numbers selected as the LineURI, Phone Number or Extension are stored in the |VOSS-4-UC| Number Inventory the status (used and/or available) of the Extension Numbers and/or DID numbers will be updated accordingly.
.. |VOSS-4-UC| replace:: VOSS-4-UC
GET http://[host-proxy]/api/data/MSDefaults/schema/?hierarchy=[hierarchy]&format=json&schema=1
{
"$schema": "http://json-schema.org/draft-03/schema",
"type": "object",
"properties": {
"name": {
"required": true,
"type": "string",
"title": "Name"
},
"skype_for_business": {
"type": "boolean",
"title": "Skype for Business"
},
"im_and_presence": {
"type": "boolean",
"description": "PC to PC (with AV disabled)",
"title": "Instant Messaging and Presence"
},
"presence_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsPresencePolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Presence Policy",
"target_attr": "Identity",
"type": "string",
"description": "Grants a per-user presence policy to a user or group of users.",
"target_model_type": "device/skypeforbusinesshybrid/CsPresencePolicy",
"choices": []
},
"persistent_chat_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsPersistentChatPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Persistent Chat Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsPersistentChatPolicy",
"choices": []
},
"archiving_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsArchivingPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Archiving Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsArchivingPolicy",
"choices": []
},
"audio_video": {
"type": "boolean",
"description": "PC to PC with AV enabled",
"title": "Audio Video"
},
"remote_call_control": {
"type": "boolean",
"description": "Remote Call Control",
"title": "Remote Call Control"
},
"enterprise_voice": {
"type": "boolean",
"description": "Skype for Business Enterprise Voice",
"title": "Enterprise Voice"
},
"voice_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsVoicePolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Voice Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsVoicePolicy",
"choices": []
},
"extension": {
"type": "boolean",
"title": "Extension"
},
"did": {
"type": "boolean",
"title": "Dial-in Number (DID)"
},
"third_party_video_system_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsThirdPartyVideoSystemPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Third Party Video System Policy",
"target_attr": "Identity",
"type": "string",
"description": "`",
"target_model_type": "device/skypeforbusinesshybrid/CsThirdPartyVideoSystemPolicy",
"choices": []
},
"pin_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsPinPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "PIN Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsPinPolicy",
"choices": []
},
"user_services_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsUserServicesPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "User Services Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsUserServicesPolicy",
"choices": []
},
"mobility_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsMobilityPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Mobility Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsMobilityPolicy",
"choices": []
},
"call_via_work_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsCallViaWorkPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Call-via-Work Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsCallViaWorkPolicy",
"choices": []
},
"conferencing_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsConferencingPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Conferencing Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsConferencingPolicy",
"choices": []
},
"external_access_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsExternalAccessPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "External Access Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsExternalAccessPolicy",
"choices": []
},
"exchangehybrid_mailbox": {
"type": "boolean",
"title": "Exchange Mailbox (Hybrid)"
},
"um_mailbox": {
"type": "boolean",
"title": "UM Mailbox"
},
"um_mailbox_policy": {
"target": "/api/device/exchangehybrid/UMMailboxPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "UM Mailbox Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/exchangehybrid/UMMailboxPolicy",
"choices": []
},
"client_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsClientPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Client Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsClientPolicy",
"choices": []
},
"client_version_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsClientVersionPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Client Version Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsClientVersionPolicy",
"choices": []
},
"dial_plan": {
"target": "/api/device/skypeforbusinesshybrid/CsDialPlan/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Dial Plan",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsDialPlan",
"choices": []
},
"voice_routing_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsVoiceRoutingPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Voice Routing Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsVoiceRoutingPolicy",
"choices": []
},
"location_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsLocationPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Location Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsLocationPolicy",
"choices": []
},
"office_365": {
"type": "boolean",
"title": "Office 365"
},
"office_365_license": {
"target": "/api/device/msonline/MsolAccountSku/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Office 365 License",
"target_attr": "Identity",
"type": "string",
"description": "Office 365 License Pack assigned to user",
"target_model_type": "device/msonline/MsolAccountSku",
"choices": []
},
"office_365_service_plans": {
"choices": [
{
"value": "MCOEV",
"title": "Microsoft Communications Online"
},
{
"value": "EXCHANGE_S_ENTERPRISE",
"title": "Exchange"
},
{
"value": "MCOSTANDARD",
"title": "Microsoft Communications Online"
},
{
"value": "OFFICESUBSCRIPTION",
"title": "Microsoft Office"
}
],
"type": "string",
"description": "Select the Service Plans applicable to the user",
"title": "Office 365 Service Plans"
},
"online_skype_for_business": {
"type": "boolean",
"title": "Online Skype for Business"
},
"online_im_and_presence": {
"type": "boolean",
"description": "PC to PC (with AV disabled)",
"title": "Online Instant Messaging and Presence"
},
"online_audio_video": {
"type": "boolean",
"description": "PC to PC with AV enabled",
"title": "Online Audio Video"
},
"online_pstn_calling": {
"type": "boolean",
"description": "PSTN Calling",
"title": "Online PSTN Calling"
},
"online_voice_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsVoicePolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Online Voice Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsVoicePolicy",
"choices": []
},
"online_telephone_number": {
"type": "boolean",
"title": "Online Telephone Number"
},
"online_caller_id_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsCallerIdPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Online Caller ID Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsCallerIdPolicy",
"choices": []
},
"online_ip_phone_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsIPPhonePolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Online IP Phone Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsIPPhonePolicy",
"choices": []
},
"online_conferencing_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsConferencingPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Online Conferencing Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsConferencingPolicy",
"choices": []
},
"online_broadcast_meeting_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsBroadcastMeetingPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Online Broadcast Meeting Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsBroadcastMeetingPolicy",
"choices": []
},
"online_meeting_room": {
"type": "boolean",
"description": "",
"title": "Online Meeting Room"
},
"online_dialin_conferencing_user": {
"type": "boolean",
"description": "",
"title": "Online Dial-in Conferencing User"
},
"online_external_access_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsExternalAccessPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Online External Access Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsExternalAccessPolicy",
"choices": []
},
"online_exchangehybrid_mailbox": {
"type": "boolean",
"title": "Online Exchange Mailbox"
},
"hosted_voicemail_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsHostedVoicemailPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Hosted Voicemail Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsHostedVoicemailPolicy",
"choices": []
},
"online_um_mailbox": {
"type": "boolean",
"description": "",
"title": "Online UM MailBox"
},
"online_client_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsClientPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Online Client Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsClientPolicy",
"choices": []
},
"online_client_version_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsClientVersionPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Online Client Version Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsClientVersionPolicy",
"choices": []
},
"online_dial_plan": {
"target": "/api/device/skypeforbusinesshybrid/CsDialPlan/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Online Dial Plan",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsDialPlan",
"choices": []
},
"online_voice_routing_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsVoiceRoutingPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Online Voice Routing Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsVoiceRoutingPolicy",
"choices": []
},
"online_graph_policy": {
"target": "/api/device/skypeforbusinesshybrid/CsGraphPolicy/choices/?field=Identity&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"title": "Online Graph Policy",
"target_attr": "Identity",
"type": "string",
"description": "",
"target_model_type": "device/skypeforbusinesshybrid/CsGraphPolicy",
"choices": []
},
"voss_ou": {
"type": "string",
"description": "This value will populate the OU field ",
"title": "Temp OU"
},
"extension_length": {
"description": "The number of digits at the end of the DID which is used as an extension",
"title": "Extension Length",
"default": "4",
"required": false,
"displayable": true,
"choices": [
{
"value": "3",
"title": "3"
},
{
"value": "4",
"title": "4"
},
{
"value": "5",
"title": "5"
},
{
"value": "6",
"title": "6"
},
{
"value": "7",
"title": "7"
}
],
"type": "string"
},
"registrarpool": {
"type": "string",
"title": "Default Registrar Pool"
},
"sip_domian": {
"type": "string",
"title": "Default SIP Domain"
}
},
"schema_version": "0.0"
}