Get-SPOSite
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-SPOSiteO exemplo 1 retorna todos os conjuntos de sites.
-----------------------EXEMPLO 2-----------------------------
Get-SPOSite -Identity https://contoso.sharepoint.comO exemplo 2 lista o conjunto de sites com propriedades detalhadas.
-----------------------EXEMPLO 3-----------------------------
Get-SPOSite -Identity https://contoso.sharepoint.com -DisableSharingForNonOwnersStatusExemplo 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:$falseEste exemplo enumera Conjuntos de Sites de Grupo em um locatário.
-----------------------EXEMPLO 5-----------------------------
Get-SPOSite -Identity https://contoso.sharepoint.com/sites/groupname -detailed |flEste exemplo tem detalhes de cota de um Site de Grupo.
-----------------------EXEMPLO 6-----------------------------
Get-SPOSite -Identity https://contoso.sharepoint.com/sites/research | Select InformationSegmentEste 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 $trueEste 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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de