Get-MailUser

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi di un ambiente o dell'altro.

Usare il cmdlet Get-MailUser per visualizzare gli utenti di posta elettronica e anche gli utenti guest per Gruppi di Microsoft 365 in ambienti cloud.

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

Sintassi

AnrSet

Get-MailUser
    [-Anr <String>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [-SharedWithMailUser]
    [-SoftDeletedMailUser]
    [-SortBy <String>]
    [<CommonParameters>]

Identity

Get-MailUser
    [[-Identity] <MailUserIdParameter>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [-SharedWithMailUser]
    [-SoftDeletedMailUser]
    [-SortBy <String>]
    [<CommonParameters>]

HVEAccount

Get-MailUser
    [-HVEAccount]
    [-Filter <String>]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ResultSize <Unlimited>]
    [-SharedWithMailUser]
    [-SortBy <String>]
    [-SoftDeletedMailUser]
    [<CommonParameters>]

Descrizione

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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-MailUser

Con questo esempio viene visualizzato un elenco di riepilogo di tutti gli utenti di posta elettronica nell'organizzazione.

Esempio 2

Get-MailUser -Identity Ed | Format-List

Questo esempio restituisce informazioni dettagliate per l'utente di posta elettronica denominato Ed.

Parametri

-Anr

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Componente aggiuntivo di sicurezza predefinito per locale Cassette postali

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AnrSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Credential

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

Questo parametro è disponibile solo in Exchange locale.

Il parametro Credential consente di specificare il nome utente e la password usati per eseguire questo comando. In genere questo parametro viene utilizzato negli script o quando occorre fornire credenziali diverse con le autorizzazioni necessarie.

Questo parametro richiede la creazione e il passaggio di un oggetto credenziale. L'oggetto credenziale viene creato utilizzando il cmdlet Get-Credential. Per altre informazioni, vedere Get-Credential.

Proprietà dei parametri

Tipo:PSCredential
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AnrSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Identity
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DomainController

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

Questo parametro è disponibile solo in Exchange locale.

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.

Proprietà dei parametri

Tipo:Fqdn
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AnrSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Identity
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Filter

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Componente aggiuntivo di sicurezza predefinito per locale Cassette postali

Il parametro Filter utilizza la sintassi OPATH per filtrare i risultati in base alle proprietà e ai valori specificati. Il criterio di ricerca utilizza la sintassi "Property -ComparisonOperator 'Value'".

  • Racchiudere l'intero filtro OPATH tra virgolette doppie " ". Se il filtro contiene valori di sistema (ad esempio, $true, $false, o $null), usare invece le virgolette singole ' '. Anche se questo parametro è una stringa (non un blocco di sistema), puoi anche usare le parentesi graffe { }, ma solo se il filtro non contiene variabili.
  • La proprietà è una proprietà filtrabile. Per ulteriori informazioni sulle proprietà filtrabili in Exchange Server ed Exchange Online, vedere Proprietà filtrabili per il parametro Filter.
  • ComparisonOperator è un operatore di confronto OPATH (ad esempio -eq per gli uguali e -like per il confronto di stringhe). Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators.
  • Valore è il valore della proprietà da cercare. Racchiudere i valori di testo e le variabili tra virgolette singole ('Value' o '$Variable'). Se un valore di variabile contiene virgolette singole, sarà necessario identificarle (eseguire l'escape) per espandere correttamente la variabile. Ad esempio, al posto di '$User', usare '$($User -Replace "'","''")'. Non racchiudere interi o valori di sistema tra virgolette, ad esempio usare 500, $true, $false, o $null viceversa.

È possibile concatenare più criteri di ricerca usando gli operatori -and logici e -or. Ad esempio, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".

Per informazioni dettagliate sui filtri OPATH in Exchange, vedere Ulteriori informazioni sulla sintassi OPATH.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-HVEAccount

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Questo parametro è disponibile solamente nel servizio basato su cloud.

L'opzione HVEAccount specifica che questo account utente di posta è usato in modo specifico per il servizio di posta elettronica ad alto volume. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

HVEAccount
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Componente aggiuntivo di sicurezza predefinito per locale Cassette postali

Il parametro Identity consente di specificare l'utente di posta elettronica che si desidera visualizzare. È possibile utilizzare qualsiasi valore che identifichi l'utente di posta in modo univoco. Esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Nome distinto canonico
  • GUID

Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se si eseguisse il comando Get- senza il parametro Identity. Verificare che tutti gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.

Proprietà dei parametri

Tipo:MailUserIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Identity
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IgnoreDefaultScope

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

Questo parametro è disponibile solo in Exchange locale.

L'opzione IgnoreDefaultScope indica al comando di ignorare l'impostazione dell'ambito del destinatario predefinito per la sessione PowerShell di Exchange e di utilizzare l'intera foresta come ambito. Con questa opzione non è necessario specificare alcun valore.

Questa opzione consente al comando di accedere agli oggetti di Active Directory che non sono attualmente disponibili nell'ambito predefinito, ma introduce anche le seguenti restrizioni:

  • Non è possibile utilizzare il parametro DomainController. Il comando utilizza automaticamente un server di catalogo globale appropriato.
  • È possibile utilizzare solo il DN per il parametro Identity. Non vengono accettate altre forme di identificazione, ad esempio alias o GUID.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AnrSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Identity
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OrganizationalUnit

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Componente aggiuntivo di sicurezza predefinito per locale Cassette postali

Il parametro OrganizationalUnit filtra i risultati in base alla posizione dell'oggetto in Active Directory. Vengono restituiti solo gli oggetti presenti nella posizione specificata. L'input valido per questo parametro è un'unità organizzativa (OU) o un dominio restituito dal cmdlet Get-OrganizationalUnit. È possibile utilizzare qualsiasi valore che identifichi l'unità organizzativa o il dominio in modo univoco. Ad esempio:

  • Nome
  • Nome
  • Nome distinto (DN)
  • GUID

Proprietà dei parametri

Tipo:OrganizationalUnitIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ReadFromDomainController

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

Questo parametro è disponibile solo in Exchange locale.

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AnrSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Identity
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ResultSize

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Componente aggiuntivo di sicurezza predefinito per locale Cassette postali

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.

Proprietà dei parametri

Tipo:Unlimited
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SharedWithMailUser

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Questo parametro è disponibile solamente nel servizio basato su cloud.

{{ Fill SharedWithMailUser Description }}

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AnrSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Identity
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SoftDeletedMailUser

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Questo parametro è disponibile solamente nel servizio basato su cloud.

L'opzione SoftDeletedMailUser specifica se includere gli utenti di posta elettronica eliminati temporaneamente nei risultati. Con questa opzione non è necessario specificare alcun valore.

Gli utenti di posta elettronica eliminati temporaneamente sono utenti di posta elettronica eliminati che sono ancora recuperabili.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SortBy

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Componente aggiuntivo di sicurezza predefinito per locale Cassette postali

Il parametro SortBy consente di specificare la proprietà in base a cui ordinare i risultati. È possibile ordinare in base a una sola proprietà alla volta. I risultati vengono visualizzati in ordine crescente.

Se la visualizzazione predefinita non include la proprietà in base alla quale si sta eseguendo l'ordinamento, è possibile aggiungere al comando | Format-Table -Auto Property1,Property2,...PropertyX. per creare una nuova visualizzazione che contenga tutte le proprietà che si desidera visualizzare. I caratteri jolly (*) nei nomi di proprietà sono supportati.

È possibile eseguire l'ordinamento in base alle seguenti proprietà:

  • Nome
  • DisplayName
  • Alias

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

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.