Get-SPOSite
Retorna um ou mais conjuntos de sites.
Sintaxe
ParamSet1 (Padrão)
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 utilizar conjuntos de parâmetros, veja Conjuntos de Parâmetros de Cmdlets.
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.
Os redirecionamentos de sites, como os criados após alterar o nome de domínio do SharePoint , serão obtidos com este cmdlet.
Tem de ser um administrador do SharePoint Online e ser um administrador de coleções 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 este problema, defina a gestão de armazenamento da coleção de sites como "manual" temporariamente, defina as quotas e, em seguida, defina a definição de gestão de armazenamento da coleção de sites novamente para a definição original.
Observação
Se os parâmetros Limit ou Filter forem fornecidos, as seguintes propriedades da coleção de sites não serão preenchidas e poderão conter um valor predefinido: 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 devolve o InformationSegment associado ao site. Ele é aplicável a locatários que habilitam a Microsoft 365 barreiras de informações. Leia Saiba mais sobre as barreiras de informação para compreender as barreiras de informações no SharePoint Online.
Nota: esta propriedade só está disponível 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 utiliza a filtragem do lado do servidor para devolver sites autoritativos (ou seja, sites que têm a propriedade IsAuthoritative definida como verdadeiro).
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 obtém todos os sites que filtram pelo proprietário especificado através de uma variável.
Parâmetros
-ArchiveStatus
Aplicável: SharePoint Online
Apresenta sites de um status de arquivo específico. Por exemplo, NotArchived, RecentlyArchived, FullyArchived, Archived ou Reactivating.
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 definição persistente, mas sim uma análise do estado da coleção de sites. O objetivo é obter esta definição e não é garantido que outras definições devolvidas estejam corretas. Para obter outras definições e valores, utilize o Get-SPOSite sem este parâmetro para garantir que tudo é apresentado 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, pode filtrar por estas propriedades: Proprietário, Modelo (pode ser utilizado para filtrar se for a única propriedade presente no filtro), LockState, Url, IsAuthoritative (apenas suporta 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 onde a propriedade IsAuthoritative está definida como true. Quando IsAuthoritative é verdadeiro, sinaliza para Microsoft Search, Copilot (BizChat) e outros agentes de IA que o conteúdo do site é oficial, fidedigno 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.