Add-UnifiedGroupLinks
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 su organización basada en la nube. Para quitar miembros, propietarios y suscriptores, use el Remove-UnifiedGroupLinks cmdlet. 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, consulte 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 usuarios que no son miembros como propietarios del grupo. Los usuarios invitados nunca pueden ser propietarios de un 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
Default (valor predeterminado)
Add-UnifiedGroupLinks
[-Identity] <UnifiedGroupIdParameter>
-Links <RecipientIdParameter[]>
-LinkType <LinkType>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Los 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 artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que tiene asignados. 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, incluso si los usuarios son 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 legal.
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 en los que el atributo de departamento es "Marketing" se agregan al grupo de Microsoft 365 denominado Marketing.
Parámetros
-Confirm
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al 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. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro Identity especifica el grupo de Microsoft 365 que desea modificar. Puede usar cualquier valor que identifique de forma única al grupo de Microsoft 365. Por ejemplo:
- Nombre
- Alias
- Nombre distintivo (DN)
- Nombre distintivo (DN)
- DN canónico
- GUID
Propiedades de parámetro
| Tipo: | UnifiedGroupIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Links
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
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 usuarios que no son miembros como propietarios del grupo. Los usuarios invitados nunca pueden ser propietarios de un grupo.
Propiedades de parámetro
| Tipo: | RecipientIdParameter[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-LinkType
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El parámetro LinkType especifica el rol del destinatario en el grupo de Microsoft 365 que desea agregar. Los valores admitidos son:
- Miembros: participen en conversaciones, creen canales de Teams, colaboren en archivos y editen el sitio de SharePoint conectado.
- Propietarios: agregar o quitar miembros, eliminar conversaciones, cambiar la configuración de equipo, eliminar el equipo y control total del sitio de SharePoint conectado. Los grupos deben tener al menos un propietario.
- Suscriptores: miembros existentes del grupo que reciben notificaciones de eventos de conversación y calendario del grupo. Todos los suscriptores son miembros del grupo, pero no todos los miembros son necesariamente suscriptores (según el valor de propiedad AutoSubscribeNewMembers del grupo y cuándo se agregó el miembro).
Debe utilizar 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 usuarios que no son miembros como propietarios del grupo. Los usuarios invitados nunca pueden ser propietarios de un grupo.
Propiedades de parámetro
| Tipo: | LinkType |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.