Get-EXORecipient

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solo nel modulo PowerShell di Exchange Online. Per ulteriori informazioni, vedere Informazioni sul modulo PowerShell di Exchange Online.

Usare il cmdlet Get-EXORecipient 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).

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

Sintassi

Identity (Impostazione predefinita) 

Get-EXORecipient
    [[-Identity] <String>]
    [-ExternalDirectoryObjectId <Guid>]
    [-Filter <String>]
    [-IncludeSoftDeletedRecipients]
    [-OrganizationalUnit <String>]
    [-PrimarySmtpAddress <String>]
    [-Properties <String[]>]
    [-PropertySets <PropertySet[]>]
    [-RecipientPreviewFilter <String>]
    [-RecipientType <String[]>]
    [-RecipientTypeDetails <String[]>]
    [-ResultSize <Unlimited>]
    [-UserPrincipalName <String>]
    [<CommonParameters>]

Anr 

Get-EXORecipient
    [-Anr <String>]
    [-Filter <String>]
    [-IncludeSoftDeletedRecipients]
    [-OrganizationalUnit <String>]
    [-Properties <String[]>]
    [-PropertySets <PropertySet[]>]
    [-RecipientPreviewFilter <String>]
    [-RecipientType <String[]>]
    [-RecipientTypeDetails <String[]>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Descrizione

Get-EXORecipient cmdlet può essere usato 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).

Esempio

Esempio 1

Get-EXORecipient -ResultSize 100

In questo esempio vengono restituiti i primi 100 oggetti destinatario nell'ordinamento per nome.

Esempio 2

Get-EXORecipient -Identity john@contoso.com

In questo esempio vengono restituiti i dettagli dell'attributo del destinatario per l'utente john@contoso.com

Parametri

-Anr

Applicabile: Exchange Online

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

Non è possibile utilizzare questo parametro con i parametri ExternalDirectoryObjectId, Identity, PrimarySmtpAddress o UserPrincipalName.

Proprietà dei parametri

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

Set di parametri

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

-ExternalDirectoryObjectId

Applicabile: Exchange Online

Il parametro ExternalDirectoryObjectId identifica il destinatario che si desidera visualizzare in base all'ObjectId in Microsoft Entra ID.

Non è possibile utilizzare questo parametro con i parametri Anr, Identity, PrimarySmtpAddress o UserPrincipalName.

Proprietà dei parametri

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

Set di parametri

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

-Filter

Applicabile: Exchange Online

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, vedere Set di proprietà Get-EXORecipient e Proprietà filtrabili per il parametro Filtro.
  • 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

-Identity

Applicabile: Exchange Online

Il parametro Identity consente di specificare l'oggetto destinatario da visualizzare. Per ottenere prestazioni ottimali, è consigliabile usare i valori seguenti per identificare il destinatario:

  • ID utente o Nome entità utente (UPN)
  • GUID

In caso contrario, è possibile utilizzare qualsiasi valore che identifichi in modo univoco il destinatario. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Dominio\Nomeutente
  • Indirizzo di posta elettronica
  • LegacyExchangeDN
  • SamAccountName

Non è possibile utilizzare questo parametro con i parametri Anr, ExternalDirectoryObjectId, PrimarySmtpAddress o UserPrincipalName.

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:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

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

-IncludeSoftDeletedRecipients

Applicabile: Exchange Online

L'opzione IncludeSoftDeletedRecipients specifica se includere i destinatari eliminati temporaneamente nei risultati. Con questa opzione non è necessario specificare alcun valore.

I destinatari eliminati temporaneamente sono destinatari eliminati che sono ancora ripristinabili.

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

-OrganizationalUnit

Applicabile: Exchange Online

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 visibile utilizzando il 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: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

-PrimarySmtpAddress

Applicabile: Exchange Online

PrimarySmtpAddress identifica il destinatario che si desidera visualizzare in base all'indirizzo di posta elettronica SMTP primario, navin@contoso.comad esempio .

Non è possibile utilizzare questo parametro con i parametri Anr, ExternalDirectoryObjectId, Identity o UserPrincipalName.

Proprietà dei parametri

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

Set di parametri

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

-Properties

Applicabile: Exchange Online

Il parametro Proprietà consente di specificare le proprietà restituite nell'output di questo cmdlet. È possibile specificare più valori separati da virgole.

Per ulteriori informazioni sulle proprietà disponibili, vedere Set di proprietà Get-EXORecipient.

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

-PropertySets

Applicabile: Exchange Online

Il parametro PropertySets specifica un raggruppamento logico delle proprietà restituite nell'output di questo cmdlet. I valori validi sono:

  • Minimo (questo è il valore predefinito)
  • Archiviare
  • Personalizzato
  • MailboxMove
  • Criteri

Per ulteriori informazioni sulle proprietà incluse in ogni set di proprietà, vedere Set di proprietà Get-EXORecipient.

Proprietà dei parametri

Tipo:

PropertySet[]

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

-RecipientPreviewFilter

Applicabile: Exchange Online

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

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

-RecipientType

Applicabile: Exchange Online

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

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

È possibile specificare più valori separati da virgole.

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

-RecipientTypeDetails

Applicabile: Exchange Online

Il parametro RecipientTypeDetails filtra i risultati in base al sottotipo del destinatario specificato. I valori validi sono:

  • DiscoveryMailbox
  • DynamicDistributionGroup
  • EquipmentMailbox
  • GroupMailbox
  • GuestMailUser
  • LegacyMailbox
  • Cassetta postale collegata
  • LinkedRoomMailbox
  • PostaContatto
  • MailForestContact
  • MailNonUniversalGroup
  • MailUniversalDistributionGroup
  • MailUniversalSecurityGroup
  • MailUser
  • PublicFolder
  • Cassetta postale pubblica
  • RemoteEquipmentMailbox
  • RemoteRoomMailbox
  • RemoteSharedMailbox
  • RemoteTeamMailbox
  • RemoteUserMailbox
  • Elenco delle stanze
  • RoomMailbox
  • SchedulingMailbox
  • SharedMailbox
  • SharedWithMailUser
  • TeamMailbox
  • UserMailbox

È possibile specificare più valori separati da virgole.

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

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

-ResultSize

Applicabile: Exchange Online

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

-UserPrincipalName

Applicabile: Exchange Online

Il parametro UserPrincipalName identifica il destinatario che si desidera visualizzare in base all'UPN (ad esempio, navin@contoso.onmicrosoft.com).

Non è possibile utilizzare questo parametro con i parametri Anr, ExternalDirectoryObjectId, Identity o PrimarySmtpAddress.

Proprietà dei parametri

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

Set di parametri

Identity
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
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.