Set-CsOnlineUMMailBox

 

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

Use the Set-CsOnlineUMMailBoxcmdlet to set the Unified Messaging (UM) properties for a user who is currently UM-enabled.

Set-CsOnlineUMMailBox -Identity <String> [-AirSyncNumbers <MultiValuedProperty>] [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AnonymousCallersCanLeaveMessages <$true | $false>] [-AutomaticSpeechRecognitionEnabled <$true | $false>] [-CallAnsweringAudioCodec <G711 | Wma | Gsm | Mp3>] [-CallAnsweringRulesEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <String>] [-FaxEnabled <$true | $false>] [-Force <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-ImListMigrationCompleted <$true | $false>] [-MissedCallNotificationEnabled <$true | $false>] [-Name <String>] [-OperatorNumber <String>] [-PhoneNumber <String>] [-PhoneProviderId <String>] [-PinlessAccessToVoiceMailEnabled <$true | $false>] [-PlayOnPhoneEnabled <$true | $false>] [-SendWelcomeMail <$true | $false>] [-SubscriberAccessEnabled <$true | $false>] [-TenantId <Guid>] [-TUIAccessToCalendarEnabled <$true | $false>] [-TUIAccessToEmailEnabled <$true | $false>] [-UMMailboxPolicy <String>] [-UMSMSNotificationOption <None | VoiceMail | VoiceMailAndMissedCalls>] [-VerifyGlobalRoutingEntry <SwitchParameter>] [-VoiceMailAnalysisEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

This example configures a UM-enabled user, tony@contoso.com with the following settings:

  • Changes the call answering audio codec to Wma

  • Disables call answering rules

  • Prevents him from receiving incoming faxes

  • Enables voice mail notifications but not missed call notifications using text messaging

Set-UMMailbox -Identity tony@contoso.com -TUIAccessToCalendarEnabled $false -TUIAccessToEmailEnabled $false

This example prevents the user tony@contoso.com from accessing his calendar and email when he's using UNRESOLVED_TOKEN_VAL(exOutlookNoVersionNoMk) Voice Access.

Set-UMMailbox -Identity tony@contoso.com -TUIAccessToCalendarEnabled $false -TUIAccessToEmailEnabled $false

The Set-UMMailbox cmdlet sets UM properties associated with a user who has been UM-enabled. Many of the UM properties for the user are stored on the user's mailbox, and other UM properties for the user are stored in UNRESOLVED_TOKEN_VAL(exADNoMk).

After this task is completed, the parameters and values specified are configured on the UM mailbox.

 

Parameter Required Type Description

Identity

Required

System.String

The Identity parameter specifies the user to enable for Unified Messaging. The values for this parameter include the following:

  • ADObjectID

  • GUID

  • Distinguished name (DN)

  • Domain\Account

  • User principal name (UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

AirSyncNumbers

Optional

Microsoft.Rtc.Management.ADConnect.Core.MultiValuedProperty

PARAMVALUE: MultiValuedProperty

AllowUMCallsFromNonUsers

Optional

Microsoft.Rtc.Management.Hosted.CloudVoice.ExUmUtils+AllowUMCallsFromNonUsersFlags

The AllowUMCallsFromNonUsers parameter specifies whether to exclude the mailbox from directory searches.

AnonymousCallersCanLeaveMessages

Optional

System.Boolean

The AnonymousCallersCanLeaveMessages parameter specifies whether diverted calls without a caller ID are allowed to leave a message.

AutomaticSpeechRecognitionEnabled

Optional

System.Boolean

The AutomaticSpeechRecognitionEnabled parameter specifies whether users can use Automatic Speech Recognition (ASR) when they log on to their mailbox. This parameter can only be set to $true if there is ASR support for the language selected by the user in UNRESOLVED_TOKEN_VAL(exCoNameNoMk)UNRESOLVED_TOKEN_VAL(exOutlookOnTheWeb)Options.

CallAnsweringAudioCodec

Optional

Microsoft.Rtc.Management.Hosted.CloudVoice.ExUmUtils+AudioCodecEnum

The CallAnsweringAudioCodec parameter specifies the audio codec used to encode voice mail messages left for the user. The audio codec used is the audio codec set on the UM dial plan. The default value is Mp3.

CallAnsweringRulesEnabled

Optional

System.Boolean

The CallAnsweringRulesEnabled parameter specifies whether users can configure or set up Call Answering Rules for their accounts. The default value is $true.

Confirm

Optional

System.Management.Automation.SwitchParameter

Confirm 參數會導致此命令暫停處理,並需要確認才能進行。

DomainController

Optional

System.String

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

FaxEnabled

Optional

System.Boolean

The FaxEnabled parameter specifies whether a user is allowed to receive incoming faxes.

Force

Optional

System.Management.Automation.SwitchParameter

PS_PD_Force_Desc

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

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

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

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

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

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

ImListMigrationCompleted

Optional

System.Boolean

The ImListMigrationCompleted parameter specifies whether the UM-enabled user's UNRESOLVED_TOKEN_VAL(exLyncNoVersion) or 商務用 Skype contact list is stored in their mailbox.

UNRESOLVED_TOKENBLOCK_VAL(PD_ImListMigrationCompleted)

MissedCallNotificationEnabled

Optional

System.Boolean

The MissedCallNotificationEnabled parameter specifies whether to send missed call notifications.

警告警告:
當您將整合通訊與 Lync Server或 商務用 Skype Server 整合時,信箱位於 Exchange 2010 信箱伺服器上的使用者,將無法使用未接來電通知。未接來電通知需於使用者在來電尚未傳送給信箱伺服器前中斷連接才可產生。

Name

Optional

System.String

The Name parameter specifies the display name for the user. The display name is limited to 64 characters.

OperatorNumber

Optional

System.String

The OperatorNumber parameter specifies the string of digits for the personal operator.

PhoneNumber

Optional

System.String

UNRESOLVED_TOKEN_VAL(PD_Cloud_Only_Parameter)

The PhoneNumber parameter specifies whether to assign a phone number to a UM-enabled user. This is only used for E.164 consumer dial plans.

PhoneProviderId

Optional

System.String

UNRESOLVED_TOKEN_VAL(PD_Cloud_Only_Parameter)

The PhoneProviderId parameter specifies the user's phone number and mobile service provider. This information is used to provide custom call forwarding and cancelling voice mail setup instructions based on the mobile phone provider.

PinlessAccessToVoiceMailEnabled

Optional

System.Boolean

The PinlessAccessToVoiceMailEnabled parameter specifies whether UM-enabled users are required to use a PIN to access their voice mail. A PIN is still required to access email and the calendar. The default value is $false.

PlayOnPhoneEnabled

Optional

System.Boolean

The PlayOnPhoneEnabled parameter specifies whether a user can use the Play on Phone feature to listen to voice messages. The default value is $true.

SendWelcomeMail

Optional

System.Boolean

SubscriberAccessEnabled

Optional

System.Boolean

The SubscriberAccessEnabled parameter specifies whether the users are allowed subscriber access to their individual mailboxes. If it's set to $true, after users are authenticated, they're able to retrieve voice mail over the telephone. The default value is $true.

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 參數主要是用於混合式部署。

TUIAccessToCalendarEnabled

Optional

System.Boolean

The TUIAccessToCalendarEnabled parameter specifies whether UM-enabled users can access and manage their individual calendar using the Microsoft UNRESOLVED_TOKEN_VAL(exOutlookNoVersionNoMk) Voice Access telephone user interface (TUI) or touchtone interface. The default value is $true.

TUIAccessToEmailEnabled

Optional

System.Boolean

The TUIAccessToEmailEnabled parameter specifies whether users can access their individual email messages over the telephone. The default value is $true.

UMMailboxPolicy

Optional

System.String

The UMMailboxPolicy parameter specifies the UM mailbox policy associated with the UM-enabled user's mailbox.

UMSMSNotificationOption

Optional

Microsoft.Rtc.Management.Hosted.CloudVoice.ExUmUtils+UMSMSNotificationOptions

The UMSMSNotificationOption parameter specifies whether a UM-enabled user gets SMS or text messaging notifications for voice mail only, voice mail and missed calls, or no notifications. The values for this parameter are: VoiceMail, VoiceMailAndMissedCalls, and None. The default value is None.

VerifyGlobalRoutingEntry

Optional

System.Management.Automation.SwitchParameter

UNRESOLVED_TOKEN_VAL(PD_Cloud_Only_Parameter)

The VerifyGlobalRoutingEntry parameter specifies the phone number has been successfully registered in the global routing database.

VoiceMailAnalysisEnabled

Optional

System.Boolean

The VoiceMailAnalysisEnabled parameter specifies whether a copy of each voice mail left for a UM-enabled user will be forwarded to Microsoft for analysis and improvement of speech recognition features.

WhatIf

Optional

System.Management.Automation.SwitchParameter

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

BypassDualWrite

Optional

System.Boolean

PARAMVALUE: $true | $false

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

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

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

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

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

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

SubscriberAccessEnabled

Optional

System.Boolean

 
顯示: