Get-SPOSite
Devuelve una o más colecciones de sitios.
Sintaxis
ParamSet1 (Es el valor predeterminado).
Get-SPOSite
[[-Identity] <SpoSitePipeBind>]
[-Limit <String>]
[-Detailed]
[-IsAuthoritative <Boolean>]
[<CommonParameters>]
ParamSet3
Get-SPOSite
[-Identity] <SpoSitePipeBind>
[-DisableSharingForNonOwnersStatus]
[<CommonParameters>]
ParamSet2
Get-SPOSite
[-Filter <String>]
[-Limit <String>]
[-Detailed]
[-Template <String>]
[-IncludePersonalSite <Boolean>]
[-GroupIdDefined <Boolean>]
[-ArchiveStatus <ArchiveStatusFilterType>]
[<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.
Las redirecciones de sitio, como las creadas después de cambiar el nombre de dominio de SharePoint , se recuperarán mediante este cmdlet.
Debe ser administrador de SharePoint Online y ser administrador de la 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 el elemento InformationSegment 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 Shell de administración de SharePoint Online versión 16.0.19927.12000 o posterior.
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 -Filter { IsAuthoritative -eq true }
En este ejemplo se usa el filtrado del lado servidor para devolver sitios autoritativos (es decir, sitios que tienen la propiedad IsAuthoritative establecida en true).
EJEMPLO 9
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 10
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 11
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.
EJEMPLO 12
$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
-ArchiveStatus
Aplicable: SharePoint Online
Muestra los sitios de un estado de archivo específico. Por ejemplo, NotArchived, RecentlyArchived, FullyArchived, Archived o Reactivating.
Propiedades del parámetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.ArchiveStatusFilterType |
| Valor predeterminado: | None |
| Valores aceptados: | NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParamSet2
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Detailed
Aplicable: SharePoint Online
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).
Propiedades del parámetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParamSet1
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
ParamSet2
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DisableSharingForNonOwnersStatus
Aplicable: SharePoint Online
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 valores, use el Get-SPOSite sin este parámetro para asegurarse de que todo se muestra correctamente.
Propiedades del parámetro
| Tipo: | System.Management.Automation.SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParamSet3
| Posición: | Named |
| Mandatory: | 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: SharePoint Online
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.
Actualmente, puede filtrar por estas propiedades: Propietario, Plantilla (se puede usar para filtrar si es la única propiedad presente en el filtro), LockState, Url, IsAuthoritative (solo admite operadores de comparación -eq y -ne).
No se admite el uso del operador -or para incluir un filtro adicional.
Los valores del operador distinguen mayúsculas de minúsculas.
Propiedades del parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParamSet2
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-GroupIdDefined
Aplicable: SharePoint Online
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.
Propiedades del parámetro
| Tipo: | System.Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParamSet2
| Posición: | Named |
| Mandatory: | 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: SharePoint Online
Especifica la dirección URL de la colección de sitios.
Propiedades del parámetro
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParamSet1
| Posición: | 0 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
ParamSet3
| Posición: | 0 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IncludePersonalSite
Aplicable: SharePoint Online
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.
Propiedades del parámetro
| Tipo: | System.Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParamSet2
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IsAuthoritative
Aplicable: SharePoint Online
Filtre la lista de sitios donde la propiedad IsAuthoritative está establecida en true. Cuando IsAuthoritative es true, indica a Microsoft Search, Copilot (BizChat) y a otros agentes de inteligencia artificial que el contenido del sitio es oficial, de confianza y comprobado.
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParamSet1
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Limit
Aplicable: SharePoint Online
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.
Propiedades del parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParamSet1
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
ParamSet2
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Template
Aplicable: SharePoint Online
Muestra sitios de una plantilla específica. Por ejemplo, STS, STS#0, STS#1, STS#3, GROUP#0, SRCHCEN#0 o SITEPAGEPUBLISHING#0.
Propiedades del parámetro
| Tipo: | System.String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParamSet2
| Posición: | Named |
| Mandatory: | 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.