Set-PlaceV3

아티클
10/30/2024

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

참고

회의실에 업데이트 & 작업 영역을 반영하는 데 최대 24시간이 걸릴 수 있습니다. 여러 회의실 및 작업 영역을 온보딩해야 하는 경우 변경 내용을 즉시 반영하도록 강제 적용할 수 있는 를 사용하는 Initialize-Places것이 좋습니다.
이 Set-UserPhoto 2024년 4월에 더 이상 사용되지 않습니다 . Set-PlaceV3을 사용할 때 이 cmdlet에 매개 변수를 추가하여 회의실 및 작업 영역에서 사진을 설정하는 작업을 진행 중입니다. 그 동안 다음 지침 에 따라 방이나 작업 영역에서 사진을 설정합니다.

구문

건물

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

층

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

섹션

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

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

책상

책상은 개별 책상을 나타내는 Places 새로운 엔터티 유형입니다. 이러한 개체는 예약 가능하거나 예약할 수 없음(기본값)일 수 있습니다.

책상을 예약할 수 있도록 하려면 Desk 사서함을 만들고 사서함을 의 Set-PlaceV3매개 변수에 전달 Alias 하여 Desk 개체와 연결해야 합니다Mailbox. 회의실/작업 영역 유형과 달리 사서함만 만들어 책상을 암시적으로 프로비전하지 않습니다. 또한 메타데이터(예: Capacity 또는 DisplayName 필드)는 사서함 메타데이터와 동기화되지 않습니다. 사서함은 주로 예약 엔진에만 필요하며 메타데이터는 Places 디렉터리에서 읽습니다.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-Name]
 [-Tags]
 [-Mailbox]

회의실 또는 작업 영역

Set-PlaceV3 Exchange Set-Place cmdlet에 이미 노출된 레거시 위치 매개 변수를 지원합니다. 그러나 일단 방이 매개 변수를 사용하여 -ParentId 바닥/건물에 연결되면 위치 정보(Street, City등)는 회의실이나 작업 영역이 아닌 건물에서 관리해야 합니다.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Street]
 [-City]
 [-State]
 [-PostalCode]
 [-CountryOrRegion]
 [-Building]
 [-Floor]
 [-FloorLabel]
 [-Tags]

설명

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

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

주의

PowerShell cmdlet에서 추가 매개 변수를 찾을 수 있지만 현재 지원되지 않습니다. 이 페이지에 문서화되지 않은 매개 변수는 사용하지 않는 것이 좋습니다.

예제

예 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

다음은 책상 사서함을 만들어 기존 데스크 엔터티에 할당하는 예제입니다. 다음을 실행하기 전에 모듈을 ExchangeOnlineManagement 설치하고 cmdlet을 Connect-ExchangeOnline 실행해야 합니다.

$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
Set-PlaceV3 {DeskId} -Mailbox $mbx.Alias

매개 변수

-Identity

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

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

이름
별칭
DN(고유 이름)
DN(고유 이름)
정식 DN
GUID

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

이름
GUID

특성	설명
유형:	RecipientIdParameter
위치:	0
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	True
와일드카드 문자 허용:	거짓

-AudioDeviceName, -DisplayDeviceName 및 VideoDeviceName

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

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

특성	설명
유형:	String
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-건물

중요

빌드 매개 변수는 사용되지 않으며 이전 버전과의 호환성을 위해서만 여기에 제공됩니다. 건물 정보는 회의실 또는 작업 영역의 부모 체인에 있는 건물 엔터티에서 읽습니다.

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

특성	설명
유형:	String
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-용량

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

특성	설명
유형:	System.Int32
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-도시

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

회의실/작업 영역이 아닌 건물의 위치 데이터를 관리하는 것이 좋습니다. 객실 사이에는 층 ->> 건물 및 객실 사이에 계층 구조가 있으며 객실은 건물의 위치 특성을 상속합니다.

특성	설명
유형:	String
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-CountryOrRegion

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

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

특성	설명
유형:	CountryInfo
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-Label

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

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

특성	설명
유형:	String
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	True
와일드카드 문자 허용:	거짓

-DisplayDeviceName

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

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

특성	설명
유형:	String
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-FloorLabel

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

특성	설명
유형:	String
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-층

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

특성	설명
유형:	System.Int32
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-GeoCoordinates

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

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

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

회의실/작업 영역이 아닌 건물의 위치 데이터를 관리하는 것이 좋습니다. 객실 사이에는 층>-> 건물, 그리고 방은 건물의 위치 특성을 상속하는 계층 구조가 있습니다.

특성	설명
유형:	GeoCoordinates
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-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자입니다. Set-PlaceV3 건물 및 바닥과 같은 연결된 SMTP 주소가 없는 장소의 이름만 업데이트할 수 있습니다. 회의실 및 작업 영역과 같은 연결된 SMTP 주소가 있는 장소의 표시 이름을 업데이트하려면 Exchange Set-Mailbox cmdlet을 사용합니다.

특성	설명
유형:	String
기본값:	없음
필수:	True
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-ParentId

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

참고

Outlook Roomfinder와의 이전 버전과의 호환성이 필요한 경우 회의실을 바닥 엔터티로 양육하는 동시에 "Floor"/"FloorLabel" 속성도 업데이트해야 합니다. Places Finder는 새 계층 구조를 사용하고 Outlook Roomfinder는 레거시 "Floor" 및 "FloorLabel" 개체를 사용하기 위해 연결됩니다. 또한 Outlook에서 회의실 찾기에 대한 회의실 및 작업 영역 구성에 설명된 대로 회의실이 회의실 목록과 연결되어 있는지 확인해야 합니다.

특성	설명
유형:	String
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-PostalCode

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

특성	설명
유형:	String
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-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인 "로비"로 지정하여 이 층을 순서가 지정된 목록에 먼저 표시할 수 있습니다.

특성	설명
유형:	System.Int32
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-상태

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

회의실/작업 영역이 아닌 건물의 위치 데이터를 관리하는 것이 좋습니다. 객실 사이에는 층> -> 건물, 그리고 방은 건물의 위치 특성을 상속하는 계층 구조가 있습니다.

특성	설명
유형:	String
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-거리

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

특성	설명
유형:	String
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

-태그

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

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

참고

업데이트 시 전체 집합이 대체됩니다. 값을 추가하거나 제거하려면 유지해야 하는 이전 값을 포함해야 합니다.

특성	설명
유형:	String
위치:	명명 된
기본값:	없음
필수:	거짓
파이프라인 입력 수락:	거짓
와일드카드 문자 허용:	거짓

문제 해결

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

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에 매개 변수를 추가하여 회의실 및 작업 영역에 사진을 설정하는 작업을 진행 중입니다. 그 동안 방이나 작업 영역에서 사진을 설정하는 다음 지침을 따르세요.

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

다음을 통해 공유