Edit

Grant-CsBroadcastMeetingPolicy

  • Reference
Module:
SkypeForBusiness
Applies to:
Microsoft Teams, Skype for Business Online

Use the Grant-CsBroadcastMeetingPolicy cmdlet to assign a broadcast meeting policy to a user.

Syntax

Grant-CsBroadcastMeetingPolicy
     [-PolicyName] <String>
     [-Tenant <Guid>]
     [-DomainController <Fqdn>]
     [-Identity] <UserIdParameter>
     [-PassThru]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Administrators can manage Broadcast meeting functionality in Microsoft Teams or Skype for Business Online using the following:

  • Broadcast meeting configuration at the tenant level
  • Broadcast meeting policy at the user level
  • Conferencing policy at the user level.

Broadcast meeting configuration and broadcast meeting policy govern broadcast-specific functionality. In addition, the settings of the conferencing policy assigned to the user producing the broadcast also general conferencing settings that are also relevant for broadcast meetings.

This document describes how to specify which broadcast meeting policy is assigned to a user. Be sure to also review the following docs to manage conferencing policy:Grant-CsConferencingPolicy, New-CsConferencingPolicy, and Set-CsConferencingPolicy.

NOTES:

  • Broadcast meeting policies are predefined in Microsoft Teams or Skype for Business. The defined settings for each policy can be displayed by using the Get-CsBroadcastMeetingPolicy cmdlet with no parameters.
  • New broadcast meeting policy instance can't be created, and existing policies can't be modified. They can only be granted, or assigned to users.

Examples

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

Grant-CsBroadcastMeetingPolicy -Identity jphillips@contoso.com -PolicyName BroadcastMeetingPolicyAllEnabled

This example grants the BroadcastMeetingPolicyAllEnabled policy to a user identified by their User Principal Name (UPN).

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

Grant-CsBroadcastMeetingPolicy -Identity jphillips@contoso.com -PolicyName $Null

In Example 2, any per-user broadcast meeting policy previously assigned to the user jphillips is unassigned from that user; as a result, they will be managed by the global broadcast meeting policy. To unassign a per-user policy, set the PolicyName to a null value ($Null).

Parameters

-Confirm

The Confirm switch causes the command to pause processing, and requires confirmation to proceed.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams, Skype for Business Online

-DomainController

This parameter is reserved for internal Microsoft use.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams, Skype for Business Online

-Identity

Specifies the identity of the target user. Acceptable values include:

Example: jphillips@contoso.com

Example: sip:jphillips@contoso.com

Example: 98403f08-577c-46dd-851a-f0460a13b03d

Type:UserIdParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams, Skype for Business Online

-PassThru

Enables you to pass a user object through the pipeline that represents the user account being assigned the policy.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams, Skype for Business Online

-PolicyName

Specifies the name of the policy to be assigned to a user. A list of the policies for your organization can be retrieved using Get-CsBroadcastMeetingPolicy. The PolicyName is the policy identity minus the policy scope (the "tag:" prefix). For example, a policy with the identity "Tag:BroadcastMeetingPolicyDisabled" has a PolicyName equal to "BroadcastMeetingPolicyDisabled". To unassign a previously assigned policy, set PolicyName to $Null.

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams, Skype for Business Online

-Tenant

PARAMVALUE: Guid

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams, Skype for Business Online

-WhatIf

The WhatIf switch causes the command to simulate its results. By using this switch, you can view what changes would occur without having to commit those changes.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Microsoft Teams, Skype for Business Online

Inputs

None

Outputs

None