Postfacheinstellungen des Benutzers aktualisierenUpdate user mailbox settings

Aktivieren, konfigurieren oder deaktivieren Sie eine oder mehrere der folgenden Einstellungen als Teil des Mailbox Settingseines Benutzers:Enable, configure, or disable one or more of the following settings as part of a user's mailboxSettings:

Wenn Sie das bevorzugte Datums-oder Uhrzeitformat für einen Benutzer aktualisieren, geben Sie es im Format " Short Date " oder " Short Time " ein.When updating the preferred date or time format for a user, specify it in respectively, the short date or short time format.

Wenn Sie die bevorzugte Zeitzone für einen Benutzer aktualisieren, geben Sie ihn im Format Windows oder IANA-Zeitzone (Internet Assigned Numbers Authority ) (auch als Olson-Zeitzone bezeichnet) an.When updating the preferred time zone for a user, specify it in the Windows or Internet Assigned Numbers Authority (IANA) time zone (also known as Olson time zone) format. Sie können die Zeitzone auch weiter anpassen, wie in Beispiel 2 unten dargestellt.You can also further customize the time zone as shown in example 2 below.

Tipp

Sie können keine Postfacheinstellungen erstellen oder löschen.You cannot create or delete any mailbox settings.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) MailboxSettings.ReadWriteMailboxSettings.ReadWrite
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) MailboxSettings.ReadWriteMailboxSettings.ReadWrite
AnwendungApplication MailboxSettings.ReadWriteMailboxSettings.ReadWrite

HTTP-AnforderungHTTP request

PATCH /me/mailboxSettings
PATCH /users/{id|userPrincipalName}/mailboxSettings

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.This method supports the OData Query Parameters to help customize the response.

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die relevanten Eigenschaften an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben. Im Folgenden werden die beschreibbaren/aktualisierbaren Eigenschaften aufgelistet:In the request body, supply the values for the relevant properties that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed. The following are the writable/updatable properties:

EigenschaftProperty TypType BeschreibungDescription
automaticRepliesSettingautomaticRepliesSetting automaticRepliesSettingautomaticRepliesSetting Konfigurationseinstellungen zum automatischen Benachrichtigen des Absenders bei eingehenden E-Mails mit einer Nachricht vom angemeldeten Benutzer.Configuration settings to automatically notify the sender of an incoming email with a message from the signed-in user. Sie können solche Benachrichtigungen nur für einen zukünftigen Datumsbereich festlegen.You can set such notifications for only a future date range.
DATEFORMATdateFormat stringstring Das Datumsformat für das Postfach des Benutzers.The date format for the user's mailbox.
languagelanguage localeInfolocaleInfo Die Gebietsschemainformationen des Benutzers, einschließlich der bevorzugten Sprache und Land/Region.The locale information for the user, including the preferred language and country/region.
TimeFormattimeFormat stringstring Das Zeitformat für das Postfach des Benutzers.The time format for the user's mailbox.
timeZonetimeZone stringstring Die Standardzeitzone für das Postfach des Benutzers.The default time zone for the user's mailbox.
workingHoursworkingHours workingHoursworkingHours Die Stunden, Wochentage und die Zeitzone, an denen bzw. in der der Benutzer arbeitet.The hours, days of a week, and time zone that the user works.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 200 OK werden der Antwortcode und die aktualisierten Eigenschaften eines Mailbox Settings -Objekts im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and the updated properties of a mailboxSettings object in the response body.

FehlerErrors

Durch Festlegen von Geschäftszeiten mit falschen Werten können möglicherweise die folgenden Fehler zurückgegeben werden.Setting working hours with inappropriate values may return the following errors.

SzenarioScenario HTTP-StatuscodeHTTP status code FehlercodeError code FehlermeldungError message
Ungültige startTime oder endTimeInvalid startTime or endTime 400400 RequestBodyReadRequestBodyRead Das Literal „08“ kann nicht in den erwarteten Typ „Edm.TimeOfDay“ konvertiert werden.Cannot convert the literal '08' to the expected type 'Edm.TimeOfDay'.
Die Startzeit größer als die EndzeitStart time is greater than end time 400400 ErrorInvalidTimeSettingsErrorInvalidTimeSettings Die Startzeit muss vor der Endzeit liegen.Start Time should occur before End Time.
Ungültiger Tag in daysOfWeekInvalid day in daysOfWeek 400400 InvalidArgumentsInvalidArguments Der angeforderte Wert „RandomDay“ wurde nicht gefunden.Requested value 'RandomDay' was not found.
Ungültige timeZoneInvalid timeZone 400400 InvalidTimeZoneInvalidTimeZone Die angegebenen Zeitzoneneinstellungen sind ungültig.Time Zone settings provided are invalid.

BeispieleExamples

Beispiel 1Example 1

AnforderungRequest

Im folgenden Beispiel werden automatische Antworten für einen bestimmten Datumsbereich durch Festlegen der folgenden Eigenschaften der automaticRepliesSetting-Eigenschaft aktiviert: status, scheduledStartDateTime und scheduledEndDateTime.The first example enables automatic replies for a date range, by setting the following properties of the automaticRepliesSetting property: status, scheduledStartDateTime and scheduledEndDateTime.

PATCH https://graph.microsoft.com/v1.0/me/mailboxSettings
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Me/mailboxSettings",
    "automaticRepliesSetting": {
        "status": "Scheduled",
        "scheduledStartDateTime": {
          "dateTime": "2016-03-20T18:00:00.0000000",
          "timeZone": "UTC"
        },
        "scheduledEndDateTime": {
          "dateTime": "2016-03-28T18:00:00.0000000",
          "timeZone": "UTC"
        }
    }
}

AntwortResponse

Die Antwort enthält die aktualisierten Einstellungen für automatische Antworten.The response includes the updated settings for automatic replies. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten.Note: The response object shown here may be truncated for brevity. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Me/mailboxSettings",
    "automaticRepliesSetting": {
        "status": "scheduled",
        "externalAudience": "all",
        "scheduledStartDateTime": {
            "dateTime": "2016-03-20T02:00:00.0000000",
            "timeZone": "UTC"
        },
        "scheduledEndDateTime": {
            "dateTime": "2016-03-28T02:00:00.0000000",
            "timeZone": "UTC"
        },
    "internalReplyMessage": "<html>\n<body>\n<p>I'm at our company's worldwide reunion and will respond to your message as soon as I return.<br>\n</p></body>\n</html>\n",
    "externalReplyMessage": "<html>\n<body>\n<p>I'm at the Contoso worldwide reunion and will respond to your message as soon as I return.<br>\n</p></body>\n</html>\n"
    }
}

Beispiel 2Example 2

AnforderungRequest

Das zweite Beispiel passt die Zeitzone für die Geschäftszeiten des angemeldeten Benutzers an, indem die timeZone-Eigenschaft auf eine benutzerdefinierte Zeitzone festgelegt wird.The second example customizes the time zone for the working hours of the signed-in user, by setting the timeZone property to a custom time zone.

PATCH https://graph.microsoft.com/v1.0/me/mailboxSettings
Content-Type: application/json

{
  "workingHours": {
      "endTime" : "18:30:00.0000000", 
      "daysOfWeek": [ 
          "Monday", 
          "Tuesday", 
          "Wednesday", 
          "Thursday", 
          "Friday", 
          "Saturday" 
      ], 
      "timeZone" : { 
         "@odata.type": "#microsoft.graph.customTimeZone", 
         "bias":-300, 
         "name": "Customized Time Zone",
         "standardOffset":{   
           "time":"02:00:00.0000000", 
           "dayOccurrence":2, 
           "dayOfWeek":"Sunday", 
           "month":10, 
           "year":0 
         }, 
         "daylightOffset":{   
           "daylightBias":100, 
           "time":"02:00:00.0000000", 
           "dayOccurrence":4, 
           "dayOfWeek":"Sunday", 
           "month":5, 
           "year":0 
         } 
      } 
  }
} 

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#users('94447c6e-ea4c-494c-a9ed-d905e366c5cb')/mailboxSettings",
    "workingHours":{
        "daysOfWeek":[
            "monday",
            "tuesday",
            "wednesday",
            "thursday",
            "friday",
            "saturday"
        ],
        "startTime":"09:00:00.0000000",
        "endTime":"18:30:00.0000000",
        "timeZone":{
            "@odata.type":"#microsoft.graph.customTimeZone",
            "bias":-200,
            "name":"Customized Time Zone",
            "standardOffset":{
                "time":"02:00:00.0000000",
                "dayOccurrence":4,
                "dayOfWeek":"sunday",
                "month":5,
                "year":0
            },
            "daylightOffset":{
                "daylightBias":-100,
                "time":"02:00:00.0000000",
                "dayOccurrence":2,
                "dayOfWeek":"sunday",
                "month":10,
                "year":0
            }
        }
    }
}