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>]

Questo cmdlet consente a un amministratore di aggiornare un criterio di posizione denominato in Microsoft Entra ID da PolicyId.

I criteri di accesso condizionale sono regole personalizzate che definiscono uno scenario di accesso.

Negli scenari delegati con account aziendali o dell'istituto di istruzione, quando agiscono su un altro utente, l'utente connesso deve avere un ruolo di Microsoft Entra supportato o un ruolo personalizzato con le autorizzazioni necessarie. I ruoli supportati includono:

• Amministratore della sicurezza
• Amministratore dell'accesso condizionale

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

Questo esempio illustra come aggiornare un criterio di posizione con nome IP in Microsoft Entra ID da PolicyId.

• -PolicyId parametro specifica l'ID di un criterio di posizione denominato.
• -OdataType parametro specifica il tipo odata di un criterio di posizione denominato.
• -DisplayName parametro consente di specificare il nome visualizzato di un criterio di posizione denominato.
• -IsTrusted parametro specifica il valore IsTrusted per i criteri di posizione denominati.
• -IpRanges parametro specifica l'elenco di intervalli di indirizzi IP in formato CIDR IPv4 (ad esempio, 1.2.3.4/32) o qualsiasi formato IPv6 valido come specificato in 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

Questo comando aggiorna un criterio di località denominato paese in Microsoft Entra ID da PolicyId.

• -PolicyId parametro specifica l'ID di un criterio di posizione denominato.
• -OdataType parametro specifica il tipo odata di un criterio di posizione denominato.
• -IncludeUnknownCountriesAndRegions parametro specifica il valore includeUnknownCountriesAndRegions per i criteri di posizione denominati.

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'

Questo comando aggiorna il nome visualizzato dei criteri di posizione denominati in Microsoft Entra ID da PolicyId.

• -PolicyId parametro specifica l'ID di un criterio di posizione denominato.
• -OdataType parametro specifica il tipo odata di un criterio di posizione denominato.
• -DisplayName parametro consente di specificare il nome visualizzato di un criterio di posizione denominato.

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.