New-EntraBetaAdministrativeUnitMember

Sintaxe

Default (Predefinição)

New-EntraBetaAdministrativeUnitMember

    -AdministrativeUnitId <String>
    [-GroupTypes <System.Collections.Generic.List`1[System.String]>]
    [-AssignedLabels <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AssignedLabel]>]
    [-OdataType <String>]
    [-Description <String>]
    -SecurityEnabled <Boolean>
    [-IsAssignableToRole <Boolean>]
    [-ProxyAddresses <System.Collections.Generic.List`1[System.String]>]
    -DisplayName <String>
    [-Visibility <String>]
    -MailEnabled <Boolean>
    -MailNickname <String>
    [-MembershipRule <String>]
    [-MembershipRuleProcessingState <String>]
    [<CommonParameters>]

Descrição

Exemplos

Exemplo 1: Criar um grupo dinâmico numa unidade administrativa

Connect-Entra -Scopes 'AdministrativeUnit.ReadWrite.All'
$params = @{
    AdministrativeUnitId = 'bbbbbbbb-1111-2222-3333-cccccccccccc'
    OdataType = 'Microsoft.Graph.Group'
    DisplayName = 'NewAUMember'
    Description = 'createdUnitMember'
    MailEnabled = $True
    MailNickname = 'new'
    SecurityEnabled = $False
    GroupTypes = @('Unified', 'DynamicMembership')
    MembershipRule = "(user.department -contains 'Marketing')"
    MembershipRuleProcessingState = 'On'
    IsAssignableToRole = $false
    Visibility = 'Public'
    ProxyAddresses = @('SMTP:Ahiresh@M365x99297270.onmicrosoft.com')
}
New-EntraBetaAdministrativeUnitMember @params

Id                                   DeletedDateTime
--                                   ---------------
dddddddd-2222-2222-3333-cccccccccccc

Parâmetros

-AdministrativeUnitId

Especifica o AdministrativeUnitId de uma unidade administrativa do Microsoft Entra ID.

Propriedades dos parâmetros

Conjuntos de parâmetros

-AssignedLabels

Este parâmetro permite a atribuição de etiquetas de sensibilidade a grupos. Para mais informações sobre como os rótulos de sensibilidade podem ser atribuídos a grupos, consulte Atribuir rótulos de sensibilidade

Propriedades dos parâmetros

Conjuntos de parâmetros

-Description

Especifica uma descrição para o grupo.

Propriedades dos parâmetros

Conjuntos de parâmetros

-DisplayName

Especifica um nome de exibição para o grupo.

Propriedades dos parâmetros

Conjuntos de parâmetros

-GroupTypes

Especifica que o grupo é um grupo dinâmico. Para criar um grupo dinâmico, especifique um valor de DynamicMembership.

Propriedades dos parâmetros

Conjuntos de parâmetros

-IsAssignableToRole

A bandeira indica se o grupo pode ser atribuído a uma função. Esta propriedade só pode ser definida no momento da criação do grupo e não pode ser modificada num grupo existente.

Propriedades dos parâmetros

Conjuntos de parâmetros

-MailEnabled

Especifica se este grupo está habilitado para e-mail.

Atualmente, não pode criar grupos com email no Microsoft Entra ID.

Propriedades dos parâmetros

Conjuntos de parâmetros

-MailNickname

Especifica um apelido de correio para o grupo. Se o MailEnabled for $False, deve ainda assim especificar um apelido de correio.

Propriedades dos parâmetros

Conjuntos de parâmetros

-MembershipRule

Especifica a regra de pertença para um grupo dinâmico.

Para mais informações sobre as regras que pode usar para grupos dinâmicos, Usar atributos para criar regras avançadas

Propriedades dos parâmetros

Conjuntos de parâmetros

-MembershipRuleProcessingState

Especifica o estado de processamento das regras. Os valores aceitáveis para este parâmetro são:

• "Ligado". Processa a regra do grupo.
• "Pausado". Parem de processar a regra do grupo.

Alterar o valor do estado de processamento não altera a lista de membros do grupo.

Propriedades dos parâmetros

Conjuntos de parâmetros

-OdataType

Especifica o tipo de odata do objeto a criar na unidade administrativa.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ProxyAddresses

Define o atributo proxy Addresses.

Propriedades dos parâmetros

Conjuntos de parâmetros

-SecurityEnabled

Especifica se o grupo está habilitado para segurança. Para grupos de segurança, este valor deve ser $True.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Visibility

Este parâmetro determina a visibilidade do conteúdo do grupo e da lista de membros. Este parâmetro pode assumir um dos seguintes valores:

• "Público" - Qualquer pessoa pode ver o conteúdo do grupo
• "Privado" - Só os membros podem ver o conteúdo do grupo
• "HiddenMembership" - Só os membros podem ver o conteúdo do grupo e apenas membros, proprietários, Administradores Globais/Empresariais, Administradores de Utilizadores e Administradores de Helpdesk podem consultar a lista de membros do grupo.

Se não for fornecido valor, o valor padrão será "Público".

Notes:

• Este parâmetro só é válido para grupos que tenham o groupType definido como "Unified".
• Se um grupo tiver este atributo definido como "HiddenMembership", não pode ser alterado mais tarde.
• Qualquer pessoa pode juntar-se a um grupo que tenha este atributo definido como "Público". Se o atributo estiver definido como Privado ou HiddenMembership, apenas os proprietários podem adicionar novos membros ao grupo e os pedidos para entrar no grupo precisam de aprovação do(s) proprietário(s).

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

None

Saídas

System.Object

Ligações Relacionadas

• Add-EntraBetaAdministrativeUnitMember
• Get-EntraBetaAdministrativeUnitMember
• Remove-EntraBetaAdministrativeUnitMember