Get-SPWeb

Syntax

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.

--------------------EXAMPLE 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".

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

-Confirm

-Filter

-Identity

-Limit

-Regex

-Site

-WhatIf