> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-references/device/security/reset-mobile-device-pin.md). # Repor PIN do dispositivo móvel Repor o código de acesso deste dispositivo móvel ### Descrição Aciona uma redefinição do código de acesso do Intune para este dispositivo móvel. O Intune só suporta isto para determinados tipos de dispositivos de propriedade empresarial e rejeita-o para dispositivos pessoais ou não suportados. Opcionalmente, a redefinição é ignorada quando Microsoft Defender for Endpoint classifica o dispositivo com risco médio ou elevado. ### Redefinir o código de acesso apenas se o dispositivo não estiver em risco Quando *Redefinir o código de acesso apenas se o dispositivo não estiver em risco* (`skipIfAtRisk`) estiver ativado, o runbook verifica a pontuação de risco do dispositivo em Microsoft Defender for Endpoint antes de o dispositivo Intune ser pesquisado e a redefinição ser acionada. A pesquisa usa o ID do dispositivo Entra e é a mesma consulta que o **Verificar estado do Defender** runbook executa. A verificação está desativada por predefinição. Possíveis resultados: * **Sem risco elevado** (pontuação de risco `Nenhum`, `Informativo` ou `Baixo`): o código de acesso é redefinido como habitualmente. * **Pontuação de risco `Médio` ou `Elevado`**: o runbook interrompe-se com um aviso antes de qualquer coisa ser alterada. Um dispositivo com uma pontuação de risco elevada pode estar envolvido num incidente de segurança; redefinir o respetivo código de acesso pode conceder acesso ao dispositivo ou interferir com a investigação. Alinhe primeiro com a sua equipa de segurança; para redefinir o código de acesso na mesma, execute o runbook com a opção desativada. * **Dispositivo não encontrado no Microsoft Defender for Endpoint**: a pontuação de risco não pode ser determinada. O runbook regista isso e prossegue com a redefinição. Os dispositivos móveis só aparecem em Defender for Endpoint quando a aplicação Defender está implementada e integrada neles, pelo que os dispositivos sem Defender não são bloqueados pela verificação. * **Dispositivo encontrado, mas sem pontuação de risco** (por exemplo, recém-integrado): o runbook regista isso e prossegue também. * **A consulta ao Defender falha**: o runbook interrompe-se sem redefinir o código de acesso, pelo que um problema temporário da API nunca contorna a proteção. #### Ativar a verificação por predefinição Para impor a verificação em todos os pedidos, pré-defina o parâmetro e oculte-o, para que não possa ser desativado a partir do portal. A configuração JSON para isto é a seguinte: ```json "rjgit-device_security_reset-mobile-device-pin": { "parameters": { "skipIfAtRisk": { "Default": true, "Hide": true } } } ``` ### Localização Dispositivo → Segurança → Redefinir PIN do dispositivo móvel **Nome completo do Runbook** rjgit-device\_security\_reset-mobile-device-pin ### Detalhes | Propriedade | Valor | | ------------------- | ----------------------------------- | | Versão | 1.1.0 | | Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10) | | Agendável | não | ### Permissões #### Permissões da aplicação * **Tipo**: Microsoft Graph * DeviceManagementManagedDevices.Read.All * *Procura o dispositivo Intune para verificar o respetivo tipo de propriedade antes da redefinição* * DeviceManagementManagedDevices.PrivilegedOperations.All * *Executa a ação privilegiada resetPasscode no dispositivo* * **Tipo**: WindowsDefenderATP * Machine.Read.All *(opcional — funcionalidade: verificação de risco do Defender)* * *Lê a pontuação de risco do dispositivo em Defender na verificação prévia skipIfAtRisk* ### Parâmetros #### ID do dispositivo ID do dispositivo Entra ID do dispositivo no qual o runbook atua. Definido pelo portal a partir do dispositivo selecionado. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | verdadeiro | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### skipIfAtRisk Ignora a redefinição quando Microsoft Defender for Endpoint classifica o dispositivo com risco médio ou elevado, para que uma redefinição não possa abrir um dispositivo que esteja sob investigação. Os dispositivos desconhecidos do Defender não são bloqueados. | Propriedade | Valor | | -------------------------- | ------------------------------------------------------- | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Nome de exibição do portal | Redefinir apenas se o dispositivo não estiver em risco? | **Opções do portal** | Opção do portal | Valor | | ----------------------------------------------------------------------------- | ---------- | | Redefinir apenas se a pontuação de risco do Defender não for média ou elevada | verdadeiro | | Redefinir independentemente da pontuação de risco do Defender | falso | [Voltar à visão geral da referência do Runbook](/pt/automatizacao/runbooks/runbook-references.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-references/device/security/reset-mobile-device-pin.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.