New-GlobalAddressList
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.
Use o cmdlet New-GlobalAddressList para criar uma GAL (lista de endereços global).
Em Exchange Online, esse cmdlet está disponível apenas na função Listas de Endereços e, por padrão, a função não é atribuída a nenhum grupo de funções. Para usar esse cmdlet, você precisa adicionar a função Listas de Endereços a um grupo de funções (por exemplo, ao grupo de funções gerenciamento de organização). Para obter mais informações, consulte Adicionar uma função a um grupo de funções.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
New-GlobalAddressList
[-Name] <String>
-IncludedRecipients <WellKnownRecipientType>
[-ConditionalCompany <MultiValuedProperty>]
[-ConditionalCustomAttribute1 <MultiValuedProperty>]
[-ConditionalCustomAttribute10 <MultiValuedProperty>]
[-ConditionalCustomAttribute11 <MultiValuedProperty>]
[-ConditionalCustomAttribute12 <MultiValuedProperty>]
[-ConditionalCustomAttribute13 <MultiValuedProperty>]
[-ConditionalCustomAttribute14 <MultiValuedProperty>]
[-ConditionalCustomAttribute15 <MultiValuedProperty>]
[-ConditionalCustomAttribute2 <MultiValuedProperty>]
[-ConditionalCustomAttribute3 <MultiValuedProperty>]
[-ConditionalCustomAttribute4 <MultiValuedProperty>]
[-ConditionalCustomAttribute5 <MultiValuedProperty>]
[-ConditionalCustomAttribute6 <MultiValuedProperty>]
[-ConditionalCustomAttribute7 <MultiValuedProperty>]
[-ConditionalCustomAttribute8 <MultiValuedProperty>]
[-ConditionalCustomAttribute9 <MultiValuedProperty>]
[-ConditionalDepartment <MultiValuedProperty>]
[-ConditionalStateOrProvince <MultiValuedProperty>]
[-Confirm]
[-DomainController <Fqdn>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>]
New-GlobalAddressList
[-Name] <String>
-RecipientFilter <String>
[-Confirm]
[-DomainController <Fqdn>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>]
Description
Os parâmetros Conditional que são usados com o parâmetro IncludedRecipients estão sujeitos às seguintes limitações:
- O operador EQV é usado para cada valor de propriedade, como em "Departamento = Vendas". Não há suporte para caracteres curinga e correspondências parciais.
- O operador OR sempre é usado para vários valores da mesma propriedade, como e "Departamento = Vendas OR Marketing".
- O operador AND sempre é usado para várias propriedades, como em "Departamento = Vendas AND Empresa = Contoso".
Para criar filtros flexíveis que usam qualquer propriedade do destinatário disponível e que não estejam sujeitos a essas limitações, você pode usar o parâmetro RecipientFilter para criar um filtro OPATH.
Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
New-GlobalAddressList -Name "NewGAL"
Este exemplo cria a GAL chamada NewGAL.
Exemplo 2
New-GlobalAddressList -Name GAL_AgencyB -RecipientFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (CustomAttribute15 -eq 'AgencyB')"
Este exemplo cria a GAL GAL_AgencyB, usando o parâmetro RecipientFilter para incluir todas os usuários de caixa de correio cujo atributo personalizado 15 seja igual a AgencyB.
Parâmetros
-ConditionalCompany
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute1
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute10
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute11
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute12
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute13
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute14
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute15
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute2
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute3
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute4
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute5
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute6
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute7
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute8
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalCustomAttribute9
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalDepartment
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConditionalStateOrProvince
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).
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
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.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludedRecipients
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).
Type: | WellKnownRecipientType |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
O parâmetro Name especifica um nome exclusivo para a nova lista de endereços global. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RecipientContainer
Este parâmetro está disponível somente no Exchange local.
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
Type: | OrganizationalUnitIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RecipientFilter
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
,$false
ou$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, use500
,$true
,$false
ou$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).
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
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.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.