Set-EntraNamedLocationPolicy

Set-EntraNamedLocationPolicy

    -PolicyId <String>
    [-OdataType <String>]
    [-IpRanges <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.IpRange]>]
    [-IncludeUnknownCountriesAndRegions <Boolean>]
    [-IsTrusted <Boolean>]
    [-DisplayName <String>]
    [-Id <String>]
    [-CountriesAndRegions <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.CountriesAndRegion]>]
    [<CommonParameters>]

Este cmdlet permite que um administrador atualize uma política de localização nomeada no Microsoft Entra ID através do PolicyId.

As políticas de acesso condicional são regras personalizadas que definem um cenário de acesso.

Em cenários delegados com contas de trabalho ou escola, ao atuar sobre outro utilizador, o utilizador iniciado deve ter um papel Microsoft Entra suportado ou um papel personalizado com as permissões necessárias. As funções suportadas incluem:

• Administrador de Segurança
• Administrador de Acesso Condicional

Connect-Entra -Scopes 'Policy.ReadWrite.ConditionalAccess'
$policy = Get-EntraNamedLocationPolicy | Where-Object { "$_.DisplayName -eq 'IP named location policy'" }
$ipRanges = New-Object -TypeName Microsoft.Open.MSGraph.Model.IpRange
$ipRanges.cidrAddress = '6.5.4.3/32'
$type = '#microsoft.graph.ipNamedLocation'
Set-EntraNamedLocationPolicy -PolicyId $policy.Id -OdataType $type -IsTrusted $false -IncludeUnknownCountriesAndRegions $false -IpRanges $ipRanges

Este exemplo mostra como atualizar uma política de localização com nome IP no Microsoft Entra ID pelo PolicyId.

• -PolicyId o parâmetro especifica o Id de uma política de localização nomeada.
• -OdataType O parâmetro especifica o tipo de odata de uma política de localização nomeada.
• -DisplayName O parâmetro especifica o nome de exibição de uma política de localização nomeada.
• -IsTrusted o parâmetro especifica o valor IsTrusted para a política de localização nomeada.
• -IpRanges O parâmetro especifica Lista de intervalos de endereços IP no formato IPv4 CIDR (por exemplo, 1.2.3.4/32) ou em qualquer formato IPv6 válido conforme especificado no IETF RFC596.

Connect-Entra -Scopes 'Policy.ReadWrite.ConditionalAccess'
$policy = Get-EntraNamedLocationPolicy | Where-Object { "$_.DisplayName -eq 'IP named location policy'" }
$type = '#microsoft.graph.countryNamedLocation'
Set-EntraNamedLocationPolicy -PolicyId $policy.Id -OdataType $type -IncludeUnknownCountriesAndRegions $true

Este comando atualiza uma política de localização nomeada por país no Microsoft Entra ID pelo PolicyId.

• -PolicyId o parâmetro especifica o Id de uma política de localização nomeada.
• -OdataType O parâmetro especifica o tipo de odata de uma política de localização nomeada.
• -IncludeUnknownCountriesAndRegions o parâmetro especifica o valor includeUnknownCountriesAndRegions para a política de localização nomeada.

Connect-Entra -Scopes 'Policy.ReadWrite.ConditionalAccess'
$policy = Get-EntraNamedLocationPolicy | Where-Object { "$_.DisplayName -eq 'IP named location policy'" }
$type = '#microsoft.graph.ipNamedLocation'
Set-EntraNamedLocationPolicy -PolicyId $policy.Id -OdataType $type -DisplayName 'NewName'

Este comando atualiza o nome de exibição da política de localização nomeada no Microsoft Entra ID pelo PolicyId.

• -PolicyId o parâmetro especifica o Id de uma política de localização nomeada.
• -OdataType O parâmetro especifica o tipo de odata de uma política de localização nomeada.
• -DisplayName O parâmetro especifica o nome de exibição de uma política de localização nomeada.

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, consulte about_CommonParameters.