Remove-CalendarEvents
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.
Remove-CalendarEvents cmdlet을 사용하여 사용자 또는 리소스 사서함에서 향후 모임을 취소합니다. 이후 모임을 취소하면 참석자 및 리소스 일정에서 제거됩니다(예: 사서함을 제거하거나 사용자가 휴무 중임).
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Remove-CalendarEvents
[-Identity] <MailboxIdParameter>
-QueryWindowInDays <Int32>
[-CancelOrganizedMeetings]
[-Confirm]
[-PreviewOnly]
[-QueryStartDate <ExDateTime>]
[-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
CancelOrganizedMeetings 스위치는 사서함에서 모임을 취소할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
사서함에서 모임을 취소하려면 이 스위치를 사용해야 합니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2019, Exchange Online |
-Confirm
Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.
- 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문
-Confirm:$false
를 사용하여 확인 메시지를 건너뛸 수 있습니다. - 대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2019, Exchange Online |
-Identity
Identity 매개 변수는 수정할 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- 별칭
- DN(고유 이름)
- DN(고유 이름)
- Domain\Username
- 전자 메일 주소
- GUID
- LegacyExchangeDN
- SamAccountName
- 사용자 ID 또는 UPN(사용자 계정 이름)
Type: | MailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2019, Exchange Online |
-PreviewOnly
PreviewOnly 스위치는 실제로 모임을 취소하지 않고 명령 결과를 미리 볼지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 스위치는 자세한 정보 표시 스위치와 함께 사용합니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2019, Exchange Online |
-QueryStartDate
QueryStartDate 매개 변수는 취소할 모임을 찾을 시작 날짜를 지정합니다.
명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".
참고: 이 매개 변수를 사용하지 않으면 오늘 날짜가 사용됩니다.
QueryWindowInDays 매개 변수를 사용하여 종료 날짜를 지정합니다.
Type: | ExDateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2019, Exchange Online |
-QueryWindowInDays
QueryWindowInDays 매개 변수는 취소할 모임을 찾기 위해 QueryStartDate 매개 변수 값 이후의 일 수를 지정합니다.
지정된 기간 동안 되풀이 모임의 인스턴스가 발생하면 전체 계열이 취소됩니다(해당 기간 동안의 인스턴스뿐만 아니라).
참고: 모임 취소에 허용되는 최대 기간은 1825일(5년)입니다.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2019, Exchange Online |
-WhatIf
Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2019, Exchange Online |