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.

The Get-SPSite cmdlet returns either a single site that matches the Identity parameter, or all the sites that match the Filter parameter for the specified scope. The scopes are the WebApplication, ContentDatabase , and SiteSubscription parameters. If none of these scopes is provided, the scope is the farm. If the scope is specified with no Filter parameter, all sites in that scope are returned.

The Identity parameter supports providing a partial URL that ends in a wildcard character (*). All site collections that match this partial URL for the specified scope are returned. Additionally, if the Regex parameter is provided, the Identity parameter is treated as a regular expression and any site collection with a URL provided in the given scope that matches the expression is returned.

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.

It is important to note that every site collection that the Get-SPSite cmdlet returns is automatically destroyed at the end of the pipeline. To store the results of Get-SPSite in a local variable, use the Start-SPAssignment and Stop-SPAssignment cmdlets to avoid memory leaks.

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://<site name>.

------------------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

The previous example uses the Global method of assignment collection. The Global method is easy to use but the contents of this object grows quickly. Be careful not to run a Get-SPSite command that returns many results while global assignment is enabled.

------------------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

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
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
Accept pipeline input:False
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
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
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
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Filtro

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 un valor con el formato {$_NombreDePropiedad <operator> "valorDeFiltro"}.

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

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

-Identidad

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
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
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
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
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
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
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition