Update-AzADGroup

Modul:

Az.Resources

Aktualisieren der Entität in Gruppen

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

Beschreibung

Aktualisieren der Entität in Gruppen

Beispiele

Beispiel 1: Aktualisieren der Beschreibung für die Gruppe

Update-AzADGroup -ObjectId $objectid -Description $description

Aktualisieren sie die Beschreibung für die Gruppe.

Parameter

-AdditionalProperties

Zusätzliche Parameter

Typ:	Hashtable
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AppRoleAssignment

Stellt die App-Rollen dar, die eine Gruppe für eine Anwendung gewährt wurde. Unterstützt $expand.

Typ:	IMicrosoftGraphAppRoleAssignmentAutoGenerated[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Classification

Beschreibt eine Klassifizierung für die Gruppe (z. B. niedrige, mittlere oder hohe Geschäftliche Auswirkungen). Gültige Werte für diese Eigenschaft werden durch Erstellen eines ClassificationList-Einstellungswerts basierend auf der Vorlagendefinition definiert. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, NOT, ge, le, startsWith).

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-CreatedOnBehalfOf

Stellt ein Azure Active Directory -Objekt dar. Der directoryObject-Typ ist der Basistyp für viele andere Verzeichnisentitätstypen.

Typ:	IMicrosoftGraphDirectoryObject
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:	PSObject
Aliase:	AzureRMContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DeletedDateTime

.

Typ:	DateTime
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Description

Eine optionale Beschreibung für die Gruppe. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, NOT, ge, le, startsWith) und $search.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DisplayName

Der im Verzeichnis angezeigte Name

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-GroupType

Gibt den Gruppentyp und seine Mitgliedschaft an. Wenn die Sammlung Unified enthält, ist die Gruppe eine Microsoft 365-Gruppe; andernfalls ist es entweder eine Sicherheitsgruppe oder Verteilergruppe. Ausführliche Informationen finden Sie unter "Gruppenübersicht". Wenn die Sammlung DynamicMembership enthält, weist die Gruppe dynamische Mitgliedschaft auf; andernfalls ist die Mitgliedschaft statisch. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, NOT).

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-HasMembersWithLicenseError

Gibt an, ob in dieser Gruppe Mitglieder mit Lizenzfehlern aus der gruppenbasierten Lizenzzuweisung vorhanden sind. Diese Eigenschaft wird nie für einen GET-Vorgang zurückgegeben. Sie können es als $filter Argument verwenden, um Gruppen abzurufen, die Mitglieder mit Lizenzfehlern haben (d. a. filtern Sie nach dieser Eigenschaft, die wahr ist). Unterstützt $filter (eq).

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-IsArchived

.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-IsAssignableToRole

Gibt an, ob diese Gruppe einer Azure Active Directory-Rolle zugewiesen werden kann. Diese Eigenschaft kann nur beim Erstellen der Gruppe festgelegt werden und ist unveränderlich. Wenn dieser Wert auf "true" festgelegt ist, muss die securityEnabled-Eigenschaft auch auf "true" festgelegt werden, und die Gruppe darf keine dynamische Gruppe sein (d. r. "groupTypes" darf "DynamicMembership" nicht enthalten). Diese Eigenschaft kann nur anrufer in den Rollen "Globaler Administrator" und "Privilegierte Rollenadministrator" festgelegt werden. Dem Aufrufer muss auch die Berechtigung "Directory.AccessAsUser.All" zugewiesen werden, um diese Eigenschaft festzulegen. Weitere Informationen finden Sie unter Verwenden einer Gruppe zum Verwalten von Azure AD-Rollenzuweisungen, die standardmäßig zurückgegeben werden. Unterstützt $filter (eq, ne, NOT).

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-JsonFilePath

Pfad der json-Datei, die für den Updatevorgang bereitgestellt wird

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-JsonString

Json-Zeichenfolge, die für den Updatevorgang bereitgestellt wird

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MailEnabled

Gibt an, ob die Gruppe E-Mail-aktiviert ist. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, NOT).

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MailNickname

Der E-Mail-Alias für die Gruppe, eindeutig in der Organisation. Diese Eigenschaft muss angegeben werden, wenn eine Gruppe erstellt wird. Diese Zeichen können nicht im mailNickName: @()/[]';:verwendet werden.<>,LEERZEICHEN. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MembershipRule

Die Regel, die Mitglieder für diese Gruppe bestimmt, wenn es sich bei der Gruppe um eine dynamische Gruppe handelt (groupTypes enthält DynamicMembership). Weitere Informationen zur Syntax der Mitgliedschaftsregel finden Sie in der Syntax der Mitgliedschaftsregeln. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, NOT, ge, le, startsWith).

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MembershipRuleProcessingState

Gibt an, ob die Verarbeitung der dynamischen Mitgliedschaft aktiviert oder angehalten ist. Mögliche Werte sind "Ein" oder "Angehalten". Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, NOT, in).

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ObjectId

key: ID der Gruppe

Typ:	String
Aliase:	GroupId
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PassThru

Gibt true zurück, wenn der Befehl erfolgreich ist.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PermissionGrant

Die Berechtigungen, die einer Gruppe für eine bestimmte Anwendung erteilt wurden. Unterstützt $expand.

Typ:	IMicrosoftGraphResourceSpecificPermissionGrant[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PreferredDataLocation

Der bevorzugte Datenspeicherort für die Gruppe. Weitere Informationen finden Sie unter OneDrive Online Multi-Geo. Wird standardmäßig zurückgegeben.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PreferredLanguage

Die bevorzugte Sprache für eine Microsoft 365-Gruppe. Sollte dem ISO 639-1-Code folgen; z. B. "en-US". Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SecurityEnabled

Gibt an, ob es sich bei der Gruppe um eine Sicherheitsgruppe handelt. Wird standardmäßig zurückgegeben. Unterstützt $filter (eq, ne, NOT, in).

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SecurityIdentifier

Sicherheitsbezeichner der Gruppe, die in Windows-Szenarien verwendet wird. Wird standardmäßig zurückgegeben.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Theme

Gibt das Farbdesign einer Microsoft 365-Gruppe an. Mögliche Werte sind Teal, Lila, Grün, Blau, Rosa, Orange oder Rot. Wird standardmäßig zurückgegeben.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Visibility

Gibt die Gruppenbeitrittsrichtlinie und die Sichtbarkeit von Gruppeninhalten für Gruppen an. Mögliche Werte sind: Private, Public oder Hiddenmembership. Hiddenmembership kann nur für Microsoft 365-Gruppen festgelegt werden, wenn die Gruppen erstellt werden. Sie kann später nicht aktualisiert werden. Andere Werte der Sichtbarkeit können nach der Gruppenerstellung aktualisiert werden. Wenn während der Gruppenerstellung in Microsoft Graph kein Sichtbarkeitswert angegeben wird, wird standardmäßig eine Sicherheitsgruppe als "Privat" erstellt, und die Microsoft 365-Gruppe ist öffentlich. Weitere Informationen finden Sie unter Gruppensichtbarkeitsoptionen. Wird standardmäßig zurückgegeben.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Ausgaben

Boolean