Get-EXORecipient

O parâmetro Anr especifica uma cadeia de caracteres na qual executar uma pesquisa ANR (resolução de nomes ambíguos). Você pode especificar uma cadeia de caracteres parcial para objetos com um atributo correspondente a esta cadeia de caracteres. Os atributos padrão pesquisados são:

• CommonName (CN)
• DisplayName
• FirstName
• Sobrenome
• Alias

Não pode utilizar este parâmetro com os parâmetros ExternalDirectoryObjectId, Identity, PrimarySmtpAddress ou UserPrincipalName.

O parâmetro ExternalDirectoryObjectId identifica o destinatário que pretende ver pelo ObjectId no Microsoft Entra ID.

Não pode utilizar este parâmetro com os parâmetros Anr, Identity, PrimarySmtpAddress ou UserPrincipalName.

O parâmetro Filter utiliza a sintaxe OPATH para filtrar os resultados pelas propriedades e valores especificados. Os critérios de pesquisa utilizam a sintaxe "Property -ComparisonOperator 'Value'".

• Coloque todo o filtro OPATH entre aspas " ". Se o filtro contiver valores de sistema (por exemplo, $true, $falseou $null), utilize aspas únicas ' ' em vez disso. Embora este parâmetro seja uma cadeia (não um bloco de sistema), também pode utilizar chavetas { }, mas apenas se o filtro não contiver variáveis.
• A propriedade é uma propriedade filtráveis. Para obter mais informações sobre as propriedades filtráveis, veja Get-EXORecipient property sets (Conjuntos de propriedades Get-EXORecipient) e Filterable properties (Propriedades filtráveis) para o parâmetro Filter (Filtro).
• ComparisonOperator é um operador de comparação OPATH (por exemplo -eq , para igual e -like para comparação de cadeias). Para obter mais informações sobre operadores de comparação, veja about_Comparison_Operators.
• Valor é o valor da propriedade a procurar. Coloque os valores de texto e as variáveis entre plicas ('Value' ou '$Variable'). Se um valor de variável contiver aspas únicas, terá de identificar (escape) as aspas únicas para expandir a variável corretamente. Por exemplo, em vez de '$User', utilize '$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, utilize 500, $true, $falseou $null em alternativa).

Pode encadear múltiplos critérios de pesquisa em conjunto com os operadores lógicos -and e -or. Por exemplo: "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3".

Para obter informações detalhadas sobre filtros OPATH no Exchange, veja Informações adicionais sobre sintaxe OPATH.

O parâmetro Identity especifica o objeto destinatário que você deseja visualizar. Para obter o melhor desempenho, recomendamos que utilize os seguintes valores para identificar o destinatário:

• ID de usuário ou nome UPN
• GUID

Caso contrário, pode utilizar qualquer valor que identifique exclusivamente o destinatário. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Domínio\Nome de Utilizador
• Endereço de email
• LegacyExchangeDN
• SamAccountName

Não pode utilizar este parâmetro com os parâmetros Anr, ExternalDirectoryObjectId, PrimarySmtpAddress ou UserPrincipalName.

O comutador IncludeSoftDeletedRecipients especifica se pretende incluir destinatários eliminados de forma recuperável nos resultados. Não é preciso especificar um valor com essa opção.

Os destinatários eliminados de forma recuperável são destinatários eliminados que ainda são recuperáveis.

O parâmetro OrganizationalUnit filtra os resultados com base na localização do objeto no Active Directory. Somente objetos que existem na localização especificada são retornados. A entrada válida para esse parâmetro é uma UO (unidade organizacional) ou um domínio que fique visível na utilização do cmdlet Get-OrganizationalUnit. É possível usar qualquer valor que identifique a UO ou o domínio com exclusividade. Por exemplo:

• Nome
• Nome
• Nome diferenciado (DN)
• GUID

O PrimarySmtpAddress identifica o destinatário que pretende ver pelo endereço de e-mail SMTP principal (por exemplo, navin@contoso.com).

Não pode utilizar este parâmetro com os parâmetros Anr, ExternalDirectoryObjectId, Identity ou UserPrincipalName.

O parâmetro Propriedades especifica as propriedades que são devolvidas na saída deste cmdlet. Vários valores, separados por vírgulas, podem ser especificados.

Para obter mais informações sobre as propriedades disponíveis, veja Get-EXORecipient property sets (Conjuntos de propriedades Get-EXORecipient).

O parâmetro PropertySets especifica um agrupamento lógico de propriedades que são devolvidas na saída deste cmdlet. Os valores válidos são:

• Mínimo (este é o valor predefinido)
• Arquivar
• Personalizado
• MailboxMove
• Política

Para obter mais informações sobre as propriedades incluídas em cada conjunto de propriedades, veja Get-EXORecipient property sets (Conjuntos de propriedades Get-EXORecipient).

Esse parâmetro está reservado para uso interno da Microsoft.

O parâmetro RecipientType filtra os resultados pelo tipo de destinatário especificado. Os valores válidos são:

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

Vários valores, separados por vírgulas, podem ser especificados.

O parâmetro RecipientTypeDetails filtra os resultados pelo subtipo de destinatário especificado. Os valores válidos são:

• DiscoveryMailbox
• DynamicDistributionGroup
• Caixa de Correio de Equipamento
• 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

Vários valores, separados por vírgulas, podem ser especificados.

O valor do parâmetro RecipientType afeta os valores que pode utilizar para este parâmetro. Por exemplo, se utilizar o valor RecipientType MailContact, não poderá utilizar o valor UserMailbox para este parâmetro. Receberá o erro: Nenhum dos RecipientTypeDetails especificados está incluído em qualquer tipo de destinatário especificado.

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.

O parâmetro UserPrincipalName identifica o destinatário que pretende ver pelo UPN (por exemplo, navin@contoso.onmicrosoft.com).

Não pode utilizar este parâmetro com os parâmetros Anr, ExternalDirectoryObjectId, Identity ou PrimarySmtpAddress.