Get-SPOSite

Retorna um ou mais conjuntos de sites.

Sintaxe

ParamSet1 (Default)

Get-SPOSite
    [[-Identity] <SpoSitePipeBind>]
    [-Limit <String>]
    [-Detailed]
    [-IsAuthoritative <Boolean>]
    [<CommonParameters>]

ParamSet3

Get-SPOSite
    [-Identity] <SpoSitePipeBind>
    [-DisableSharingForNonOwnersStatus]
    [<CommonParameters>]

ParamSet2

Get-SPOSite
    [-Filter <String>]
    [-Limit <String>]
    [-Detailed]
    [-Template <String>]
    [-IncludePersonalSite <Boolean>]
    [-GroupIdDefined <Boolean>]
    [-ArchiveStatus <ArchiveStatusFilterType>]
    [<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 de 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.

Redirecionamentos de site, como aqueles criados após a alteração do nome de domínio do SharePoint , serão recuperados usando este cmdlet.

Você precisa ser um administrador do SharePoint Online 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 do conjunto de sites como "manual" temporariamente, defina suas cotas e, em seguida, defina a configuração de gerenciamento de armazenamento do conjunto de sites de volta para sua configuração original.

Observação

Se os parâmetros Limit ou Filter forem fornecidos, as seguintes propriedades do conjunto 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 o InformationSegment associado ao site. Ele é aplicável a locatários que habilitam a Microsoft 365 barreiras de informações. Leia mais sobre barreiras de informações para entender as barreiras de informações no SharePoint Online.

Observação: esta 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 -Filter { IsAuthoritative -eq true }

Este exemplo usa a filtragem do lado do servidor para retornar sites autoritativos (ou seja, sites que têm a propriedade IsAuthoritative definida como true).

EXEMPLO 9

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 10

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 11

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.

EXEMPLO 12

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

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

Parâmetros

-ArchiveStatus

Aplicável: SharePoint Online

Exibe sites de um status de arquivo morto específico. Por exemplo, NotArchived, RecentlyArchived, FullyArchived, Archived, ou Reativando.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.PowerShell.ArchiveStatusFilterType
Valor padrão:None
Valores aceitos:NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet2
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Detailed

Aplicável: SharePoint Online

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.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet1
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ParamSet2
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisableSharingForNonOwnersStatus

Aplicável: SharePoint Online

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 do conjunto de sites. O objetivo 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.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet3
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Filter

Aplicável: SharePoint Online

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: Owner, Template (pode ser usado para filtrar se for a única propriedade presente no filtro), LockState, Url, IsAuthoritative (suporta apenas os operadores de comparação -eq e -ne). 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.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet2
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GroupIdDefined

Aplicável: SharePoint Online

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.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet2
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: SharePoint Online

Especifica a URL do conjunto de sites.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet1
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ParamSet3
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IncludePersonalSite

Aplicável: SharePoint Online

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.

Propriedades do parâmetro

Tipo:System.Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet2
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IsAuthoritative

Aplicável: SharePoint Online

Filtre a lista de sites em que a propriedade IsAuthoritative está definida como true. Quando IsAuthoritative é verdadeiro, ele sinaliza para a Pesquisa da Microsoft, o Copilot (BizChat) e outros agentes de IA que o conteúdo do site é oficial, confiável e verificado.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet1
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Limit

Aplicável: SharePoint Online

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.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet1
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
ParamSet2
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Template

Aplicável: SharePoint Online

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

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ParamSet2
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

Entradas

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Saídas

System.Object