Set-EntraGroupLifecyclePolicy
Atualiza uma Política de Ciclo de Vida de grupo específica em Microsoft Entra ID.
Sintaxe
Default (Default)
Set-EntraGroupLifecyclePolicy
-GroupLifecyclePolicyId <String>
[-AlternateNotificationEmails <String>]
[-GroupLifetimeInDays <Int32>]
[-ManagedGroupTypes <String>]
[<CommonParameters>]
Description
O Set-EntraGroupLifecyclePolicy comando atualiza uma Política de Ciclo de Vida de grupo específica no Microsoft Entra ID.
Exemplos
Exemplo 1: atualiza a política de ciclo de vida do grupo
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
Este exemplo atualiza o groupLifecyclePolicy especificado em Microsoft Entra ID.
-
-GroupLifecyclePolicyIdO parâmetro especifica a ID da Política de Ciclo de Vida a ser modificada. -
-GroupLifetimeInDaysO parâmetro especifica o tempo de vida dos grupos na política para 200 dias. O GroupLifetimeInDays representa o número de dias antes que um grupo expire e precise ser renovado. Depois de renovada, a expiração do grupo é estendida pelo número de dias definido. -
-AlternateNotificationEmailsO parâmetro especifica o endereço de email que recebe notificações sobre a política. Vários endereços de email podem ser definidos separando o endereço de email com um ponto e vírgula. -
-ManagedGroupTypeso parâmetro especifica a qual Microsoft 365 agrupa a política. Os valores possíveis sãoAll,Selected, ouNone. Nesse caso, 'All' sugere que a política gerencie todos os tipos de grupos.
Parâmetros
-AlternateNotificationEmails
Os e-mails de notificação para grupos que não têm proprietários são enviados para estes endereços de e-mail. Lista de endereços de email separados por um ";".
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GroupLifecyclePolicyId
Especifica a ID de um objeto groupLifecyclePolicies no Microsoft Entra ID.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | ID |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-GroupLifetimeInDays
O número de dias em que um grupo pode existir antes de ser renovado.
Propriedades do parâmetro
| Tipo: | System.Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ManagedGroupTypes
Permite que o administrador selecione a quais grupos de Microsoft 365 a política se aplica.
- "Nenhum" criará a política em um estado desabilitado.
- "Todos" aplicará a política a cada grupo de Microsoft 365 no locatário.
- "Selecionado" permitirá que o administrador escolha grupos Microsoft 365 específicos aos quais a política se aplica.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.