Remove-CalendarEvents
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수 및 설정은 한 환경 또는 다른 환경에만 사용할 수 있습니다.
Remove-CalendarEvents cmdlet을 사용하여 사용자 또는 리소스 사서함에서 향후 모임을 취소합니다. 향후 모임을 취소하면 참석자 및 리소스 일정에서 제거됩니다(예: 사서함을 제거하거나 사용자가 휴무 중임).
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Remove-CalendarEvents
[-Identity] <MailboxIdParameter>
-QueryWindowInDays <Int32>
[-CancelOrganizedMeetings]
[-Confirm]
[-PreviewOnly]
[-QueryStartDate <ExDateTime>]
[-UseCustomRouting]
[-WhatIf]
[<CommonParameters>]
Description
이 cmdlet은 사서함이 모임 이끌이이고 모임에 참석자 또는 리소스가 하나 이상 있는 지정된 사서함에서 모임을 취소합니다. 참석자나 리소스가 없는 약속이나 모임은 취소하지 않습니다. 모임 취소를 보내야 하므로 메일을 보내려면 사서함을 사용하도록 설정해야 합니다.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 문서에서는 cmdlet에 대한 모든 매개 변수를 나열하지만 할당된 권한에 포함되지 않은 경우 일부 매개 변수에 액세스할 수 없을 수 있습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Remove-CalendarEvents -Identity chris@contoso.com -CancelOrganizedMeetings -QueryWindowInDays 120
이 예제에서는 오늘 날짜 이후 또는 120일 후에 발생하는 사서함 chris@contoso.com 의 모든 모임을 취소합니다. 모임을 취소한 후 사서함을 제거할 수 있습니다.
예 2
Remove-CalendarEvents -Identity "Angela Gruber" -CancelOrganizedMeetings -QueryStartDate 11-1-2018 -QueryWindowInDays 120
다음은 지정된 날짜 범위에 대한 Angela Gruber 일정의 모임을 취소하는 예제입니다. 안젤라는 회사에서 임시 휴가를 복용, 그래서 이러한 회의를 취소하는 것은 그녀의 부재 기간 동안 사용자 및 리소스 달력에서 그들을 제거합니다.
예 3
Remove-CalendarEvents -Identity "Jacob Berger" -CancelOrganizedMeetings -QueryStartDate 9-1-2018 -QueryWindowInDays 90 -PreviewOnly -Verbose
이 예제에서는 지정된 날짜 범위에 대해 Jacob Berger의 일정에서 취소될 모임을 미리 봅니다. 사서함은 변경되지 않습니다.
매개 변수
-CancelOrganizedMeetings
적용 가능: Exchange Server 2019, Exchange Online
CancelOrganizedMeetings 스위치는 사서함에서 모임을 취소할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
사서함에서 모임을 취소하려면 이 스위치를 사용해야 합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Confirm
적용 가능: Exchange Server 2019, Exchange Online
Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.
- 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문
-Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다. - 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Server 2019, Exchange Online
Identity 매개 변수는 수정할 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- 별칭
- DN(고유 이름)
- DN(고유 이름)
- Domain\Username
- 전자 메일 주소
- GUID
- LegacyExchangeDN
- SamAccountName
- 사용자 ID 또는 UPN(사용자 계정 이름)
매개 변수 속성
| 형식: | MailboxIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-PreviewOnly
적용 가능: Exchange Server 2019, Exchange Online
PreviewOnly 스위치는 실제로 모임을 취소하지 않고 명령 결과를 미리 볼지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 스위치는 자세한 정보 표시 스위치와 함께 사용합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-QueryStartDate
적용 가능: Exchange Server 2019, Exchange Online
QueryStartDate 매개 변수는 취소할 모임을 찾을 시작 날짜를 지정합니다.
명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2018년 9월 1일을 지정하려면 2018년 9월 1일을 입력합니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".
참고: 이 매개 변수를 사용하지 않으면 오늘 날짜가 사용됩니다.
QueryWindowInDays 매개 변수를 사용하여 종료 날짜를 지정합니다.
매개 변수 속성
| 형식: | ExDateTime |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-QueryWindowInDays
적용 가능: Exchange Server 2019, Exchange Online
QueryWindowInDays 매개 변수는 취소할 모임을 찾기 위해 QueryStartDate 매개 변수 값 이후의 일 수를 지정합니다.
지정된 기간 동안 되풀이 모임의 instance 발생하면 전체 계열이 취소됩니다(해당 기간 동안의 인스턴스뿐만 아니라).
참고: 모임 취소에 허용되는 최대 기간은 1825일(5년)입니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-UseCustomRouting
적용 가능: Exchange Online
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
{{ Fill UseCustomRouting description }}
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
적용 가능: Exchange Server 2019, 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를 참조하세요.