Get-UnifiedGroup

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 Get-UnifiedGroup para ver Grupos de Microsoft 365 en la organización basada en la nube. Para ver miembros, propietarios y suscriptores de Grupos de Microsoft 365, use el cmdlet Get-UnifiedGroupLinks.

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

Get-UnifiedGroup
   [[-Identity] <UnifiedGroupIdParameter>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

Get-UnifiedGroup
   [-Anr <String>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

Description

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

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.

Ejemplos

Ejemplo 1

Get-UnifiedGroup

En este ejemplo se devuelve una lista de resumen de todos los Grupos de Microsoft 365.

Ejemplo 2

Get-UnifiedGroup | Format-List DisplayName,EmailAddresses,Notes,ManagedBy,AccessType

En este ejemplo se devuelve la siguiente información sobre todos los Grupos de Microsoft 365:

Nombre completo (DN)
Dirección de correo electrónico
Descripción
Propietarios
Privacidad

Ejemplo 3

Get-UnifiedGroup -Identity "Marketing Department" | Format-List

En este ejemplo se devuelve información detallada sobre el grupo de Microsoft 365 denominado Departamento de marketing.

Ejemplo 4

Get-UnifiedGroup | Where-Object {-Not $_.ManagedBy}

Este ejemplo devuelve Grupos de Microsoft 365 que no tienen un propietario.

Ejemplo 5

Get-UnifiedGroup -Filter {ResourceProvisioningOptions -eq "Team"}

Este ejemplo devuelve Grupos de Microsoft 365 que se crean cuando se crea un Microsoft Team.

Parámetros

-Anr

Este parámetro está reservado para uso interno de Microsoft.

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

-Filter

El parámetro Filter usa la sintaxis de OPATH para filtrar los resultados por las propiedades y valores especificados. Los criterios de búsqueda usan la sintaxis "Property -ComparisonOperator 'Value'".

Incluya todo el filtro de OPATH entre comillas dobles " ". Si el filtro contiene valores del sistema (por ejemplo, , $true$falseo $null), use comillas simples ' ' en su lugar. Aunque este parámetro es una cadena (no un bloque del sistema), también puede usar llaves { }, pero solo si el filtro no contiene variables.
La propiedad es una propiedad filtrable. Para obtener más información sobre las propiedades filtrables en exchange server y Exchange Online, vea Propiedades filtrables para el parámetro Filter.
ComparisonOperator es un operador de comparación de OPATH (por ejemplo -eq , para igual y -like para la comparación de cadenas). Para obtener más información sobre los operadores de comparación, consulte about_Comparison_Operators.
Value es el valor de propiedad que se va a buscar. Incluya valores de texto y variables entre comillas simples ('Value' o '$Variable'). Si un valor de variable contiene comillas simples, debe identificar (escape) las comillas simples para expandir la variable correctamente. Por ejemplo, en lugar de '$User', use '$($User -Replace "'","''")'. No incluya enteros ni valores del sistema entre comillas (por ejemplo, use 500, $true, $falseo $null en su lugar).

Puede encadenar varios criterios de búsqueda mediante los operadores lógicos -and y -or. Por ejemplo, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".

Para obtener información detallada sobre los filtros de OPATH en Exchange, consulte Información adicional de la sintaxis de OPATH.

Type:	String
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 Microsoft grupo 365 que desea ver. 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

Nota: Puede usar el valor DisplayName para identificar el grupo Microsoft 365, pero no se garantiza que los resultados sean únicos. Si debe devolver un resultado único y singular, use un identificador único para el grupo Microsoft 365.

Type:	UnifiedGroupIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IncludeAllProperties

El modificador IncludeAllProperties especifica si se deben incluir los valores de todas las propiedades en los resultados. No es necesario especificar un valor con este modificador.

Si no usa este modificador, los valores de algunas propiedades (por ejemplo, CalendarMemberReadOnly, CalendarUrl, InboxUrl, PeopleUrl y PhotoUrl) podrían aparecer en blanco.

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

-IncludeSoftDeletedGroups

El modificador IncludeSoftDeletedGroups especifica si se deben incluir Grupos de Microsoft 365 eliminadas temporalmente en los resultados. No es necesario especificar un valor con este modificador.

Los Grupos de Microsoft 365 eliminados temporalmente son grupos eliminados que todavía se pueden recuperar.

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

-ResultSize

El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Si desea incluir en los resultados devueltos todas las solicitudes que coincidan con la consulta, use el valor ilimitado para este parámetro. El valor predeterminado es 1000.

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

-SortBy

El parámetro SortBy especifica la propiedad según la cual se ordenan los resultados. Solo se puede seleccionar una propiedad a la vez. Los resultados se clasifican en orden ascendente.

Si la vista predeterminada no incluye la propiedad por la que va a ordenar, puede anexar el comando con | Format-Table -Auto Property1,Property2,...PropertyX. para crear una nueva vista que contenga todas las propiedades que desea ver. Se admiten caracteres comodín (*) en los nombres de propiedad.

Puede realizar la clasificación por las propiedades siguientes:

Nombre
DisplayName
Alias

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