Get-SPOSite

  • Referencia
Módulo:
Microsoft.Online.SharePoint.PowerShell
Se aplica a:
SharePoint Online

Devuelve una o más colecciones de sitios.

Syntax

Get-SPOSite
   [[-Identity] <SpoSitePipeBind>]
   [-Detailed]
   [-Limit <String>]
   [<CommonParameters>]
Get-SPOSite
   [-Detailed]
   [-Filter <String>]
   [-IncludePersonalSite <Boolean>]
   [-Limit <String>]
   [-Template <String>]
   [-GroupIdDefined]
   [<CommonParameters>]
Get-SPOSite
   [-Identity] <SpoSitePipeBind>
   [-DisableSharingForNonOwnersStatus]
   [<CommonParameters>]

Description

Este cmdlet contiene más de un conjunto de parámetros. Solo puede usar parámetros de un conjunto y no puede combinar parámetros de conjuntos distintos. Para obtener más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlet.

El cmdlet Get-SPOSite recupera y devuelve propiedades de todas las colecciones de sitios que coinciden con los criterios dados.

Con la versión 5361 del Shell de administración de SharePoint Online, es posible que experimente lo siguiente:

Ahora se muestran colecciones de sitios adicionales. Por ejemplo, se mostrarán todos los sitios de grupos y vídeos junto con sitios de grupo.

El parámetro Detailed ha quedado en desuso. Continuará funcionando con las versiones anteriores

Nota:

Las colecciones de sitios que están en la Papelera de reciclaje no se recuperan con el cmdlet Get-SPOSite.

Debe ser un administrador global o de SharePoint Online y un administrador de colección de sitios para ejecutar el cmdlet.

Para obtener permisos y la información más actual sobre Windows PowerShell para SharePoint Online, consulte la documentación en línea en Introducción a SharePoint Online Management Shell.

Nota:

Si el espacio empresarial tiene habilitada la administración de almacenamiento de la colección de sitios, no podrá establecer la cuota y se producirá un error genérico. Para solucionar este problema, establezca temporalmente la administración del almacenamiento de colecciones de sitios en "manual", establezca las cuotas y, a continuación, establezca la configuración de administración de almacenamiento de la colección de sitios en su configuración original.

Nota:

Si se proporcionan los parámetros Limit o Filter, las siguientes propiedades de colección de sitios no se rellenarán y pueden contener un valor predeterminado: AllowDownloadingNonWebViewableFiles, AllowEditing, AllowSelfServiceUpgrade, AnonymousLinkExpirationInDays, ConditionalAccessPolicy, DefaultLinkPermission, DefaultLinkToExistingAccess, DefaultSharingLinkType, DenyAddAndCustomizePages, DisableCompanyWideSharingLinks, ExternalUserExpirationInDays, InformationSegment, LimitedAccessFileType, OverrideTenantAnonymousLinkExpirationPolicy, OverrideTenantExternalUserExpirationPolicy, PWAEnabled, SandboxedCodeActivationCapability, SensitivityLabel, SharingAllowedDomainList, SharingBlockedDomainList, SharingCapability, SharingDomainRestrictionMode.

Ejemplos

-----------------------EJEMPLO 1-----------------------------

Get-SPOSite

El ejemplo 1 devuelve todas las colecciones de sitios.

-----------------------EJEMPLO 2-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com

El ejemplo 2 muestra la colección de sitios con propiedades detalladas.

-----------------------EJEMPLO 3-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com -DisableSharingForNonOwnersStatus

El ejemplo 3 actualiza el estado si los usuarios que no son propietarios de una colección de sitios pueden compartir la colección de sitios (no establece este valor).

-----------------------EJEMPLO 4-----------------------------

Get-SPOSite -Template GROUP#0 -IncludePersonalSite:$false

En este ejemplo, se enumeran las colecciones de sitios de grupo en una cuenta empresarial.

-----------------------EJEMPLO 5-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/groupname -detailed |fl

En este ejemplo, se muestran los detalles de cuota de un sitio de grupo.

-----------------------EJEMPLO 6-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/research | Select InformationSegment

En este ejemplo se devuelve informationSegments asociado al sitio. Se aplica a los inquilinos que han habilitado para Microsoft 365 capacidad de barreras de información. Lea Más información sobre las barreras de información para comprender las barreras de información en SharePoint Online.

Nota: Esta propiedad solo está disponible en la versión 16.0.19927.12000 o posterior del Shell de administración de SharePoint Online.

-----------------------EJEMPLO 7-----------------------------

Get-SPOSite -Filter { Url -like "contoso.sharepoint.com/sites/18" }

En este ejemplo, se usa el filtrado del lado del servidor para devolver sitios que coincidan con 18.

-----------------------EJEMPLO 8-----------------------------

Get-SPOSite -Limit ALL | ?{$_.IsTeamsConnected -eq $true}

En este ejemplo, se usa el filtrado del lado del cliente para devolver una lista de sitios conectados a Microsoft Teams.

-----------------------EJEMPLO 9-----------------------------

Get-SPOSite -Limit ALL | ?{$_.IsTeamsChannelConnected -eq $true}

En este ejemplo, se usa el filtrado del lado del cliente para devolver una lista de sitios conectados a Microsoft Teams Private o un canal compartido.

-----------------------EJEMPLO 10-----------------------------

Get-SPOSite -Limit ALL -GroupIdDefined $true

En este ejemplo, se usa el filtrado del lado del servidor para devolver todos los sitios que tienen un grupo de Microsoft 365 asociado.

-----------------------EXAMPLE 11-----------------------------

$userUPN="joe.healy@contoso.com"
Get-SPOSite -Filter "Owner -like '$($userUPN)'"

En este ejemplo se recuperan todos los sitios filtrados por el propietario especificado mediante una variable.

Parámetros

-Detailed

Use este parámetro para ver información de propiedad adicional sobre una colección de sitios. Observará un tiempo de respuesta más lento cuando se use el parámetro Detailed.

Se devuelven las siguientes propiedades:

  • ResourceUsageCurrent

  • ResourceUsageAverage

  • StorageUsageCurrent

  • LockIssue

  • WebsCount

  • CompatibilityLevel

  • AllowSelfServiceUpgrade

  • SiteDefinedSharingCapability

Devuelve el valor almacenado del sitio web.

  • SharingCapability

Devuelve el nivel de acceso efectivo (la directiva del sitio y la cuenta asociada combinadas).

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

-DisableSharingForNonOwnersStatus

Este parámetro impide que los usuarios que no sean los propietarios de una colección de sitios puedan compartir.

Nota:

Este parámetro está disponible solo en la versión del Shell de administración de SharePoint Online versión 16.0.4613.1211 o posteriores. DisableSharingForNonOwnersStatus no es una configuración persistente, sino un análisis del estado de la colección de sitios. El propósito de esto es obtener esta configuración y no se garantiza que otros valores devueltos sean correctos. Para obtener otros valores y configuraciones, use el Get-SPOSite sin este parámetro para asegurarse de que todo se muestra correctamente.

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

-Filter

Especifica el bloque de scripts del filtro del lado del servidor que se va a aplicar. El tipo debe ser un nombre de filtro válido y el valor debe estar en formato { PropertyName <operator> "filterValue"}. Los operadores válidos son los siguientes: eq, ne, like, notlike. De momento, puede filtrar por estas propiedades: Propietario, Plantilla (se puede usar para filtrar si es la única propiedad presente en el filtro), LockState, Url. No se admite el uso del operador -or para incluir un filtro adicional.

Los valores del operador distinguen mayúsculas de minúsculas.

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

-GroupIdDefined

Filtra la lista de sitios devueltos a sitios con un identificador de grupo (es decir, sitios conectados a un grupo de Microsoft 365) cuando el valor se establece en $true. Filtra la lista de sitios solo para los sitios sin identificador de grupo cuando el valor es $false.

Los valores son Verdadero, Falso e indefinido. De forma predeterminada, el valor es indefinido, lo que significa que el filtro no se aplica.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Identity

Especifica la dirección URL de la colección de sitios.

Type:SpoSitePipeBind
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-IncludePersonalSite

Muestra sitios personales cuando el valor se establece en $true.

Los valores válidos son $true y $false. De manera predeterminada, el valor es $false, que indica que no se devolverán sitios personales.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Limit

Especifica el número máximo de colecciones de sitios que se devolverán. Puede ser cualquier número. Para recuperar todas las colecciones de sitios, use TODOS. El valor predeterminado es 200. Si se proporciona este parámetro, habrá colecciones de sitios que no se rellenen y contengan valores predeterminados.

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

-Template

Muestra sitios de una plantilla específica. Por ejemplo, STS, STS#0, STS#1, STS#3, GROUP#0, SRCHCEN#0 o SITEPAGEPUBLISHING#0.

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

Entradas

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Salidas

System.Object