Set-Place
이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.
Set-Place cmdlet을 사용하여 더 나은 검색 및 회의실 제안 환경을 제공하는 추가 메타데이터로 회의실 사서함을 업데이트합니다.
참고: 하이브리드 환경에서 이 cmdlet은 동기화된 회의실 사서함의 속성인 City, CountryOrRegion, GeoCoordinates, Phone, PostalCode, State 또는 Street에서 작동하지 않습니다. 이러한 속성을 수정하려면(동기화된 회의실 사서함의 GeoCoordinates 제외) 온-프레미스 Exchange에서 Set-User 또는 Set-Mailbox cmdlet을 사용합니다.
참고: EXO V3 모듈에서 이 cmdlet을 사용하는 것이 좋습니다. Set-Place 사용하여 속성의 특정 조합을 함께 변경하는 명령은 이전 버전의 모듈에서 실패할 수 있습니다. EXO V3 모듈에 대한 자세한 내용은 Exchange Online PowerShell 모듈 정보를 참조하세요.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Set-Place
[-Identity] <RecipientIdParameter>
[-AudioDeviceName <String>]
[-Building <String>]
[-Capacity <System.Int32>]
[-City <String>]
[-Confirm]
[-CountryOrRegion <CountryInfo>]
[-DisplayDeviceName <String>]
[-Floor <System.Int32>]
[-FloorLabel <String>]
[-GeoCoordinates <GeoCoordinates>]
[-IsWheelChairAccessible <Boolean>]
[-Label <String>]
[-MTREnabled <Boolean>]
[-ParentId <String>]
[-ParentType <Microsoft.Exchange.Management.RecipientTasks.SetPlaceParentType>]
[-Phone <String>]
[-PostalCode <String>]
[-State <String>]
[-Street <String>]
[-Tags <String[]>]
[-VideoDeviceName <String>]
[-WhatIf]
[<CommonParameters>]
Description
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 문서에서는 cmdlet에 대한 모든 매개 변수를 나열하지만 할당된 권한에 포함되지 않은 경우 일부 매개 변수에 액세스할 수 없을 수 있습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Set-Place -Identity "Conference Room 01" -IsWheelChairAccessible $true -AudioDeviceName PolyCom -DisplayDeviceName "InFocus WXGA Projector"
이 예제에서는 회의실 01이라는 회의실 사서함에 지정된 메타데이터를 추가합니다.
예 2
Set-Place -Identity "Conference Room 02" -Building "Building 02" -Capacity 5 -CountryOrRegion ES -Floor 3 -FloorLabel "Human Resources" -Label Interviews
이 예제에서는 회의실 02라는 회의실 사서함에 지정된 메타데이터를 추가합니다.
매개 변수
-AudioDeviceName
적용 가능: Exchange Online
AudioDeviceName 매개 변수는 회의실에 있는 오디오 디바이스의 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
기본값은 비워 두는 것입니다($null). 이 방에 오디오 장치가 없음을 나타내려면 이 매개 변수에 대한 값 $null 사용합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Building
적용 가능: Exchange Online
Building 매개 변수는 회의실이 있는 건물 이름 또는 건물 번호를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Capacity
적용 가능: Exchange Online
Capacity 매개 변수는 회의실의 용량을 지정합니다. 사용할 수 있는 값은 정수입니다.
매개 변수 속성
| 형식: | System.Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-City
적용 가능: Exchange Online
City 매개 변수는 회의실의 도시를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Confirm
적용 가능: Exchange Online
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-CountryOrRegion
적용 가능: Exchange Online
CountryOrRegion 매개 변수는 회의실의 국가 또는 지역을 지정합니다. 유효한 값은 유효한 ISO 3166-1 두 글자 국가 코드(예: 오스트레일리아의 경우 AU) 또는 해당 국가의 해당 식별 이름입니다(공식 ISO 3166 유지 관리 기관 짧은 이름과 다를 수 있음).
두 글자로 된 국가 코드에 대한 참조는 국가 코드 목록에서 사용할 수 있습니다.
식별 이름은 Get-Place cmdlet에 의해 CountryOrRegion 속성 값에 반환되지만 필터 작업에서 식별 이름 또는 두 글자로 된 국가 코드를 사용할 수 있습니다.
매개 변수 속성
| 형식: | CountryInfo |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-DisplayDeviceName
적용 가능: Exchange Online
DisplayDeviceName 매개 변수는 회의실에 있는 디스플레이 디바이스의 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
기본값은 비워 두는 것입니다($null). 이 방에 디스플레이 디바이스가 없음을 나타내려면 이 매개 변수에 대한 값 $null 사용합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Floor
적용 가능: Exchange Online
Floor 매개 변수는 회의실이 있는 바닥 번호를 지정합니다.
매개 변수 속성
| 형식: | System.Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-FloorLabel
적용 가능: Exchange Online
FloorLabel 매개 변수는 회의실이 있는 바닥의 설명 레이블을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-GeoCoordinates
적용 가능: Exchange Online
GeoCoordinates 매개 변수는 위도, 경도 및 (선택 사항) 고도 좌표로 회의실의 위치를 지정합니다. 이 매개 변수의 유효한 값은 다음 형식 중 하나를 사용합니다.
- 위도 및 경도: 예를 들어 "47.644125;-122.122411"
- 위도, 경도 및 고도: 예를 들어 "47.644125;-122.122411; 161.432"
참고: 마침표 구분 기호가 작동하지 않는 경우 대신 쉼표 를 사용합니다.
매개 변수 속성
| 형식: | GeoCoordinates |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Online
Identity 매개 변수는 수정하려는 회의실 사서함을 지정합니다. 회의실을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:
- 이름
- 별칭
- DN(고유 이름)
- DN(고유 이름)
- 정식 DN
- GUID
매개 변수 속성
| 형식: | RecipientIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-IsWheelChairAccessible
적용 가능: Exchange Online
IsWheelChairAccessible 매개 변수는 회의실이 휠체어에 액세스할 수 있는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 객실은 휠체어를 이용할 수 있습니다.
- $false: 객실은 휠체어를 이용할 수 없습니다. 이 값은 기본값입니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Label
적용 가능: Exchange Online
Label 매개 변수는 회의실에 대한 설명 레이블(예: 숫자 또는 이름)을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-MTREnabled
적용 가능: Exchange Online
참고: 현재 이 매개 변수는 정보 전용이며 추가 기능이 없습니다.
MTREnabled 매개 변수는 Microsoft Teams 룸 시스템으로 구성된 회의실을 식별합니다. 회의실을 포함하는 Teams 모임에서 Teams 룸 시스템을 오디오 원본으로 추가할 수 있습니다. 유효한 값은 다음과 같습니다.
- $true: 회의실에는 Teams 룸 시스템이 있습니다. 회의실 오디오를 사용하여 모임에 참가하도록 선택할 때 Teams 회의실 시스템을 Microsoft Teams 모임에 추가할 수 있습니다.
- $false: 회의실에 Teams 룸 시스템이 없습니다. 사용자는 회의실 오디오를 사용하는 대신 PC 또는 모바일 장치 오디오를 사용하여 Teams 모임에 참가합니다. 이 값은 기본값입니다.
Microsoft Teams 룸 대한 자세한 내용은 Microsoft Teams 룸 참조하세요.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ParentId
적용 가능: Exchange Online
참고: 이 기능은 실험적이며 Microsoft Places 사용하는 조직에서만 사용할 수 있습니다.
ParentId 매개 변수는 Microsoft Places 부모 위치 계층 구조의 Place ID를 지정합니다.
Microsoft Places 위해 룸 및 작업 영역을 온보딩하는 조직은 Microsoft Places 제대로 작동하도록 Set-Place 명령에서 ParentId 및 ParentType 매개 변수를 사용해야 합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ParentType
적용 가능: Exchange Online
참고: 이 기능은 실험적이며 Microsoft Places 사용하는 조직에서만 사용할 수 있습니다.
ParentType 매개 변수는 Microsoft Places ParentId의 부모 형식을 지정합니다. 유효한 값은 다음과 같습니다.
- 층
- 섹션
Microsoft Places 위해 룸 및 작업 영역을 온보딩하는 조직은 Microsoft Places 제대로 작동하도록 Set-Place 명령에서 ParentId 및 ParentType 매개 변수를 사용해야 합니다.
매개 변수 속성
| 형식: | Microsoft.Exchange.Management.RecipientTasks.SetPlaceParentType |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Phone
적용 가능: Exchange Online
Phone 매개 변수는 회의실의 전화 번호를 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-PostalCode
적용 가능: Exchange Online
PostalCode 매개 변수는 회의실의 우편 번호를 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-State
적용 가능: Exchange Online
State 매개 변수는 회의실의 상태 또는 지방을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Street
적용 가능: Exchange Online
Street 매개 변수는 회의실의 실제 주소를 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Tags
적용 가능: Exchange Online
Tags 매개 변수는 회의실의 추가 기능(예: 보기 유형 또는 가구 유형과 같은 세부 정보)을 지정합니다.
여러 레이블을 쉼표로 구분하여 지정할 수 있습니다. 레이블에 공백이 포함된 경우 값을 따옴표 "Label 1","Label 2",..."Label N"로 묶습니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-VideoDeviceName
적용 가능: Exchange Online
VideoDeviceName 매개 변수는 회의실에 있는 비디오 디바이스의 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
기본값은 비워 두는 것입니다($null). 이 방에 비디오 디바이스가 없음을 나타내려면 이 매개 변수에 대한 값 $null 사용합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
적용 가능: Exchange Online
Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.