Update-AzADGroup

Módulo:

Az.Resources

actualizar entidad en grupos

Sintaxis

PowerShell

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>]

PowerShell

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

PowerShell

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

Description

actualizar entidad en grupos

Ejemplos

Ejemplo 1: Actualización de la descripción del grupo

PowerShell

Update-AzADGroup -ObjectId $objectid -Description $description

Actualice la descripción del grupo.

Parámetros

-AdditionalProperties

Parámetros adicionales

Tipo:	Hashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AppRoleAssignment

Representa los roles de aplicación a los que se ha concedido un grupo para una aplicación. Admite $expand.

Tipo:	IMicrosoftGraphAppRoleAssignmentAutoGenerated[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Classification

Describe una clasificación para el grupo (como un impacto empresarial bajo, medio o alto). Los valores válidos para esta propiedad se definen mediante la creación de un valor de configuración ClassificationList, en función de la definición de plantilla. Se devuelve de forma predeterminada. Admite $filter (eq, ne, NOT, ge, le, startsWith).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CreatedOnBehalfOf

Representa un objeto de Azure Active Directory. El tipo directoryObject es el tipo base para muchos otros tipos de entidad de directorio.

Tipo:	IMicrosoftGraphDirectoryObject
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Tipo:	PSObject
Alias:	AzureRMContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DeletedDateTime

.

Tipo:	DateTime
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Description

Descripción opcional del grupo. Se devuelve de forma predeterminada. Admite $filter (eq, ne, NOT, ge, le, startsWith) y $search.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisplayName

Nombre que se muestra en el directorio

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-GroupType

Especifica el tipo de grupo y su pertenencia. Si la colección contiene Unified, el grupo es un grupo de Microsoft 365; de lo contrario, es un grupo de seguridad o un grupo de distribución. Para obtener más información, consulte Información general sobre grupos. Si la colección incluye DynamicMembership, el grupo tiene pertenencia dinámica; de lo contrario, la pertenencia es estática. Se devuelve de forma predeterminada. Admite $filter (eq, NOT).

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-HasMembersWithLicenseError

Indica si hay miembros de este grupo que tienen errores de licencia de su asignación de licencias basada en grupos. Esta propiedad nunca se devuelve en una operación GET. Puede usarlo como argumento de $filter para obtener grupos que tienen miembros con errores de licencia (es decir, filtrar por esta propiedad siendo true). Admite $filter (eq).

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IsArchived

.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IsAssignableToRole

Indica si este grupo se puede asignar a un rol de Azure Active Directory. Esta propiedad solo se puede establecer al crear el grupo y es inmutable. Si se establece en true, la propiedad securityEnabled también debe establecerse en true y el grupo no puede ser un grupo dinámico (es decir, groupTypes no puede contener DynamicMembership). Solo los autores de llamadas en roles de administrador global y administrador de roles con privilegios pueden establecer esta propiedad. También se debe asignar al autor de la llamada el permiso Directory.AccessAsUser.All para establecer esta propiedad. Para más información, consulte Uso de un grupo para administrar asignaciones de roles de Azure ADReturned de forma predeterminada. Admite $filter (eq, ne, NOT).

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-JsonFilePath

Ruta de acceso del archivo Json proporcionado a la operación de actualización

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-JsonString

Cadena JSON proporcionada a la operación de actualización

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MailEnabled

Especifica si el grupo está habilitado para correo. Se devuelve de forma predeterminada. Admite $filter (eq, ne, NOT).

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MailNickname

Alias de correo del grupo, único en la organización. Esta propiedad debe especificarse cuando se crea un grupo. Estos caracteres no se pueden usar en mailNickName: @()/[]';:.<>,SPACE. Se devuelve de forma predeterminada. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MembershipRule

Regla que determina los miembros de este grupo si el grupo es un grupo dinámico (groupTypes contiene DynamicMembership). Para obtener más información sobre la sintaxis de la regla de pertenencia, vea Sintaxis de reglas de pertenencia. Se devuelve de forma predeterminada. Admite $filter (eq, ne, NOT, ge, le, startsWith).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MembershipRuleProcessingState

Indica si el procesamiento de pertenencia dinámica está activado o en pausa. Los valores posibles son Activado o Pausado. Se devuelve de forma predeterminada. Admite $filter (eq, ne, NOT, in).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ObjectId

key: id. de grupo

Tipo:	String
Alias:	GroupId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PassThru

Devuelve true cuando el comando se ejecuta correctamente.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PermissionGrant

Permisos concedidos para un grupo a una aplicación específica. Admite $expand.

Tipo:	IMicrosoftGraphResourceSpecificPermissionGrant[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PreferredDataLocation

Ubicación de datos preferida para el grupo. Para obtener más información, vea OneDrive Online Multi-Geo. Se devuelve de forma predeterminada.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PreferredLanguage

Idioma preferido para un grupo de Microsoft 365. Debe seguir el código ISO 639-1; por ejemplo, "en-US". Se devuelve de forma predeterminada. Admite $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SecurityEnabled

Especifica si el grupo es un grupo de seguridad. Se devuelve de forma predeterminada. Admite $filter (eq, ne, NOT, in).

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SecurityIdentifier

Identificador de seguridad del grupo, usado en escenarios de Windows. Se devuelve de forma predeterminada.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Theme

Especifica el tema de color de un grupo de Microsoft 365. Los valores posibles son Teal, Purple, Green, Blue, Pink, Orange o Red. Se devuelve de forma predeterminada.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Visibility

Especifica la directiva de unión a grupos y la visibilidad del contenido del grupo para los grupos. Los valores posibles son: Private, Public o Hiddenmembership. Hiddenmembership solo se puede establecer para grupos de Microsoft 365, cuando se crean los grupos. No se puede actualizar más adelante. Otros valores de visibilidad se pueden actualizar después de la creación del grupo. Si no se especifica el valor de visibilidad durante la creación de grupos en Microsoft Graph, se crea un grupo de seguridad como privado de forma predeterminada y el grupo de Microsoft 365 es Público. Consulte opciones de visibilidad de grupo para obtener más información. Se devuelve de forma predeterminada.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Salidas

Boolean