Get-SiteMailbox

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-04-06

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

La cmdlet Get-SiteMailbox permet d'afficher des informations sur les boîtes aux lettres de site. Cette cmdlet est principalement utilisée par MicrosoftSharePoint et Exchange pour afficher des informations destinées aux utilisateurs dans l’interface utilisateur. Toutefois, elle peut également être utile pour les informations de découverte telles que les propriétaires, les membres et le statut de cycle de vie des boîtes aux lettres de site.

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

Get-SiteMailbox <COMMON PARAMETERS>

Get-SiteMailbox [-BypassOwnerCheck <SwitchParameter>] [-DeletedSiteMailbox <SwitchParameter>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-Anr <String>] [-DomainController <Fqdn>] [-Identity <RecipientIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>]

Cet exemple renvoie les informations par défaut relatives à la boîte aux lettres de site ContentSite, qui inclut le nom du site lorsque la boîte aux lettres de site était fermée, et l'URL SharePoint.

Get-SiteMailbox -BypassOwnerCheck -Identity ContentSite

Cet exemple renvoie les informations complètes sur la boîte aux lettres de site ContentSite.

Get-SiteMailbox -BypassOwnerCheck -Identity ContentSite | Format-List

Cet exemple interroge les boîtes aux lettres de site marquées pour suppression et les supprime de la base de données de boîtes aux lettres en opérant un pipelining de la cmdlet Remove-Mailbox.

Get-SiteMailbox -BypassOwnerCheck -DeletedSiteMailbox | Remove-Mailbox -Confirm:$false

Si n'êtes ni membre ni propriétaire de la boîte aux lettres de site pour laquelle vous souhaitez afficher les informations de diagnostic, vous devez utiliser le paramètre BypassOwnerCheck lors de l'exécution de cette cmdlet. Si n'êtes ni membre ni propriétaire de la boîte aux lettres de site et que vous exécutez cette cmdlet sans utiliser le paramètre BypassOwnerCheck, la commande échoue avec une erreur « Objet non trouvé ».

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir entrée « Boîtes aux lettres de site » dans la rubrique Autorisations de partage et de collaboration.

 

Paramètre Obligatoire Type Description

Anr

Facultatif

System.String

Le paramètre Anr spécifie une chaîne sur laquelle une recherche de résolution de noms ANR (Ambiguous Name Resolution) peut porter. Vous pouvez spécifier une chaîne partielle et rechercher des objets ayant un attribut correspondant à cette chaîne. Les attributs par défaut recherchés sont :

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

BypassOwnerCheck

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre BypassOwnerCheck est utilisé lorsque le compte qui exécute la commande n’est pas membre ou propriétaire de la boîte aux lettres de site. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si vous exécutez la commande sans ce paramètre et que vous n’êtes pas membre ou propriétaire de la boîte aux lettres de site, la commande échoue.

DeletedSiteMailbox

Facultatif

System.Management.Automation.SwitchParameter

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

Le commutateur DeletedSiteMailbox renvoie les boîtes aux lettres de site qui ont été marquées pour suppression. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Lorsque l’application de cycle de vie dans SharePoint ferme une boîte aux lettres de site, celle-ci est conservée pendant la période indiquée dans la stratégie du cycle de vie dans l’état Fermé. La boîte aux lettres peut ensuite être réactivée par un utilisateur final ou par un administrateur SharePoint. Après la période de rétention, le nom de la boîte aux lettres de site Exchange qui est hébergée dans la base de données de boîtes aux lettres sera précédé de MDEL: pour indiquer qu'elle a été marquée pour suppression. Pour libérer de l’espace de stockage ainsi que l’alias, utilisez la cmdlet Remove-Mailbox afin de supprimer manuellement ces boîtes aux lettres de site de la base de données de boîtes aux lettres.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 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.

Identity

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Le paramètre Identity spécifie l'identité de la boîte aux lettres de site. Vous pouvez utiliser l'une des valeurs suivantes :

  • GUID

  • Nom unique (DN)

  • Nom d'affichage

  • Domain\Account

  • Nom d'utilisateur principal (UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

ReadFromDomainController

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur ReadFromDomainController spécifie quelles informations doivent être lues à partir d’un contrôleur de domaine dans le domaine de l’utilisateur. Si vous exécutez la commande Set-AdServerSettings -ViewEntireForest $true pour inclure tous les objets dans la forêt et que vous n'utilisez pas le commutateur ReadFromDomainController, vous n'obtiendrez peut-être pas des informations actualisées. Si vous utilisez le commutateur ReadFromDomainController, plusieurs lectures seront peut-être nécessaires avant d'obtenir l'information. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

noteRemarque :
Par défaut, la portée du destinataire est définie sur le domaine qui héberge vos serveurs Exchange.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. Pour retourner toutes les demandes correspondant à la requête, utilisez unlimited comme valeur pour ce paramètre. La valeur par défaut est 1000.

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.

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.

 
Afficher: