Update-AzADGroup
atualizar entidade em grupos
Sintaxe
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>]
Update-AzADGroup
-ObjectId <String>
-JsonFilePath <String>
[-DefaultProfile <PSObject>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzADGroup
-ObjectId <String>
-JsonString <String>
[-DefaultProfile <PSObject>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
atualizar entidade em grupos
Exemplos
Exemplo 1: atualizar a descrição do grupo
Update-AzADGroup -ObjectId $objectid -Description $description
Atualizar a descrição do grupo.
Parâmetros
-AdditionalProperties
Parâmetros adicionais
Tipo: | Hashtable |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AppRoleAssignment
Representa as funções de aplicativo que um grupo recebeu para um aplicativo. Dá suporte a $expand.
Tipo: | IMicrosoftGraphAppRoleAssignmentAutoGenerated[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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. Dá suporte a $filter (eq, ne, NOT, ge, le, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CreatedOnBehalfOf
Representa um objeto do Azure Active Directory. O tipo directoryObject é o tipo base para muitos outros tipos de entidade de diretório.
Tipo: | IMicrosoftGraphDirectoryObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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.
Tipo: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DeletedDateTime
.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Description
Uma descrição opcional para o grupo. Retornado por padrão. Dá suporte a $filter (eq, ne, NOT, ge, le, startsWith) e $search.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisplayName
O nome exibido no diretório
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-GroupType
Especifica o tipo de grupo e sua associação. Se a coleção contiver Unified, o grupo será um grupo do Microsoft 365; caso contrário, é 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. Retornado por padrão. Dá suporte a $filter (eq, NOT).
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-HasMembersWithLicenseError
Indica se há membros nesse 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 têm membros com erros de licença (ou seja, filtrar essa propriedade sendo verdadeira). Dá suporte a $filter (eq).
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-IsArchived
.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-IsAssignableToRole
Indica se esse grupo pode ser atribuído a uma função do 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 administrador global e administrador de função 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 atribuições de função do Azure ADReturned por padrão. Dá suporte a $filter (eq, ne, NOT).
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-JsonFilePath
Caminho do arquivo Json fornecido para a operação De atualização
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-JsonString
Cadeia de caracteres Json fornecida para a operação De atualização
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MailEnabled
Especifica se o grupo está habilitado para email. Retornado por padrão. Dá suporte a $filter (eq, ne, NOT).
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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. Retornado por padrão. Dá suporte a $filter (eq, ne, NOT, ge, le, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MembershipRuleProcessingState
Indica se o processamento de associação dinâmica está ativado ou pausado. Os valores possíveis estão ativados ou em pausa. Retornado por padrão. Dá suporte a $filter (eq, ne, NOT, in).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ObjectId
key: id do grupo
Tipo: | String |
Aliases: | GroupId |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PassThru
Retorna true quando o comando é bem-sucedido
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PermissionGrant
As permissões que foram concedidas para um grupo para um aplicativo específico. Dá suporte a $expand.
Tipo: | IMicrosoftGraphResourceSpecificPermissionGrant[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PreferredDataLocation
O local de dados preferencial para o grupo. Para obter mais informações, consulte o OneDrive Online Multi-Geo. Retornado por padrão.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PreferredLanguage
O idioma preferencial para um grupo do Microsoft 365. Deve seguir o código ISO 639-1; por exemplo'en-US'. Retornado por padrão. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SecurityEnabled
Especifica se o grupo é um grupo de segurança. Retornado por padrão. Dá suporte a $filter (eq, ne, NOT, in).
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SecurityIdentifier
Identificador de segurança do grupo, usado em cenários do Windows. Retornado por padrão.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Theme
Especifica o tema de cores de um grupo do Microsoft 365. Os valores possíveis são Teal, Roxo, Verde, Azul, Rosa, Laranja ou Vermelho. Retornado por padrão.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Visibility
Especifica a política de junção de grupo e a visibilidade do conteúdo do grupo para grupos. Os valores possíveis são: Private, Public ou Hiddenmembership. A ocultação só pode ser definida para grupos do Microsoft 365 quando os grupos são criados. Ele 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 será criado como Privado por padrão e o grupo do Microsoft 365 será Público. Confira as opções de visibilidade do grupo para saber mais. Retornado por padrão.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Saídas
Azure PowerShell