다음을 통해 공유

New-Place

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

참고

  • 최신 기능 및 개선 사항에 액세스하려면 Places PowerShell 버전 2.0.0 이상으로 업데이트합니다.

구문

건물

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]

Room

회의실을 만들면 연결된 사서함이 자동으로 프로비전됩니다. Mailbox 매개 변수에 EmailAddress를 제공하는 경우 해당 이름으로 새 사서함이 만들어지고 회의실에 연결됩니다.

참고

  • 회의실 사서함을 자동으로 만들려면 Places 관리자, Exchange 관리자 또는 전역 관리자 역할 중 하나가 필요합니다.
  • 프로비전하는 데 최대 24시간이 걸릴 수 있습니다. 짧은 지연을 허용하여 모든 리소스가 완전히 설정되고 작동되도록 합니다.
  • 회의실을 만들려면 권장되지 않지만 여기에 설명된 대로 New-Mailbox cmdlet을 계속 사용할 수 있습니다. Places 사서함 메타데이터 및 연결된 회의실과 24시간 이내에 동기화됩니다.
  • 회의실에 연결한 후에는 사서함 리소스 유형을 변경하지 마세요 . 리소스 유형 불일치로 인해 회의실에 대한 업데이트 실패합니다.
New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-Capacity]

작업 영역

작업 영역(책상 풀)을 만들면 연결된 사서함이 자동으로 프로비전됩니다. Mailbox 매개 변수에 EmailAddress를 제공하는 경우 해당 이름으로 새 사서함이 만들어지고 작업 영역에 연결됩니다.

참고

  • 작업 영역 사서함을 자동으로 만들려면 Places 관리자, Exchange 관리자 또는 전역 관리자 역할 중 하나가 필요합니다.
  • 프로비전하는 데 최대 24시간이 걸릴 수 있습니다. 짧은 지연을 허용하여 모든 리소스가 완전히 설정되고 작동되도록 합니다.
  • 작업 영역을 만들려면 권장되지는 않지만 여기에 설명된 대로 New-Mailbox cmdlet을 계속 사용할 수 있습니다.
  • 생성 직후에 형식을 작업 영역으로 설정합니다. Places 사서함 메타데이터 및 연결된 작업 영역과 24시간 이내에 동기화됩니다. - 사서함 리소스 유형을 작업 영역/책상 풀에 연결한 후에는 변경하지 마세요 . 리소스 유형 불일치로 인해 회의실에 대한 업데이트 실패합니다.
New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-Capacity]

책상

책상은 개별 책상 단위를 나타냅니다. 각 데스크에는 사용할 수 있는 방법을 정의하는 Mode 속성이 있습니다.

  • 예약 가능 – 미리 예약할 수 있습니다.
  • 드롭인 – 즉석에서만 사용할 수 있습니다.
  • 할당 됨 – 특정 사용자에게 할당됩니다.
  • 사용할 수 없음 – 예약에 사용할 수 없습니다.

데스크 모드 및 사서함은 다음과 같이 작동합니다.

  • 기본 동작: 모드가 정의되지 않은 경우 책상은 기본적으로 사용할 수 없음으로 설정됩니다. 사서함이 만들어지지 않습니다.
  • 예약 가능 또는 DropIn 모드: 책상 사서함이 필요합니다. 책상이 프로비전되거나 기존 책상에 연결할 수 있을 때 자동으로 만들어집니다.
    • Mailbox 매개 변수에 기존 EmailAddress를 제공하는 경우 데스크는 해당 사서함에 연결됩니다.
    • 존재하지 않는 EmailAddress를 제공하는 경우 해당 이름으로 새 사서함이 만들어지고 책상에 연결됩니다.
    • EmailAddress가 제공되지 않으면 사서함이 시스템 생성 이름으로 자동으로 만들어지고 책상에 연결됩니다.
  • 할당되거나 사용할 수 없는 모드: 사서함 연결은 선택 사항이며 사서함이 만들어지지 않습니다. 그러나 필요한 경우 이러한 책상을 사용자 지정 사서함과 수동으로 연결할 수 있습니다.
  • 나중에 모드 변경: 책상이 사용할 수 없는 모드에서 시작되고 사서함이 연결되지 않은 경우 Set-PlacesV3 cmdlet을 사용하여 책상을 예약 가능으로 전환하면 사서함이 자동으로 만들어지고 연결됩니다. 그러나 사서함을 책상에 연결해도 책상 모드가 자동으로 업데이트되지는 않습니다.

회의실 또는 작업 영역과 달리 책상은 용량 또는 DisplayName과 같은 메타데이터를 사서함 속성과 동기화하지 않습니다. 사서함은 주로 예약 엔진에서 사용되며 메타데이터는 Places 디렉터리에서 읽습니다.

참고

  • 책상 사서함을 자동으로 만들려면 Places 관리자, Exchange 관리자 또는 전역 관리자 역할 중 하나가 필요합니다.
  • 기존 사서함에 연결하려면 해당 리소스 종류가 Desk여야 합니다.
  • 새 사서함을 만드는 경우 만든 직후에 리소스 유형을 Desk로 설정합니다.
  • 사서함 유형을 회의실 또는 작업 영역으로 설정하지 마세요.
  • 사서함 리소스 유형을 책상에 연결한 후에 는 변경하지 마세요 . 리소스 유형 불일치로 인해 책상에 업데이트 실패합니다.
New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-GeoCoordinates]
 [-Mailbox]
 [-Mode]

설명

Microsoft Places 건물, 바닥, 구역, 객실, 작업 영역 및 책상에 대한 완전한 계층 구조가 필요합니다.

  • 바닥은 건물에 속해야 합니다.
  • 구역은 바닥에 속해야 합니다.
  • 객실은 바닥 또는 구역에 속해야 합니다.
  • 작업 영역 또는 책상은 섹션에 속해야 합니다.

ParentId 속성을 사용하여 엔터티를 연결합니다.

이 cmdlet을 실행하려면 Places 관리자, Exchange 관리자 또는 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

다음은 사서함 세부 정보를 지정하지 않고 섹션과 용량 10으로 구성된 새 회의실을 만드는 예제입니다. 회의실 사서함이 자동으로 만들어지고 연결됩니다.

New-Place -Name 'Room a' -Type Room -ParentId -ParentId $SectionId -Capacity 10

예 5

이 예제에서는 섹션에 부모로 지정된 새 회의실을 만들고 사서함 세부 정보를 제공합니다.

New-Place -Name 'Room a' -Type Room -ParentId -ParentId $SectionId -Mailbox <mailboxAddress>

예 6

다음은 섹션에 부모로 지정된 새 작업 영역(데스크 풀)을 만들고 사서함 세부 정보를 제공하는 예제입니다.

New-Place -Name 'Deskpool A' -Type Workspace -ParentId -ParentId $SectionId -Mailbox <mailboxAddress>

예 7

이 예제에서는 사서함 세부 정보를 지정하지 않고 섹션을 부모로 사용하는 예약 가능한 책상을 만듭니다. 책상 사서함이 자동으로 만들어지고 연결되고 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'}

예 8

이 예제에서는 섹션을 부모로 하는 예약 가능한 책상을 만들고 사서함을 제공합니다. 사서함이 있는 경우 책상이 해당 사서함에 연결되고, 그렇지 않으면 제공된 이름으로 새 책상 사서함이 자동으로 만들어집니다.

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

예제 9

이 예제에서는 섹션에 부모로 지정된 할당된 모드 데스크를 만들고 사용자에게 할당합니다. 할당된 사용자만 이 책상을 사용할 수 있습니다. 다른 사람들은 더 이상 예약할 수 없습니다.

$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
New-Place -Name 'Bookable Desk101' -Type Desk -ParentId $section.PlaceId -Mode @{Name='Assigned';Metadata=$modemetadata}

매개 변수

-도시

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
위치: 명명 된
기본값: 없음
필수: 거짓
파이프라인 입력 수락: 거짓
와일드카드 문자 허용: 거짓

-모드

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

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

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

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

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

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

    • 예약 가능 및 Drop-In 모드의 Places 메타데이터 필드를 지원하지 않습니다.
    • 사용할 수 없는 모드의 Places 책상을 Reason 사용할 수 없는 이유를 설명하는 필드(문자열)를 지원합니다. 값에는 새로 만든 책상과 Maintenance 서비스 진행 중인 Places 대한 값이 포함 New 됩니다.
    • 할당된 모드는 및 AssignedPersonId의 두 메타데이터 필드를 AssignedPersonEmailAddress 지원합니다. 이러한 사용자는 책상에 할당된 사용자를 식별합니다. 두 필드 중 하나를 제공하면 할당된 모드를 사용하도록 설정할 수 있습니다.
특성 설명
유형: 모드
위치: 명명 된
기본값: @{Name='Unavailable', Metadata={'Reason':'New'}}
필수: 거짓
파이프라인 입력 수락: 거짓
와일드카드 문자 허용: 거짓

-형

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

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