Get-CsOnlineUMMailBox

 

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

Use the Get-CsOnlineUMMailBox cmdlet to view existing mailboxes that are Unified Messaging (UM) enabled.

Get-CsOnlineUMMailBox [-AccountPartition <String>] [-Anr <String>] [-Credential <PSCredential>] [-DomainController <String>] [-Filter <String>] [-Force <SwitchParameter>] [-Identity <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <String>] [-OrganizationalUnit <String>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Int32>] [-SortBy <String>] [-TenantId <Guid>]

This example displays a summary list of all the UM-enabled mailboxes in your organization

Get-UMMailbox

This example displays detailed information for the UM-enabled mailbox for tonysmith@contoso.com.

Get-UMMailbox -Identity tonysmith@contoso.com | Format-List

Use the Get-CsOnlineUMMailBox cmdlet to view existing mailboxes that are Unified Messaging (UM) enabled.

 

Parameter Required Type Description

AccountPartition

Optional

System.String

Anr

Optional

System.String

Anr 參數會指定用來執行模糊名稱解析 (ANR) 搜尋的字串。您可以指定部分字串,然後搜尋屬性符合該字串的物件。搜尋的預設屬性如下:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Optional

System.Management.Automation.PSCredential

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

Credential 參數會指定用來執行此命令的使用者名稱和密碼。通常您會在指令碼中使用此參數,或在您必須提供具有必要權限的其他認證時使用此參數。

此參數需要建立及傳遞認證物件。此認證物件是透過使用 Get-Credential Cmdlet 來建立。如需詳細資訊,請參閱 Get-Credential

DomainController

Optional

System.String

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

Filter

Optional

System.String

Filter 參數會指出用來篩選收件者的 OPath 篩選器。

如需可篩選屬性的相關資訊,請參閱Filterable Properties for the -Filter Parameter

Force

Optional

System.Management.Automation.SwitchParameter

Identity

Optional

System.String

The Identity parameter specifies the UM-enabled mailbox that you want to view. You can use any value that uniquely identifies the mailbox.

例如:

  • 名稱

  • 顯示名稱

  • 別名

  • 辨別名稱 (DN)

  • 標準 DN

  • <domain name>\<account name>

  • 電子郵件地址

  • GUID

  • LegacyExchangeDN

  • SamAccountName

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

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

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

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

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

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

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

Organization

Optional

System.String

OrganizationalUnit

Optional

System.String

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

OrganizationalUnit 參數會依據物件在 UNRESOLVED_TOKEN_VAL(exADNoMk) 中的位置來篩選結果。系統只會傳回存在於指定位置的物件。這個參數的有效輸入是可使用 Get-OrganizationalUnit Cmdlet 查看的組織單位 (OU) 或網域。您可以使用唯一識別 OU 或網域的任何值。例如:

  • 名稱

  • 正式名稱

  • 辨別名稱 (DN)

  • GUID

ReadFromDomainController

Optional

System.Management.Automation.SwitchParameter

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

ReadFromDomainController 參數會指定應從使用者網域的網域控制站讀取的資訊。如果您執行 Set-AdServerSettings -ViewEntireForest $true 以包含樹系中的所有物件,而且如果您不使用 ReadFromDomainController 參數,則可能會從含有過時資訊的通用類別目錄讀取資訊。當您使用 ReadFromDomainController 參數時,可能需要多次讀取才能取得資訊。您不需要指定此參數的值。

註記注意事項:
依預設,收件者範圍會設為主控您的 UNRESOLVED_TOKEN_VAL(exExchangeNoVersion) 伺服器之網域。

ResultSize

Optional

System.Int32

指定此 Cmdlet 所傳回的記錄筆數。結果大小可以設為 0 和 2147483647 (含) 之間的任何數字。如果設為 0,命令會執行,但不會傳回資料。

SortBy

Optional

System.String

SortBy 參數會指定排序結果依據的屬性。您一次只能依據一個屬性進行排序。結果會以遞增順序排序。

如果預設檢視未包含排序依據的屬性,您可以在命令中附加 | Format-Table -Auto <Property1>,<Property2>... 來建立新檢視,以納入所有要查看的屬性。支援在屬性名稱中使用萬用字元 (*)。

You can sort by the following properties:

  • Name

  • DisplayName

  • ServerLegacyDN

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

BypassDualWrite

Optional

System.Boolean

PARAMVALUE: $true | $false

 
顯示: