Get-EntraNamedLocationPolicy

モジュール:
Microsoft.Entra.SignIns Module v1.3

Microsoft Entra ID名前付き場所ポリシーを取得します。

構文

GetQuery (既定) 

Get-EntraNamedLocationPolicy

    [-Property <String[]>]
    [<CommonParameters>]

GetById 

Get-EntraNamedLocationPolicy

    -PolicyId <String>
    [-Property <String[]>]
    [<CommonParameters>]

説明

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

名前付き場所は、ネットワークの場所を定義するカスタム 規則であり、条件付きアクセス ポリシーで使用できます。

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

  • グローバル セキュリティで保護されたアクセス管理者 (読み取り専用の標準プロパティ)
  • セキュリティ 閲覧者 (読み取り専用の標準プロパティ)
  • セキュリティ管理者 (読み取り専用の標準プロパティ)
  • グローバルリーダー
  • 条件付きアクセス管理者

例

例 1: Microsoft Entra ID内のすべての名前付き場所ポリシーの一覧を取得します

Connect-Entra -Scopes 'Policy.Read.All'
Get-EntraNamedLocationPolicy

Id                                   CreatedDateTime      DisplayName    ModifiedDateTime
--                                   ---------------      -----------    ----------------
dddddddd-3333-4444-5555-eeeeeeeeeeee 31/07/2024 9:53:10   NamedLocation   31/07/2024 9:53:10
eeeeeeee-4444-5555-6666-ffffffffffff 31/07/2024 4:38:42   NamedLocation1  31/07/2024 4:38:42
ffffffff-5555-6666-7777-aaaaaaaaaaaa 01/08/2024 4:39:42   NamedLocation2  01/08/2024 4:39:42
aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb 01/08/2024 4:57:03   NamedLocation3  01/08/2024 4:57:03

このコマンドは、Microsoft Entra ID内のすべての名前付き場所ポリシーの一覧を取得します。

例 2: ID で名前付き場所ポリシーを取得する

Connect-Entra -Scopes 'Policy.Read.All'
$policy = Get-EntraNamedLocationPolicy | Where-Object { $_.DisplayName -eq 'Provisioning Workers' }
Get-EntraNamedLocationPolicy -PolicyId $policy.Id

Id                                   CreatedDateTime      DisplayName    ModifiedDateTime
--                                   ---------------      -----------    ----------------
dddddddd-3333-4444-5555-eeeeeeeeeeee 3/1/2024 9:53:10 AM  NamedLocation  3/1/2024 9:53:10 AM

この例では、Microsoft Entra IDで指定された名前付き場所ポリシーを取得します。

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

パラメーター

-PolicyId

Microsoft Entra IDの名前付き場所ポリシーの ID を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

GetById
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Property

返されるプロパティを指定します。

パラメーターのプロパティ

型:

System.String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Select

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

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