19.1 Get-DRAOnlineMailbox

Synopsis

Gets properties of a specified shared mailbox or a list of online sharedmailboxes in Exchange Online.

Syntax

Get-DRAOnlineMailbox -Tenant <String> [-OnlineSharedMailboxAndFilter
<Hashtable>] [-OnlineSharedMailboxOrFilter <Hashtable>] [-Identifier
<String>] [-Attributes <String[]>] [-PowersForOperations <String[]>] [-
VisiblePropertiesOnly <SwitchParameter>] [-EnforceServerLimit
<SwitchParameter>] [-ObjectsPerResponse <Int32>] [-ResumeString <String>]
[-DRARestServer <String>] [-DRARestPort <Int32>] [-IgnoreCertificateErrors
<SwitchParameter>] [-Force <SwitchParameter>] [-Timeout <Int32>]
[<CommonParameters>]

Description

The Get-DRAOnlineMailbox cmdlet retrieves one or more online shared mailboxes from Exchange Online. You can view the default list of attributes or specify specific attributes.Refer to the examples for details on how to view specific attributes.

Parameter

Attribute / Description	Parameters / Values
Attribute / Description	Required	Position	Default Value	Accept Pipeline input?	Accept wildcard characters?
OnlineSharedMailboxAndFilter[<Hashtable>] The attributes to use for searching online shared mailbox objects. Online shared mailbox matching all of the listed attributes will be returned.	false	named		true (ByPropertyName)	false
OnlineSharedMailboxOrFilter[<Hashtable>] The attributes to use for searching online shared mailbox objects. Online shared mailboxes matching any of the listed attributes will be returned.	false	named		true (ByPropertyName)	false
Identifier [<String>] The GUID or UPN of the Entra ID user. When the Identifier is a UPN, the Tenant parameter will be ignored.	false	named		true (ByPropertyName)	false
Tenant <String> The Tenant ID of the object in GUID or displayname format. For example: b201dhg8-087e-5n9d-9986-c4d987bfa0b1 or MyTenant.	false	named		true (ByPropertyName)	false
Attributes [<String[]>] An array of attributes to retrieve specific values. If this parameter is missing, a default list of attributes is returned.	false	named		true (ByPropertyName)	false
PowersForOperations [<String[]>] An array of DRA operation names for which you want the server to return read/write permission information. This parameter is typically used by a UI-based client to hide or disable elements the calling user doesn't have powers for. The PowersForOperations parameter is applicable only if you have specified the Identifier parameter.	false	named		true (ByPropertyName)	false
VisiblePropertiesOnly [<SwitchParameter>] A flag to indicate whether DRA should return only properties the caller has powers to view. By default, DRA will return an error if the caller requests a property that they do not have powers to view. By specifying this flag DRA is instructed to not return an error and instead just not return a value for such attributes.	false	named		false	false
EnforceServerLimit [<SwitchParameter>] A switch parameter indicates that the search results should be limited by the search result limit on the DRA Server. The typical server limit is 1000 items. The default is true.	false	named		false	false
ObjectsPerResponse [<Nullable`1>] The number of objects to return in a response. The default is 250.	false	named		false	false
ResumeString [<String>] This parameter indicates the last item returned from the server when multiple responses are needed to return all the search results to the client. The value of this parameter is set using the ResumeString property from the previous set of results. The ResumeString looks like: "CN=MYUser160,CN=Users, DC=MyDomain,DC=corp"The EnforceServerLimit, ObjectsPerResponse, and ResumeString parameters are applicable only when the Identifier parameter is not specified.	false	named		false	false
DRARestServer [<String>] The name of the computer running the DRA REST Service. The requested DRA operation will execute on this server. If the parameter is not specified, the value defaults to 'localhost'.	false	named		true (ByPropertyName)	false
DRARestPort [<Int32>] The port where the DRA REST Service listens for requests. This parameter is used only when the DRARestServer parameter is also specified. If the parameter is not specified, the value defaults to 8755	false	named	8755	true (ByPropertyName)	false
IgnoreCertificateErrors [<SwitchParameter>] Allows the request to bypass any SSL certificate errors, such as the InvalidOperation error that occurs when the REST Service is bound to a self-signed certificate.	false	named		false	false
Force [<SwitchParameter>] Suppresses any request for user input and supplies a 'yes' response. For example: -Force with a delete request will perform the delete without presenting the confirmation request to the user.	false	named		false	false
Timeout [<Int32>] The wait time in seconds before the request to the DRA REST server times out. To specify an infinite timeout, you can set this parameter to -1.	false	named	100 seconds	true (ByPropertyName)	false
<CommonParameters> Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information see

NOTE:For more information, type "Get-Help Get-DRAOnlineMailbox -detailed". For technical information, type "Get-Help Get-DRAOnlineMailbox -full".

Example 19-1 1

PS C:\\>Get-DRAOnlineMailbox -Tenant b201dhg8-087e-5n9d-9986-c4d987bfa0b1
-OnlineSharedMailboxOrFilter @{Name="PF*"} -ObjectsPerResponse 50

PS C:\\>Get-DRAOnlineMailbox -Tenant b201dhg8-087e-5n9d-9986-c4d987bfa0b1
-OnlineSharedMailboxOrFilter @{Name="PF*"} -ObjectsPerResponse 50 -
ResumeString "CN=770DF55D-062B-4115-A8AF-A6A865A4BA00,AZ=b201dhg8-087e-
5n9d-9986-c4d987bfa0b1\"

In this example, DRA searches the tenant "b201dhg8-087e-5n9d-9986-c4d987bfa0b1" for online shared mailboxes with a name attribute starting with "PF". The server will return a maximum of 50 items in the response. If there are more objects than the number specified in ObjectsPerResponse, the ResumeString will be returned, which can be used in a subsequent call to retrieve the next set of objects. The next line in this example demonstrates how to use the ResumeString in the subsequent call.

Example 19-2 1

PS C:\\>Get-DRAOnlineMailbox -Tenant MyTenant -OnlineSharedMailboxOrFilter
@{MultiMatch="SCH"}

In this example, a filtered search will be conducted using "SCH" with Multimatch.