Update-AzADGroup

Sintaxe

UpdateExpanded (Default)

Update-AzADGroup
    -ObjectId <String>
    [-AdditionalProperties <Hashtable>]
    [-AppRoleAssignment <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>]
    [-Classification <String>]
    [-CreatedOnBehalfOf <IMicrosoftGraphDirectoryObject>]
    [-DeletedDateTime <DateTime>]
    [-Description <String>]
    [-DisplayName <String>]
    [-GroupType <String[]>]
    [-HasMembersWithLicenseError]
    [-IsArchived]
    [-IsAssignableToRole]
    [-MailEnabled]
    [-MailNickname <String>]
    [-MembershipRule <String>]
    [-MembershipRuleProcessingState <String>]
    [-PermissionGrant <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
    [-PreferredDataLocation <String>]
    [-PreferredLanguage <String>]
    [-SecurityEnabled]
    [-SecurityIdentifier <String>]
    [-Theme <String>]
    [-Visibility <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaJsonFilePath

Update-AzADGroup
    -ObjectId <String>
    -JsonFilePath <String>
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaJsonString

Update-AzADGroup
    -ObjectId <String>
    -JsonString <String>
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: atualizar a descrição do grupo

Update-AzADGroup -ObjectId $objectid -Description $description

Parâmetros

-AdditionalProperties

Parâmetros adicionais

Propriedades do parâmetro

Conjuntos de parâmetros

-AppRoleAssignment

Representa as funções de aplicativo que um grupo recebeu para um aplicativo. Dá suporte a $expand.

Propriedades do parâmetro

Conjuntos de parâmetros

-Classification

Descreve uma classificação para o grupo (como impacto comercial baixo, médio ou elevado). Os valores válidos para essa propriedade são definidos criando um valor de configuração ClassificationList, com base na definição do modelo. Retornado por padrão. Dá suporte a $filter (eq, ne, NOT, ge, le, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Conjuntos de parâmetros

-CreatedOnBehalfOf

Representa um objeto Azure Active Directory. O tipo directoryObject é o tipo base para muitos outros tipos de entidade de diretório.

Propriedades do parâmetro

Conjuntos de parâmetros

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Propriedades do parâmetro

Conjuntos de parâmetros

-DeletedDateTime

.

Propriedades do parâmetro

Conjuntos de parâmetros

-Description

Uma descrição opcional para o grupo. Devolvido por padrão. Dá suporte a $filter (eq, ne, NOT, ge, le, startsWith) e $search.

Propriedades do parâmetro

Conjuntos de parâmetros

-DisplayName

O nome exibido no diretório

Propriedades do parâmetro

Conjuntos de parâmetros

-GroupType

Especifica o tipo de grupo e sua associação. Se a coleção contiver Unified, o grupo será um grupo Microsoft 365; caso contrário, será um grupo de segurança ou um grupo de distribuição. Para obter detalhes, consulte a visão geral dos grupos. Se a coleção incluir DynamicMembership, o grupo terá associação dinâmica; caso contrário, a associação é estática. Devolvido por padrão. Dá suporte a $filter (eq, NOT).

Propriedades do parâmetro

Conjuntos de parâmetros

-HasMembersWithLicenseError

Indica se existem membros neste grupo com erros de licença da sua atribuição de licença baseada em grupo. Esta propriedade nunca é retornada em uma operação GET. Você pode usá-lo como um argumento $filter para acessar os grupos que têm membros com erros de licença (ou seja, o filtro para essa propriedade é true). Dá suporte a $filter (eq).

Propriedades do parâmetro

Conjuntos de parâmetros

-IsArchived

.

Propriedades do parâmetro

Conjuntos de parâmetros

-IsAssignableToRole

Indica se esse grupo pode ser atribuído a uma função Azure Active Directory. Essa propriedade só pode ser definida durante a criação do grupo e é imutável. Se definida como true, a propriedade securityEnabled também deve ser definida como true e o grupo não pode ser um grupo dinâmico (ou seja, groupTypes não pode conter DynamicMembership). Somente os chamadores nas funções de administrador de função Administrador global e Com privilégios podem definir essa propriedade. O chamador também deve receber a permissão Directory.AccessAsUser.All para definir essa propriedade. Para obter mais informações, consulte Como usar um grupo para gerenciar Azure atribuições de função do ADReturned por padrão. Dá suporte a $filter (eq, ne, NOT).

Propriedades do parâmetro

Conjuntos de parâmetros

-JsonFilePath

Caminho do arquivo Json fornecido para a operação Update

Propriedades do parâmetro

Conjuntos de parâmetros

-JsonString

Cadeia de caracteres Json fornecida para a operação Update

Propriedades do parâmetro

Conjuntos de parâmetros

-MailEnabled

Especifica se o grupo está habilitado para email. Devolvido por padrão. Dá suporte a $filter (eq, ne, NOT).

Propriedades do parâmetro

Conjuntos de parâmetros

-MailNickname

O alias de email do grupo, exclusivo na organização. Essa propriedade deve ser especificada quando um grupo é criado. Esses caracteres não podem ser usados no mailNickName: @()/[]';:.<>,SPACE. Devolvido por padrão. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-MembershipRule

A regra que determina os membros desse grupo se o grupo for um grupo dinâmico (groupTypes contém DynamicMembership). Para obter mais informações sobre a sintaxe da regra de associação, consulte a sintaxe Regras de Associação. Devolvido por padrão. Dá suporte a $filter (eq, ne, NOT, ge, le, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-MembershipRuleProcessingState

Indica se o processamento de associação dinâmica está ativado ou em pausa. Os valores possíveis estão ativados ou em pausa. Devolvido por padrão. Dá suporte a $filter (eq, ne, NOT, in).

Propriedades do parâmetro

Conjuntos de parâmetros

-ObjectId

key: id do grupo

Propriedades do parâmetro

Conjuntos de parâmetros

-PassThru

Retorna true quando o comando é bem-sucedido

Propriedades do parâmetro

Conjuntos de parâmetros

-PermissionGrant

As permissões que foram concedidas para um grupo para um aplicativo específico. Dá suporte a $expand.

Propriedades do parâmetro

Conjuntos de parâmetros

-PreferredDataLocation

O local de dados preferencial para o grupo. Para obter mais informações, consulte OneDrive Online Multi-Geo. Devolvido por padrão.

Propriedades do parâmetro

Conjuntos de parâmetros

-PreferredLanguage

O idioma preferencial para um grupo de Microsoft 365. Deve seguir o código ISO 639-1; por exemplo'en-US'. Devolvido por padrão. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-SecurityEnabled

Especifica se o grupo é um grupo de segurança. Devolvido por padrão. Dá suporte a $filter (eq, ne, NOT, in).

Propriedades do parâmetro

Conjuntos de parâmetros

-SecurityIdentifier

Identificador de segurança do grupo, usado em cenários de Windows. Devolvido por padrão.

Propriedades do parâmetro

Conjuntos de parâmetros

-Theme

Especifica o tema de cores de um grupo de Microsoft 365. Os valores possíveis são Teal, Roxo, Verde, Azul, Rosa, Laranja ou Vermelho. Devolvido por padrão.

Propriedades do parâmetro

Conjuntos de parâmetros

-Visibility

Especifica a política de associação ao grupo e a visibilidade do conteúdo do grupo para grupos. Os valores possíveis são: Private, Public ou Hiddenmembership. A ocultação pode ser definida somente para grupos de Microsoft 365, quando os grupos são criados. Não pode ser atualizado posteriormente. Outros valores de visibilidade podem ser atualizados após a criação do grupo. Se o valor de visibilidade não for especificado durante a criação do grupo em Microsoft Graph, um grupo de segurança será criado como Privado por padrão e Microsoft 365 grupo será Público. Confira as opções de visibilidade do grupo para saber mais. Devolvido por padrão.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Saídas

Boolean