Get-Place
This cmdlet is available only in the cloud-based service.
Use the Get-Place cmdlet to view the additional metadata that was configured on room mailboxes by using the Set-Place cmdlet. The additional metadata provides a better search and room suggestion experience.
For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.
Syntax
Identity
Get-Place
[[-Identity] <RecipientIdParameter>]
[-Confirm]
[-ResultSize <Unlimited>]
[-WhatIf]
[<CommonParameters>]
AllPlaces
Get-Place
[-Type <GetPlaceType>]
[-Confirm]
[-ResultSize <Unlimited>]
[-WhatIf]
[<CommonParameters>]
Description
You need to be assigned permissions before you can run this cmdlet. Although this article lists all parameters for the cmdlet, you might not have access to some parameters if they aren't included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see Find the permissions required to run any Exchange cmdlet.
Examples
Example 1
Get-Place -Identity "Conference Room 01"
This example returns summary metadata for the room mailbox named Conference Room 1.
Example 2
Get-Place -Identity "Conference Room 01" | Format-List
This example returns detailed metadata for Conference Room 1.
Example 3
Get-Place -Type Room
This example returns all room mailboxes.
Parameters
-Confirm
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
Type: | SwitchParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | cf |
Parameter sets
(All)
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-Identity
Applicable: Exchange Online
The Identity parameter specifies the room mailbox that you want to view. You can use any value that uniquely identifies the room. For example:
- Name
- Alias
- Distinguished name (DN)
- Canonical DN
- Email address
- GUID
You can't use this parameter with the Type parameter.
Parameter properties
Type: | RecipientIdParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
Identity
Position: | 0 |
Mandatory: | False |
Value from pipeline: | True |
Value from pipeline by property name: | True |
Value from remaining arguments: | False |
-ResultSize
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
Type: | Unlimited |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
(All)
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-Type
Applicable: Exchange Online
The Type parameter filters the results by the type of room mailbox. Valid values are:
- Room
- RoomList
- Space
You can't use this parameter with the Identity parameter.
Parameter properties
Type: | GetPlaceType |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
AllPlaces
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-WhatIf
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
Type: | SwitchParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | wi |
Parameter sets
(All)
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.