Set-EntraAdministrativeUnit
語法
Default (預設值)
Set-EntraAdministrativeUnit
-AdministrativeUnitId <String>
[-Description <String>]
[-DisplayName <String>]
[-MembershipType <String>]
[-MembershipRule <String>]
[-MembershipRuleProcessingState <String>]
[-Visibility <String>]
[<CommonParameters>]
Description
指令Set-EntraAdministrativeUnit長會更新 Microsoft Entra ID 中管理單元的屬性。 指定 AdministrativeUnitId 參數以更新特定行政單位。
在委派情境下，登入使用者必須被指派一個支援的 Microsoft Entra 角色或擁有權限microsoft.directory/administrativeUnits/allProperties/allTasks的自訂角色。
以下支援的最低權限角色用於此操作：
範例
範例 1：更新顯示名稱與描述
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'
此指令更新特定行政單位的顯示名稱。
-
-AdministrativeUnitId 參數指定行政單位的識別碼。
-
-DisplayName 參數指定行政單位的顯示名稱。
-
-Description 參數指定行政單位的描述。
參數
-AdministrativeUnitId
指定 Microsoft Entra ID 中管理單元的 ID。
參數屬性
| 類型: | System.String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | ObjectId (物件識別碼) |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Description
規定行政單位的描述。
參數屬性
| 類型: | System.String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DisplayName
指定行政單位的顯示名稱。
參數屬性
| 類型: | System.String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MembershipRule
規定適用於行政單位的動態成員規則。 可能的值為： dynamic， assigned。 若未設定，預設值為 null ，預設行為為 assigned。 這是選擇性參數。
參數屬性
| 類型: | System.String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MembershipRuleProcessingState
控制動態成員規則是否啟動。 設定為 以 On 啟用或 Paused 停止更新。 這是選擇性參數。
參數屬性
| 類型: | System.String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MembershipType
規定行政單位的成員類型。 可能的值有： dynamic 和 assigned。 若未設定，預設值為 null，成員類型預設為 assigned。 這是選擇性參數。
參數屬性
| 類型: | System.String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Visibility
規定行政單位的可見性。 如果未設定，則預設為 public 。 設定為 以 HiddenMembership 隱藏會員身份，不讓非會員看到。 這是選擇性參數。
參數屬性
| 類型: | System.String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。