Set-PlaceV3

Set-PlaceV3 cmdlet을 사용하여 Places 디렉터리 내의 책상, 객실, 작업 영역, 구역, 바닥 또는 건물에 대한 메타데이터를 업데이트합니다.

구문

건물

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-Label]
 [-IsWheelChairAccessible]
 [-GeoCoordinates]
 [-Phone]
 [-Street]
 [-City]
 [-State]
 [-PostalCode]
 [-CountryOrRegion]
 [-ResourceLinks]

층

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-SortOrder]

섹션

섹션은 바닥 내의 공간 그룹화(예: 이웃)입니다. 책상과 작업 영역은 섹션에 부모로 지정되어야 합니다. 객실은 필요에 따라 섹션에 부모로 지정되거나 바닥에 직접 부모로 설정할 수도 있습니다.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]

책상

데스크는 Microsoft Places 새로 도입된 엔터티 유형으로, 개별 책상 단위를 나타냅니다. 각 책상에는 책상을 예약하는 방법을 지정하는 Mode 속성이 포함되어 있습니다. 자세한 내용은 아래 모드 섹션을 참조하세요.

Desk의 경우 다음과 같이 모드와 사서함 간에 몇 가지 종속성이 있습니다.

• Mode 속성이 정의되지 않은 경우 책상은 기본적으로 사용할 수 없음으로 설정되며 책상 사서함이 자동으로 만들어지지 않습니다.
• 예약 가능 또는 DropIn 모드로 설정된 데스크의 경우 책상 사서함이 필요합니다. 책상이 프로비전되면 자동으로 만들어집니다. 또는 Mailbox 매개 변수에서 EmailAddress를 지정하여 기존 사서함을 연결할 수 있습니다.
• 할당됨 또는 사용할 수 없는 모드의 데스크의 경우 사서함 연결은 선택 사항이며 기본적으로 사서함이 만들어지지 않습니다. 그러나 필요한 경우 이러한 책상을 사용자 지정 사서함과 수동으로 연결할 수 있습니다.
• 처음에 모드가 구성되지 않은 경우 데스크는 사용할 수 없는 모드로 유지됩니다. 나중에 사서함을 연결해도 책상 모드가 자동으로 업데이트되지는 않습니다.

회의실 또는 작업 영역 유형과 달리 책상은 단순히 사서함을 만들어 자동으로 프로비전되지 않습니다. 또한 용량 또는 DisplayName과 같은 메타데이터는 사서함 속성과 동기화되지 않습니다. 사서함은 주로 예약 엔진에서 사용되며 메타데이터는 Places 디렉터리에서 읽습니다.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-IsWheelChairAccessible]
 [-DisplayDeviceName]
 [-Tags]
 [-Mailbox]
 [-Mode]

Room

Set-PlaceV3 Exchange Set-Place cmdlet에서 이미 사용할 수 있는 레거시 위치 매개 변수를 지원합니다. 그러나 방이 매개 변수를 사용하여 -ParentId 바닥이나 건물에 연결되면 위치 세부 정보(Street 및 City)는 개별 회의실이나 작업 영역이 아닌 건물 수준에서 관리되어야 합니다.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]

작업 영역

Set-PlaceV3 Exchange Set-Place cmdlet에서 이미 사용할 수 있는 레거시 위치 매개 변수를 지원합니다. 그러나 작업 영역이 매개 변수를 사용하여 -ParentId 섹션에 연결되면 위치 세부 정보(Street 및 City)는 개별 회의실이나 작업 영역이 아닌 건물 수준에서 관리되어야 합니다.

작업 영역은 Mode 속성을 지원합니다. 동일한 세부 정보는 매개 변수 섹션에 Mode 설명되어 있습니다.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]
 [-Mode]

설명

Places 객실/작업 영역, 바닥 및 건물 간에 완전히 설정된 계층 구조에 따라 달라집니다. 건물과 바닥이 만들어지면 parentId를 사용하여 연결할 수 있습니다. 객실에는 부모 바닥 또는 구역이 있어야 합니다. 작업 영역 또는 책상에는 부모 섹션이 있어야 합니다. 섹션에는 부모 바닥이 있어야 합니다. 바닥에는 부모 건물이 있어야 합니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. Exchange 관리 역할 또는 Places TenantPlacesManagement 역할이 있어야 합니다.

예제

예 1

다음은 회의실, 바닥 및 건물에 대한 디렉터리 계층 구조를 설정하는 예제입니다.

이 예제에서 Floor의 PlaceId는 f12172b6-195d-4e6e-8f4f-eb72e41de99a이고 건물의 PlaceId는 daa2f89b-75c4-4eb7-adcc-ff249233338d입니다.

Set-PlaceV3 -Identity 'room@contoso.com' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ParentId daa2f89b-75c4-4eb7-adcc-ff249233338d

예 2

다음은 건물의 주소를 업데이트하는 예제입니다.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052

예 3

다음은 건물의 지리적 좌표를 업데이트하는 예제입니다.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -GeoCoordinates "47.644125;-122.122411"

예 4

이 예제에서는 리소스 링크를 사용하여 건물의 리소스 링크를 업데이트합니다. 업데이트 시 전체 집합이 대체됩니다. 값을 추가하거나 제거하려면 유지해야 하는 이전 값을 포함해야 합니다.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}

예 5

다음은 사서함 세부 정보를 지정하지 않고 섹션 아래에 예약 가능한 책상을 만드는 예제입니다. 책상 사서함이 자동으로 만들어지고 연결되고 MailboxOID 속성이 채워집니다. 책상은 Places Finder에 표시되며 누구나 예약할 수 있습니다.

$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Reservable Desk101' -Type Desk -ParentId $section.PlaceId -Mode @{Name='Reservable'}

예 6

다음은 모드 값을 DropIn 모드로 업데이트하는 예제입니다.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -Mode @{Name='DropIn'}

예 7

다음은 모드 값을 할당된 모드로 업데이트하는 예제입니다.

책상이 이미 할당된 모드 데스크인 경우에도 변경 내용은 메타데이터 필드일 뿐입니다. 완전히 새로운 모드 개체를 만들고 이전 모드 개체를 대체해야 합니다.

$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a Mode @{Name='Assigned';Metadata=$modemetadata}

매개 변수

-Identity

ID 매개 변수는 업데이트할 위치를 지정합니다. 장소를 고유하게 식별하는 모든 값을 사용할 수 있습니다.

예를 들어 사서함(회의실 및 작업 영역)을 기반으로 하는 장소의 경우:

• 이름 [사용되지 않음]
• 별칭 [사용되지 않음]
• 고유 이름(DN) [사용되지 않음]
• 정식 DN [사용되지 않음]
• GUID [사용되지 않음]
• 전자 메일 주소

예를 들어 사서함(건물, 바닥, 구역 및 책상)을 기반으로 하지 않는 장소의 경우:

• 이름
• GUID

-AudioDeviceName 및 -VideoDeviceName

이러한 매개 변수는 오디오의 이름과 회의실의 비디오 디바이스를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

기본값은 비워 두는 것입니다($null). 이 방에 오디오 또는 비디오 디바이스가 없음을 나타내려면 매개 변수에 대한 값 $null 사용합니다.

-건물

Building 매개 변수는 회의실이 있는 건물 이름 또는 건물 번호를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

-용량

Capacity 매개 변수는 회의실 또는 작업 영역의 용량을 지정합니다. 사용할 수 있는 값은 정수입니다.

-도시

City 매개 변수는 건물의 도시를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다. 최대 길이는 200자입니다.

-CountryOrRegion

CountryOrRegion 매개 변수는 건물의 국가 또는 지역을 지정합니다. 유효한 값은 유효한 ISO 3166-1 두 글자 국가 코드(예: 오스트레일리아의 경우 AU) 또는 해당 국가의 해당 식별 이름입니다(공식 ISO 3166 유지 관리 기관 짧은 이름과 다를 수 있음).

두 글자로 된 국가 코드에 대한 참조는 국가 코드 목록에서 사용할 수 있습니다.

-Label

Label 매개 변수는 해당 위치에 대한 설명이 포함된 레이블을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다. 최대 길이는 200자입니다.

회의실 및 작업 영역의 경우 명령은 Exchange Set-Place에서 -Label이라는 값을 업데이트합니다.

-DisplayDeviceName

DisplayDeviceName 매개 변수는 장소(회의실, 책상 또는 작업 영역)에 있는 디스플레이 디바이스의 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

기본값은 비워 두는 것입니다($null). 이 위치에 디스플레이 디바이스가 없음을 나타내려면 이 매개 변수에 대한 값 $null 사용합니다.

-FloorLabel

FloorLabel 매개 변수는 바닥의 설명 레이블을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

-층

Floor 매개 변수는 특정 건물 내의 바닥 정렬 순서를 지정합니다.

-GeoCoordinates

GeoCoordinates 매개 변수는 건물의 위치를 위도, 경도 및 (선택 사항) 고도 좌표로 지정합니다. 이 매개 변수의 유효한 값은 다음 형식 중 하나를 사용합니다.

• 위도 및 경도: 예를 들어 "47.644125;-122.122411"
• 위도, 경도 및 고도: 예를 들어 "47.644125;-122.122411; 161.432"

마침표 구분 기호가 작동하지 않는 경우 대신 쉼표 를 사용합니다.

-IsWheelChairAccessible

IsWheelChairAccessible 매개 변수는 장소가 휠체어에 액세스할 수 있는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

• $true: 휠체어를 이용할 수 있습니다.
• $false: 휠체어를 이용할 수 없습니다. 이 값은 기본값입니다.

-MTREnabled

MTREnabled 매개 변수는 Microsoft Teams 룸 시스템으로 구성된 회의실을 식별합니다. 회의실을 포함하는 Teams 모임에서 Teams 룸 시스템을 오디오 원본으로 추가할 수 있습니다. 유효한 값은 다음과 같습니다.

• $true: 객실에는 Teams 룸 시스템이 있습니다. 회의실 오디오를 사용하여 모임에 참가하도록 선택할 때 Teams 회의실 시스템을 Microsoft Teams 모임에 추가할 수 있습니다.
• $false: 회의실에는 Teams 룸 시스템이 없습니다. 사용자는 회의실 오디오를 사용하는 대신 PC 또는 모바일 장치 오디오를 사용하여 Teams 모임에 참가할 수 있습니다. 이 값은 기본값입니다.

Microsoft Teams 룸 대한 자세한 내용은 Microsoft Teams 룸 참조하세요.

-DisplayName

DisplayName 매개 변수는 장소의 표시 이름을 지정합니다. 최대 길이는 200자입니다. 연결된 SMTP 주소가 있는 회의실 또는 작업 영역 위치의 표시 이름을 업데이트하려면 장소 관리자, Exchange 관리자 또는 전역 관리 역할이 필요합니다.

-ParentId

ParentId 매개 변수는 Microsoft Places 부모 위치 계층 구조의 Place ID를 지정합니다. 객실에는 부모 바닥 또는 구역이 있어야 합니다. 작업 영역 또는 책상에는 부모 섹션이 있어야 합니다. 섹션에는 부모 바닥이 있어야 합니다. 바닥에는 부모 건물이 있어야 합니다.

-PostalCode

PostalCode 매개 변수는 건물의 우편 번호를 지정합니다.

-ResourceLinks

ResourceLinks 매개 변수는 식사 메뉴, 서비스 링크 또는 방문자 관리를 위한 Teams 앱 과 같이 이 건물에 연결해야 하는 외부 링크 또는 Teams 앱 ID를 지정합니다. Places 서비스를 설정하는 방법에 대한 자세한 내용은 Places 서비스를 참조하세요.

예제 4와 같이 값은 링크 배열로 제공되어야 합니다. 각 링크에는 이름, 값 및 형식 속성이 포함되어야 합니다. 예를 들어 링크는 @{name="TestLink"; value=https://contoso.com/"";; type="Url"}로 작성됩니다.

• 이름

  • 이 문자열은 링크 또는 앱 이름이 Places 앱에 표시되는 방법을 표시하는 데 사용됩니다.

  • 최대 길이는 200자입니다.

• 값

  • 이 값은 URL 링크 또는 Teams 앱 ID여야 합니다. Teams 앱 ID는 Teams 관리 센터의 앱 관리 페이지에서 앱의 앱 세부 정보 페이지에서 찾을 수 있습니다.

  • 최대 길이는 1,000자입니다.

• 형식 은 지원되는 형식 중 하나여야 합니다.

  • Url - URL 링크임을 나타냅니다.

  • MetaOsApp - 이 링크가 Teams 앱임을 나타냅니다.

-SortOrder

SortOrder 매개 변수는 바닥의 정렬 순서를 지정합니다. 예를 들어 바닥의 이름은 정렬 순서가 0인 "로비"로 지정하여 이 층을 순서가 지정된 목록에 먼저 표시할 수 있습니다.

-상태

State 매개 변수는 건물의 상태 또는 지방을 지정합니다. 최대 길이는 200자입니다.

-거리

Street 매개 변수는 건물의 실제 주소를 지정합니다. 최대 길이는 200자입니다.

-모드

Mode 매개 변수는 장소를 사용하거나 예약하는 방법을 정의합니다. 현재 모드는 책상과 책상 풀(작업 영역)에서만 사용할 수 있습니다.

현재 총 4개의 모드가 있습니다.

• 예약 가능- 예약 가능한 책상은 미리 예약하거나 현장에서 예약하도록 구성된 책상입니다.
• 드롭인- 데스크는 현장에서 사용할 수 있으며 사전에 예약할 수 없습니다. Microsoft Teams의 기능을 사용하여 이러한 책상에 있는 주변 장치를 디렉터리의 개별 데스크 개체에 연결할 수 있습니다.
• 할당됨 - 할당된 책상은 특정 사용자와 영구적으로 연결되며 다른 사용자가 예약할 수 없습니다. 할당된 모든 데스크에는 항상 지정된 사용자가 있어야 합니다.
• 사용할 수 없음- 유지 관리 또는 기타 이유로 인해 책상을 예약할 수 없습니다.

모드 값에는 예제 6과 같이 이름 및 메타데이터 속성이 포함되어야 합니다. 이름은 문자열이고 메타데이터는 사전 개체입니다.

• 이름: 이름 필드는 위치에 대한 활성 모드를 지정합니다. 열거형 값을 사용하며 사용 가능한 옵션은 장소 유형에 따라 다릅니다. 책상의 경우 지원되는 모드에는 , DropIn및 Unavailable가 Assigned 포함Reservable됩니다. 데스크 풀의 경우 지원되는 모드는 및 DropInUnavailable입니다Reservable.

• 메타데이터: 메타데이터 필드는 선택한 모드와 관련된 추가 정보를 저장하는 데 사용되는 사전입니다. 이 메타데이터는 특정 예약 시나리오와 관련된 비즈니스 논리를 지원합니다.

  • 예약 가능 및 DropIn 모드의 Places 메타데이터 필드를 지원하지 않습니다.
  • 사용할 수 없는 모드의 Places 책상을 Reason 사용할 수 없는 이유를 설명하는 필드(문자열)를 지원합니다. 값에는 새로 만든 책상과 Maintenance 서비스 진행 중인 Places 대한 값이 포함 New 됩니다.
  • 할당된 모드는 및 AssignedPersonId의 두 메타데이터 필드를 AssignedPersonEmailAddress 지원합니다. 이러한 사용자는 책상에 할당된 사용자를 식별합니다. 두 필드 중 하나를 제공하면 할당된 모드를 사용하도록 설정할 수 있습니다.

-태그

Tags 매개 변수는 회의실의 추가 기능(예: 보기 유형 또는 가구 유형과 같은 세부 정보)을 지정합니다. 현재 최대 길이는 없습니다.

여러 레이블을 쉼표로 구분하여 지정할 수 있습니다. 레이블에 공백이 포함된 경우 값을 따옴표 "Label 1","Label 2",..."Label N"로 묶습니다.

문제 해결

사용 권한 거부 오류를 수신하고 있습니다.

Set-PlaceV3 TenantPlacesManagement, GlobalAdmin 또는 MailRecepients 역할 중 하나가 필요합니다. 역할은 다양한 방법으로 할당할 수 있으므로 역할 권한을 할당하는 지원되는 방법은 다음과 같습니다.

• Exchange 관리 센터를 통해 권한이 할당된 경우(영구 권한만 지원) Places cmdlet을 사용하는 데 아무런 문제가 없어야 합니다. 사용 권한 거부 오류가 표시될 것으로 예상되지 않습니다.
• Entra를 통해 사용자에게 직접 권한을 할당하는 경우(영구 역할 또는 임시 역할) Places cmdlet을 사용하는 데 아무런 문제가 없어야 합니다. 사용 권한 거부 오류가 표시될 것으로 예상되지 않습니다. 그러나 Entra와 Exchange 간의 동기화가 다소 지연될 수 있습니다.
• Entra를 통해 사용자가 속한 Entra의 그룹에 권한이 할당되면 Exchange에서 지원되지 않으며 역할 간 그룹은 존중되지 않습니다. Exchange cmdlet 및 Places cmdlet은 모두 사용 권한이 거부되어 실패합니다. 이 예상 동작은 여기에 설명되어 있습니다.

리소스에 ParentId를 할당했지만 Places Finder에서 아직 표시되지 않습니다.

리소스와 해당 부모 Floor 간의 상관 관계가 Places 환경에 표시되는 데 최대 24시간이 걸릴 수 있습니다. 이 지연을 제거하기 위해 노력하고 있습니다.

리소스에 사진을 설정할 어떻게 할까요? 있나요?

이 Set-UserPhoto 2024년 4월에 더 이상 사용되지 않습니다 . Set-PlaceV3을 사용할 때 이 cmdlet에 매개 변수를 추가하여 회의실 및 작업 영역에서 사진을 설정하는 작업을 진행 중입니다. 그 동안 방이나 작업 영역에서 사진을 설정하는 다음 지침을 따르세요.

현재 건물이나 바닥에 사진을 설정할 수 없습니다.