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

このコマンドレットを使用すると、管理者は PolicyId によってMicrosoft Entra IDの名前付き場所ポリシーを更新できます。

条件付きアクセス ポリシーは、アクセス シナリオを定義するカスタム ルールです。

職場または学校アカウントを使用する委任されたシナリオでは、別のユーザーを操作する場合、サインインしているユーザーは、サポートされているMicrosoft Entraロールまたは必要なアクセス許可を持つカスタム ロールを持っている必要があります。 サポートされるロールは次のとおりです。

• セキュリティ管理者
• 条件付きアクセス管理者

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

この例では、PolicyId によってMicrosoft Entra IDの IP 名前付き場所ポリシーを更新する方法を示します。

• -PolicyId パラメーターは、名前付き場所ポリシーの ID を指定します。
• -OdataType パラメーターは、名前付き場所ポリシーの odata 型を指定します。
• -DisplayName パラメーターは、名前付き場所ポリシーの表示名を指定します。
• -IsTrusted パラメーターは、名前付き場所ポリシーの IsTrusted 値を指定します。
• -IpRanges パラメーターは、IPv4 CIDR 形式 (1.2.3.4/32 など) または IETF RFC596 で指定されている任意の有効な IPv6 形式の IP アドレス範囲のリストを指定します。

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

このコマンドは、PolicyId でMicrosoft Entra IDの国名付き場所ポリシーを更新します。

• -PolicyId パラメーターは、名前付き場所ポリシーの ID を指定します。
• -OdataType パラメーターは、名前付き場所ポリシーの odata 型を指定します。
• -IncludeUnknownCountriesAndRegions パラメーターは、名前付き場所ポリシーの includeUnknownCountriesAndRegions 値を指定します。

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'

このコマンドは、PolicyId によってMicrosoft Entra IDの名前付き場所ポリシーの表示名を更新します。

• -PolicyId パラメーターは、名前付き場所ポリシーの ID を指定します。
• -OdataType パラメーターは、名前付き場所ポリシーの odata 型を指定します。
• -DisplayName パラメーターは、名前付き場所ポリシーの表示名を指定します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。