Set-CsMeetingRoom

Modifies the property values of an existing Skype for Business Server meeting room. A meeting room is a conferencing device designed to address video conferencing and collaboration scenarios in small conference rooms. This cmdlet was introduced in Lync Server 2013.

Note: This cmdlet is not supported for managing Microsoft Teams Rooms. You must use the methods described in the Microsoft Teams Rooms documentation to manage Microsoft Teams Rooms.

Syntax

Set-CsMeetingRoom
   [-Identity] <UserIdParameter>
   [-AcpInfo <Microsoft.Rtc.Management.ADConnect.Core.MultiValuedProperty`1[Microsoft.Rtc.Management.ADConnect.Collections.AcpInfo]>]
   [-AudioVideoDisabled <Boolean>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-EnterpriseVoiceEnabled <Boolean>]
   [-ExchangeArchivingPolicy <ExchangeArchivingPolicyOptionsEnum>]
   [-HostedVoiceMail <Boolean>]
   [-LineServerURI <String>]
   [-LineURI <String>]
   [-PassThru]
   [-PrivateLine <String>]
   [-RemoteCallControlTelephonyEnabled <Boolean>]
   [-SipAddress <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

In Skype for Business Server, meeting rooms are self-contained computer appliances that are installed in conference rooms and supply advanced meeting capabilities such as:

One touch meeting join experience

Multi-view video gallery

Touch-enabled white-boarding on the front of room screen

Calendar integration to provide access to scheduled meetings

Content sharing and switching

In order to manage these new endpoint devices you must, among other things, create and enable an Exchange resource mailbox account for the device, then enable that resource account for Skype for Business Server. Note that, for Skype for Business Server, there are no cmdlets for creating or removing meeting rooms. Instead, you use the Enable-CsMeetingRoom cmdlet to enable meeting rooms and the Disable-CsMeetingRoom cmdlet to disable meeting rooms. The resource account must already exist in order for you to enable the meeting room, and disabling a meeting room only removes that room from your collection of meeting rooms; it does not delete the resource mailbox account.

Skype for Business Server Control Panel: The functions carried out by the Set-CsMeetingRoom cmdlet are not available in the Skype for Business Server Control Panel.

Examples

-------------------------- Example 1 --------------------------

Set-CsMeetingRoom -Identity "RedmondMeetingRoom" -LineUri "tel:+12065551219"

The command show in Example 1 updates the LineUri assigned to the meeting room RedmondMeetingRoom.

-------------------------- Example 2 --------------------------

Set-CsMeetingRoom -Identity "RedmondMeetingRoom" -Enabled $False

Set-CsMeetingRoom -Identity "RedmondMeetingRoom" -Enabled $True

In Example 2, the meeting room RedmondMeetingRoom is temporarily disabled; this is done by setting the Enabled property to False ($False):

Set-CsMeetingRoom -Identity "RedmondMeetingRoom" -Enabled $False

To re-enable the room, simply set the Enabled property to True ($True):

Set-CsMeetingRoom -Identity "RedmondMeetingRoom" -Enabled $True

-------------------------- Example 3 --------------------------

Get-CsMeetingRoom | Set-CsMeetingRoom -Enabled $False

Example 3 temporarily disables all the meeting rooms in the organization. To do this, the command first calls the Get-CsMeetingRoom cmdlet without any parameters; that returns a collection of all the available meeting rooms. That collection is then piped to the Set-CsMeetingRoom cmdlet, which temporarily disables each room in the collection.

-------------------------- Example 4 --------------------------

Get-CsMeetingRoom | Set-CsMeetingRoom -ExchangeArchivingPolicy "UseLyncArchivingPolicy"

In Example 4, all the meeting rooms in the organization are configured to use Skype for Business Server archiving rather than Exchange archiving. To carry out this task, the command first uses the Get-CsMeetingRoom cmdlet to return a collection of all the available meeting rooms. That collection is then piped to the Set-CsMeetingRoom cmdlet, which uses the ExchangeArchivingPolicy cmdlet to configure each room in the collection to use Skype for Business Server archiving.

Parameters

-AcpInfo

Enables you to assign one or more third-party audio conferencing providers to a meeting room. However, it is recommended that you use the Set-CsUserAcp cmdlet to assign Audio conferencing providers.

Type:Microsoft.Rtc.Management.ADConnect.Core.MultiValuedProperty`1[Microsoft.Rtc.Management.ADConnect.Collections.AcpInfo]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-AudioVideoDisabled

Indicates whether the room is allowed to make audio/video (A/V) calls by using Skype for Business. If set to True, the room will largely be restricted to sending and receiving instant messages.

You cannot disable A/V communications if a room is currently enabled for remote call control, Enterprise Voice and/or Internet Protocol private branch exchange (IP-PBX) soft phone routing.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-DomainController

Enables you to connect to the specified domain controller in order to retrieve meeting room information. To connect to a particular domain controller, include the DomainController parameter followed by the computer name (for example, atl-dc-001) or its fully qualified domain name (FQDN) (for example, atl-dc-001.litwareinc.com).

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-Enabled

Indicates whether or not the room has been enabled for Skype for Business Server. If you set this value to False, the room will no longer be able to log on to Skype for Business Server; setting this value to True re-enables the meeting room's logon privileges.

If you disable an account by using the Enabled parameter, the information associated with that account (including assigned policies and whether or not the room is enabled for Enterprise Voice and/or remote call control) is retained. If you later re-enable the account by using the Enabled parameter, the associated account information will be restored. This differs from using the Disable-CsMeetingRoom cmdlet to disable a meeting room account. When you run Disable-CsMeetingRoom, all the Skype for Business Server data associated with that account is deleted.

Type:Boolean
Aliases:CsEnabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-EnterpriseVoiceEnabled

Indicates whether the room has been enabled for Enterprise Voice, which is the Microsoft implementation of Voice over Internet Protocol (VoIP). With Enterprise Voice, rooms can make telephone calls using the Internet rather than using the standard telephone network.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-ExchangeArchivingPolicy

Indicates how (and where) the room's instant messaging and conferencing sessions will be archived. Allowed values are:

Uninitialized

UseLyncArchivingPolicy

NoArchiving

ArchivingToExchange

Type:ExchangeArchivingPolicyOptionsEnum
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-HostedVoiceMail

When set to True, enables a room's voice mail calls to be routed to a hosted version of Exchange. In addition, setting this option to True enables rooms to directly place a call to another user's voice mail.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-Identity

Indicates the Identity of the meeting room to be modified. Meeting room Identities are typically specified using one of four formats: 1) the room's SIP address; 2) the room's user principal name (UPN); 3) the room's domain name and logon name, in the form domain\logon (for example, litwareinc\room14) and 4) the room's Active Directory display name (for example, Room 14). You can also reference a room account by using the room's Active Directory distinguished name.

Type:UserIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-LineServerURI

The URI of the remote call control telephone gateway assigned to the room. The LineServerUri is the gateway URI, prefaced by "sip:". For example:

-LineServerUri "sip:rccgateway@litwareinc.com"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-LineURI

Phone number assigned to the room. The line Uniform Resource Identifier (URI) must be specified using the E.164 format and use the "TEL:" prefix. For example:

-LineUri "TEL:+14255551297"

Any extension number should be added to the end of the line URI, for example:

-LineUri "TEL:+14255551297;ext=51297"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-PassThru

Enables you to pass a meeting room object through the pipeline that represents the meeting room being modified. By default, the Set-CsMeetingRoom cmdlet does not pass objects through the pipeline.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-PrivateLine

Phone number for the room private telephone line. A private line is a phone number that is not published in Active Directory Domain Services (AD DS) and, as a result, is not readily available to other people. In addition, this private line bypasses most in-bound call routing rules; for example, a call to a private line will not be forwarded to a room's delegates. Private lines are often used for personal phone calls or for business calls that should be kept separate from other team members.

The private line value should be specified using the E.164 format, and be prefixed by the "TEL:" prefix. For example:

-PrivateLine "TEL:+14255551297"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-RemoteCallControlTelephonyEnabled

Indicates whether the room has been enabled for remote call control telephony. When enabled for remote call control, a room can employ Skype for Business Server to answer phone calls made to his or her desk phone. Phone calls can also be made using Skype for Business. These calls all rely on the standard telephone network, also known as the public switched telephone network (PSTN). To make and receive phone calls over the Internet, the room must be enabled for Enterprise Voice. For details, see the parameter EnterpriseVoiceEnabled.

To be enabled for remote call control, a room must also have both a LineUri and a LineServerUri.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-SipAddress

Unique identifier (similar to an email address) that allows the room to communicate using SIP devices such as Skype for Business. The SIP address must use the sip: prefix as well as a valid SIP domain; for example:

-SipAddress "sip:room14@litwareinc.com"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Online, Skype for Business Server 2015, Skype for Business Server 2019

Inputs

The Set-CsMeetingRoom cmdlet accepts pipelined instances of the Microsoft.Rtc.Management.ADConnect.Schema.OCSADMeetingRoom object.

Outputs

None. Instead, the Set-CsMeetingRoom cmdlet modifies existing instances of the Microsoft.Rtc.Management.ADConnect.Schema.OCSADMeetingRoom object.