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

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.

Syntax

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, 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 demás cmdlets (por ejemplo, los cmdlets 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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
Type:UnifiedGroupIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to: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 recibirán el mismo rol en el grupo de Microsoft 365 (no se pueden agregar destinatarios con roles diferentes en el mismo comando).

Type:RecipientIdParameter[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 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).

En PowerShell, cualquier propietario o suscriptor que quiera agregar al grupo también debe ser miembro.

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

Type:LinkType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection