Get-SPWeb
Devuelve todos los subsitios que coinciden con los criterios proporcionados.
Sintaxis
Default (Es el valor predeterminado).
Get-SPWeb
[[-Identity] <SPWebPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Filter <ScriptBlock>]
[-Limit <String>]
[-Regex]
[-Site <SPSitePipeBind>]
[-WhatIf]
[<CommonParameters>]
Description
El cmdlet Get-SPWeb devuelve todos los subsitios que coinciden con el ámbito proporcionado por el parámetro Identity. Se devuelven todos los subsitios que cumplen los criterios.
La identidad puede ser la dirección URL completa o una ruta de acceso relativa. Si especifica una ruta de acceso relativa, también debe especificar el parámetro Site para identificar la colección de sitios desde la que devolver el subsitio.
El parámetro Identity también admite proporcionar una dirección URL parcial que termina en un carácter comodín (*). Se devuelven todos los subsitios que coinciden con esta dirección URL parcial para el ámbito especificado. Además, si se proporciona el parámetro Regex, el parámetro Identity se trata como una expresión regular y se devuelve cualquier subweb con una dirección URL proporcionada en el ámbito especificado que coincida con la expresión.
El parámetro Filter es un filtro del lado servidor para determinadas propiedades de subsitio 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 subsitios son Template y Title. 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 lado servidor para obtener resultados más rápidos.
Es importante tener en cuenta que todas las colecciones de sitios devueltas por el cmdlet Get-SPWeb se eliminan automáticamente al final de la canalización. Para almacenar los resultados de Get-SPWeb en una variable local, se deben usar 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-SPWeb -site https://sitename/sites/site1
En este ejemplo se devuelven todas las subwebs de una colección de sitios determinada.
EJEMPLO 2
Get-SPWeb -Site https://sitename/sites/site1 -filter {$_.Template -eq "STS#0"}
En este ejemplo se muestran todos los subsitios que usan la plantilla "STS#0".
EJEMPLO 3
Start-SPAssignment -Global
C:\PS>$w = Get-SPWeb https://sitename
C:\PS>$w.set_SiteLogoUrl("https://PathToImage/test.jpg")
C:\PS>$w.Update()
Stop-SPAssignment -Global
En este ejemplo se demuestra cómo guardar un subsitio como una variable y cómo llamar a métodos de modelo de objetos en el objeto SPAssignment.
Parámetros
-AssignmentCollection
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | SPAssignmentCollection |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Le pide confirmación antes de ejecutar el comando.
Para obtener más información, escriba el siguiente comando: get-help about_commonparameters
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| 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 Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el filtro de servidor que se va a usar para el ámbito especificado.
El tipo debe ser un filtro válido con el formato {filterName <operator> "filterValue"}.
Propiedades del parámetro
| Tipo: | ScriptBlock |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| 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 Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el nombre o la dirección URL parcial o completa del subsitio. Si usa una ruta de acceso relativa, debe especificar el parámetro Site.
Una dirección URL válida con el formato https://server_name o una ruta de acceso relativa con el formato /Subsitios/MiSubsitio.
Propiedades del parámetro
| Tipo: | SPWebPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| 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 Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Limita el número máximo de subsitios que se devuelven. El valor predeterminado es 200. Para devolver todos los sitios, escriba TODO.
El tipo debe ser un número válido mayor que 0 o TODO.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| 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 |
-Regex
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica si la dirección URL proporcionada para el parámetro Identity se trata como una expresión regular.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| 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 |
-Site
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica la dirección URL o el GUID de la colección de sitios desde donde enumerar subsitios.
El tipo debe ser una dirección URL válida, con el formato https://server_name un GUID, con el formato 1234-5678-9807, o un objeto SPSite.
Propiedades del parámetro
| Tipo: | SPSitePipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| 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.