Get-UnifiedGroup

Módulo:: Exchange PowerShell

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

Use el cmdlet Get-UnifiedGroup para ver Grupos de Microsoft 365 en su organización basada en la nube. Para ver los miembros, propietarios y suscriptores de Grupos de Microsoft 365, use el Get-UnifiedGroupLinks cmdlet.

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

Identity (valor predeterminado)

Get-UnifiedGroup
    [[-Identity] <UnifiedGroupIdParameter>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-IncludeSoftDeletedGroups]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

AnrSet

Get-UnifiedGroup
    [-Anr <String>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-IncludeSoftDeletedGroups]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<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.

Ejemplos

Ejemplo 1

Get-UnifiedGroup

En este ejemplo se devuelve una lista resumida 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}

En este ejemplo se devuelven los Grupos de Microsoft 365 que no tienen propietario.

Ejemplo 5

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

En este ejemplo se muestran los Grupos de Microsoft 365 que se crean cuando se crea un equipo de Microsoft.

Parámetros

-Anr

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

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

AnrSet

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

-Filter

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

Incluya todo el filtro OPATH entre comillas dobles " ". Si el filtro contiene valores del sistema (por ejemplo, $true, , $falseo $null), use las 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 acerca de las propiedades filtrables en Exchange Server y Exchange Online, consulte Propiedades filtrables para el parámetro Filter.
ComparisonOperator es un operador de comparación OPATH (por ejemplo -eq , para la comparación 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.
El valor es el valor de propiedad que se va a buscar. Escriba los valores de texto y las 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 escriba enteros ni valores del sistema entre comillas (por ejemplo, use 500, $true, $false, o $null , en su lugar).

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

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

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

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

El parámetro Identity especifica el grupo de Microsoft 365 que desea ver. 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

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

Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores para el parámetro Identidad sean precisas y no contengan valores $null inexistentes.

Propiedades de parámetro

Tipo:	UnifiedGroupIdParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

Identity

Posición:	1
Obligatorio:	False
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames

El modificador IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames especifica si se devuelven las direcciones SMTP y los nombres para mostrar de los destinatarios AcceptMessagesOnlyFromSendersOrMembers en la propiedad AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames. No es necesario especificar un valor con este modificador.

Este modificador se introdujo para restaurar identificadores legibles en los resultados del cmdlet. Si no usa este modificador, los destinatarios AcceptMessagesOnlyFromSendersOrMembers se mostrarán como GUID y la propiedad AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames estará vacía.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

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

-IncludeAllProperties

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

Si no usa este modificador, es posible que los valores de algunas propiedades (por ejemplo, CalendarMemberReadOnly, CalendarUrl, InboxUrl, PeopleUrl y PhotoUrl) aparezcan en blanco.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

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

-IncludeBypassModerationFromSendersOrMembersWithDisplayNames

El modificador IncludeBypassModerationFromSendersOrMembersWithDisplayNames especifica si se devuelven las direcciones SMTP y los nombres para mostrar de los destinatarios de BypassModerationFromSendersOrMembers en la propiedad BypassModerationFromSendersOrMembersWithDisplayNames. No es necesario especificar un valor con este modificador.

Este modificador se introdujo para restaurar identificadores legibles en los resultados del cmdlet. Si no usa este modificador, los destinatarios de BypassModerationFromSendersOrMembers se mostrarán como GUID y la propiedad BypassModerationFromSendersOrMembersWithDisplayNames estará vacía.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

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

-IncludeGrantSendOnBehalfToWithDisplayNames

El modificador IncludeGrantSendOnBehalfToWithDisplayNames especifica si se devuelven las direcciones SMTP y los nombres para mostrar de los destinatarios GrantSendOnBehalfTo en la propiedad GrantSendOnBehalfToWithDisplayNames. No es necesario especificar un valor con este modificador.

Este modificador se introdujo para restaurar identificadores legibles en los resultados del cmdlet. Si no usa este modificador, los destinatarios de GrantSendOnBehalfTo se mostrarán como GUID y la propiedad GrantSendOnBehalfToWithDisplayNames estará vacía.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

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

-IncludeModeratedByWithDisplayNames

El modificador IncludeModeratedByWithDisplayNames especifica si se devuelven las direcciones SMTP y los nombres para mostrar de los destinatarios ModeratedBy en la propiedad ModeratedByWithDisplayNames. No es necesario especificar un valor con este modificador.

Este modificador se introdujo para restaurar identificadores legibles en los resultados del cmdlet. Si no usa este modificador, los destinatarios ModeratedBy se mostrarán como GUID y la propiedad ModeratedByWithDisplayNames estará vacía.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

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

-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames

El modificador IncludeRejectMessagesFromSendersOrMembersWithDisplayNames especifica si se devuelven las direcciones SMTP y los nombres para mostrar de los destinatarios RejectMessagesFromSendersOrMembers en la propiedad RejectMessagesFromSendersOrMembersWithDisplayNames. 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

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

-IncludeSoftDeletedGroups

El modificador IncludeSoftDeletedGroups especifica si se incluirán Grupos de Microsoft 365 eliminados de forma temporal en los resultados. No es necesario especificar un valor con este modificador.

Los Grupos de Microsoft 365 eliminados de forma temporal son grupos eliminados que aún se pueden recuperar.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

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

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

Propiedades de parámetro

Tipo:	Unlimited
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

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

-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 está ordenando, 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

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

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.

Comentarios

¿Le ha resultado útil esta página?