New-AzureADMSGroup

  • Referência
Módulo:
AzureAD

Cria um grupo de Azure AD.

Syntax

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 Azure AD Preview.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailEnabled

Indica se esse grupo está habilitado para email.

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

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MailNickname

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SecurityEnabled

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

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.