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

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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IMicrosoftGraphAppRoleAssignmentAutoGenerated[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IMicrosoftGraphDirectoryObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeletedDateTime

.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

Namnet som visas i katalogen

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IsArchived

.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MailEnabled

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ObjectId

nyckel: ID för grupp

Type:	String
Aliases:	GroupId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Returnerar sant när kommandot lyckas

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	IMicrosoftGraphResourceSpecificPermissionGrant[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PreferredDataLocation

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecurityEnabled

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecurityIdentifier

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Utdata

Boolean

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.

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.