New-AzureADMSGroup

  • Referência
Módulo:
AzureAD

Cria um grupo do Azure AD.

Sintaxe

New-AzureADMSGroup
   [-Description <String>]
   -DisplayName <String>
   [-IsAssignableToRole <Boolean>]
   -MailEnabled <Boolean>
   -MailNickname <String>
   -SecurityEnabled <Boolean>
   [-GroupTypes <System.Collections.Generic.List`1[System.String]>]
   [-Visibility <String>]
   [<CommonParameters>]

Description

O cmdlet New-AzureADMSGroup cria um grupo do Azure Active Directory (Azure AD).

Exemplos

Exemplo: Criar um grupo atribuível à função

PS C:\> New-AzureADMSGroup -DisplayName "HelpDesk admin group" -Description "Group assignable to role" -MailEnabled $False -MailNickname "helpDeskAdminGroup" -SecurityEnabled $True -IsAssignableToRole $True -Visibility "Private"

Id                            : 1026185e-25df-4522-a380-7ab697a7241c
Description                   : Group assignable to role
OnPremisesSyncEnabled         : 
DisplayName                   : HelpDesk admin group
Mail                          : 
MailEnabled                   : False
IsAssignableToRole            : True 
MailNickname                  : helpDeskAdminGroup
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {}

Parâmetros

-Description

Especifica uma descrição para o grupo.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisplayName

Especifica um nome a apresentar para o grupo.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-GroupTypes

Especifica que o grupo é um grupo unificado ou dinâmico.

Notas:

  • Atualmente, este parâmetro não pode ser utilizado para criar grupos dinâmicos. Para criar um grupo dinâmico no PowerShell, tem de utilizar o módulo de Pré-visualização do Azure AD.
Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IsAssignableToRole

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.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MailEnabled

Indica se este grupo está ativado por correio.

Atualmente, não pode criar grupos com capacidade de correio no Azure AD.

Tipo:Boolean
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MailNickname

Especifica uma alcunha de correio para o grupo. Se MailEnabled for $False ainda tem de especificar uma alcunha de correio.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SecurityEnabled

Indica se o grupo está ativado para segurança. Para grupos de segurança, este valor tem de ser $True.

Tipo:Boolean
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Visibility

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

  • "Público" – qualquer pessoa pode ver os conteúdos do grupo
  • "Privado" – apenas os membros podem ver o conteúdo do grupo
  • "HiddenMembership" – apenas os membros podem ver o conteúdo do grupo e apenas os membros, proprietários, Administrador Global/Empresa, Administrador de Utilizadores e Administradores de Suporte Técnico podem ver a lista de membros do grupo.

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

Notas:

  • Este parâmetro só é válido para grupos que tenham o groupType definido como "Unificado".
  • Se um grupo tiver este atributo definido como "HiddenMembership", não poderá ser alterado mais tarde.
  • Qualquer pessoa pode aderir a um grupo que tenha este atributo definido como "Público". Se o atributo estiver definido como Private ou HiddenMembership, apenas os proprietários podem adicionar novos membros ao grupo e os pedidos para aderir ao grupo precisam da aprovação dos proprietários.
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

Object

Notas

Veja o guia de migração de New-AzureADMSGroup para o Microsoft Graph PowerShell.

Este cmdlet está atualmente em Pré-visualização Pública. Enquanto um cmdlet está em Pré-visualização Pública, podemos fazer alterações ao cmdlet que podem ter efeitos inesperados. Recomendamos que não utilize este cmdlet num ambiente de produção.