Compartir a través de


Get-UnifiedGroup

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.

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

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 se le asignan. 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
  • Description
  • 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 equipo de Microsoft.

Parámetros

-Anr

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

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

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

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.

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

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El parámetro Identity especifica el grupo de Microsoft 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 de 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 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 del parámetro Identity son precisas y no contienen 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

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El modificador IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames especifica si se deben devolver 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 muestran como GUID y la propiedad AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames está 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

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

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.

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

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El modificador IncludeBypassModerationFromSendersOrMembersWithDisplayNames especifica si se deben devolver las direcciones SMTP y los nombres para mostrar de los destinatarios 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 BypassModerationFromSendersOrMembers se muestran como GUID y la propiedad BypassModerationFromSendersOrMembersWithDisplayNames está 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

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El modificador IncludeGrantSendOnBehalfToWithDisplayNames especifica si se deben devolver 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 GrantSendOnBehalfTo se muestran como GUID y la propiedad GrantSendOnBehalfToWithDisplayNames está 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

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El modificador IncludeModeratedByWithDisplayNames especifica si se deben devolver 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 de ModeratedBy se muestran como GUID y la propiedad ModeratedByWithDisplayNames está 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

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El modificador IncludeRejectMessagesFromSendersOrMembersWithDisplayNames especifica si se deben devolver 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.

Este modificador se introdujo para restaurar identificadores legibles en los resultados del cmdlet. Si no usa este modificador, los destinatarios de ModeratedBy se muestran como GUID y la propiedad RejectMessagesFromSendersOrMembersWithDisplayNames está 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

-IncludeSoftDeletedGroups

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

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.

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

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

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

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

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

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.