Initialize-Places

cmdlet은 Initialize-Places , 및 Set-PlaceV3 cmdlet 대신 New-Place사용할 수 있는 간소화된 빠른 만들기 환경입니다.

Initialize-Places 기존 회의실과 테넌트 내 작업 영역을 구문 분석하고 건물, 바닥 및 구역 이름을 유추합니다. 이를 통해 이 정보를 확인하고 편집한 다음 테넌트에서 건물 > 바닥 > 실 및 작업 영역의 전체 계층 구조를 빌드할 수 있습니다. 이 계층 구조를 Places 디렉터리라고도 합니다.

이 페이지에서는 cmdlet 구문 및 옵션에 대한 세부 정보를 제공합니다. 이 cmdlet을 사용하는 단계별 가이드는 건물 및 층 구성에 제공됩니다.

중요

2024년 11월 14일에 MicrosoftPlaces cmdlet 모듈에 대한 중요한 업데이트가 이루어졌습니다. 해당 날짜 이전에 미리 보기 프로그램에 참가한 경우 를 실행 Run Install-Module -Name MicrosoftPlaces -Force하여 최신 버전의 모듈을 다운로드한 다음 PowerShell을 닫고 다시 시작합니다.

구문

실행 중 Initialize-Places 옵션 목록이 표시됩니다.

Initialize-Places
Please choose the desired option before continuing:
 1. Export suggested mapping CSV of rooms to buildings/floors.
 2. Import mapping CSV to automatically create buildings/floors and room mappings.
 3. Export PowerShell script with commands to manually create buildings/floors and room mappings based on an imported CSV.

주의

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

옵션 1

이 옵션은 테넌트에서 구성된 회의실 및 작업 영역을 구문 분석하고 ResourceAccountsMapped.csv라는 CSV 파일을 생성합니다. 이 CSV 파일에는 회의실, 작업 공간 및 RoomList 데이터에서 유추되는 건물, 바닥 및 섹션 이름과 같은 다른 데이터가 포함되어 있습니다.

CSV 파일에는 RoomList와 연결된 Exchange Online 있는 회의실 및 작업 영역만 포함되며 아직 Places 디렉터리의 바닥 또는 섹션에 부모로 지정되지 않았습니다.

예시:

• RoomList와 연결되지 않은 Places CSV에 포함되지 않습니다. 이러한 회의실은 회의실 찾기에 표시되지 않으며, 나중에 수동으로 추가하지 않는 한 Places Finder에 표시되지 않도록 기본적으로 제외됩니다.

• 둘 이상의 RoomList와 연결된 Places 포함됩니다. 그러나 유추된 건물 이름은 비어 있습니다. 올바른 건물 이름으로 작성해야 합니다.

• Places 이미 바닥으로 부모이거나 섹션이 CSV에 포함되어 있지 않습니다. 새 회의실과 작업 영역이 Exchange Online 추가되고 출력 CSV 파일에 새 회의실 및 작업 영역만 포함해야 하는 경우 스크립트를 반복적으로 실행할 수 있습니다.

다른 회의실 및 작업 영역을 내보내는 방법에 대한 지침은 건물 및 바닥 구성, 수동 설정을 참조하세요.

옵션 2

옵션 1에서 생성된 회의실 및 작업 영역 정보의 유효성이 검사되면 건물 및 바닥 구성 에 설명된 대로 불필요한 열을 제거하고 새 CSV 파일로 저장해야 합니다. 이제 옵션 2를 사용하여 이 정보를 Places 디렉터리에 다시 쓸 준비가 되었습니다.

CSV 파일에 있는 모든 새 건물, 바닥 또는 섹션이 Places 디렉터리에 추가되고 새 객실과 작업 공간은 바닥/구역으로 부모로 지정됩니다.

건물, 도시 또는 기타 기준을 작성하여 작업을 세분화할 수 있습니다. 이 방법을 사용하면 Places 디렉터리에 추가하려는 회의실 및 작업 공간의 하위 집합이 포함된 더 작은 CSV 파일을 반복적으로 업로드할 수 있습니다. 새 CSV 파일을 업로드할 때마다 Places 디렉터리에 아직 없는 건물, 바닥 및 섹션이 계층 구조에 추가됩니다.

CSV 파일을 업로드하면 fileToImport-ImportResults.csv 라는 파일이 생성되고 동일한 폴더에 저장됩니다. 이 파일은 업로드 중에 문제가 발생했는지 여부를 문서화합니다. 이 단계에서는 테넌트에서 Microsoft Places 공간 데이터의 전체 계층 구조를 사용할 수 있게 됩니다.

CSV 파일을 업로드하면 Microsoft 365 환경에서 건물 이름이 표시됩니다. 이는 실질적으로 사용자가 다음 건물을 보고 선택할 수 있음을 의미합니다.

• 작업 계획(즉, Outlook 근무 시간 및 위치)

• 작업 공간 존재

• Microsoft Places 개요에 설명된 다른 환경

중요

CSV 파일과 CSV 파일을 반복적으로 업로드하는 경우 각 건물, 바닥 및 섹션의 철자가 정확히 동일한지 확인합니다. 이러한 차이로 인해 추가 건물, 바닥 또는 구역이 만들어집니다.

옵션 3

이 고급 옵션을 사용하면 실행하기 전에 Places 디렉터리를 구성하는 PowerShell 스크립트를 검토할 수 있습니다. 이 옵션을 사용하면 PowerShell 스크립트가 컴퓨터에 다운로드되지만 실행되지 않습니다. 옵션 3은 여러 사용자 간에 관리 작업을 구분해야 하는 경우에 유용할 수 있습니다.

PowerShell 스크립트는 PlacesOnboardingScript.ps1 호출되며 업로드된 CSV 파일과 동일한 폴더에 저장됩니다. PowerShell 스크립트를 수동으로 실행하여 Places 디렉터리를 구성해야 합니다.

참고

cmdlet 설명은 옵션 3에 "가져오기"라는 용어를 잘못 사용하지만 이 옵션은 Places 디렉터리에 아무것도 만들지 않습니다. 수동으로 실행해야 하는 스크립트만 생성합니다.

파일 형식

내보낸 파일의 파일 형식(옵션 1)

열 이름	설명
InferredBuildingName	Microsoft Places 회의실/작업 영역의 건물 속성 및 연결된 회의실 목록을 기반으로 이 회의실/작업 영역의 건물 이름이라고 생각하는 것을 유추(제안)하려고 시도합니다. 이 열은 가져오기 전에 올바른 값으로 업데이트된 & 검토해야 합니다(옵션 2 또는 3).
InferredFloorName	Microsoft Places 회의실/작업 영역의 floorLabel 속성 및 연결된 회의실 목록에 따라 이 회의실/작업 영역의 바닥 이름이라고 생각하는 것을 유추(제안)하려고 시도합니다. 이 열은 가져오기 전에 올바른 값으로 업데이트된 & 검토해야 합니다(옵션 2 또는 3).
InferredSectionName	Microsoft Places 바닥 이름(InferredFloorName)을 작업 영역의 섹션 이름으로 제안하고 회의실의 경우 비워 둡니다. 이 열을 검토해야 & 가져오기 전에 올바른 값으로 업데이트해야 합니다(옵션 2 또는 3).
CurrentBuildingLabel	회의실 또는 작업 영역의 메타데이터에 설정된 빌드 의 현재 문자열 값
CurrentFloorNumber	회의실 또는 작업 영역의 메타데이터에 설정된 바닥 의 현재 정수 값입니다.
CurrentFloorLabel	회의실 또는 작업 영역의 메타데이터에 설정된 floorLabel 의 현재 문자열 값
PrimarySmtpAddress	회의실 또는 작업 영역의 smtp 주소
이름	회의실/작업 영역의 표시 이름
RoomList	회의실/작업 영역의 연결된 회의실 목록
ResourceType	리소스가 회의실 또는 공간(작업 영역)인지를 정의합니다.
StreetAddress	회의실/작업 영역의 거리 주소
구/군/시	방/작업 영역의 도시
StateOrProvince	회의실/작업 영역의 주/주
CountryOrRegion	회의실/작업 영역의 국가/지역
자신	유추된 건물 이름 및 유추된 바닥 이름의 신뢰도 수준

가져오기에 필요한 파일 형식(옵션 2 및 3)

가져온 파일에는 다음 네 개의 열만 있어야 합니다.

열 이름	설명
InferredBuildingName	(필수) 이 이름은 건물을 만들 때 사용됩니다.
InferredFloorName	(필수) 이 이름은 바닥을 만들 때 사용됩니다.
InferredSectionName	이 이름은 섹션(바닥에 영역 또는 이웃)을 만들 때 사용됩니다. 이 이름은 작업 영역에 필요하지만 회의실의 경우 선택 사항입니다.
PrimarySmtpAddress	(필수) 회의실 또는 작업 영역의 smtp 주소