Set-Group

A opção BypassSecurityGroupManagerCheck especifica se é possível permitir que um usuário que não é proprietário do grupo modifique ou exclua o grupo. Não é preciso especificar um valor com essa opção.

Se você não estiver definido na propriedade ManagedBy do grupo, precisará usar essa opção em comandos que modificam ou excluem o grupo. Para usar essa opção, sua conta requer permissões específicas com base no tipo de grupo:

• Grupos de distribuição ou grupos de segurança habilitados para email: você precisa ser membro do grupo de funções gerenciamento de organização ou ter a função Criação e Associação do Grupo de Segurança atribuída.
• Grupos de distribuição ou grupos de segurança habilitados para email: você precisa ser um membro do grupo de função Gerenciamento da Organização ou ter a função Associação e Criação de Grupo de Segurança atribuída.

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.

{{ Descrição de preenchimento }}

O parâmetro DisplayName especifica o nome de exibição do grupo. 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 (").

Esse parâmetro só será significativo se o grupo estiver habilitado para email.

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 DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.

O parâmetro Identity especifica o grupo que você deseja modificar. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:

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

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

A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo padrão do destinatário para a sessão do Exchange PowerShell e usar toda a floresta como o escopo. Não é preciso especificar um valor com essa opção.

Essa opção permite que o comando acesse objetos do Active Directory que não estão disponíveis no momento no escopo padrão, mas também introduz as seguintes restrições:

• Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
• Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.

O parâmetro IsHierarchicalGroup especifica se o grupo é parte de um catálogo de endereços hierárquico. Os valores válidos são $true ou $false. O valor padrão é $false.

O parâmetro ManagedBy especifica um proprietário para o grupo. O grupo deve ter pelo menos um proprietário. Se você não usar esse parâmetro para especificar o proprietário ao criar o grupo, a conta de usuário que criou o grupo será o proprietário. O proprietário do grupo é capaz de:

• O parâmetro ManagedBy especifica um proprietário para o grupo. Um grupo deve ter pelo menos um proprietário. Se você não usar esse parâmetro para especificar o proprietário ao criar o grupo, a conta de usuário que criou o grupo será o proprietário. O proprietário do grupo é capaz de:
• Modificar as propriedades do grupo
• Adicionar ou remover membros do grupo
• Excluir o grupo
• Aprovar solicitações de entrada ou saída do membro (se disponível)

O proprietário especificado para esse parâmetro deve ser uma caixa de correio, um usuário de email ou um grupo de segurança habilitado para email (uma entidade de segurança habilitada para email que pode ter permissões atribuídas). É possível usar qualquer valor que identifique o proprietário com exclusividade. 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

Para inserir vários proprietários e substituir todas as entradas existentes, use a seguinte sintaxe: Owner1,Owner2,...OwnerN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Owner1","Owner2",..."OwnerN".

Para adicionar ou remover proprietários sem afetar outras entradas existentes, use a seguinte sintaxe: @{Add="Owner1","Owner2",...; Remove="Owner3","Owner4"...}.

Os proprietários especificados com esse parâmetro não são adicionados como membros do grupo. Você precisa adicionar manualmente os proprietários como membros.

Observação: o gerenciamento de grupo no Outlook não funciona quando o proprietário é um grupo de segurança habilitado para email. Para gerenciar o grupo no Outlook, o proprietário deve ser uma caixa de correio ou um usuário de email.

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

Os parâmetros Notes especificam informações adicionais sobre o objeto. Se o valor contiver espaços, coloque-o entre aspas (").

O parâmetro PhoneticDisplayName especifica uma ortografia alternativa do nome do usuário que é usada para texto em fala nos ambientes UM (Unificação de Mensagens). Normalmente, você usa esse parâmetro quando a pronúncia e a ortografia do nome do usuário não correspondem. O comprimento máximo é de 256 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

O parâmetro SeniorityIndex especifica a ordem em que este grupo será exibido em um catálogo de endereços hierárquico. Um grupo com o valor 2 aparecerá mais alto em um catálogo de endereços do que um grupo com o valor 1.

O parâmetro SimpleDisplayName é usado para exibir uma descrição alternativa do objeto quando apenas um conjunto limitado de caracteres é permitido. Os caracteres válidos são:

• O parâmetro SimpleDisplayName é usado para exibir uma descrição alternativa do objeto, quando apenas um conjunto limitado de caracteres for permitido. Os caracteres válidos são:
• a – z
• A – Z
• espaço
• " ' ( ) + , - . / : ?

Esse parâmetro só será significativo se o grupo estiver habilitado para email.

A opção Universal altera o escopo do grupo de Global ou DomainLocal para Universal. Não é preciso especificar um valor com essa opção.

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.

O parâmetro WindowsEmailAddress especifica o endereço de email do Windows para este destinatário. Esse é um atributo comum do Active Directory que está presente em todos os ambientes, incluindo ambientes sem Exchange. Usar o parâmetro WindowsEmailAddress em um destinatário tem um dos seguintes resultados:

• Em ambientes em que o destinatário está sujeito a políticas de endereço de email (a propriedade EmailAddressPolicyEnabled é definida como o valor True para o destinatário), o parâmetro WindowsEmailAddress não tem efeito na propriedade WindowsEmailAddress ou no valor do endereço de email primário.
• Em ambientes em que o destinatário não está sujeito a políticas de endereço de email (a propriedade EmailAddressPolicyEnabled é definida como o valor False para o destinatário), o parâmetro WindowsEmailAddress atualiza a propriedade WindowsEmailAddress e o endereço de email primário para o mesmo valor.

A propriedade WindowsEmailAddress é visível para o destinatário em Usuários e Computadores do Active Directory no atributo E-mail. O nome comum do atributo é E-mail-Addresses e o Ldap-Display-Name é email. Se você modificar esse atributo no Active Directory, o endereço de email principal do destinatário não será atualizado para o mesmo valor.