Compartilhar via

New-AzureADMSGroup

Módulo:
AzureAD Module

Cria um grupo do Azure AD.

Sintaxe

Default (Padrão) 

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisplayName

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GroupTypes

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

Observações:

  • No momento, 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 de visualização do Azure AD.

Propriedades do parâmetro

Tipo:

List<T>[String]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MailEnabled

Indica se esse grupo está habilitado para email.

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MailNickname

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SecurityEnabled

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Visibility

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

  • "Público" - Qualquer pessoa pode visualizar o conteúdo do grupo
  • "Privado" - Somente membros podem visualizar o conteúdo do grupo
  • "HiddenMembership" - Somente os membros podem exibir o conteúdo do grupo e somente os membros, proprietários, Administrador Global/da Empresa, Administrador de Usuários e Administradores de Suporte Técnico podem exibir a lista de membros do grupo.

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

Observações:

  • Esse parâmetro só é válido para grupos que têm o groupType definido como "Unified".
  • 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 os proprietários poderão adicionar novos membros ao grupo e as solicitações para ingressar no grupo precisarão da aprovação dos proprietários.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Entradas

None

Saídas

Object

Observações

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

Esse 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.