Set-RoleGroup

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.

O parâmetro Description especifica a descrição exibida quando o grupo de função for visualizado usando-se o cmdlet Get-RoleGroup. Coloque a descrição entre aspas (").

O parâmetro DisplayName especifica o nome amigável do grupo de função. Se o nome contiver espaços, coloque-o entre aspas ("). Esse parâmetro tem um comprimento máximo de 256 caracteres.

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.

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

A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.

O parâmetro Identity especifica o nome do grupo da função a ser modificado. Se o nome contiver espaços, coloque-o entre aspas (").

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

O parâmetro LinkedCredential especifica o nome de usuário e a senha usados para acessar o controlador de domínio especificado pelo parâmetro LinkedDomainController.

Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential). Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential) e, em seguida, use o nome da variável ($cred) para esse parâmetro. Para saber mais, confira Obter credencial.

O parâmetro LinkedCredential só pode ser usado com um grupo de função vinculado.

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

O parâmetro LinkedDomainController especifica o nome de domínio totalmente qualificado (FQDN) ou endereço IP do controlador de domínio na floresta onde o USG externo reside. O controlador de domínio especificado é usado para obter informações de segurança para o USG externo especificado pelo parâmetro LinkedForeignGroup.

O parâmetro LinkedDomainController só pode ser usado com um grupo de função vinculado.

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

O parâmetro LinkedForeignGroup especifica o nome do USG externo a ser vinculado a este grupo de função. Se o nome do USG externo contiver espaços, coloque-o entre aspas (").

O parâmetro LinkedForeignGroup só pode ser usado para alterar o USG externo vinculado a um grupo de função vinculado existente. Não é possível transformar um grupo de função padrão em um grupo de função vinculado usando o cmdlet Set-RoleGroup. Você deve criar um grupo de função usando o cmdlet New-RoleGroup.

Se o parâmetro LinkedForeignGroup for usado, o controlador de domínio também deve ser especificado no parâmetro LinkedDomainController.

O parâmetro ManagedBy especifica os usuários ou USG que podem modificar a configuração de um grupo de função ou adicionar ou remover membros a ou de um grupo de função. A lista especificada com este parâmetro substitui a lista ManagedBy existente. Para adicionar ou remover gerentes de grupo de funções individuais e para obter mais informações sobre como modificar propriedades multivalorizados, consulte Modificando propriedades multivaloradas.

Você pode usar o nome, nome diferenciado (DN) ou endereço SMTP principal do usuário ou USG que deseja adicionar. Se o nome do usuário ou USG contiver espaços, coloque-o entre aspas (").

Se quiser adicionar mais de um usuário ou USG, separe-os por vírgulas.

O parâmetro Name especifica o nome do grupo de função. O nome pode ter no máximo 64 caracteres. Se o nome contiver espaços, coloque-o entre aspas (").

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

{{ Preencher BemKnownObject Description }}

A opção WhatIf não funciona no PowerShell de Conformidade de Segurança & .

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.