Get-PlaceV3

Get-PlaceV3 コマンドレットを使用して、Places ディレクトリ内の会議室、ワークスペース、建物、フロア、セクション、またはデスクに構成されているメタデータを表示します。

構文

Get-PlaceV3
   [-Identity]
   [-AncestorId]
   [-Type]

説明

このコマンドレットを実行するために必要なアクセス許可が必要です。 TenantPlacesManagement アクセス許可Places、管理者ロール、Exchange 管理者ロール、またはカスタム ロールを使用できます。

例

例 1

次の使用例は、smtp アドレス識別子を使用して会議室またはワークスペースを返します。

Get-PlaceV3 -Identity smtp@domain.com

例 2

次の使用例は、特定の型のすべての場所を返します。

Get-PlaceV3 -Type Building

例 3

次の使用例は、場所の名前と型に基づいて PlaceId を返します。

Get-PlaceV3 -Type Building | Where-Object -Property DisplayName -eq 'Pine Valley' | fl PlaceId

例 4

次の使用例は、先祖が特定の場所であるすべての場所を返します。

Get-PlaceV3 -AncestorId 86897e93-bcef-4c05-af9d-45116dda791f 

パラメーター

-Identity

ID パラメーターは、表示する場所を指定します。 場所を一意に識別する任意の値を使用できます。

たとえば、メールボックス (会議室とワークスペース) に基づく場所の場合は、次のようになります。

• 名前 [非推奨]
• エイリアス [非推奨]
• 識別名 (DN) [非推奨]
• 正規 DN [非推奨]
• GUID [非推奨]
• 電子メール アドレス

たとえば、メールボックス (建物、フロア、セクション、デスク) に基づいていない場所の場合は、次のようになります。

• Name_PlaceId
• PlaceId

このパラメーターを Type パラメーターと共に使用することはできません。

-AncestorId

AncestorId パラメーターは、場所の guid を指定します。 指定した場所が見つかった場合は、ディレクトリ階層内のこの場所の下にあるすべての場所が返されます。 たとえば、建物の PlaceId が AncestorId として提供されている場合、コマンドはディレクトリ階層でその建物の下にあるすべてのフロア、セクション、部屋、デスク プール (ワークスペース) とデスクを返します。

-Type

Type パラメーターは、表示する場所の型を指定します。 有効な値は次のとおりです。

• Room
• RoomList
• スペース
• 建物
• Floor
• Section
• 机

このパラメーターを Identity パラメーターと共に使用することはできません。