Get-SPSite

Devuelve todas las colecciones de sitios que coinciden con los criterios especificados.

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

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-CompatibilityLevel

Especifica la versión de plantillas que se usará al crear un nuevo objeto SPSite. Este valor establece el valor CompatibilityLevel inicial para la colección de sitios. Los valores de este parámetro pueden ser SharePoint Server o SharePoint Server. Cuando no se especifica este parámetro, el valor CompatibilityLevel usará de forma predeterminada la versión más reciente posible para la aplicación web de acuerdo con la configuración de SiteCreationMode.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ContentDatabase

Especifica el GUID de la base de datos de contenido desde la que se enumerarán las colecciones de sitios.

El tipo debe ser un nombre de base de datos válido, con el formato SPContentDB01, o un GUID válido (por ejemplo, 12345678-90ab-cdef-1234-567890bcdefgh).

Type:SPContentDatabasePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-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 y un valor válidos con el formato {$_PropertyName <operador> "filterValue"}.

Los operadores válidos son: EQ, NE, LIKE, NOTLIKE.

Type:ScriptBlock
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

Especifica la dirección URL o el GUID de la colección de sitios que se va a obtener.

El tipo debe ser una dirección URL válida, con el formato https://server_name o https://server_name/sites/sitename, o un GUID válido (por ejemplo, 12345678-90ab-cdef-1234-567890bcdefgh).

Type:SPSitePipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Limit

Limita el número máximo de colecciones de sitios que se devolverá. El valor predeterminado es 200.

El tipo debe ser un número no negativo. Especifique ALL para devolver todas las colecciones para el ámbito determinado.

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

-NeedsB2BUpgrade

Especifica si debe actualizarse el sitio.

Los valores válidos son True y False.

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

-Regex

Cuando se usa, la dirección URL proporcionada para el parámetro Identity se trata como una expresión regular.

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

-SiteSubscription

Especifica la suscripción de sitios desde la que se obtendrán colecciones de sitios.

El tipo debe ser una dirección URL válida, con el formato https://server_name, o un GUID válido (por ejemplo, 12345678-90ab-cdef-1234-567890bcdefgh).

Type:SPSiteSubscriptionPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WebApplication

Especifica la dirección URL, el GUID o el nombre de la aplicación web desde la que se van a enumerar los sitios.

El tipo debe ser una dirección URL válida con el formato https://server_name, un GUID válido (por ejemplo, 12345678-90ab-cdef-1234-567890bcdefgh) o el nombre de la aplicación web (por ejemplo, AplicaciónWeb1212).

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition