Get-Recipient

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Utilizzare il cmdlet Get-Recipient per visualizzare gli oggetti destinatario esistenti nell'organizzazione. Il cmdlet restituisce tutti gli oggetti abilitati alla posta elettronica (ad esempio, cassette postali, utenti e contatti di posta elettronica e gruppi di distribuzione).

Nota: in PowerShell di Exchange Online, si consiglia di utilizzare il cmdlet Get-EXORecipient anziché questo cmdlet. Per ulteriori informazioni, vedere Connessione a Exchange Online PowerShell.

Negli ambienti cloud, per restituire i gruppi di Microsoft 365, è necessario utilizzare il parametro RecipientTypeDetails con il valore GroupMailbox.

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

Sintassi

Get-Recipient
   [-Anr <String>]
   [-AuthenticationType <AuthenticationType>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PropertySet <PropertySet>]
   [-ReadFromDomainController]
   [-RecipientType <RecipientType[]>]
   [-RecipientTypeDetails <RecipientTypeDetails[]>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-Capabilities <MultiValuedProperty>]
   [-Database <DatabaseIdParameter>]
   [-Properties <String[]>]
   [-IncludeSoftDeletedRecipients]
   [<CommonParameters>]
Get-Recipient
   [[-Identity] <RecipientIdParameter>]
   [-AuthenticationType <AuthenticationType>]
   [-BookmarkDisplayName <String>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-IncludeBookmarkObject <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PropertySet <PropertySet>]
   [-ReadFromDomainController]
   [-RecipientType <RecipientType[]>]
   [-RecipientTypeDetails <RecipientTypeDetails[]>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-Capabilities <MultiValuedProperty>]
   [-Properties <String[]>]
   [-IncludeSoftDeletedRecipients]
   [<CommonParameters>]
Get-Recipient
   [-Database <DatabaseIdParameter>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-Properties <String[]>]
   [-PropertySet <PropertySet>]
   [-ReadFromDomainController]
   [-RecipientType <RecipientType[]>]
   [-RecipientTypeDetails <RecipientTypeDetails[]>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-IncludeSoftDeletedRecipients] [<CommonParameters>]
   [<CommonParameters>]
Get-Recipient
   [-RecipientPreviewFilter <String>]
   [-AuthenticationType <AuthenticationType>]
   [-Capabilities <MultiValuedProperty>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-IncludeSoftDeletedRecipients]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-Properties <String[]>]
   [-PropertySet <PropertySet>]
   [-ReadFromDomainController]
   [-RecipientType <RecipientType[]>]
   [-RecipientTypeDetails <RecipientTypeDetails[]>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-Recipient potrebbe non restituire tutte le proprietà specifiche di un destinatario. Per visualizzare le proprietà specifiche di un oggetto del destinatario, è necessario utilizzare il cmdlet corrispondente in base al tipo di oggetto (ad esempio, Get-Mailbox, Get-MailUser, o Get-DistributionGroup).

È 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-Recipient -ResultSize unlimited

Questo esempio consente di recuperare un elenco riepilogativo di tutti i destinatari nell'organizzazione.

Esempio 2

Get-Recipient -Identity "Marketing Department" | Format-List

In questo esempio vengono restituite informazioni dettagliate per il destinatario denominato Marketing Department.

Esempio 3

Get-Recipient -RecipientType MailContact -SortBy Office | Format-Table -Auto Office,Name

Con questo esempio vengono recuperate le informazioni su tutti i contatti di posta elettronica all'interno dell'organizzazione, ordinati in base all'ufficio.

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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-AuthenticationType

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro AuthenticationType consente di specificare il destinatario in base al tipo di autenticazione. Utilizzare uno dei seguenti valori:

  • Federato
  • Gestione
Type:AuthenticationType
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance Center, Exchange Online Protection
-BookmarkDisplayName

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-Capabilities

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance Center, Exchange Online Protection
-Credential

Questo parametro è disponibile solo in Exchange locale.

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

Un valore per questo parametro richiede il cmdlet Get-Credential. Per sospendere questo comando e visualizzare la richiesta di immissione delle credenziali, usare il valore (Get-Credential). In alternativa, prima di eseguire questo comando, archiviare le credenziali in una variabile (ad esempio, $cred = Get-Credential) e quindi usare il nome della variabile ($cred) per questo parametro. Per altre informazioni, vedere Get-Credential.

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

Questo parametro è disponibile solo in Exchange locale.

Il parametro Database restituisce tutti i destinatari archiviati nel database delle cassette postali specificato. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID
Type:DatabaseIdParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-DomainController

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.

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

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

  • Racchiudere l'intero filtro OPath tra virgolette doppie " ". Se il filtro contiene valori di sistema (ad esempio, , o ), utilizzare $true $false le $null virgolette singole ' '. Anche se questo parametro è una stringa (non un blocco di sistema), è anche possibile utilizzare le parentesi graffe { }, ma solo se il filtro non contiene variabili.
  • La proprietà è una proprietà filtrabile. Per ulteriori informazioni sulle proprietà filtrabili, vedere Proprietà filtrabili per il parametro Filter.
  • ComparisonOperator è un operatore di confronto OPath, ad esempio per -eq equals e -like per il confronto tra stringhe. Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators.
  • Il 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, è necessario identificare (escape) le virgolette singole per espandere correttamente la variabile. Ad esempio, anziché '$User' , utilizzare '$($User -Replace "'","''")' . Non racchiudere valori interi o di sistema (ad esempio, 500 $true , , o $false $null ).

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

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-Identity

Il parametro Identity consente di specificare l'oggetto destinatario da visualizzare. È possibile utilizzare qualsiasi valore che identifichi il destinatario in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Nome distinto canonico
  • GUID
Type:RecipientIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-IgnoreDefaultScope

Questo parametro è disponibile solo in Exchange locale.

L'opzione IgnoreDefaultScope imposta il comando in modo che ignori l'impostazione predefinita dell'ambito dei destinatari per la sessione di Exchange Management Shell e usi invece l'intera foresta come ambito. In questo modo il comando può accedere agli oggetti di Active Directory attualmente non disponibili nell'ambito predefinito.

L'utilizzo del parametro IgnoreDefaultScope presenta 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.
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-IncludeBookmarkObject

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-IncludeSoftDeletedRecipients

L'opzione IncludeSoftDeletedRecipients consente di specificare se includere i destinatari eliminati in modo reverso nei risultati. Con questa opzione non è necessario specificare alcun valore.

I destinatari eliminati in modo reversibile sono destinatari eliminati che sono ancora ripristinabili.

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

Il parametro OrganizationalUnit consente di filtrare 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
Type:OrganizationalUnitIdParameter
Position:Named
Default value:None
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
-Properties

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-PropertySet

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:PropertySet
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-ReadFromDomainController

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. Se si esegue il comando Set-AdServerSettings -ViewEntireForest $true in modo che nella foresta vengano inclusi tutti gli oggetti e non si utilizza l'opzione ReadFromDomainController, è possibile che le informazioni vengano lette da un catalogo globale contenente informazioni obsolete. Quando si utilizza l'opzione ReadFromDomainController, potrebbero essere necessarie più letture per ottenere le informazioni. Non è necessario specificare un valore con questa opzione.

Per impostazione predefinita, l'ambito dei destinatari è impostato sul dominio che ospita i server Exchange.

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

Il parametro RecipientPreviewFilter consente di testare un filtro destinatario da utilizzare in un gruppo di distribuzione dinamico, in un elenco di indirizzi o in un criterio dell'indirizzo di posta elettronica. Questo parametro utilizza la sintassi del filtro Opath "Property -ComparisonOperator 'Value'" (la stessa sintassi del parametro RecipientFilter).

  • Racchiudere l'intero filtro OPath tra virgolette doppie " ". Se il filtro contiene valori di sistema (ad esempio, , o ), utilizzare $true $false le $null virgolette singole ' '. Anche se questo parametro è una stringa (non un blocco di sistema), è anche possibile utilizzare le parentesi graffe { }, ma solo se il filtro non contiene variabili.
  • La proprietà è una proprietà filtrabile. Per le proprietà filtrabili del destinatario, vedere Proprietà filtrabili per il parametro RecipientFilter.
  • ComparisonOperator è un operatore di confronto OPath, ad esempio per -eq equals e -like per il confronto tra stringhe. Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators.
  • Il 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, è necessario identificare (escape) le virgolette singole per espandere correttamente la variabile. Ad esempio, anziché '$User' , utilizzare '$($User -Replace "'","''")' . Non racchiudere valori interi o di sistema (ad esempio, 500 $true , , o $false $null ).

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-RecipientType

Il parametro RecipientType consente di filtrare i risultati in base al tipo di destinatario specificato. I valori validi sono:

  • DynamicDistributionGroup
  • MailContact
  • MailNonUniversalGroup
  • MailUniversalDistributionGroup
  • MailUniversalSecurityGroup
  • MailUser
  • PublicFolder
  • UserMailbox

È possibile specificare più valori separati da virgole.

Type:RecipientType[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-RecipientTypeDetails

Il parametro RecipientTypeDetails consente di filtrare i risultati in base al sottotipo di destinatario specificato. I valori validi sono:

  • DiscoveryMailbox
  • DynamicDistributionGroup
  • EquipmentMailbox
  • GroupMailbox
  • GuestMailUser
  • LegacyMailbox
  • LinkedMailbox
  • LinkedRoomMailbox
  • MailContact
  • MailForestContact
  • MailNonUniversalGroup
  • MailUniversalDistributionGroup
  • MailUniversalSecurityGroup
  • MailUser
  • PublicFolder
  • PublicFolderMailbox
  • RemoteEquipmentMailbox
  • RemoteRoomMailbox
  • RemoteSharedMailbox
  • RemoteTeamMailbox
  • RemoteUserMailbox
  • RoomList
  • RoomMailbox
  • SchedulingMailbox
  • SharedMailbox
  • TeamMailbox
  • UserMailbox

È possibile specificare più valori separati da virgole.

Il valore del parametro RecipientType influisce sui valori che è possibile utilizzare per questo parametro. Ad esempio, se si utilizza il valore RecipientType MailContact, non è possibile utilizzare il valore UserMailbox per questo parametro. Verrà visualizzato l'errore: Nessuno dei RecipientTypeDetails specificati è incluso in un tipo di destinatario specificato.

Type:RecipientTypeDetails[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection
-SortBy

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 cui ordinamento si sta ordinando, è possibile aggiungere il comando con | Format-Table -Auto Property1,Property2,...PropertyX . per creare una nuova visualizzazione contenente tutte le proprietà che si desidera visualizzare. Sono supportati i caratteri jolly ( * ) nei nomi delle proprietà.

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

  • Nome
  • DisplayName
  • Alias
  • Città
  • FirstName
  • LastName
  • Ufficio
  • ServerLegacyDN
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Security & Compliance Center, Exchange Online Protection

Input

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

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.