Get-SPWeb

Syntax

Get-SPWeb
   [[-Identity] <SPWebPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-Site <SPSitePipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

Get-SPWeb cmdlet은 Identity 매개 변수에 지정된 범위와 일치하는 하위 사이트를 모두 반환합니다. 조건과 일치하는 모든 하위 사이트가 반환됩니다.

Identity는 전체 URL이나 상대 경로일 수 있습니다. 상대 경로를 지정하는 경우 Site 매개 변수도 지정하여 하위 사이트를 반환할 원본 사이트 모음을 식별해야 합니다.

Identity 매개 변수는 와일드카드 문자(*)로 끝나는 부분 URL도 지원합니다. 지정한 범위에 대해 이 부분 URL과 일치하는 모든 하위 사이트가 반환됩니다. 또한 Regex 매개 변수를 제공하면 Identity 매개 변수가 정규식으로 처리되며 지정한 범위에 제공된 URL 중 식과 일치하는 URL을 가진 모든 하위 사이트가 반환됩니다.

Filter 매개 변수는 콘텐츠 데이터베이스에 저장된 특정 하위 사이트 속성에 대한 서버 쪽 필터입니다. Filter 매개 변수가 없으면 이러한 속성에 대한 필터링이 느린 프로세스입니다. 이러한 하위 사이트 속성은 템플릿 및 제목입니다. Filter 매개 변수는 Where-Object 문과 동일한 구문을 사용하는 스크립트 블록이지만 더 빠른 결과를 위해 서버 쪽에서 실행됩니다.

Get-SPWeb cmdlet에서 반환된 사이트 모음은 파이프라인이 끝날 때 자동으로 삭제됩니다. Get-SPWeb의 결과를 로컬 변수에 저장하려면 Start-SPAssignment 및 Stop-SPAssignment cmdlet을 사용하여 메모리 누수를 방지해야 합니다.

SharePoint 제품용 Windows PowerShell에 대한 사용 권한 및 최신 정보는 SharePoint Server Cmdlets를 참조하세요.

예제

---------------예제 1---------------

Get-SPWeb -site https://sitename/sites/site1

이 예제에서는 지정한 사이트 모음의 모든 하위 웹을 반환합니다.

---------------예제 2---------------

Get-SPWeb -Site https://sitename/sites/site1  -filter {$_.Template -eq "STS#0"}

이 예제에서는 "STS#0" 서식 파일을 사용하는 모든 하위 사이트를 표시합니다.

---------------예제 3---------------

Start-SPAssignment -Global
$w = Get-SPWeb https://sitename
$w.set_SiteLogoUrl("https://PathToImage/test.jpg")
$w.Update()
Stop-SPAssignment -Global

이 예제에서는 하위 사이트를 변수로 저장하고 SPAssignment 개체에서 개체 모델 메서드를 호출하는 방법을 보여 줍니다.

매개 변수

-AssignmentCollection

-Confirm

-Filter

-Identity

-Limit

-Regex

-Site

-WhatIf