Get-SPWeb

지정한 조건과 일치하는 하위 사이트를 모두 반환합니다.

Syntax

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

Description

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

The Identity can be either the full URL or a relative path. If you specify a relative path, you must also specify the Site parameter to identify the site collection from which to return the subsite.

The Identity parameter also supports providing a partial URL that ends in a wildcard character (*). All subsites 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 subweb with a URL provided in the given scope that matches the expression is returned.

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

It is important to note that every site collection returned by the Get-SPWeb cmdlet is automatically disposed of at the end of the pipeline. To store the results of Get-SPWeb in a local variable, the Start-SPAssignment and Stop-SPAssignment cmdlets must be used to avoid memory leaks.

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

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

-Confirm

명령을 실행하기 전에 사용자에게 확인 메시지를 표시합니다. 자세한 내용을 확인하려면 다음 명령을 입력하세요. 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

-Filter

지정한 범위에 사용할 서버 쪽 필터를 지정합니다.

형식은 {필터 이름 <연산자> "필터 값"} 형식의 유효한 필터여야 합니다.

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

-Identity

하위 사이트의 이름이나 전체 또는 부분 URL을 지정합니다. 상대 경로를 사용하는 경우 Site 매개 변수를 지정해야 합니다.

http://서버_이름 형식의 유효한 URL 또는 /SubSites/MySubSite 형식의 상대 경로입니다.

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

-Limit

반환할 최대 하위 사이트 수를 지정합니다. 기본값은 200입니다. 모든 사이트를 반환하려면 ALL 을 입력합니다.

형식은 0보다 큰 유효한 숫자나 ALL이어야 합니다.

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

-Regex

Identity 매개 변수에서 제공하는 URL을 정규식으로 처리할지 여부를 지정합니다.

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

-Site

하위 사이트를 나열할 원본 사이트 모음의 URL이나 GUID를 지정합니다.

형식은 1234-5678-9807 형식의 https://server_name유효한 URL( GUID) 또는 SPSite 개체여야 합니다.

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

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: 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