New-DynamicDistributionGroup

O parâmetro Alias especifica o alias do Exchange (também conhecido como apelido de email) para o destinatário. Esse valor identifica o destinatário como um objeto habilitado para email e não deve ser confundido com vários endereços de email para o mesmo destinatário (também conhecido como endereços de proxy). Um destinatário pode ter apenas um valor de Alias. O tamanho máximo é de 64 caracteres.

O valor do Alias pode conter letras, números e os seguintes caracteres:

• !, #, %, *, +, -, /, =, ?, ^, _, e ~.
• $, &, ', ', {, }e | precisam ser escapados (por exemplo -Alias what`'snew) ou todo o valor incluído em aspas individuais (por exemplo, -Alias 'what'snew'). O & caractere não tem suporte no valor do Alias para Azure AD Sincronização do Connect.
• Os períodos (.) devem ser cercados por outros caracteres válidos (por exemplo, help.desk).
• Caracteres unicode U+00A1 a U+00FF.

Quando você cria um destinatário sem especificar um endereço de email, o valor do Alias especificado é usado para gerar o endereço de email primário (alias@domain). Os caracteres Unicode com suporte são mapeados para os melhores caracteres de texto US-ASCII. Por exemplo, U+00F6 (ö) é alterado para oe no endereço de email primário.

Se você não usar o parâmetro Alias ao criar um destinatário, o valor de um parâmetro necessário diferente será usado para o valor da propriedade Alias:

• Destinatários com contas de usuário (por exemplo, caixas de correio de usuário e usuários de email): o lado esquerdo do parâmetro MicrosoftOnlineServicesID ou UserPrincipalName é usado. Por exemplo, helpdesk@contoso.onmicrosoft.com resulta no valor helpdeskda propriedade Alias .
• Destinatários sem contas de usuário (por exemplo, caixas de correio de sala, contatos de email e grupos de distribuição): o valor do parâmetro Name é usado. Os espaços são removidos e caracteres sem suporte são convertidos em pontos de interrogação (?).

Se você modificar o valor do Alias de um destinatário existente, o endereço de email primário será atualizado automaticamente somente em ambientes em que o destinatário está sujeito a políticas de endereço de email (a propriedade EmailAddressPolicyEnabled é True para o destinatário).

O parâmetro Alias nunca gera ou atualiza o endereço de email primário de um contato de email ou de um usuário de email.

Este parâmetro está disponível somente no Exchange local.

O parâmetro ArbitrationMailbox especifica a caixa de correio de arbitragem que é usada para gerenciar o processo de moderação desse destinatário. É possível usar qualquer valor que identifique a caixa de correio de arbitragem exclusivamente. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• Domain\username
• Endereço de email
• GUID
• LegacyExchangeDN
• SamAccountName
• ID de usuário ou nome UPN

O parâmetro ConditionalCompany especifica um filtro precatório baseado no valor da propriedade Company do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute1 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute1 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute10 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute10 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute11 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute11 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute12 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute12 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute13 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute13 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute14 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute14 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute15 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute15 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute2 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute2 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute3 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute3 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute4 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute4 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute5 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute5 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute6 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute6 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute7 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute7 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute8 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute8 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalCustomAttribute9 especifica um filtro predefinido baseado no valor da propriedade CustomAttribute9 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalDepartment especifica um filtro precatório baseado no valor da propriedade Do Departamento do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ConditionalStateOrProvince especifica um filtro precatório baseado no valor da propriedade StateOrProvince do destinatário. Vários valores, separados por vírgulas, podem ser especificados.

Quando você usa vários valores para esse parâmetro, o operador booliano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, confira a seção Descrição Detalhada deste tópico.

Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro pre digitalizado. Você não pode usar parâmetros condicionais em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

• Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Esse parâmetro só está disponível no serviço baseado em nuvem.

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

O parâmetro DisplayName especifica o nome de exibição do grupo de distribuição dinâmico. O nome de exibição está visível no centro de administração do Exchange e nas listas de endereços. O comprimento máximo é de 256 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Se você não usa o parâmetro DisplayName, o valor do parâmetro Name é usado para o nome de exibição.

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

O parâmetro IncludedRecipients especifica um filtro precatório baseado no tipo de destinatário. Os valores válidos são:

• AllRecipients: esse valor só pode ser usado por si só.
• Mailboxusers
• MailContacts
• Mailgroups
• MailUsers
• MailUsers

Vários valores, separados por vírgulas, podem ser especificados. Quando você usa vários valores, o operador booliano OR é aplicado.

Você precisa usar esse parâmetro quando usar todos os parâmetros condicionais como parte de um filtro pré-verificado. Você não pode usar esse parâmetro em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).

O parâmetro ModeratedBy especifica um ou mais moderadores para esse destinatário. Um moderador aprova mensagens enviadas para o destinatário antes que as mensagens sejam entregues. Um moderador deve ser uma caixa de correio, um usuário de email ou um contato de email em sua organização. É possível usar qualquer valor que identifique o moderador exclusivamente. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• DN canônico
• GUID

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Você usa esse parâmetro para especificar pelo menos um moderador ao definir o parâmetro ModeraçãoEnabled para o valor $true.

O parâmetro ModerationEnabled especifica se a moderação está habilitada para esse destinatário. Os valores válidos são:

• $true: a moderação está habilitada para esse destinatário. As mensagens enviadas a esse destinatário devem ser aprovadas por um moderador antes que as mensagens sejam entregues.
• $false: A moderação está desabilitada para este destinatário. As mensagens enviadas a esse destinatário são entregues sem a aprovação de um moderador. Esse é o valor padrão.

Você usa o parâmetro ModeratedBy para especificar os moderadores.

O parâmetro Name especifica o nome exclusivo do grupo de distribuição dinâmico. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Esse valor também é usado para a propriedade DisplayName se você não usar o parâmetro DisplayName.

O parâmetro OrganizationalUnit especifica a UO (unidade organizacional) onde o grupo de distribuição dinâmico é criado.

A entrada válida para esse parâmetro é uma OU (unidade organizacional) ou domínio retornado pelo 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

Se você não usar esse parâmetro, o valor padrão normalmente será o contêiner Usuários no domínio do servidor exchange ao qual você está conectado (também conhecido como escopo do destinatário). No Exchange local, você pode alterar o escopo do destinatário para a sessão atual do PowerShell usando o cmdlet Set-AdServerSettings.

Se você não usar o parâmetro RecipientContainer, o local do grupo de distribuição dinâmica será usado para a propriedade RecipientContainer (o local padrão ou o valor especificado para o parâmetro OrganizationalUnit).

Observação: embora esse parâmetro esteja disponível no Exchange Online, há apenas uma OU utilizável em uma organização Exchange Online, portanto, usar esse parâmetro não tem efeito.

O parâmetro PrimarySmtpAddress especifica o endereço de email de retorno principal que é usado para o destinatário.

O parâmetro RecipientContainer especifica um filtro baseado na localização do destinatário no Active Directory. A entrada válida para esse parâmetro é uma OU (unidade organizacional) ou domínio retornado pelo 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

GUID

Observe que a propriedade RecipientContainer não pode ficar em branco. O grupo está sempre limitado a procurar destinatários em um local específico (o valor que você especificar para esse parâmetro ou o local em que o grupo foi criado).

Observação: embora esse parâmetro esteja disponível no Exchange Online, há apenas uma OU utilizável em uma organização Exchange Online, portanto, usar esse parâmetro não tem efeito.

O parâmetro RecipientFilter especifica um filtro OPATH personalizado baseado no valor de qualquer propriedade do destinatário disponível. Você pode usar qualquer operador de Windows PowerShell disponível e há suporte para curingas e correspondências parciais. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'".

• Inclua todo o filtro OPATH nas aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $falseou $null), use aspas individuais ' ' em vez disso. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também pode usar chaves { }, mas somente se o filtro não contiver variáveis.
• A propriedade é uma propriedade filtrada. Para propriedades filtradas, consulte Propriedades filtradas para o parâmetro RecipientFilter.
• ComparisonOperator é um operador de comparação OPATH (por exemplo -eq , para iguais e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.
• Valor é o valor da propriedade a ser filtrada. Inclua valores e variáveis de texto em aspas individuais ('Value' ou '$Variable'). Se um valor variável contiver aspas individuais, você precisará identificar (escapar) as aspas individuais para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não inclua inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $falseou $null em vez disso).
• Em ambientes baseados em nuvem, você não pode usar um curinga como o primeiro caractere. Por exemplo, 'Sales*' é permitido, mas '*Sales' não é permitido.
• No Exchange local, os curingas são válidos apenas como o primeiro ou o último caractere. Por exemplo, 'Sales*' ou '*Sales' são permitidos, mas 'Sa*les' não são permitidos.

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

Você não pode usar esse parâmetro em combinação com o parâmetro IncludedRecipients ou quaisquer parâmetros condicionais (que são usados para criar filtros precatórios).

O comprimento máximo da propriedade RecipientFilter é de 2048 caracteres, incluindo sintaxe interna.

As conexões do cliente são feitas por proxy dos serviços de Acesso para Cliente para os serviços de back-end nos servidores de Caixa de Correio locais ou remotos. Os valores válidos são:

• Sempre: notifique todos os remetentes quando as mensagens não forem aprovadas. Esse é o valor padrão.
• Always: notificar todos os remetentes quando suas mensagens não forem aprovadas. Este é o valor padrão.
• Internal: notificar remetentes da organização quando as mensagens não forem aprovadas.

Esse parâmetro só é significativo quando a moderação é habilitada (o parâmetro ModerationEnabled tem o valor $true).

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.