Get-DeviceConditionalAccessPolicy
Este cmdlet funciona somente no PowerShell de Segurança & Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..
Use o cmdlet Get-DeviceConditionalAccessPolicy para exibir as políticas de acesso condicional de dispositivo móvel no Mobilidade básica e segurança no Microsoft 365.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Get-DeviceConditionalAccessPolicy
[[-Identity] <PolicyIdParameter>]
[<CommonParameters>]
Description
Os cmdlets em Mobilidade básica e segurança são descritos na lista a seguir:
- Cmdlets DeviceTenantPolicy e DeviceTenantRule: uma política que define se deve bloquear ou permitir o acesso de dispositivos móveis ao email do Exchange Online por dispositivos sem suporte que usam apenas o Exchange ActiveSync. Essa configuração se aplica a todos os usuários da sua organização. Os cenários de permissão e bloqueio permitem gerar relatórios para dispositivos sem suporte, e você pode especificar exceções para a política com base nos grupos de segurança.
- Cmdlets DeviceConditionalAccessPolicy e DeviceConditionalAccessRule: políticas que controlam o acesso de dispositivos móveis ao Microsoft 365 para dispositivos com suporte. Essas políticas são aplicadas a grupos de segurança. Os dispositivos sem suporte não têm permissão para se inscrever no Mobilidade básica e segurança.
- Cmdlets DeviceConfigurationPolicy e DeviceConfigurationRule: políticas que controlam as configurações de dispositivos móveis com suporte. Essas políticas são aplicadas a grupos de segurança.
- Get-DevicePolicy: retorna todas as políticas básicas de Mobilidade e segurança, independentemente do tipo (DeviceTenantPolicy, DeviceConditionalAccessPolicy ou DeviceConfigurationPolicy).
Para obter mais informações sobre Mobilidade básica e segurança, consulte Visão geral da Mobilidade básica e segurança para Microsoft 365.
Para usar este cmdlet no PowerShell de Segurança e Conformidade, você precisa receber permissões. Para obter mais informações, confira Permissões no portal do Microsoft Defender ou Permissões no portal de conformidade do Microsoft Purview.
Exemplos
Exemplo 1
Get-DeviceConditionalAccessPolicy | Format-Table Name,Enabled,Priority
Este exemplo mostra informações resumidas de todas as políticas de acesso condicional de dispositivo móvel.
Exemplo 2
Get-DeviceConditionalAccessPolicy -Identity "Human Resources"
Este exemplo mostra detalhes sobre a política de acesso condicional de dispositivo móvel denominada Recursos Humanos.
Parâmetros
-Identity
Aplicável: Exchange Online, Segurança & Conformidade
O parâmetro Identity especifica a política de acesso condicional do dispositivo móvel que você deseja exibir. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | PolicyIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| 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.