Dela via

New-AzADGroup

  • Referens
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 rolladministratörsrollerna Global administratör och Privileged 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ördes. 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

Kommentarer

ALIAS

EGENSKAPER FÖR KOMPLEXA PARAMETRAR

Skapa parametrarna som beskrivs nedan genom att skapa en hash-tabell som innehåller lämpliga egenskaper. Information om hash-tabeller finns i Get-Help about_Hash_Tables.

ACCEPTEDSENDER <IMicrosoftGraphDirectoryObject[]>: Listan över användare eller grupper som tillåts skapa post- eller kalenderhändelser 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.

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Namnet som visas i katalogen

APPROLEASSIGNMENT <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>: Representerar approllerna som en grupp har beviljats för ett program. Stöder $expand.

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Namnet som visas i katalogen
  • [AppRoleId <String>]: Identifieraren (id) för approllen som är tilldelad till huvudnamnet. Den här approllen måste exponeras i egenskapen appRoles i resursprogrammets tjänsthuvudnamn (resourceId). Om resursprogrammet inte har deklarerat några approller kan ett standardprogramroll-ID på 00000000-0000-0000-0000-00000000000 anges för att signalera att huvudkontot har tilldelats till resursappen utan några specifika approller. Krävs vid skapande.
  • [CreatedDateTime <DateTime?>]: Tiden då approlltilldelningen skapades. Tidsstämpeltypen representerar datum- och tidsinformation med ISO 8601-format och är alltid i UTC-tid. Till exempel är midnatt UTC den 1 januari 2014 2014-01-01T00:00:00Z. Skrivskyddat.
  • [PrincipalDisplayName <String>]: Visningsnamnet för användaren, gruppen eller tjänstens huvudnamn som beviljats approlltilldelningen. Skrivskyddat. Stöder $filter (eq och startswith).
  • [PrincipalId <String>]: Den unika identifieraren (ID) för användaren, gruppen eller tjänstens huvudnamn som beviljas approllen. Krävs vid skapande.
  • [PrincipalType <String>]: Typen av det tilldelade huvudkontot. Detta kan antingen vara Användare, Grupp eller ServicePrincipal. Skrivskyddat.
  • [ResourceDisplayName <String>]: Visningsnamnet för resursappens tjänsthuvudnamn som tilldelningen görs till.
  • [ResourceId <String>]: Den unika identifieraren (ID) för resurstjänstens huvudnamn som tilldelningen görs för. Krävs vid skapande. Stöder $filter (endast eq).

CREATEDONBEHALFOF <IMicrosoftGraphDirectoryObject>: Representerar ett Azure Active Directory-objekt. Typen directoryObject är bastypen för många andra katalogentitetstyper.

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Namnet som visas i katalogen

PERMISSIONGRANT <IMicrosoftGraphResourceSpecificPermissionGrant[]>: De behörigheter som har beviljats för en grupp till ett visst program. Stöder $expand.

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Namnet som visas i katalogen
  • [ClientAppId <String>]: ID för tjänstens huvudnamn för Den Azure AD-app som har beviljats åtkomst. Skrivskyddat.
  • [ClientId <String>]: ID för Den Azure AD-app som har beviljats åtkomst. Skrivskyddat.
  • [Permission <String>]: Namnet på den resursspecifika behörigheten. Skrivskyddat.
  • [PermissionType <String>]: Typ av behörighet. Möjliga värden är: Program, Delegerat. Skrivskyddat.
  • [ResourceAppId <String>]: ID för Den Azure AD-app som är värd för resursen. Skrivskyddat.

TRANSITIVEMEMBER <IMicrosoftGraphDirectoryObject[]>: .

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Namnet som visas i katalogen

TRANSITIVEMEMBEROF <IMicrosoftGraphDirectoryObject[]>: .

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Namnet som visas i katalogen