New-AddressBookPolicy
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.
Use o cmdlet New-AddressBookPolicy para excluir uma política de catálogo de endereços. As políticas do livro de endereços definem a lista de endereços global (GAL), o livro de endereços offline (OAB), a lista de salas e as listas de endereços apresentadas aos utilizadores da caixa de correio a quem foi atribuída a política.
No Exchange Online, este cmdlet só está disponível na função Listas Endereço e, por predefinição, a função não é atribuída a nenhum grupo de funções. Para utilizar este cmdlet, tem de adicionar a função endereço Listas a um grupo de funções (por exemplo, ao grupo de funções Gestão da Organização). Para obter mais informações, veja 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.
Sintaxe
Default (Padrão)
New-AddressBookPolicy
[-Name] <String>
-AddressLists <AddressListIdParameter[]>
-GlobalAddressList <GlobalAddressListIdParameter>
-OfflineAddressBook <OfflineAddressBookIdParameter>
-RoomList <AddressListIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-WhatIf]
[<CommonParameters>]
Description
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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-AddressBookPolicy -Name "All Fabrikam ABP" -AddressLists "\All Fabrikam","\All Fabrikam Mailboxes","\All Fabrikam DLs","\All Fabrikam Contacts" -RoomList "\All Fabrikam-Rooms" -OfflineAddressBook "\Fabrikam-All-OAB" -GlobalAddressList "\All Fabrikam"
Este exemplo cria uma política de catálogo de endereços com as seguintes configurações:
- Nome: All Fabrikam ABP
- Listas de endereços incluídas All Fabrikam, All Fabrikam Mailboxes, All Fabrikam DLs, All Fabrikam Contacts
- Lista de salas incluída: All Fabrikam-Rooms
- OAB incluído: Fabrikam-All-OAB
- GAL incluído: All Fabrikam
Parâmetros
-AddressLists
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro AddressLists especifica as listas de endereços para os utilizadores da caixa de correio a quem foi atribuída esta política de livro de endereços. É possível usar qualquer valor que identifique a lista de endereços com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Pode encontrar os valores de identificação das listas de endereços com o cmdlet Get-AddressList.
Propriedades do parâmetro
| Tipo: | AddressListIdParameter[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GlobalAddressList
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro GlobalAddressList especifica a GAL para os utilizadores da caixa de correio a quem foi atribuída esta política de livro de endereços. É possível usar qualquer valor que identifique a GAL com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Pode encontrar os valores de identificação de GALs com o cmdlet Get-GlobalAddressList.
Você pode especificar somente uma GAL para cada política de catálogo de endereços.
Propriedades do parâmetro
| Tipo: | GlobalAddressListIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro Name especifica o nome da política de catálogo de endereços.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OfflineAddressBook
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro OfflineAddressBook especifica o OAB para os utilizadores da caixa de correio a quem foi atribuída esta política do livro de endereços. É possível usar qualquer valor que identifique o OAB com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Pode encontrar os valores de identificação de OABs com o cmdlet Get-OfflineAddressBook.
Você pode especificar somente um OAB para cada política de catálogo de endereços.
Propriedades do parâmetro
| Tipo: | OfflineAddressBookIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RoomList
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro RoomList especifica uma lista de endereços utilizada para experiências de localização para os utilizadores da caixa de correio que têm esta política de livro de endereços atribuída.
- Ao utilizar experiências de localização (por exemplo, Localizador de Salas ou selecionar uma sala de conferências ao agendar uma reunião), os utilizadores veem apenas os recursos que correspondem aos resultados do RecipientFilter da lista de endereços especificada por este parâmetro.
- Ao utilizar experiências que não sejam específicas da localização (por exemplo, os campos Para ou Cc de um evento de calendário), as listas de endereços especificadas pelo parâmetro AddressLists nesta política do livro de endereços são aplicadas. A lista de endereços especificada por este parâmetro não é utilizada.
Um valor válido para este parâmetro é uma lista de endereços. É possível usar qualquer valor que identifique a lista de endereços com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Observação
Não existe uma associação automática entre este parâmetro e grupos de distribuição de lista de salas, que também utilizam um parâmetro chamado RoomList nos cmdlets New-DistributionGroup e Set-DistributionGroup. Ainda tem de criar grupos de distribuição de listas de salas e atribuir recursos como membros do grupo. As experiências de localização são filtradas para mostrar apenas as salas incluídas na lista de endereços especificada pela propriedade RoomList da política do livro de endereços atribuída ao utilizador (se aplicável).
Propriedades do parâmetro
| Tipo: | AddressListIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.