Get-SPSite

Syntax

Get-SPSite
   [-Identity] <SPSitePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   -ContentDatabase <SPContentDatabasePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [-NeedsB2BUpgrade]
   [<CommonParameters>]

Get-SPSite
   -SiteSubscription <SPSiteSubscriptionPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WebApplication <SPWebApplicationPipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

Este cmdlet contiene más de un conjunto de parámetros. Es posible que solo pueda usar parámetros procedentes de un conjunto de parámetros y no pueda combinar los parámetros de distintos conjuntos de parámetros. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.

El cmdlet Get-SPSite devuelve un solo sitio que coincide con el parámetro Identity o todos los sitios que coinciden con el parámetro Filter en el ámbito especificado. Los ámbitos son los parámetros WebApplication, ContentDatabase y SiteSubscription. Si no se proporciona ninguno de esos ámbitos, la granja de servidores será el ámbito. Si el ámbito se especifica sin el parámetro Filter, se devolverán todos los sitios de ese ámbito.

El parámetro Identity permite que se proporcione una dirección URL parcial que acabe con un carácter comodín (*). Todas las colecciones de sitios que coinciden con esta dirección URL parcial para el ámbito especificado se devuelven. Además, si se proporciona el parámetro Regex, el parámetro Identity se trata como una expresión regular y se devolverán todas colecciones de sitios con una dirección URL proporcionada en el ámbito determinado que coincidan con la expresión.

El parámetro Filter es un filtro del lado servidor para determinadas propiedades de colección de sitios que se almacenan en la base de datos de contenido; sin el parámetro Filter, el filtrado de estas propiedades es un proceso lento. Estas propiedades de colección de sitios son Owner, SecondaryContact y LockState. El parámetro Filter es un bloque de script que usa la misma sintaxis que una instrucción Where-Object, pero se ejecuta en el servidor para obtener resultados más rápidos.

Los valores válidos de LockState son los siguientes: Unlock, NoAdditions, ReadOnly y NoAccess.

Es importante tener en cuenta que cada colección de sitios que devuelve el cmdlet Get-SPSite se destruye automáticamente al final de la canalización. Para almacenar los resultados de Get-SPSite en una variable local, use los cmdlets Start-SPAssignment y Stop-SPAssignment para evitar pérdidas de memoria.

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

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

Get-SPSite 'https://<site name>' | Get-SPWeb -Limit All | Select Title

En este ejemplo se obtiene la colección de títulos subweb de la colección de sitios en https://< nombre> del sitio.

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

Get-SPSite -ContentDatabase "b399a366-d899-4cff-8a9b-8c0594ee755f" | Format-Table -Property Url, Owner, SecondaryContact

En este ejemplo se obtiene un subconjunto de datos de todos los sitios de la base de datos de contenido b399a366-d899-4cff-8a9b-8c0594ee755f.

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

Start-SPAssignment -Global
$s = Get-SPSite -Identity https://<MyApp>/Sites/Site1
$s.Url
Stop-SPAssignment -Global

En este ejemplo se obtienen los sitios que especifica el parámetro Identity y se insertan los resultados en la variable s

En el ejemplo anterior se usa el método Global de colección de asignaciones. El método Global es fácil de usar, pero el contenido de este objeto crece con rapidez. Es importante que no ejecute un comando Get-SPSite que devuelva muchos resultados cuando la asignación global está habilitada.

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

$GC = Start-SPAssignment
$Sites = $GC | Get-SPSite -Filter {$_.Owner -eq "DOMAIN\JDow"} -Limit 50
Stop-SPAssignment $GC

En este ejemplo se obtienen los 50 primeros sitios cuyo propietario es el usuario DOMAIN\JDow mediante una consulta de lado servidor, y se asignan a una variable local.

En este ejemplo se usan los métodos de colección de asignaciones avanzados.

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

Get-SPWebApplication https://<site name> | Get-SPSite -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.Usage.Storage }{$sum}

En este ejemplo se muestra un comando que devuelve la suma del uso de espacio en disco de todos los sitios de una aplicación web determinada.

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

Get-SPSite -Identity "https://localserver/(my|personal)/sites" -Regex

En este ejemplo se devuelven todos los sitios que coinciden con la expresión regular determinada.

Es necesario poner comillas en el parámetro Identity cuando se usa el parámetro Regex.

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

Get-SPSite https://<site name>/sites/teams/* -Limit 100

En este ejemplo se obtienen hasta 100 de los sitios en la dirección URL. https://sitename/sites/teams.

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

Get-SPSite | select url, @{Expression={$_.Usage.Storage}}

En este ejemplo se obtiene la cantidad de almacenamiento que usa una colección de sitios mediante el campo de almacenamiento de la propiedad .UsageInfo.

------------------EXAMPLE 9---------------------

Get-SPSite -Limit all -CompatibilityLevel 14

En este ejemplo se devuelven todas las colecciones de sitios en modo de SharePoint Server.

Parámetros

-AssignmentCollection

-CompatibilityLevel

-Confirm

-ContentDatabase

-Filter

-Identity

-Limit

-NeedsB2BUpgrade

-Regex

-SiteSubscription

-WebApplication

-WhatIf