New-AzADGroup

Modul:

Az.Resources

Lägger till en ny entitet i grupper

Syntax

New-AzADGroup
   -DisplayName <String>
   -MailNickname <String>
   [-AcceptedSender <IMicrosoftGraphDirectoryObject[]>]
   [-AdditionalProperties <Hashtable>]
   [-AppRoleAssignment <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>]
   [-Classification <String>]
   [-CreatedOnBehalfOf <IMicrosoftGraphDirectoryObject>]
   [-DeletedDateTime <DateTime>]
   [-Description <String>]
   [-GroupType <String[]>]
   [-HasMembersWithLicenseError]
   [-IsArchived]
   [-IsAssignableToRole]
   [-MailEnabled]
   [-MembershipRule <String>]
   [-MembershipRuleProcessingState <String>]
   [-PermissionGrant <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
   [-PreferredDataLocation <String>]
   [-PreferredLanguage <String>]
   [-SecurityEnabled]
   [-SecurityIdentifier <String>]
   [-Theme <String>]
   [-TransitiveMember <IMicrosoftGraphDirectoryObject[]>]
   [-TransitiveMemberOf <IMicrosoftGraphDirectoryObject[]>]
   [-Visibility <String>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Lägger till en ny entitet i grupper

Exempel

Exempel 1: Skapa grupp

New-AzADGroup -DisplayName $gname -MailNickname $nickname

Skapa grupp

Parametrar

-AcceptedSender

Listan över användare eller grupper som tillåts skapa händelser för inlägg eller kalender i den här gruppen. Om den här listan inte är tom får endast användare eller grupper som anges här publicera. Mer information finns i AVSNITTET ANTECKNINGAR för ACCEPTEDSENDER-egenskaper och skapa en hash-tabell.

Typ:	IMicrosoftGraphDirectoryObject[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-AdditionalProperties

Ytterligare parametrar

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-AppRoleAssignment

Representerar de approller som en grupp har beviljats för ett program. Stöder $expand. Mer information finns i AVSNITTET ANTECKNINGAR för APPROLEASSIGNMENT-egenskaper och skapa en hash-tabell.

Typ:	IMicrosoftGraphAppRoleAssignmentAutoGenerated[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Classification

Beskriver en klassificering för gruppen (till exempel låg, medelhög eller hög affärspåverkan). Giltiga värden för den här egenskapen definieras genom att du skapar ett inställningsvärde för ClassificationList baserat på malldefinitionen. Returneras som standard. Stöder $filter (eq, ne, NOT, ge, le, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CreatedOnBehalfOf

Representerar ett Azure Active Directory-objekt. Typen directoryObject är bastypen för många andra katalogentitetstyper. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för CREATEONBEHALFOF-egenskaper och skapa en hash-tabell.

Typ:	IMicrosoftGraphDirectoryObject
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	PSObject
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DeletedDateTime

.

Typ:	DateTime
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Description

En valfri beskrivning för gruppen. Returneras som standard. Stöder $filter (eq, ne, NOT, ge, le, startsWith) och $search.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DisplayName

Visningsnamnet för gruppen. Den här egenskapen krävs när en grupp skapas och kan inte rensas under uppdateringar. Returneras som standard. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith), $search och $orderBy.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-GroupType

Anger grupptypen och dess medlemskap. Om samlingen innehåller Unified är gruppen en Microsoft 365-grupp. Annars är det antingen en säkerhetsgrupp eller distributionsgrupp. Mer information finns i översikten över grupper. Om samlingen innehåller DynamicMembership har gruppen dynamiskt medlemskap. annars är medlemskap statiskt. Returneras som standard. Stöder $filter (eq, NOT).

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-HasMembersWithLicenseError

Anger om det finns medlemmar i den här gruppen som har licensfel från sin gruppbaserade licenstilldelning. Den här egenskapen returneras aldrig för en GET-åtgärd. Du kan använda det som ett $filter argument för att hämta grupper som har medlemmar med licensfel (d.s. filtrera efter att den här egenskapen är sann). Stöder $filter (eq).

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-IsArchived

.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-IsAssignableToRole

Anger om den här gruppen kan tilldelas till en Azure Active Directory-roll. Den här egenskapen kan bara anges när du skapar gruppen och är oföränderlig. Om värdet är true måste egenskapen securityEnabled också anges till true och gruppen kan inte vara en dynamisk grupp (det vill: groupTypes får inte innehålla DynamicMembership). Endast anropare i rollen Global administratör och Privilegierad rolladministratör kan ange den här egenskapen. Anroparen måste också tilldelas behörigheten Directory.AccessAsUser.All för att kunna ange den här egenskapen. Mer information finns i Använda en grupp för att hantera Azure AD-rolltilldelningarÅtervänd som standard. Stöder $filter (eq, ne, NOT).

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MailEnabled

Anger om gruppen är e-postaktiverad. Returneras som standard. Stöder $filter (eq, ne, NOT).

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MailNickname

E-postaliaset för gruppen, unikt i organisationen. Den här egenskapen måste anges när en grupp skapas. Dessa tecken kan inte användas i mailNickName: @()/[]';:.<>,SPACE. Returneras som standard. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MembershipRule

Regeln som avgör medlemmar för den här gruppen om gruppen är en dynamisk grupp (groupTypes innehåller DynamicMembership). Mer information om syntaxen för medlemskapsregeln finns i Syntax för medlemskapsregler. Returneras som standard. Stöder $filter (eq, ne, NOT, ge, le, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MembershipRuleProcessingState

Anger om den dynamiska medlemskapsbearbetningen är aktiverad eller pausad. Möjliga värden är På eller Pausade. Returneras som standard. Stöder $filter (eq, ne, NOT, in).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PermissionGrant

De behörigheter som har beviljats för en grupp till ett visst program. Stöder $expand. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för PERMISSIONGRANT-egenskaper och skapa en hash-tabell.

Typ:	IMicrosoftGraphResourceSpecificPermissionGrant[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PreferredDataLocation

Önskad dataplats för gruppen. Mer information finns i OneDrive Online Multi-Geo. Returneras som standard.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PreferredLanguage

Det föredragna språket för en Microsoft 365-grupp. Bör följa ISO 639-1 Code; till exempel "en-US". Returneras som standard. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SecurityEnabled

Anger om gruppen är en säkerhetsgrupp. Returneras som standard. Stöder $filter (eq, ne, NOT, in).

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SecurityIdentifier

Säkerhetsidentifierare för gruppen som används i Windows-scenarier. Returneras som standard.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Theme

Anger en Microsoft 365-grupps färgtema. Möjliga värden är kricka, lila, grön, blå, rosa, orange eller röd. Returneras som standard.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-TransitiveMember

. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för TRANSITIVEMEMBER-egenskaper och skapa en hash-tabell.

Typ:	IMicrosoftGraphDirectoryObject[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-TransitiveMemberOf

. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för TRANSITIVEMEMBEROF-egenskaper och skapa en hash-tabell.

Typ:	IMicrosoftGraphDirectoryObject[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Visibility

Anger gruppkopplingsprincipen och synligheten för gruppinnehåll för grupper. Möjliga värden är: Privat, Offentlig eller Hiddenmembership. Hiddenmembership kan endast anges för Microsoft 365-grupper när grupperna skapas. Det kan inte uppdateras senare. Andra synlighetsvärden kan uppdateras när gruppen har skapats. Om synlighetsvärdet inte anges när gruppen skapas i Microsoft Graph skapas en säkerhetsgrupp som privat som standard och Microsoft 365-gruppen är offentlig. Mer information finns i alternativ för gruppsynlighet. Returneras som standard.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Utdata

IMicrosoftGraphGroup