Set-Group
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 Set-Group para modificar as configurações do objeto de grupo. Se o grupo for um grupo de segurança habilitado para email ou um grupo de distribuição, você poderá usar o cmdlet Set-DistributionGroup para modificar outras configurações Microsoft Exchange que não estão disponíveis usando o cmdlet Set-Group.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Set-Group
[-Identity] <GroupIdParameter>
[-BypassSecurityGroupManagerCheck]
[-Confirm]
[-Description <MultiValueProperty>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-IgnoreDefaultScope]
[-IsHierarchicalGroup <Boolean>]
[-ManagedBy <GeneralRecipientIdParameter[]>]
[-Name <String>]
[-Notes <String>]
[-PhoneticDisplayName <String>]
[-SeniorityIndex <Int32>]
[-SimpleDisplayName <String>]
[-Universal]
[-WhatIf]
[-WindowsEmailAddress <SmtpAddress>]
[<CommonParameters>]Description
O cmdlet Set-Group não pode ser usado para modificar grupos dinâmicos de distribuição. Para modificar grupos dinâmicos de distribuição, use o cmdlet Set-DynamicDistributionGroup.
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
Set-Group -Identity "Legal Department" -Universal -Notes "verified"Este exemplo aplica as seguintes alterações para o grupo de segurança global existente chamado Legal Department:
Altera o escopo do grupo para universal.
Adiciona um valor do parâmetro Notes como Verificado.
Exemplo 2
Set-Group -Identity "Human Resources" -IsHierarchicalGroup $true -SeniorityIndex 1Este exemplo especifica que o grupo Human Resources é um grupo hierárquico e o exibe por último dentro da hierarquia porque seu número de índice é 1.
Parâmetros
-BypassSecurityGroupManagerCheck
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.
| Type: | SwitchParameter |
| 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, Exchange Online Protection |
-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, Exchange Online Protection |
-Description
Esse parâmetro só está disponível no serviço baseado em nuvem.
{{ Descrição de preenchimento }}
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-DisplayName
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.
| Type: | String |
| 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, Exchange Online Protection |
-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.
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.
| 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 |
-Identity
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
| Type: | GroupIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IgnoreDefaultScope
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.
| Type: | SwitchParameter |
| 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 |
-IsHierarchicalGroup
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.
| Type: | Boolean |
| 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, Exchange Online Protection |
-ManagedBy
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.
| Type: | GeneralRecipientIdParameter[] |
| 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, Exchange Online Protection |
-Name
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 (").
| Type: | String |
| 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, Exchange Online Protection |
-Notes
Os parâmetros Notes especificam informações adicionais sobre o objeto. Se o valor contiver espaços, coloque-o entre aspas (").
| Type: | String |
| 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, Exchange Online Protection |
-PhoneticDisplayName
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 (").
| Type: | String |
| 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, Exchange Online Protection |
-SeniorityIndex
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.
| Type: | Int32 |
| 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, Exchange Online Protection |
-SimpleDisplayName
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.
| Type: | String |
| 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, Exchange Online Protection |
-Universal
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.
| Type: | SwitchParameter |
| 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, Exchange Online Protection |
-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, Exchange Online Protection |
-WindowsEmailAddress
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.
| Type: | SmtpAddress |
| 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, Exchange Online Protection |
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.