Get-SiteMailbox

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Questo cmdlet è disponibile solo in Exchange locale.

Il cmdlet Get-SiteMailbox consente di visualizzare le informazioni relative alle cassette postali del sito. Questo cmdlet viene usato principalmente da Microsoft SharePoint ed Exchange per visualizzare le informazioni agli utenti nell'interfaccia utente. Potrebbe tuttavia risultare utile per l'individuazione di informazioni quali i proprietari della cassetta postale del sito, i membri e lo stato del ciclo di vita.

Le cassette postali del sito sono state deprecate in Exchange Online e SharePoint Online nel 2017. Per altre informazioni, vedere Deprecazione delle cassette postali del sito.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Get-SiteMailbox
   [[-Identity] <RecipientIdParameter>]
   [-Anr <String>]
   [-BypassOwnerCheck]
   [-DeletedSiteMailbox]
   [-DomainController <Fqdn>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Descrizione

Se non si è un membro o proprietario della cassetta postale del sito per cui si desidera visualizzare le informazioni di diagnostica, è necessario utilizzare il parametro BypassOwnerCheck quando viene eseguito il cmdlet. Se non si è un membro o proprietario della cassetta postale del sito e si esegue il cmdlet senza utilizzare il parametro BypassOwnerCheck, il comando restituisce l'errore "Oggetto non trovato".

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Get-SiteMailbox -BypassOwnerCheck -Identity ContentSite

In questo esempio vengono restituite le informazioni predefinite sulla cassetta postale del sito ContentSite, che include il nome del sito, la chiusura della cassetta postale del sito e l'URL di SharePoint.

Esempio 2

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

Con questo esempio vengono restituite le informazioni complete sulla cassetta postale del sito ContentSite.

Esempio 3

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

In questo esempio viene eseguita una query delle cassette postali del sito contrassegnate per l'eliminazione e vengono rimosse dal database della cassetta postale tramite il pipelining del cmdlet Remove-Mailbox.

Parametri

-Anr

Il parametro Anr consente di specificare una stringa in cui eseguire la ricerca per la risoluzione dei nomi ambigui (ANR). È possibile specificare una stringa parziale e cercare gli oggetti con un attributo che corrisponda alla stringa. Gli attributi predefiniti ricercati sono i seguenti:

  • CommonName (CN)
  • DisplayName
  • FirstName
  • LastName
  • Alias
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BypassOwnerCheck

Il parametro BypassOwnerCheck viene usato quando l'account che esegue il comando non è un membro o un proprietario della cassetta postale del sito. Con questa opzione non è necessario specificare alcun valore.

Se non si usa questa opzione e non si è membri o proprietari della cassetta postale del sito, il comando avrà esito negativo.

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

-DeletedSiteMailbox

L'opzione DeletedSiteMailbox restituisce le cassette postali del sito contrassegnate per l'eliminazione in sospeso. Con questa opzione non è necessario specificare alcun valore.

Quando l'applicazione del ciclo di vita in SharePoint chiude una cassetta postale del sito, la cassetta postale del sito viene conservata per il periodo specificato nei criteri del ciclo di vita nello stato chiuso. La cassetta postale può quindi essere riattivata da un utente finale o da un amministratore di SharePoint. Dopo il periodo di conservazione, la cassetta postale del sito di Exchange ospitata nel database delle cassette postali avrà il nome anteposto a MDEL: per indicare che è stata contrassegnata per l'eliminazione. Per liberare lo spazio di archiviazione e l'alias, utilizzare il cmdlet Remove-Mailbox per rimuovere manualmente le cassette postali del sito dal database.

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

-DomainController

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

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

-Identity

Il parametro Identity consente di specificare l'identità della cassetta postale del sito. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Nome distinto canonico
  • GUID
Type:RecipientIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ReadFromDomainController

L'opzione ReadFromDomainController consente di specificare che le informazioni devono essere lette da un controller di dominio nel dominio dell'utente. Con questa opzione non è necessario specificare alcun valore.

Il comando: Set-AdServerSettings -ViewEntireForest $true per includere tutti gli oggetti nella foresta richiede l'opzione ReadFromDomainController. In caso contrario, il comando potrebbe usare un catalogo globale che contiene informazioni obsolete. Inoltre, potrebbe essere necessario eseguire più iterazioni del comando con l'opzione ReadFromDomainController per ottenere le informazioni.

Per impostazione predefinita, l'ambito del destinatario è impostato sul dominio che ospita i server di Exchange.

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

-ResultSize

Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.

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

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.