Set-EntraAdministrativeUnit
構文
Default (既定)
Set-EntraAdministrativeUnit
-AdministrativeUnitId <String>
[-Description <String>]
[-DisplayName <String>]
[-MembershipType <String>]
[-MembershipRule <String>]
[-MembershipRuleProcessingState <String>]
[-Visibility <String>]
[<CommonParameters>]
説明
Set-EntraAdministrativeUnit コマンドレットは、Microsoft Entra IDの管理単位のプロパティを更新します。 特定 AdministrativeUnitId 管理単位を更新するパラメーターを指定します。
委任されたシナリオでは、サインインしているユーザーに、サポートされているMicrosoft Entra ロールまたはmicrosoft.directory/administrativeUnits/allProperties/allTasksアクセス許可を持つカスタム ロールを割り当てる必要があります。
この操作では、次の最小特権ロールがサポートされています。
例
例 1: DisplayName と説明を更新する
Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$administrativeUnit = Get-EntraAdministrativeUnit -Filter "DisplayName eq 'Pacific Administrative Unit'"
Set-EntraAdministrativeUnit -AdministrativeUnitId $administrativeUnit.Id -DisplayName 'Pacific Admin Unit' -Description 'Pacific Admin Unit Description' -MembershipType 'Assigned'
このコマンドは、特定の管理単位の DisplayName を更新します。
-
-AdministrativeUnitId パラメーターは、管理単位の ID を指定します。
-
-DisplayName パラメーターは、管理単位の表示名を指定します。
-
-Description パラメーターは、管理単位の説明を指定します。
パラメーター
-AdministrativeUnitId
Microsoft Entra IDの管理単位の ID を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | オブジェクト識別子 |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Description
管理単位の説明を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DisplayName
管理単位の表示名を指定します。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MembershipRule
管理単位に適用される動的メンバーシップ規則を指定します。 使用可能な値は、 dynamic、 assignedです。 設定しない場合、既定値は null され、既定の動作は assigned。 このパラメーターはオプションです。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MembershipRuleProcessingState
動的メンバーシップ ルールがアクティブかどうかを制御します。
Onに設定して有効にするか、更新プログラムを停止Paused。 このパラメーターはオプションです。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MembershipType
管理単位のメンバーシップの種類を指定します。 使用可能な値は、 dynamic と assignedです。 設定しない場合、既定値は nullされ、メンバーシップの種類は既定で assigned になります。 このパラメーターはオプションです。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Visibility
管理単位の可視性を指定します。 設定されていない場合、既定値は public です。 メンバー以外のメンバーからメンバーシップを非表示にするには、 HiddenMembership に設定します。 このパラメーターはオプションです。
パラメーターのプロパティ
| 型: | System.String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。