Get-UnifiedGroup
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet Get-UnifiedGroup para exibir Grupos do Microsoft 365 em sua organização baseada em nuvem. Para exibir membros, proprietários e assinantes para Grupos do Microsoft 365, use o cmdlet Get-UnifiedGroupLinks.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Get-UnifiedGroup
[[-Identity] <UnifiedGroupIdParameter>]
[-Filter <String>]
[-IncludeAllProperties]
[-IncludeSoftDeletedGroups]
[-ResultSize <Unlimited>]
[-SortBy <String>]
[<CommonParameters>] Get-UnifiedGroup
[-Anr <String>]
[-Filter <String>]
[-IncludeAllProperties]
[-IncludeSoftDeletedGroups]
[-ResultSize <Unlimited>]
[-SortBy <String>]
[<CommonParameters>] Description
Grupos do Microsoft 365 são objetos de grupo disponíveis em Microsoft 365 serviços.
Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Get-UnifiedGroupEste exemplo retorna uma lista de resumo de todos os Grupos do Microsoft 365.
Exemplo 2
Get-UnifiedGroup | Format-List DisplayName,EmailAddresses,Notes,ManagedBy,AccessTypeEste exemplo retorna as seguintes informações sobre todas as Grupos do Microsoft 365:
- Nome diferenciado (DN)
- Nome para exibição
- Descrição
- Proprietários
- Privacidade
Exemplo 3
Get-UnifiedGroup -Identity "Marketing Department" | Format-ListEste exemplo retorna informações detalhadas sobre o Microsoft Grupo 365 chamado Departamento de Marketing.
Exemplo 4
Get-UnifiedGroup | Where-Object {-Not $_.ManagedBy}Este exemplo retorna Grupos do Microsoft 365 que não têm um proprietário.
Exemplo 5
Get-UnifiedGroup -Filter {ResourceProvisioningOptions -eq "Team"}Este exemplo retorna Grupos do Microsoft 365 que são criadas quando uma equipe de Microsoft é criada.
Parâmetros
-Anr
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Filter
O parâmetro Filter usa a sintaxe OPATH para filtrar os resultados pelas propriedades e valores especificados. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'".
- Inclua todo o filtro OPATH nas aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo,
$true,$falseou$null), use aspas individuais ' ' em vez disso. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também pode usar chaves { }, mas somente se o filtro não contiver variáveis. - A propriedade é uma propriedade filtrada. Para obter mais informações sobre as propriedades filtradas no servidor exchange e Exchange Online, consulte Propriedades filtreáveis para o parâmetro Filter.
- ComparisonOperator é um operador de comparação OPATH (por exemplo
-eq, para iguais e-likepara comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators. - Valor é o valor da propriedade a ser pesquisado. Inclua valores e variáveis de texto em aspas individuais (
'Value'ou'$Variable'). Se um valor variável contiver aspas individuais, você precisará identificar (escapar) as aspas individuais para expandir a variável corretamente. Por exemplo, em vez de'$User', use'$($User -Replace "'","''")'. Não inclua inteiros ou valores do sistema entre aspas (por exemplo, use500,$true,$falseou$nullem vez disso).
Você pode encadear vários critérios de pesquisa usando os operadores lógicos -and e -or. Por exemplo: "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3".
Para obter informações detalhadas sobre filtros OPATH no Exchange, consulte Informações adicionais de sintaxe OPATH.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Identity
O parâmetro Identity especifica o grupo Microsoft 365 que você deseja exibir. Você pode usar qualquer valor que identifique exclusivamente o grupo Microsoft 365. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- DN canônico
- GUID
Observação: você pode usar o valor DisplayName para identificar o grupo Microsoft 365, mas os resultados não são garantidos como exclusivos. Se você precisar retornar um resultado singular e exclusivo, use um identificador exclusivo para o grupo Microsoft 365.
| Type: | UnifiedGroupIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IncludeAllProperties
A opção IncludeAllProperties especifica se deve incluir os valores de todas as propriedades nos resultados. Não é preciso especificar um valor com essa opção.
Se você não usar essa opção, os valores de algumas propriedades (por exemplo, CalendarMemberReadOnly, CalendarUrl, InboxUrl, PeopleUrl e PhotoUrl) poderão aparecer em branco.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IncludeSoftDeletedGroups
A opção IncludeSoftDeletedGroups especifica se deve incluir Grupos do Microsoft 365 excluídos suavemente nos resultados. Não é preciso especificar um valor com essa opção.
Os Grupos do Microsoft 365 excluídos são grupos excluídos que ainda podem ser recuperados.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ResultSize
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-SortBy
O parâmetro SortBy especifica a propriedade pela qual classificar os resultados. Você pode classificar apenas por uma propriedade de cada vez. Os resultados são classificados em ordem crescente.
Se a exibição padrão não incluir a propriedade pela qual você está classificando, você poderá acrescentar o comando com | Format-Table -Auto Property1,Property2,...PropertyX. para criar uma nova exibição que contenha todas as propriedades que você deseja ver. Os caracteres curinga (*) nos nomes de propriedade são permitidos.
É possível classificar pelas seguintes propriedades:
- Nome
- DisplayName
- Alias
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários