Set-MailboxCalendarFolder

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.

Utilisez l’applet de commande Set-MailboxCalendarFolder pour configurer les paramètres de publication ou de partage de calendrier sur une boîte aux lettres pour la visibilité des informations de calendrier pour les utilisateurs externes. Pour ajouter ou modifier les autorisations afin que les utilisateurs internes puissent accéder au calendrier, utilisez les applets de commande Add-MailboxFolderPermission ou Set-MailboxFolderPermission.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

Set-MailboxCalendarFolder
   [-Identity] <MailboxFolderIdParameter>
   [-Confirm]
   [-DetailLevel <DetailLevelEnumType>]
   [-DomainController <Fqdn>]
   [-PublishDateRangeFrom <DateRangeEnumType>]
   [-PublishDateRangeTo <DateRangeEnumType>]
   [-PublishEnabled <Boolean>]
   [-ResetUrl]
   [-SearchableUrlEnabled <Boolean>]
   [-SetAsSharingSource]
   [-SharedCalendarSyncStartDate <DateTime>]
   [-UseHttps]
   [-WhatIf]
   [<CommonParameters>]

Description

L’applet de commande Set-MailboxCalendarFolder configure les informations de publication de calendrier. Le dossier calendrier peut être configuré comme suit :

  • Indique si le dossier calendrier est activé pour la publication
  • Plage de jours calendaires de début et de fin à publier
  • Niveau de détail à publier pour le calendrier
  • Si l’URL publiée du calendrier est activée pour la recherche sur le web

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Set-MailboxCalendarFolder -Identity kai:\Calendar -DetailLevel LimitedDetails

Cet exemple définit le niveau de détails à publier pour le calendrier partagé de Kai sur LimitedDetails, ce qui signifie que des détails limités sont affichés.

Exemple 2

Set-MailboxCalendarFolder -Identity kai:\Calendar -SearchableUrlEnabled $true

Cet exemple montre comment activer la recherche sur le web dans le calendrier de la boîte aux lettres de Kai.

Paramètres

-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DetailLevel

Le paramètre DetailLevel spécifie le niveau de détails du calendrier qui est publié et disponible pour les utilisateurs anonymes. Les valeurs valides sont les suivantes :

  • AvailabilityOnly (il s’agit de la valeur par défaut)
  • LimitedDetails
  • FullDetails
  • Éditeur

Ce paramètre est significatif uniquement lorsque la valeur du paramètre PublishEnabled est $true.

Type:DetailLevelEnumType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Le paramètre Identity spécifie le dossier calendrier que vous souhaitez modifier. La syntaxe pour cela est MailboxID:\ParentFolder[\SubFolder].

Pour la valeur de MailboxID, vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la boîte aux lettres. Par exemple :

  • Nom
  • Alias
  • Nom unique
  • Nom unique
  • Domaine\Nom d’utilisateur
  • Adresse e-mail
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

Exemples de valeurs pour ce paramètre : john@contoso.com:\Calendar ou John:\Calendar

Type:MailboxFolderIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PublishDateRangeFrom

Le paramètre PublishDateRangeFrom spécifie la date de début des informations de calendrier à publier (informations passées). Les valeurs valides sont les suivantes :

  • Oneday
  • Trois jours
  • OneWeek
  • OneMonth
  • ThreeMonths (il s’agit de la valeur par défaut)
  • SixMois
  • OneYear

Ce paramètre est significatif uniquement lorsque la valeur du paramètre PublishEnabled est $true.

Type:DateRangeEnumType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-PublishDateRangeTo

Le paramètre PublishDateRangeTo spécifie la date de fin des informations de calendrier à publier (informations futures). Les valeurs valides sont les suivantes :

  • Oneday
  • Trois jours
  • OneWeek
  • OneMonth
  • ThreeMonths (il s’agit de la valeur par défaut)
  • SixMois
  • OneYear

Ce paramètre est significatif uniquement lorsque la valeur du paramètre PublishEnabled est $true.

Type:DateRangeEnumType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-PublishEnabled

Le paramètre PublishEnabled spécifie s’il faut publier les informations de calendrier spécifiées. Les valeurs valides sont les suivantes :

  • $true : les informations de calendrier sont publiées.
  • $false : les informations de calendrier ne sont pas publiées. Il s’agit de la valeur par défaut.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResetUrl

Le commutateur ResetUrl remplace l’URL non publique existante par une nouvelle URL pour un calendrier qui a été publié sans faire l’objet d’une recherche publique. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SearchableUrlEnabled

Le paramètre SearchableUrlEnabled spécifie si l’URL du calendrier publié est détectable sur le web.

  • $true : l’URL du calendrier publié est détectable sur le web.
  • $false : l’URL du calendrier publié n’est pas détectable sur le web. Il s’agit de la valeur par défaut.

Ce paramètre est significatif uniquement lorsque la valeur du paramètre PublishEnabled est $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SetAsSharingSource

Le commutateur SetAsSharingSource spécifie s’il faut définir le dossier calendrier comme source de partage. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SharedCalendarSyncStartDate

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Remarque : Ce paramètre est pris en charge uniquement pour les calendriers partagés qui ont été mis à niveau comme décrit dans Partage de calendriers dans Microsoft 365 et n’est applicable à aucun autre type de calendrier ou de dossier de boîte aux lettres.

Le paramètre SharedCalendarSyncStartDate spécifie la limite pour les événements passés dans le calendrier partagé qui sont visibles par les délégués. Une copie du calendrier partagé dans la plage de dates spécifiée est stockée dans la boîte aux lettres du délégué.

Pour spécifier une valeur date/heure pour ce paramètre, utilisez l’une des options suivantes :

  • Spécifiez la valeur de date/heure utc : par exemple, « 2021-05-06 14:30:00z ».
  • Spécifiez la valeur de date/heure en tant que formule qui convertit la date/heure de votre fuseau horaire local au format UTC : par exemple, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Pour plus d’informations, consultez Get-Date.

Remarques :

  • Vous utilisez ce paramètre sur le calendrier partagé dans la boîte aux lettres du délégué. Par exemple : Set-MailboxCalendarFolder -Identity delegate@contoso.onmicrosoft.com:DelegateSharedCalendarFolderId" -SharedCalendarSyncStartDate (Get-Date "5/6/2023 9:30 AM").ToUniversalTime(). DelegateSharedCalendarFolderId est le FolderId du calendrier partagé dans la boîte aux lettres du délégué (par exemple, Get-MailboxFolderStatistics -Identity delegate@contoso.onmicrosoft.com -FolderScope Calendar | Format-List Name,FolderId).
  • Les utilisateurs doivent disposer d’un accès FullDetails, Editor ou Delegate au calendrier partagé spécifié.
  • La définition de ce paramètre peut entraîner la disparition des événements du calendrier partagé pendant que le calendrier est resynchronisé.
  • La valeur de ce paramètre est utilisée lors de l’initialisation de la synchronisation du dossier du calendrier. Après cela, chaque élément nouveau, mis à jour et supprimé est traité et synchronisé, quelle que soit la valeur du paramètre SharedCalendarSyncStartDate.
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UseHttps

Le commutateur UseHttps spécifie s’il faut utiliser HTTPS pour l’URL publiée du dossier calendrier. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Ce commutateur n’est significatif que lorsque la valeur du paramètre PublishEnabled est $true.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.