Compartir a través de

Add-UnifiedGroupLinks

  • Referencia
Módulo:
ExchangePowerShell
Se aplica a:
Exchange Online, Exchange Online Protection

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Add-UnifiedGroupLinks para agregar miembros, propietarios y suscriptores a Grupos de Microsoft 365 en la organización basada en la nube. Para quitar miembros, propietarios y suscriptores, use el cmdlet Remove-UnifiedGroupLinks. Para modificar otras propiedades de Grupos de Microsoft 365, use el cmdlet Set-UnifiedGroup.

Nota:

No puede usar este cmdlet para modificar los miembros, propietarios o suscriptores del grupo de Microsoft 365 si se conecta mediante la autenticación basada en certificados (también conocida como CBA o autenticación de solo aplicación para scripts desatendidos) o la identidad administrada de Azure. Puede usar Microsoft Graph para: Para obtener más información, vea Tipo de recurso de grupo.

Con este cmdlet, solo los miembros del grupo pueden ser propietarios del grupo. Agregue usuarios como miembros antes de agregarlos como propietarios. Esta limitación no se aplica en los portales de administración web, donde puede agregar no miembros como propietarios del grupo. Los usuarios invitados nunca pueden ser propietarios del grupo.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

Add-UnifiedGroupLinks
   [-Identity] <UnifiedGroupIdParameter>
   -Links <RecipientIdParameter[]>
   -LinkType <LinkType>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

Grupos de Microsoft 365 son objetos de grupo que están disponibles en los servicios de Microsoft 365.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Nota: Solo los miembros pueden ser propietarios de un grupo, por lo que primero debe agregar un usuario como miembro antes de agregarlo como propietario. Los usuarios invitados no pueden ser propietarios de grupos, aunque sean miembros de los grupos.

Ejemplos

Ejemplo 1

Add-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links chris@contoso.com,michelle@contoso.com

En este ejemplo se agregan miembros chris@contoso.com y michelle@contoso.com al grupo de Microsoft 365 denominado Departamento jurídico.

Ejemplo 2

$users= Get-User -ResultSize unlimited | where {$_.Department -eq "Marketing" -AND $_.RecipientType -eq "UserMailbox"}

Add-UnifiedGroupLinks -Identity Marketing -LinkType members -Links ($users.UserPrincipalName)

En este ejemplo se muestra cómo agregar miembros masivos a un grupo de Microsoft 365. Los buzones donde el atributo Department es "Marketing" se agregan al grupo de Microsoft 365 denominado Marketing.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-Identity

El parámetro Identity especifica el grupo de Microsoft 365 que desea modificar. Puede usar cualquier valor que identifique de forma única el grupo de Microsoft 365. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre distintivo (DN)
  • DN canónico
  • GUID
Tipo:UnifiedGroupIdParameter
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-Links

El parámetro Links especifica los destinatarios que se van a agregar al grupo de Microsoft 365. Especifique si estos destinatarios son miembros, propietarios o suscriptores mediante el parámetro LinkType.

Puede usar cualquier valor que identifique de forma exclusiva el destinatario. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre distintivo (DN)
  • DN canónico
  • GUID

Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Debe usar este parámetro con el parámetro LinkType, lo que significa que los destinatarios especificados reciben el mismo rol en el grupo de Microsoft 365 (no se pueden agregar destinatarios con roles diferentes en el mismo comando).

Nota: Con este cmdlet, solo los miembros del grupo pueden ser propietarios del grupo. Agregue usuarios como miembros antes de agregarlos como propietarios. Esta limitación no se aplica en los portales de administración web, donde puede agregar no miembros como propietarios del grupo. Los usuarios invitados nunca pueden ser propietarios del grupo.

Tipo:RecipientIdParameter[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-LinkType

El parámetro LinkType especifica el rol del destinatario en el grupo de Microsoft 365 que desea agregar. Los valores admitidos son:

  • Miembros: participe en conversaciones, cree canales de Teams, colabore en archivos y edite el sitio de SharePoint conectado.
  • Propietarios: agregue o quite miembros, elimine conversaciones, cambie la configuración del equipo, elimine el equipo y el control total del sitio de SharePoint conectado. Los grupos deben tener al menos un propietario.
  • Suscriptores: miembros del grupo existentes que reciben notificaciones de eventos de conversación y calendario del grupo. Todos los suscriptores son miembros del grupo, pero todos los miembros no son necesariamente suscriptores (según el valor de la propiedad AutoSubscribeNewMembers del grupo y cuándo se agregó el miembro).

Debe usar este parámetro con el parámetro Links.

Nota: Con este cmdlet, solo los miembros del grupo pueden ser propietarios del grupo. Agregue usuarios como miembros antes de agregarlos como propietarios. Esta limitación no se aplica en los portales de administración web, donde puede agregar no miembros como propietarios del grupo. Los usuarios invitados nunca pueden ser propietarios del grupo.

Tipo:LinkType
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection