Update-AzADGroup

Sintaxe

UpdateExpanded (Predefinição)

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: Descrição da atualização para o grupo

Update-AzADGroup -ObjectId $objectid -Description $description

Parâmetros

-AdditionalProperties

Parâmetros adicionais

Propriedades dos parâmetros

Conjuntos de parâmetros

-AppRoleAssignment

Representa as funções de aplicativo que um grupo recebeu para um aplicativo. Suporta $expand.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Classification

Descreve uma classificação para o grupo (como baixo, médio ou alto impacto nos negócios). 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. Suporta $filter (eq, ne, NOT, ge, le, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CreatedOnBehalfOf

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-DefaultProfile

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-DeletedDateTime

.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Description

Uma descrição opcional para o grupo. Retornado por padrão. Suporta $filter (eq, ne, NOT, ge, le, startsWith) e $search.

Propriedades dos parâmetros

Conjuntos de parâmetros

-DisplayName

O nome exibido no diretório

Propriedades dos parâmetros

Conjuntos de parâmetros

-GroupType

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-HasMembersWithLicenseError

Indica se há membros neste grupo que têm erros de licença de sua atribuição de licença baseada em grupo. Essa propriedade nunca é retornada em uma operação GET. Você pode usá-lo como um argumento $filter para obter grupos que tenham membros com erros de licença (ou seja, filtrar para que essa propriedade seja true). Suporta $filter (eq).

Propriedades dos parâmetros

Conjuntos de parâmetros

-IsArchived

.

Propriedades dos parâmetros

Conjuntos de parâmetros

-IsAssignableToRole

Indica se este grupo pode ser atribuído a uma função do Azure Active Directory. Esta propriedade só pode ser definida durante a criação do grupo e é imutável. Se definido 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). Apenas os chamadores em funções de Administrador global e Privileged role administrator podem definir esta característica. O chamador também deve receber a permissão Directory.AccessAsUser.All para definir essa propriedade. Para mais informações, consulte Usar um grupo para gerir atribuições de papéis no Azure AD Retornado por defeito. Suporta $filter (eq, ne, NOT).

Propriedades dos parâmetros

Conjuntos de parâmetros

-JsonFilePath

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-JsonString

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-MailEnabled

Especifica se o grupo está habilitado para email. Retornado por padrão. Suporta $filter (eq, ne, NOT).

Propriedades dos parâmetros

Conjuntos de parâmetros

-MailNickname

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-MembershipRule

A regra que determina os membros para este 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 Sintaxe das regras de associação. Retornado por padrão. Suporta $filter (eq, ne, NOT, ge, le, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-MembershipRuleProcessingState

Indica se o processamento dinâmico de associação está ativado ou pausado. Os valores possíveis são On ou Paused. Retornado por padrão. Suporta $filter (eq, ne, NOT, in).

Propriedades dos parâmetros

Conjuntos de parâmetros

-ObjectId

Chave: ID do grupo

Propriedades dos parâmetros

Conjuntos de parâmetros

-PassThru

Retorna true quando o comando é bem-sucedido

Propriedades dos parâmetros

Conjuntos de parâmetros

-PermissionGrant

As permissões que foram concedidas para um grupo para um aplicativo específico. Suporta $expand.

Propriedades dos parâmetros

Conjuntos de parâmetros

-PreferredDataLocation

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-PreferredLanguage

A linguagem preferida para um grupo Microsoft 365. Deve seguir o código ISO 639-1; por exemplo, 'en-US'. Retornado por padrão. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-SecurityEnabled

Especifica se o grupo é um grupo de segurança. Retornado por padrão. Suporta $filter (eq, ne, NOT, in).

Propriedades dos parâmetros

Conjuntos de parâmetros

-SecurityIdentifier

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Theme

Especifica o tema de cor de um grupo da Microsoft 365. Os valores possíveis são Teal, Purple, Green, Blue, Pink, Orange ou Red. Retornado por padrão.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Visibility

Especifica a política de ingresso no grupo e a visibilidade do conteúdo do grupo para grupos. Os valores possíveis são: Private, Public, ou Hiddenmembership. A filiação oculta só pode ser definida para grupos Microsoft 365, quando os grupos são criados. Não pode ser atualizado mais tarde. 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 no Microsoft Graph, um grupo de segurança é criado como Privado por defeito e o grupo Microsoft 365 é Público. Consulte as opções de visibilidade do grupo para saber mais. Retornado por padrão.

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

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

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Saídas

Boolean