다음을 통해 공유

New-Place

  • 아티클

New-Place cmdlet을 사용하여 Places 디렉터리 내에 건물, 바닥, 구역 또는 책상을 만듭니다.

참고

회의실 또는 작업 영역을 만들려면 여기에 설명된 New-Mailbox cmdlet을 계속 사용해야 합니다 .

구문

건물

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-PostalCode]
 [-CountryOrRegion]
 [-State]
 [-City]
 [-Street]
 [-GeoCoordinates]
 [-ResourceLinks]
 [-Tags]

층

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-SortOrder]
 [-Tags]

섹션

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

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]

책상

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

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

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-GeoCoordinates]
 [-Mailbox]

설명

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

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

주의

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

예제

예 1

이 예제에서는 해당 건물 내에 새 건물과 바닥을 만듭니다.

New-Place -Type Building -Name 'Building 3'

빌드 3을 성공적으로 만든 후 바닥에 ParentId를 설정할 때 사용할 PlaceId를 읽어보세요.

New-Place -Type Floor -Name 'Lobby' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
New-Place -Type Floor -Name '1' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a

예 2

이 예제에서는 주소 정보를 사용하여 새 건물을 만듭니다.

New-Place -Name 'Building 3' -Type Building -Description 'Building 3 in North of Redmond Campus' -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052

예 3

이 예제에서는 리소스 링크가 있는 새 건물을 만듭니다.

New-Place -Name 'Building 3' -Type Building -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}'

예 4

다음은 바닥으로 연결된 섹션을 만든 다음, 책상 사서함을 만들어 기존 책상 엔터티에 할당하는 예제입니다. 이 샘플 스크립트를 ExchangeOnlineManagement 실행하기 전에 모듈을 Connect-ExchangeOnline 설치하고 cmdlet을 실행합니다.

$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Desk101' -Type Desk -ParentId $section.PlaceId -Mailbox $mbx.Alias

매개 변수

-도시

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

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

-CountryOrRegion

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

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

주소 정보는 Places 탐색 페이지에서 주변 건물을 표시하는 데 사용됩니다.

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

-Label

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

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

-GeoCoordinates

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

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

참고

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

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

-DisplayName

DisplayName 매개 변수는 장소의 표시 이름을 지정합니다. 최대 길이는 200자입니다.

건물의 표시 이름이 표시됩니다.

  • Outlook에서 사용자가 작업 시간과 위치를 설정할 때 건물을 선택할 수 있습니다.
  • Places 탐색 페이지에서 동일한 건물, 인근 건물 등에 누가 있는지 보여 줍니다.
  • Places Finder에서 회의실 또는 작업 영역을 검색할 때 필터로 사용할 수 있습니다.

회의실 또는 작업 영역을 검색할 때 바닥의 표시 이름은 Places Finder에 필터로 표시됩니다.

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

-ParentId

ParentId 매개 변수는 Microsoft Places 부모 위치 계층 구조의 Place ID를 지정합니다.

  • 객실에는 부모 바닥 또는 구역이 있어야 합니다.
  • 작업 영역 또는 책상에는 부모 섹션이 있어야 합니다.
  • 섹션에는 부모 바닥이 있어야 합니다.
  • 바닥에는 부모 건물이 있어야 합니다.

참고

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

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

-PostalCode

PostalCode 매개 변수는 건물의 우편 번호를 지정합니다. 최대 길이는 200자입니다.

특성 설명
유형: 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 관리 센터의 앱 관리 페이지에서 앱의 앱 세부 정보 페이지에서 찾을 수 있습니다.
    • 최대 길이는 1000자입니다.
  • 형식 은 지원되는 형식 중 하나여야 합니다.
    • Url - URL 링크임을 나타냅니다.
    • MetaOsApp - 이 링크가 Teams 앱임을 나타냅니다.

참고

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

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

-SortOrder

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

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

-상태

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

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

-거리

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

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

-태그

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

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

참고

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

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

-형

Type 매개 변수는 생성되는 위치의 형식을 지정합니다. 유효한 값은 다음과 같습니다.

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