Set-EntraAdministrativeUnit

Modul:
Microsoft.Entra.DirectoryManagement Module v1.3

Uppdaterar egenskaperna för en administrativ enhet.

Syntax

Default (Standard) 

Set-EntraAdministrativeUnit

    -AdministrativeUnitId <String>
    [-Description <String>]
    [-DisplayName <String>]
    [-MembershipType <String>]
    [-MembershipRule <String>]
    [-MembershipRuleProcessingState <String>]
    [-Visibility <String>]
    [<CommonParameters>]

Description

Cmdleten Set-EntraAdministrativeUnit uppdaterar egenskaperna för en administrativ enhet i Microsoft Entra ID. Ange AdministrativeUnitId parametern för att uppdatera en specifik administrativ enhet.

I delegerade scenarier måste den inloggade användaren tilldelas en Microsoft Entra roll som stöds eller en anpassad roll med behörigheten microsoft.directory/administrativeUnits/allProperties/allTasks .

Följande minst privilegierade roller stöds för den här åtgärden:

  • Privilegierad rolladministratör

Exempel

Exempel 1: Uppdatera DisplayName och beskrivning

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'

Det här kommandot uppdaterar DisplayName för en specifik administrativ enhet.

  • -AdministrativeUnitId parameter anger ID för en administrativ enhet.
  • -DisplayName parameter anger visningsnamnet för den administrativa enheten.
  • -Description parametern anger beskrivningen för den administrativa enheten.

Parametrar

-AdministrativeUnitId

Anger ID för en administrativ enhet i Microsoft Entra ID.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Objekt-ID

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Description

Anger en beskrivning för den administrativa enheten.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DisplayName

Anger ett visningsnamn för den administrativa enheten.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MembershipRule

Anger den regel för dynamiskt medlemskap som tillämpas på den administrativa enheten. Möjliga värden är: dynamic, assigned. Om det inte anges är null standardvärdet och standardbeteendet är assigned. Den här parametern är valfri.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MembershipRuleProcessingState

Styr om regeln för dynamiskt medlemskap är aktiv. Ange till On för att aktivera eller Paused stoppa uppdateringar. Den här parametern är valfri.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MembershipType

Anger medlemskapstypen för den administrativa enheten. Möjliga värden är: dynamic och assigned. Om det inte anges är nullstandardvärdet , och medlemskapstypen är assignedsom standard . Den här parametern är valfri.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Visibility

Anger synligheten för den administrativa enheten. Standardvärdet är public om det inte har angetts. Ange till för att HiddenMembership dölja medlemskap från icke-medlemmar. Den här parametern är valfri.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.