[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Creates a new conferencing policy for use in your organization. Conferencing policies determine the features and capabilities that can be used in a Web conference; this includes everything from whether or not the conference can include IP audio and video to the maximum number of people who can attend a meeting.

Syntax


New-CsConferencingPolicy -Identity <XdsIdentity> [-AllowAnnotations <$true \| $false>] [-AllowAnonymousParticipantsInMeetings <$true \| $false>] [-AllowAnonymousUsersToDialOut <$true \| $false>] [-AllowConferenceRecording <$true \| $false>] [-AllowExternalUserControl <$true \| $false>] [-AllowExternalUsersToRecordMeeting <$true \| $false>] [-AllowExternalUsersToSaveContent <$true \| $false>] [-AllowIPAudio <$true \| $false>] [-AllowIPVideo <$true \| $false>] [-AllowParticipantControl <$true \| $false>] [-AllowPolls <$true \| $false>] [-AllowUserToScheduleMeetingsWithAppSharing <$true \| $false>] [-AppSharingBitRateKb <Int64>] [-AudioBitRateKb <UInt32>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableAppDesktopSharing <None \| SingleApplication \| Desktop>] [-EnableDataCollaboration <$true \| $false>] [-EnableDialInConferencing <$true \| $false>] [-EnableFileTransfer <$true \| $false>] [-EnableP2PFileTransfer <$true \| $false>] [-EnableP2PRecording <$true \| $false>] [-EnableP2PVideo <$true \| $false>] [-FileTransferBitRateKb <Int64>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxMeetingSize <UInt32>] [-MaxVideoConferenceResolution <CIF \| VGA>] [-VideoBitRateKb <Int64>] [-WhatIf [<SwitchParameter>]]

New-CsConferencingPolicy -Identity <XdsIdentity> [-AllowAnnotations <$true | $false>] [-AllowAnonymousParticipantsInMeetings <$true | $false>] [-AllowAnonymousUsersToDialOut <$true | $false>] [-AllowConferenceRecording <$true | $false>] [-AllowExternalUserControl <$true | $false>] [-AllowExternalUsersToRecordMeeting <$true | $false>] [-AllowExternalUsersToSaveContent <$true | $false>] [-AllowIPAudio <$true | $false>] [-AllowIPVideo <$true | $false>] [-AllowParticipantControl <$true | $false>] [-AllowPolls <$true | $false>] [-AllowUserToScheduleMeetingsWithAppSharing <$true | $false>] [-AppSharingBitRateKb <Int64>] [-AudioBitRateKb <UInt32>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableAppDesktopSharing <None | SingleApplication | Desktop>] [-EnableDataCollaboration <$true | $false>] [-EnableDialInConferencing <$true | $false>] [-EnableFileTransfer <$true | $false>] [-EnableP2PFileTransfer <$true | $false>] [-EnableP2PRecording <$true | $false>] [-EnableP2PVideo <$true | $false>] [-FileTransferBitRateKb <Int64>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxMeetingSize <UInt32>] [-MaxVideoConferenceResolution <CIF | VGA>] [-VideoBitRateKb <Int64>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter	Required	Type	Description
Identity	Required	XdsIdentity	Unique identifier for the conferencing policy to be created. Conferencing policies can be created at the site or per-user scopes. To create a site policy use syntax similar to this: -Identity site:Redmond. To create a per-user policy use syntax similar to this: -Identity SalesConferencingPolicy.
AllowIPAudio	Optional	Boolean	Indicates whether or not computer audio is allowed in the meeting. The default value is True ($True).
AllowIPVideo	Optional	Boolean	Indicates whether or not computer video is allowed in the meeting. The default value is True ($True).
AllowParticpantControl	Optional	Boolean	Indicates whether or not meeting participants are allowed to take control of applications shared during the meeting. The default value is True ($True).
AllowAnnotations	Optional	Boolean	Indicates whether or not participants are allowed to make onscreen annotations on any content shared during the meeting. The default value is True ($True). Note that annotations are not archived along with other meeting content.
AllowUserToScheduleMeetingsWithAppSharing	Optional	Boolean	Indicates whether or not users are allowed to schedule meetings that include application sharing. The default value is true ($True).
AllowAnonymousUsersToDialOut	Optional	Boolean	Indicates whether or not anonymous users (i.e., unauthenticated users) are allowed to join a conference using dial-out phoning. With dial-out phoning the conference server will telephone the user; when the user answers the phone, he or she will be joined to the conference. The default value is False ($False).
AllowAnonymousParticipantsInMeetings	Optional	Boolean	Indicates whether anonymous users are allowed to participate in the meeting. If set to False ($False) then only authenticated users (that is, users logged on to your Active Directory or the Active Directory of a federated partner) are allowed to attend the meeting. The default value is True ($True).
AllowExternalUsersToSaveContent	Optional	Boolean	Indicates whether external users (that is, users not currently logged-on to your network) are allowed to save handouts, slides, and other meeting content. The default value is True ($True).
AllowExternalUserControl	Optional	Boolean	Indicates whether external users (that is, users not currently logged-on to your network) are allowed to take control of shared applications or desktops. The default value is False ($False).
AllowExternalUsersToRecordMeetings	Optional	Boolean	Indicates whether external users (that is, users not currently logged-on to your network) are allowed to record the meeting. The default value is False ($False). Note that this setting takes effect only if the EnableRecording property is set to True.
EnableDialInConferencing	Optional	Boolean	Indicates whether users are able to join the meeting by dialing in with a PSTN (Public Switched Telephone network) telephone. The default value is True ($True).
EnableAppDesktopSharing	Optional	PSListModifier	Indicates whether participants are allowed to share applications (or their desktop) during the course of a meeting. Allowed values are: Desktop. Users are allowed to share their entire desktop. SingleApplication. Users are allowed to share a single application. None. Users are not allowed to share applications or their desktop. The default value is Desktop.
sAllowConferenceRecording	Optional	Boolean	Indicates whether users are allowed to record the meeting. The default value is True ($True).
EnableFileTransfer	Optional	Boolean	Indicates whether file transfers to all the meeting participants are allowed during the meeting. The default value is True ($True).
EnableP2PFileTransfer	Optional	Boolean	Indicates whether peer-to-peer file transfers (that is, file transfers that do not involve all participants) are allowed during the meeting. The default value is True ($True).
EnableDataCollaboration	Optional	Boolean	Indicates whether users are allowed to join the meeting over the Internet, provided they are using a supported Web browser. The default value is True ($True).
MaxVideoConferenceResolution	Optional	PSListModifier	Indicates the maximum resolution for meeting video. Allowed values are: CIF. CIF has a resolution of 352 pixels by 288 pixels. VGA. VGA has a resolution of 640 pixels by 480 pixels. The default value is VGA.
MaxMeetingSize	Optional	Integer	Indicates the maximum number of people who are allowed to attend a meeting. After the maximum number of participants has been reached anyone else who tries to join the meeting will be turned away with the notice that the meeting is full. The maximum number of participants can be any whole number between 2 and 250, inclusive; the default value is 200.
AudioBitRateKB	Optional	Integer	Bit rate (in kilobytes) used for audio transmissions. The audio bit rate can be any whole number between 20 and 200, inclusive; the default value is 200.
VideoBitRateKB	Optional	Integer	Bit rate (in kilobytes) used for video transmissions. The video bit rate can be any whole number between 0 and 2000, inclusive; the default value is 2000.
AppSharingBitRateKB	Optional	Integer	Bit rate (in kilobytes) used for application sharing. The application sharing bit rate can be any whole number between 0 and 2000, inclusive; the default value is 2000.
FileTransferBitRateKB	Optional	Integer	Bit rate (in kilobytes) used for file transfers. The file transfers bit rate can be any whole number between 0 and 2000, inclusive; the default value is 2000.
AllowPolls	Optional	Boolean	Indicates whether or not users are allowed to conduct online polls during a meeting. The default value is True.
Description	Optional	String	Enables administrators to provider explanatory text about the conferencing policy. For example, the Description might indicate the users the policy should be assigned to.
EnableP2PRecording	Optional	Boolean	If True, users will be able to record peer-to-peer conferencing sessions. The default value is False.
EnableP2PVideo	Optional	Boolean	If True, users will be able to take part in peer-to-peer video conferencing sessions. The default value is False.
InMemory	Optional	Switch Parameter	Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet.
Force	Switch Parameter	Guid	Suppresses the display of any non-fatal error message that might arise when running the command.
WhatIf	Optional	Switch Parameter	Describes what would happen if you executed the command without actually executing the command.
Confirm	Optional	Switch Parameter	Prompts you for confirmation before executing the command.

Detailed Description

Conferencing is an important part of Microsoft Communications Server 2010: conferencing enables groups of users (as few as 2 people to as many as 1,000 people) to come together online to view slides and video, share applications, exchange files, and otherwise communicate and collaborate.

Needless to say, it’s important for administrators to maintain control over conferences and conference settings. In some cases, there might be security concerns: by default, anyone, including unauthenticated users, can participate in meetings and save any of the slides or handouts distributed during those meetings. In other cases, there might be bandwidth concerns: having a multitude of simultaneous meetings, each involving hundreds of participants and each featuring video feeds and file sharing, has the potential to wreak havoc on your network. In addition, there might be occasional legal concerns. For example, by default meeting participants are allowed to make annotations on shared content; however, these annotations are not saved when the meeting is archived. If your organization is required to keep a record of all electronic communication, you might want to disable annotations.

Of course, wanting to manage conferencing settings is one thing; how you manage these settings is another. In Communications Server 2010 conferences are managed using conferencing policies. (In previous versions of the software, these were known as meeting policies.) As noted, conferencing policies determine the features and capabilities that can be used in a Web conference, including everything from whether or not the conference can include IP audio and video to the maximum number of people who can attend a meeting. Conferencing policies can be configured at the global scope; at the site scope; or at the per-user scope. This provides administrators with enormous flexibility when it comes to deciding which capabilities will be made available to which users.

The New-CsConferencingPolicy cmdlet enables you to create new conferencing policies at either the site or the per-user scope. (You cannot create a new global policy because the global policy already exists. However, you can modify the property values of the global policy by using Set-CsConferencingPolicy.) When you create a policy at the site scope that policy will automatically be implemented and will immediately be put to use managing the conferencing activities for users in that site. (The one exception is users who have been assigned a per-user policy; per-user policies always take precedence over site policies.) By contrast, new per-user policies are not automatically implemented and put to use; instead, these policies must be explicitly assigned to users or groups of users by using Grant-CsConferencingPolicy.

Return Types

New-CsConferencingPolicy creates a new instance of the Microsoft.Rtc.Management.WriteableConfig.Policy.Meeting.MeetingPolicy object.

Examples

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

	Copy Code
New-CsConferencingPolicy -Identity SalesConferencingPolicy -MaxMeetingSize 50

The preceding command uses New-CsConferencingPolicy to create a new conferencing policy with the Identity SalesConferencingPolicy. This policy will use all the default values for a conferencing policy except one: MaxMeetingSize. Because the -MaxMeetingSize parameter has been included, the maximum size for a meeting will be set to 50 instead of the default value of 200. Note that this command will fail if a policy with the Identity SalesConferencingPolicy already exists. In addition, this policy will not actually be put to use until Grant-CsConferencingPolicy has been used to assign the policy to a user or set of users.

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

	Copy Code
New-CsConferencingPolicy -Identity site:Redmond -MaxMeetingSize 100 -AllowParticipantControl $False

In Example 2 New-CsConferencingPolicy is used to create a conferencing policy with the Identity site:Redmond. Because this policy is configured at the site scope it will automatically applied to conferencing activities for users at the Redmond site. If a policy with this Identity already exists, or if the Redmond site doesn’t exist, this command will fail. In this example two different property values are configured: MaxMeetingSize is set to 100 and AllowParticipantControl is set to False ($False). All other policy properties will use the default values.