Update-AzADGroup

Modul:

Az.Resources

uppdatera entitet i grupper

Syntax

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

Update-AzADGroup
      -ObjectId <String>
      -JsonFilePath <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADGroup
      -ObjectId <String>
      -JsonString <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

uppdatera entitet i grupper

Exempel

Exempel 1: Uppdateringsbeskrivning för grupp

Update-AzADGroup -ObjectId $objectid -Description $description

Uppdateringsbeskrivning för grupp.

Parametrar

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

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.

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

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Typ:	PSObject
Alias:	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

Namnet som visas i katalogen

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
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

-JsonFilePath

Sökvägen till Json-filen som har angetts för uppdateringsåtgärden

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

-JsonString

Json-sträng som har angetts för uppdateringsåtgärden

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
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:	False
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

-ObjectId

nyckel: ID för grupp

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

-PassThru

Returnerar sant när kommandot lyckas

Typ:	SwitchParameter
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.

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

-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

Boolean