Enable-CsOnlineUMMailBox

 

上次修改主題的時間:2017-06-20

Use the Enable-CsOnlineUMMailBox cmdlet to enable Unified Messaging (UM) for existing mailbox users.

Enable-CsOnlineUMMailBox -Identity <UserIdParameter> [-UMMailboxPolicy <String>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-DomainController <Fqdn>] [-Extensions <MultiValuedProperty>] [-Force <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-LineUri <UserIdParameter>] [-NotifyEmail <String>] [-PilotNumber <String>] [-Pin <String>] [-PinExpired <$true | $false>] [-SendWelcomeMail <$true | $false>] [-SIPResourceIdentifier <String>] [-TenantId <Guid>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

This example enables Unified Messaging on the mailbox for tonysmith@contoso.com, sets the extension and PIN for the user that must be changed when the user logs on to UNRESOLVED_TOKEN_VAL(exOutlookNoVersionNoMk) Voice Access, assigns the UM mailbox policy MyUMMailboxPolicy to the user's mailbox, and then sends an email message that contains the Unified Messaging welcome information to administrator@contoso.com.

Enable-UMMailbox -Identity tonysmith@contoso.com -UMMailboxPolicy MyUMMailboxPolicy -Extensions 51234 -PIN 5643892 -NotifyEmail administrator@contoso.com -PINExpired $true

This example enables Unified Messaging on a SIP-enabled mailbox for tonysmith@contoso.com, associates the UM mailbox policy MyUMMailboxPolicy, and sets the extension number, SIP resource identifier, and PIN for the user that must be changed when the user logs on to UNRESOLVED_TOKEN_VAL(exOutlookNoVersionNoMk) Voice Access, and then sends an email message that contains the Unified Messaging welcome information to tonysmith@contoso.com.

Enable-UMMailbox -Identity tonysmith@contoso.com -UMMailboxPolicy MyUMMailboxPolicy -Extensions 51234 -PIN 5643892 -SIPResourceIdentifier "tonysmith@contoso.com" -PINExpired $true

When the mailbox is enabled for Unified Messaging, the settings from a UM mailbox policy are applied to the mailbox. After the mailbox is enabled for Unified Messaging, the user can use the UM features that are included in UNRESOLVED_TOKEN_VAL(exMSExchange).

 

Parameter Required Type Description

Identity

Required

Microsoft.Rtc.Management.AD.UserIdParameter

The Identity parameter specifies the mailbox that you want to enable for Unified Messaging. You can use any value that uniquely identifies the mailbox.

例如:

  • 名稱

  • 顯示名稱

  • 別名

  • 辨別名稱 (DN)

  • 標準 DN

  • <domain name>\<account name>

  • 電子郵件地址

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • 使用者識別碼或使用者主要名稱 (UPN)

AutomaticSpeechRecognitionEnabled

Optional

System.Boolean

The AutomaticSpeechRecognitionEnabled parameter specifies whether to enable Automatic Speech Recognition (ASR) for the UM mailbox. Valid values are:

  • $true   ASR is enabled for the mailbox. This is the default value. ASR is available only if the user's specified preferred language is installed.

  • $false   ASR is disabled for the mailbox.

DomainController

Optional

Microsoft.Rtc.Management.Deploy.Fqdn

指定此 Cmdlet 用來讀取或寫入指定資料的網域控制站。這個參數的有效輸入不是網域全名 (FQDN) 就是電腦名稱。

Extensions

Optional

Microsoft.Rtc.Management.ADConnect.Core.MultiValuedProperty

The Extensions parameter specifies the extension number for the user. Either a single extension number or an array of telephone number extensions can be specified. The user's extension must be unique to the UM dial plan.

If you don't use this parameter, the command attempts to use a default telephone number value for the user. If you're using a Session Initiation Protocol (SIP) Uniform Resource Identifier (URI) or E.164 dial plan, you also need to use the SIPResourceIdentifier parameter.

Force

Optional

System.Management.Automation.SwitchParameter

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

內部部署 商務用 Skype Server 才提供此參數。

IgnoreDefaultScope 參數會指示命令略過 Exchange 管理命令介面工作階段的預設收件者範圍設定,並以整個樹系為範圍。如此可讓命令存取預設範圍內目前不可用的 UNRESOLVED_TOKEN_VAL(exADNoMk) 物件。

使用 IgnoreDefaultScope 參數會產生下列限制:

  • 您不能使用 DomainController 參數。此命令會自動使用適當的通用類別目錄伺服器。

  • 您只可以針對 Identity 參數使用 DN。不接受其他形式的識別碼 (如別名或 GUID)。

LineUri

Optional

Microsoft.Rtc.Management.AD.UserIdParameter

NotifyEmail

Optional

System.String

The NotifyEmail parameter specifies the email address where the Unified Messaging welcome message is sent. By default, the message is sent to the user's SMTP email address.

PilotNumber

Optional

System.String

The PilotNumber parameter specifies the subscriber access number users can dial to gain access to their mailboxes. The default value is the subscriber access number that's specified on the UM dial plan.

Pin

Optional

System.String

The PIN parameter specifies the value for the initial PIN that's used for the UM mailbox. The PIN is checked against the UM mailbox policy rules. The PIN value must be from 4 through 24 numeric characters.

If you don't use this parameter, a system-generated PIN is sent to the user. By default, the PIN generated by the system contains six numeric characters.

PinExpired

Optional

System.Boolean

The PINExpired parameter specifies whether the PIN is treated as expired. If the PIN isn't supplied, the PIN is treated as expired and users are prompted to reset their PIN the next time they log on.

  • $true   The user is required to reset their PIN the next time they log on.

  • $false   The user isn't required to reset their PIN the next time they log on.

SendWelcomeMail

Optional

System.Boolean

true to send a welcome email to the user; otherwise false.

SIPResourceIdentifier

Optional

System.String

The SIPResourceIdentifier parameter specifies the SIP address or E.164 address for the user. This property is compared to the URI type defined on the UM dial plan.

TenantId

Optional

System.Guid

指定您的商務用 Skype Online 租用戶帳戶的全域唯一識別項 (GUID)。例如︰-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"。 您可以藉由執行此命令,來尋找租用戶識別碼:Get-CsTenant | Select-Object DisplayName, TenantID

如果您正在使用 Windows PowerShell 的遠端工作階段,而且只連線到商務用 Skype Online,則您不需要包含 Tenant 參數。租用戶識別碼會依您的連線及認證來判定。Tenant 參數主要是用於混合式部署。

UMMailboxPolicy

Optional

System.String

The UMMailboxPolicy parameter specifies the UM mailbox policy that you want to associate with the mailbox. You can use any value that uniquely identifies the policy. For example:

  • Name

  • Distinguished name (DN)

  • GUID

ValidateOnly

Optional

System.Management.Automation.SwitchParameter

ValidateOnly 參數會告訴指令程式評估執行作業所需的條件及需求,然後報告作業成功還是失敗。使用 ValidateOnly 參數時,不會進行變更。

WhatIf

Optional

System.Management.Automation.SwitchParameter

WhatIf 參數會導致此命令模擬其結果。使用此參數,您不需認可變更,就能檢視這些變更。

BypassDualWrite

Optional

System.Boolean

PARAMVALUE: $true | $false

 
顯示: