New-AzureADMSGroup
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 a apresentar 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.
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 Azure AD Pré-visualização.
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. Esta propriedade só pode ser definida no momento da criação do grupo e não pode ser modificada num grupo existente.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MailEnabled
Indica se este grupo está ativado por correio.
Atualmente, não pode criar grupos com capacidade de correio no Azure AD.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MailNickname
Especifica uma alcunha de correio para o grupo. Se MailEnabled for $False ainda tem de especificar uma alcunha de correio.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecurityEnabled
Indica se o grupo está ativado para segurança. Para grupos de segurança, este valor tem de ser $True.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Visibility
Especifica a visibilidade da lista de conteúdos e membros do grupo. Este parâmetro pode utilizar um dos seguintes valores:
- "Público" – Qualquer pessoa pode ver o conteúdo 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 têm 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Saídas
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á na 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.
Ligações Relacionadas
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários