|
| 1 | +--- |
| 2 | +external help file: Microsoft.Exchange.RolesAndAccess-Help.xml |
| 3 | +online version: https://docs.microsoft.com/powershell/module/exchange/set-eventsfromemailconfiguration |
| 4 | +applicable: Exchange Online |
| 5 | +title: Set-EventsFromEmailConfiguration |
| 6 | +schema: 2.0.0 |
| 7 | +author: chrisda |
| 8 | +ms.author: chrisda |
| 9 | +ms.reviewer: |
| 10 | +monikerRange: "exchonline-ps" |
| 11 | +--- |
| 12 | + |
| 13 | +# Set-EventsFromEmailConfiguration |
| 14 | + |
| 15 | +## SYNOPSIS |
| 16 | +This cmdlet is only available in the cloud-based service. |
| 17 | + |
| 18 | +Use the Set-EventsFromEmailConfiguration cmdlet to modify the events from email settings on a mailbox. on Outlook clients and Outlook on the web. These settings define whether Outlook or Outlook on the web (formerly known as Outlook Web App) automatically discovers events from email messages and adds them to the user's calendar. |
| 19 | + |
| 20 | +For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://docs.microsoft.com/powershell/exchange/exchange-server/exchange-cmdlet-syntax). |
| 21 | + |
| 22 | +## SYNTAX |
| 23 | + |
| 24 | +### Identity (Default) |
| 25 | +``` |
| 26 | +Set-EventsFromEmailConfiguration [-Identity] <RecipientIdParameter> |
| 27 | + [-CreateEventsFromEmailAsPrivate <Boolean>] |
| 28 | + [-EventReservationProcessingLevel <String>] |
| 29 | + [-FlightReservationProcessingLevel <String>] |
| 30 | + [-FoodEstablishmentReservationProcessingLevel <String>] |
| 31 | + [-InvoiceProcessingLevel <String>] |
| 32 | + [-LodgingReservationProcessingLevel <String>] |
| 33 | + [-ParcelDeliveryProcessingLevel <String>] |
| 34 | + [-RentalCarReservationProcessingLevel <String>] |
| 35 | + [-ServiceReservationProcessingLevel <String>] |
| 36 | + [<CommonParameters>] |
| 37 | +``` |
| 38 | + |
| 39 | +### ResetSettings |
| 40 | +``` |
| 41 | +Set-EventsFromEmailConfiguration [-Identity] <RecipientIdParameter> |
| 42 | + [-ResetSettings] |
| 43 | + [<CommonParameters>] |
| 44 | +``` |
| 45 | + |
| 46 | +## DESCRIPTION |
| 47 | +You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/exchange-server/find-exchange-cmdlet-permissions). |
| 48 | + |
| 49 | +## EXAMPLES |
| 50 | + |
| 51 | +### Example 1 |
| 52 | +```powershell |
| 53 | +Set-EventsFromEmailConfiguration -Identity [email protected] -InvoiceProgressingLevel Disabled |
| 54 | +``` |
| 55 | + |
| 56 | +This example disables the discovery of invoices from messages for the user. |
| 57 | + |
| 58 | +### Example 2 |
| 59 | +```powershell |
| 60 | +Set-EventsFromEmailConfiguration -Identity [email protected] -ServiceReservationProcessingLevel Calendar -CreateEventsFromEmailAsPrivate $true |
| 61 | +``` |
| 62 | + |
| 63 | +This example enables the discovery of service reservations, automatically adds them to the user's calendar, and makes these automatically added events private. |
| 64 | + |
| 65 | +### Example 3 |
| 66 | +```powershell |
| 67 | +Set-EventsFromEmailConfiguration -Identity [email protected] -ResetSettings |
| 68 | +``` |
| 69 | + |
| 70 | +This example resets Events from Email settings for the user. |
| 71 | + |
| 72 | +## PARAMETERS |
| 73 | + |
| 74 | +### -Identity |
| 75 | +The Identity parameter specifies the mailbox that you want to modify. You identify the mailbox by email address. |
| 76 | + |
| 77 | +```yaml |
| 78 | +Type: RecipientIdParameter |
| 79 | +Parameter Sets: (All) |
| 80 | +Aliases: |
| 81 | +Applicable: Exchange Online |
| 82 | + |
| 83 | +Required: True |
| 84 | +Position: 0 |
| 85 | +Default value: None |
| 86 | +Accept pipeline input: True (ByValue) |
| 87 | +Accept wildcard characters: False |
| 88 | +``` |
| 89 | +
|
| 90 | +### -CreateEventsFromEmailAsPrivate |
| 91 | +The CreateEventsFromEmailAsPrivate parameter specifies whether to create the events discovered from messages as normal or private events. Valid values are: |
| 92 | +
|
| 93 | +- $true: The events are crated as private events. This is the default value. |
| 94 | +
|
| 95 | +- $false: The events are created as normal events. |
| 96 | +
|
| 97 | +```yaml |
| 98 | +Type: Boolean |
| 99 | +Parameter Sets: Identity |
| 100 | +Aliases: |
| 101 | +Applicable: Exchange Online |
| 102 | + |
| 103 | +Required: False |
| 104 | +Position: Named |
| 105 | +Default value: None |
| 106 | +Accept pipeline input: False |
| 107 | +Accept wildcard characters: False |
| 108 | +``` |
| 109 | +
|
| 110 | +### -EventReservationProcessingLevel |
| 111 | +The EventReservationProcessingLevel parameter specifies whether event reservations are automatically discovered from messages, and whether these reservations are automatically added to the user's calendar. Valid values are: |
| 112 | +
|
| 113 | +- Disabled: Do not discover event reservations from messages. |
| 114 | +
|
| 115 | +- Email: Discover event reservations from messages, but don't automatically add them to the user's calendar. |
| 116 | +
|
| 117 | +- Calendar: Discover event reservations from messages and automatically add them to the user's calendar. This is the default value. |
| 118 | +
|
| 119 | +```yaml |
| 120 | +Type: String |
| 121 | +Parameter Sets: Identity |
| 122 | +Aliases: |
| 123 | +Applicable: Exchange Online |
| 124 | + |
| 125 | +Required: False |
| 126 | +Position: Named |
| 127 | +Default value: None |
| 128 | +Accept pipeline input: False |
| 129 | +Accept wildcard characters: False |
| 130 | +``` |
| 131 | +
|
| 132 | +### -FlightReservationProcessingLevel |
| 133 | +The FlightReservationProcessingLevel parameter specifies whether flight reservations are automatically discovered from messages, and whether these reservations are automatically added to the user's calendar. Valid values are: |
| 134 | +
|
| 135 | +- Disabled: Do not discover flight reservations from messages. |
| 136 | +
|
| 137 | +- Email: Discover flight reservations from messages, but don't automatically add them to the user's calendar. |
| 138 | +
|
| 139 | +- Calendar: Discover flight reservations from messages and automatically add them to the user's calendar. This is the default value. |
| 140 | +
|
| 141 | +```yaml |
| 142 | +Type: String |
| 143 | +Parameter Sets: Identity |
| 144 | +Aliases: |
| 145 | +Applicable: Exchange Online |
| 146 | + |
| 147 | +Required: False |
| 148 | +Position: Named |
| 149 | +Default value: None |
| 150 | +Accept pipeline input: False |
| 151 | +Accept wildcard characters: False |
| 152 | +``` |
| 153 | +
|
| 154 | +### -FoodEstablishmentReservationProcessingLevel |
| 155 | +The FoodEstablishmentProcessingLevel parameter specifies whether dining reservations are automatically discovered from messages, and whether these reservations are automatically added to the user's calendar. Valid values are: |
| 156 | +
|
| 157 | +- Disabled: Do not discover restaurant reservations from messages. |
| 158 | +
|
| 159 | +- Email: Discover restaurant reservations from messages however do not automatically add these to the user's calendar. |
| 160 | +
|
| 161 | +- Calendar: Discover restaurant reservations from messages and automatically add them to the user's calendar. This is the default value. |
| 162 | +
|
| 163 | +```yaml |
| 164 | +Type: String |
| 165 | +Parameter Sets: Identity |
| 166 | +Aliases: |
| 167 | +Applicable: Exchange Online |
| 168 | + |
| 169 | +Required: False |
| 170 | +Position: Named |
| 171 | +Default value: None |
| 172 | +Accept pipeline input: False |
| 173 | +Accept wildcard characters: False |
| 174 | +``` |
| 175 | +
|
| 176 | +### -InvoiceProcessingLevel |
| 177 | +The InvoiceProcessingLevel parameter specifies whether invoices are automatically discovered from messages, and whether these reservations are automatically added to the user's calendar. Valid values are: |
| 178 | +
|
| 179 | +- Disabled: Do not discover invoices from messages. |
| 180 | +
|
| 181 | +- Email: Discover invoices from messages however do not automatically add these to the user's calendar. |
| 182 | +
|
| 183 | +- Calendar: Discover invoices from messages and automatically add them to the user's calendar. This is the default value. |
| 184 | +
|
| 185 | +```yaml |
| 186 | +Type: String |
| 187 | +Parameter Sets: Identity |
| 188 | +Aliases: |
| 189 | +Applicable: Exchange Online |
| 190 | + |
| 191 | +Required: False |
| 192 | +Position: Named |
| 193 | +Default value: None |
| 194 | +Accept pipeline input: False |
| 195 | +Accept wildcard characters: False |
| 196 | +``` |
| 197 | +
|
| 198 | +### -LodgingReservationProcessingLevel |
| 199 | +The LodgingReservationProcessingLevel parameter specifies whether lodging reservations are automatically discovered from messages, and whether these reservations are automatically added to the user's calendar. Valid values are: |
| 200 | +
|
| 201 | +- Disabled: Do not discover lodging reservations from messages. |
| 202 | +
|
| 203 | +- Email: Discover lodging reservations from messages however do not automatically add these to the user's calendar. |
| 204 | +
|
| 205 | +- Calendar: Discover lodging reservations from messages and automatically add them to the user's calendar. This is the default value. |
| 206 | +
|
| 207 | +```yaml |
| 208 | +Type: String |
| 209 | +Parameter Sets: Identity |
| 210 | +Aliases: |
| 211 | +Applicable: Exchange Online |
| 212 | + |
| 213 | +Required: False |
| 214 | +Position: Named |
| 215 | +Default value: None |
| 216 | +Accept pipeline input: False |
| 217 | +Accept wildcard characters: False |
| 218 | +``` |
| 219 | +
|
| 220 | +### -ParcelDeliveryProcessingLevel |
| 221 | +The ParcelDeliveryProcessingLevel parameter specifies whether parcel deliveries are automatically discovered from messages, and whether these reservations are automatically added to the user's calendar. Valid values are: |
| 222 | +
|
| 223 | +- Disabled: Do not discover parcel deliveries from messages. |
| 224 | +
|
| 225 | +- Email: Discover parcel deliveries from messages however do not automatically add these to the user's calendar. |
| 226 | +
|
| 227 | +- Calendar: Discover parcel deliveries from messages and automatically add them to the user's calendar. This is the default value. |
| 228 | +
|
| 229 | +```yaml |
| 230 | +Type: String |
| 231 | +Parameter Sets: Identity |
| 232 | +Aliases: |
| 233 | +Applicable: Exchange Online |
| 234 | + |
| 235 | +Required: False |
| 236 | +Position: Named |
| 237 | +Default value: None |
| 238 | +Accept pipeline input: False |
| 239 | +Accept wildcard characters: False |
| 240 | +``` |
| 241 | +
|
| 242 | +### -RentalCarReservationProcessingLevel |
| 243 | +The RentalCarReservationProcessingLevel parameter specifies whether rental car reservations are automatically discovered from messages, and whether these reservations are automatically added to the user's calendar. Valid values are: |
| 244 | +
|
| 245 | +- Disabled: Do not discover rental car reservations from messages. |
| 246 | +
|
| 247 | +- Email: Discover rental car reservations from messages, but don't automatically add them to the user's calendar. |
| 248 | +
|
| 249 | +- Calendar: Discover rental car reservations from messages and automatically add them to the user's calendar. This is the default value. |
| 250 | +
|
| 251 | +```yaml |
| 252 | +Type: String |
| 253 | +Parameter Sets: Identity |
| 254 | +Aliases: |
| 255 | +Applicable: Exchange Online |
| 256 | + |
| 257 | +Required: False |
| 258 | +Position: Named |
| 259 | +Default value: None |
| 260 | +Accept pipeline input: False |
| 261 | +Accept wildcard characters: False |
| 262 | +``` |
| 263 | +
|
| 264 | +### -ResetSettings |
| 265 | +The ResetSettings switch specifies whether to return all of the reservation discovery settings to their default values. You don't need to specify a value with this switch. |
| 266 | +
|
| 267 | +```yaml |
| 268 | +Type: SwitchParameter |
| 269 | +Parameter Sets: ResetSettings |
| 270 | +Aliases: |
| 271 | +Applicable: Exchange Online |
| 272 | + |
| 273 | +Required: True |
| 274 | +Position: Named |
| 275 | +Default value: None |
| 276 | +Accept pipeline input: False |
| 277 | +Accept wildcard characters: False |
| 278 | +``` |
| 279 | +
|
| 280 | +### -ServiceReservationProcessingLevel |
| 281 | +The ServiceReservationProcessingLevel parameter specifies whether service reservations are automatically discovered from messages, and whether these reservations are automatically added to the user's calendar. Valid values are: |
| 282 | +
|
| 283 | +- Disabled: Do not discover service reservations from messages. |
| 284 | +
|
| 285 | +- Email: Discover service reservations from messages, but don't automatically add them to the user's calendar. |
| 286 | +
|
| 287 | +- Calendar: Discover service reservations from messages and automatically add them to the user's calendar. This is the default value. |
| 288 | +
|
| 289 | +```yaml |
| 290 | +Type: String |
| 291 | +Parameter Sets: Identity |
| 292 | +Aliases: |
| 293 | + |
| 294 | +Required: False |
| 295 | +Position: Named |
| 296 | +Default value: None |
| 297 | +Accept pipeline input: False |
| 298 | +Accept wildcard characters: False |
| 299 | +``` |
| 300 | +
|
| 301 | +### CommonParameters |
| 302 | +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216). |
| 303 | +
|
| 304 | +## INPUTS |
| 305 | +
|
| 306 | +### |
| 307 | +
|
| 308 | +## OUTPUTS |
| 309 | +
|
| 310 | +### |
| 311 | +
|
| 312 | +## NOTES |
| 313 | +
|
| 314 | +## RELATED LINKS |
0 commit comments