Set-MailboxCalendarFolder

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres et réglages peuvent être exclusifs à l’un ou l’autre environnement.

Utilisez l’applet de commande Set-MailboxCalendarFolder pour configurer les paramètres de publication ou de partage d’un calendrier sur une boîte aux lettres afin d’assurer la visibilité des informations de calendrier aux 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.

Syntaxe

Default (Par défaut)

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 du calendrier. Le dossier calendrier peut être configuré comme suit :

  • Si le dossier calendrier est activé pour la publication
  • Plage de jours civils de début et de fin pour la publication
  • 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 cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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 permet au calendrier de la boîte aux lettres de Kai d’être consultable sur le Web.

Paramètres

-Confirm

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Module complémentaire de sécurité intégré pour boîtes aux lettres

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent 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 applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DetailLevel

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

  • AvailabilityOnly (par défaut)
  • Détails limités
  • FullDetails

Ce paramètre n’a de sens que si la valeur du paramètre PublishEnabled est $true.

Propriétés du paramètre

Type:DetailLevelEnumType
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DomainController

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 ».

Propriétés du paramètre

Type:Fqdn
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Module complémentaire de sécurité intégré pour boîtes aux lettres

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

Pour la valeur , MailboxIDvous 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)

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

Propriétés du paramètre

Type:MailboxFolderIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PublishDateRangeFrom

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 (valeur par défaut)
  • SixMois
  • Un an

Ce paramètre n’a de sens que si la valeur du paramètre PublishEnabled est $true.

Propriétés du paramètre

Type:DateRangeEnumType
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PublishDateRangeTo

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 (valeur par défaut)
  • SixMois
  • Un an

Ce paramètre n’a de sens que si la valeur du paramètre PublishEnabled est $true.

Propriétés du paramètre

Type:DateRangeEnumType
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PublishEnabled

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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. Cette valeur est la valeur par défaut.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResetUrl

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SearchableUrlEnabled

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Le paramètre SearchableUrlEnabled indique 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. Cette valeur est la valeur par défaut.

Ce paramètre n’a de sens que si la valeur du paramètre PublishEnabled est $true.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SetAsSharingSource

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Le commutateur SetAsSharingSource spécifie si le dossier de calendrier doit être défini comme source de partage. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SharedCalendarSyncStartDate

Applicable : Exchange Online

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

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

Le paramètre SharedCalendarSyncStartDate spécifie la limite des é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 date/heure dans UTC : Par exemple, « 2021-05-06 14:30:00z ».
  • Spécifiez la valeur date/heure sous la forme d’une formule qui convertit la date/heure de votre fuseau horaire local en UTC : Par exemple, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Pour plus d’informations, consultez Get-Date.

Remarques :

  • Ce paramètre s’utilise 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 correspond à l’ID de dossier 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, Éditeur ou Délégué au calendrier partagé spécifié.
  • La définition de ce paramètre peut entraîner la disparition brève des événements du calendrier partagé pendant la resynchronisation du calendrier.
  • La valeur de ce paramètre est utilisée lors de l’initialisation de la synchronisation des dossiers 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.

Propriétés du paramètre

Type:DateTime
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UseHttps

Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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’a de sens que lorsque la valeur du paramètre PublishEnabled est $true.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Module complémentaire de sécurité intégré pour boîtes aux lettres

Le commutateur WhatIf affiche ce que la commande fait sans apporter de modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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.