Compartilhar via

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 AD (Azure Active Directory).

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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisplayName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-GroupTypes

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

Observações:

  • Atualmente, esse parâmetro não pode ser usado para criar grupos dinâmicos. Para criar um grupo dinâmico no PowerShell, você deve usar o módulo visualização do Azure AD.
Tipo:List<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IsAssignableToRole

Indica se o grupo pode ser atribuído a uma função. Essa propriedade só pode ser definida no momento da criação do grupo e não pode ser modificada em um grupo existente.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MailEnabled

Indica se esse grupo está habilitado para email.

Atualmente, você não pode criar grupos habilitados para email no Azure AD.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MailNickname

Especifica um apelido de email para o grupo. Se MailEnabled for $False você ainda deverá especificar um apelido de email.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecurityEnabled

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

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Visibility

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

  • "Público" – Qualquer pessoa pode exibir o conteúdo do grupo
  • "Privado" – somente os membros podem exibir o conteúdo do grupo
  • "HiddenMembership" – somente os membros podem exibir o conteúdo do grupo e somente membros, proprietários, Administrador Global/Da Empresa, Administrador de Usuários e Administradores de Assistência Técnica podem exibir a lista de membros do grupo.

Se nenhum valor for fornecido, o valor padrão será "Public".

Observações:

  • Esse parâmetro só é válido para grupos que têm o groupType definido como "Unificado".
  • Se um grupo tiver esse atributo definido como "HiddenMembership", ele não poderá ser alterado posteriormente.
  • Qualquer pessoa pode ingressar em um grupo que tenha esse atributo definido como "Público". Se o atributo estiver definido como Private ou HiddenMembership, somente proprietários poderão adicionar novos membros ao grupo e as solicitações para ingressar no grupo precisarão de aprovação dos proprietários.
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

Object

Observações

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

Este cmdlet está atualmente em Visualização Pública. Enquanto um cmdlet está em Visualização Pública, podemos fazer alterações no cmdlet que podem ter efeitos inesperados. Recomendamos que você não use esse cmdlet em um ambiente de produção.