Get-EXORecipient
Questo cmdlet è disponibile solo nel modulo Exchange Online PowerShell. Per altre informazioni, vedere Informazioni sul modulo Exchange Online PowerShell.
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 in ordine di ordinamento dei nomi.
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 usare 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 usare 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 usa la sintassi OPATH per filtrare i risultati in base alle proprietà e ai valori specificati. I criteri di ricerca usano la sintassi "Property -ComparisonOperator 'Value'".
- Racchiudere l'intero filtro OPATH tra virgolette doppie " ". Se il filtro contiene valori di sistema (ad esempio,
$true,$falseo$null), usare le virgolette singole ''. Sebbene questo parametro sia una stringa (non un blocco di sistema), è anche possibile usare le parentesi graffe { }, ma solo se il filtro non contiene variabili. - La proprietà è una proprietà filtrabile. Per altre informazioni sulle proprietà filtrabili, vedere Set di proprietà Get-EXORecipient e Proprietà filtrabili per il parametro Filter.
- ComparisonOperator è un operatore di confronto OPATH, ad esempio
-eqper equals e-likeper il confronto di stringhe. Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators. - Il valore è il valore della proprietà da cercare. Racchiudere valori di testo e variabili tra virgolette singole (
'Value'o'$Variable'). Se un valore variabile contiene virgolette singole, è necessario identificare (escape) le virgolette singole per espandere correttamente la variabile. Ad esempio, invece di'$User', usare'$($User -Replace "'","''")'. Non racchiudere valori interi o di sistema tra virgolette, ad esempio usare500,$true,$falseo$null.
È 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 Informazioni aggiuntive 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 usare qualsiasi valore che identifichi in modo univoco il destinatario. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Dominio\Nome utente
- Indirizzo di posta elettronica
- LegacyExchangeDN
- SamAccountName
Non è possibile usare questo parametro con i parametri Anr, ExternalDirectoryObjectId, PrimarySmtpAddress o UserPrincipalName.
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 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 |
-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 usare 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 Properties consente di specificare le proprietà restituite nell'output di questo cmdlet. È possibile specificare più valori separati da virgole.
Per altre 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 di proprietà restituite nell'output di questo cmdlet. I valori validi sono:
- Minimo (questo è il valore predefinito)
- Archiviare
- Personalizzato
- MailboxMove
- Criteri
Per altre 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
- MailContact
- 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 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
- 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 RecipientTypeDetail 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, navin@contoso.onmicrosoft.comad esempio .
Non è possibile usare 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.