Get-SPOSite

  • Referência
Módulo:
Microsoft.Online.SharePoint.PowerShell
Aplica-se a:
SharePoint Online

Retorna um ou mais conjuntos de sites.

Syntax

Get-SPOSite
   [[-Identity] <SpoSitePipeBind>]
   [-Detailed]
   [-Limit <String>]
   [<CommonParameters>]
Get-SPOSite
   [-Detailed]
   [-Filter <String>]
   [-IncludePersonalSite <Boolean>]
   [-Limit <String>]
   [-Template <String>]
   [-GroupIdDefined]
   [<CommonParameters>]
Get-SPOSite
   [-Identity] <SpoSitePipeBind>
   [-DisableSharingForNonOwnersStatus]
   [<CommonParameters>]

Description

Este cmdlet contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, consulte Conjuntos de Parâmetros do Cmdlet.

O cmdlet Get-SPOSite recupera e retorna as propriedades de todos os conjuntos de sites que correspondam aos critérios dados.

Com a versão 5361 do Shell de Gerenciamento do SharePoint Online, você pode ter as seguintes experiências:

Conjuntos de sites adicionais agora são exibidos. Por exemplo, todos os sites de vídeo e grupo são exibidos, juntamente com os sites de equipe.

O parâmetro Detailed foi substituído. Ele continuará a funcionar em versões anteriores

Observação

Conjuntos de sites na Lixeira não serão recuperados usando o cmdlet Get-SPOSite.

Você precisa ser um administrador do SharePoint Online ou um administrador global, e ser um administrador de conjunto de sites para executar o cmdlet.

Para obter permissões e as informações mais recentes sobre o Windows PowerShell do SharePoint Online, consulte a documentação on-line em Introdução ao Shell de gerenciamento do SharePoint Online..

Observação

Se o Gerenciamento de Armazenamento do Conjunto de Sites estiver habilitado para o locatário, você não poderá definir a cota e receberá uma mensagem de erro genérica. Para solucionar esse problema, defina o gerenciamento de armazenamento da coleção de sites como "manual" temporariamente, defina suas cotas e defina a configuração de gerenciamento de armazenamento do conjunto de sites de volta à configuração original.

Observação

Se os parâmetros Limite ou Filtro forem fornecidos, as seguintes propriedades de coleção de sites não serão preenchidas e poderão conter um valor padrão: AllowDownloadingNonWebViewableFiles, AllowEditing, AllowSelfServiceUpgrade, AnonymousLinkExpirationInDays, ConditionalAccessPolicy, DefaultLinkPermission, DefaultLinkToExistingAccess, DefaultSharingLinkType, DenyAddAndCustomizePages, DisableCompanyWideSharingLinks, ExternalUserExpirationInDays, InformationSegment, LimitedAccessFileType, OverrideTenantAnonymousLinkExpirationPolicy, OverrideTenantExternalUserExpirationPolicy, PWAEnabled, SandboxedCodeActivationCapability, SensitivityLabel, SharingAllowedDomainList, SharingBlockedDomainList, SharingCapability, SharingDomainRestrictionMode.

Exemplos

-----------------------EXEMPLO 1-----------------------------

Get-SPOSite

O exemplo 1 retorna todos os conjuntos de sites.

-----------------------EXEMPLO 2-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com

O exemplo 2 lista o conjunto de sites com propriedades detalhadas.

-----------------------EXEMPLO 3-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com -DisableSharingForNonOwnersStatus

Exemplo 3 atualiza o status se os não proprietários de um conjunto de sites podem compartilhar o conjunto de sites (não define esse valor).

-----------------------EXEMPLO 4-----------------------------

Get-SPOSite -Template GROUP#0 -IncludePersonalSite:$false

Este exemplo enumera Conjuntos de Sites de Grupo em um locatário.

-----------------------EXEMPLO 5-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/groupname -detailed |fl

Este exemplo tem detalhes de cota de um Site de Grupo.

-----------------------EXEMPLO 6-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/research | Select InformationSegment

Este exemplo retorna os InformationSegments associados ao site. Ele é aplicável a locatários que habilitam a Microsoft 365 barreiras de informações. Leia Saiba mais sobre barreiras de informações para entender as barreiras de informações no SharePoint Online.

Observação: essa propriedade está disponível apenas no Shell de Gerenciamento do SharePoint Online Versão 16.0.19927.12000 ou posterior.

-----------------------EXEMPLO 7-----------------------------

Get-SPOSite -Filter { Url -like "contoso.sharepoint.com/sites/18" }

Este exemplo usa a filtragem do lado do servidor para retornar sites correspondentes a 18.

-----------------------EXEMPLO 8-----------------------------

Get-SPOSite -Limit ALL | ?{$_.IsTeamsConnected -eq $true}

Este exemplo usa a filtragem do lado do cliente para retornar uma lista de sites conectados ao Microsoft Teams.

-----------------------EXEMPLO 9-----------------------------

Get-SPOSite -Limit ALL | ?{$_.IsTeamsChannelConnected -eq $true}

Este exemplo usa a filtragem do lado do cliente para retornar uma lista de sites conectados a um canal Privado ou Compartilhado do Microsoft Teams.

-----------------------EXEMPLO 10-----------------------------

Get-SPOSite -Limit ALL -GroupIdDefined $true

Este exemplo usa a filtragem do lado do servidor para retornar todos os sites que têm um grupo Microsoft 365 associado.

-----------------------EXAMPLE 11-----------------------------

$userUPN="joe.healy@contoso.com"
Get-SPOSite -Filter "Owner -like '$($userUPN)'"

Este exemplo recupera todos os sites filtrando pelo proprietário especificado usando uma variável.

Parâmetros

-Detailed

Use este parâmetro para conseguir informações adicionais de propriedades sobre um conjunto de sites. Você perceberá um tempo de resposta mais lento quando usar o parâmetro Detailed.

Os parâmetros a seguir são retornados:

  • ResourceUsageCurrent

  • ResourceUsageAverage

  • StorageUsageCurrent

  • LockIssue

  • WebsCount

  • CompatibilityLevel

  • AllowSelfServiceUpgrade

  • SiteDefinedSharingCapability

Retorna o valor armazenado da política do site.

  • SharingCapability

Retorna o nível de acesso efetivo, que é a política de site e a política de locatário combinada.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-DisableSharingForNonOwnersStatus

Esse parâmetro evita o compartilhamento por não proprietários.

Observação

Esse parâmetro está disponível apenas no Shell de Gerenciamento do SharePoint Online versão 16.0.4613.1211 ou posterior. DisableSharingForNonOwnersStatus não é uma configuração persistente, mas sim uma análise do estado da coleção de sites. A finalidade disso é obter essa configuração e não é garantido que outras configurações retornadas estejam corretas. Para obter outras configurações e valores, use o Get-SPOSite sem esse parâmetro para garantir que tudo seja exibido corretamente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Filter

Especifica o bloco de scripts do filtro do servidor a ser aplicado. O tipo deve ser um nome de filtro válido e o valor deve estar no formato { PropertyName <operator> "filterValue"}. Os operadores válidos são os seguintes: -eq, -ne, -like, -notlike. Atualmente, você pode filtrar por estas propriedades: Proprietário, Modelo (pode ser usado para filtrar se for a única propriedade presente no filtro), LockState, URL. Não há suporte para o uso do operador -or para incluir um filtro adicional.

Observação: os valores do operador diferenciam maiúsculas de minúsculas.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-GroupIdDefined

Filtra a lista de sites retornados a sites com uma ID de Grupo (ou seja, sites conectados a um grupo Microsoft 365) quando o valor é definido como $true. Filtra a lista de sites somente para sites sem uma ID de Grupo quando o valor é $false.

Os valores são $true, $falsee não definidos. Por padrão, o valor é não definido, o que significa que o filtro não se aplica.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Identity

Especifica a URL do conjunto de sites.

Type:SpoSitePipeBind
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-IncludePersonalSite

Exibe os sites pessoais quando o valor é definido como $true.

Os valores são $true e $false. Por padrão, o valor é $false o que significa que nenhum site pessoal será retornado.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Limit

Especifica o máximo de conjuntos de sites para retornar. Pode ser qualquer número. Para recuperar todos os conjuntos de sites, use ALL. O valor padrão é 200. Se esse parâmetro for fornecido, algumas propriedades do conjunto de sites não serão populadas e poderão conter um valor padrão.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Template

Exibe os sites de um modelo específico. Por exemplo, STS, STS#0, STS#1, STS#3, GROUP#0, SRCHCEN#0 ou SITEPAGEPUBLISHING#0.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

Entradas

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Saídas

System.Object