Set-EntraGroupLifecyclePolicy

Uppdaterar en specifik grupprincip för livscykel i Microsoft Entra ID.

Syntax

Default (Standard)

Set-EntraGroupLifecyclePolicy

    -GroupLifecyclePolicyId <String>
    [-AlternateNotificationEmails <String>]
    [-GroupLifetimeInDays <Int32>]
    [-ManagedGroupTypes <String>]
    [<CommonParameters>]

Description

Kommandot Set-EntraGroupLifecyclePolicy uppdaterar en specifik grupprincip för livscykel i Microsoft Entra ID.

Exempel

Exempel 1: Uppdaterar policyn för grupplivscykel

Connect-Entra -Scopes 'Directory.ReadWrite.All'
$policy = Get-EntraGroupLifecyclePolicy | Where-Object {$_.AlternateNotificationEmails -eq 'example@contoso.com'}
Set-EntraGroupLifecyclePolicy -GroupLifecyclePolicyId $policy.Id -GroupLifetimeInDays 200 -AlternateNotificationEmails 'example@contoso.com' -ManagedGroupTypes 'All'
Id                                   AlternateNotificationEmails GroupLifetimeInDays ManagedGroupTypes
--                                   --------------------------- ------------------- -----------------
ffffffff-5555-6666-7777-aaaaaaaaaaaa example@contoso.com                     200                 All

I det här exemplet uppdateras den angivna groupLifecyclePolicy i Microsoft Entra ID.

  • -GroupLifecyclePolicyId parameter anger ID för livscykelpolicyn som ska ändras.
  • -GroupLifetimeInDays parametern anger livslängden för grupperna i principen till 200 dagar. GroupLifetimeInDays representerar antalet dagar innan en grupp upphör att gälla och måste förnyas. När den har förnyats utökas gruppens giltighetstid med det antal dagar som definierats.
  • -AlternateNotificationEmails parameter anger den e-postadress som tar emot meddelanden om principen. Flera e-postadresser kan definieras genom att separera e-postadressen med semikolon.
  • -ManagedGroupTypesparameter anger vilka Microsoft 365 grupper som principen gäller för. Möjliga värden är All, Selectedeller None. I det här fallet föreslår "Alla" att principen hanterar alla typer av grupper.

Parametrar

-AlternateNotificationEmails

E-postaviseringar för grupper som inte har några ägare skickas till dessa e-postadresser. Lista över e-postadresser avgränsade med ";".

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

-GroupLifecyclePolicyId

Anger ID för ett groupLifecyclePolicies-objekt i Microsoft Entra ID.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias: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

-GroupLifetimeInDays

Antalet dagar en grupp kan finnas innan den behöver förnyas.

Parameteregenskaper

Typ:System.Int32
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

-ManagedGroupTypes

Tillåter administratören att välja vilka Microsoft 365 grupper som principen gäller för.

  • "Ingen" skapar principen i inaktiverat tillstånd.
  • "Alla" tillämpar principen på varje Microsoft 365 grupp i klientorganisationen.
  • Med "Selected" kan administratören välja specifika Microsoft 365 grupper som principen gäller för.

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.

Indata

System.String

Utdata

System.Object