Set-EntraGroupLifecyclePolicy
Atualiza uma Política específica do Ciclo de Vida do grupo no Microsoft Entra ID.
Sintaxe
Default (Predefinição)
Set-EntraGroupLifecyclePolicy
-GroupLifecyclePolicyId <String>
[-AlternateNotificationEmails <String>]
[-GroupLifetimeInDays <Int32>]
[-ManagedGroupTypes <String>]
[<CommonParameters>]
Descrição
O Set-EntraGroupLifecyclePolicy comando atualiza uma Política específica de Ciclo de Vida de grupo no Microsoft Entra ID.
Exemplos
Exemplo 1: Atualiza a política do 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 no Microsoft Entra ID.
-
-GroupLifecyclePolicyIdo parâmetro especifica o ID da Política do Ciclo de Vida a ser modificada. -
-GroupLifetimeInDaysespecifica a vida útil dos grupos na política até 200 dias. O GroupLifetimeInDays representa o número de dias antes de um grupo expirar e precisar de ser renovado. Uma vez renovada, a expiração do grupo é prolongada pelo número de dias definido. -
-AlternateNotificationEmailsParameter especifica o endereço de email que recebe notificações sobre a política. Múltiplos endereços de email podem ser definidos separando endereços de email com um ponto e vírgula. -
-ManagedGroupTypesO parâmetro especifica a que grupo da Microsoft 365 se aplica a política. Os valores possíveis sãoAll,Selected, ouNone. Neste caso, 'Todos' sugere que a política gere todos os tipos de grupos.
Parâmetros
-AlternateNotificationEmails
Emails de notificação para grupos sem proprietários são enviados para estes endereços de email. Lista de endereços de email separados por um ";".
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-GroupLifecyclePolicyId
Especifica o ID de um objeto groupLifecyclePolicies no Microsoft Entra ID.
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Id |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-GroupLifetimeInDays
O número de dias que um grupo pode existir antes de precisar de ser renovado.
Propriedades dos parâmetros
| Tipo: | System.Int32 |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ManagedGroupTypes
Permite ao administrador selecionar a que grupo da Microsoft 365 se aplica a política.
- "Nenhuma" criará a apólice num estado com deficiência.
- "Todos" aplicará a política a todos os grupos Microsoft 365 no tenant.
- "Selecionado" permitirá ao administrador escolher grupos específicos do Microsoft 365 a que a política se aplica.
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.