Update-AzADGroup

Module:

Az.Resources

entiteit bijwerken in groepen

Syntaxis

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

entiteit bijwerken in groepen

Voorbeelden

Voorbeeld 1: Beschrijving bijwerken voor groep

Update-AzADGroup -ObjectId $objectid -Description $description

Beschrijving bijwerken voor groep.

Parameters

-AdditionalProperties

Aanvullende parameters

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AppRoleAssignment

Vertegenwoordigt de app-rollen die een groep heeft gekregen voor een toepassing. Ondersteunt $expand.

Type:	IMicrosoftGraphAppRoleAssignmentAutoGenerated[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Classification

Beschrijft een classificatie voor de groep (zoals lage, gemiddelde of hoge bedrijfsimpact). Geldige waarden voor deze eigenschap worden gedefinieerd door een classificatielijst-instellingswaarde te maken op basis van de sjabloondefinitie. Standaard geretourneerd. Ondersteunt $filter (eq, ne, NOT, ge, le, startsWith).

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CreatedOnBehalfOf

Vertegenwoordigt een Azure Active Directory-object. Het type directoryObject is het basistype voor veel andere typen directory-entiteiten.

Type:	IMicrosoftGraphDirectoryObject
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:	PSObject
Aliassen:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DeletedDateTime

.

Type:	DateTime
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Description

Een optionele beschrijving voor de groep. Standaard geretourneerd. Ondersteunt $filter (eq, ne, NOT, ge, le, startsWith) en $search.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisplayName

De naam die wordt weergegeven in de map

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-GroupType

Hiermee geeft u het groepstype en het bijbehorende lidmaatschap op. Als de verzameling Unified bevat, is de groep een Microsoft 365-groep; anders is het een beveiligingsgroep of distributiegroep. Zie het overzicht van groepen voor meer informatie. Als de verzameling DynamicMembership bevat, heeft de groep dynamisch lidmaatschap; anders is lidmaatschap statisch. Standaard geretourneerd. Ondersteunt $filter (eq, NOT).

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-HasMembersWithLicenseError

Hiermee wordt aangegeven of er leden in deze groep zijn die licentiefouten hebben op basis van de licentietoewijzing op basis van een groep. Deze eigenschap wordt nooit geretourneerd voor een GET-bewerking. U kunt het gebruiken als een $filter argument om groepen te krijgen die leden hebben met licentiefouten (dat wil gezegd, filteren op deze eigenschap is waar). Ondersteunt $filter (eq).

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-IsArchived

.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-IsAssignableToRole

Hiermee wordt aangegeven of deze groep kan worden toegewezen aan een Azure Active Directory-rol. Deze eigenschap kan alleen worden ingesteld tijdens het maken van de groep en kan onveranderbaar zijn. Als deze eigenschap is ingesteld op true, moet de eigenschap securityEnabled ook worden ingesteld op true en kan de groep geen dynamische groep zijn (dat wil wel dat groupTypes geen DynamicMembership bevatten). Alleen bellers in de rollen Globale beheerder en Bevoorrechte rolbeheerder kunnen deze eigenschap instellen. Aan de aanroeper moet ook de machtiging Directory.AccessAsUser.All worden toegewezen om deze eigenschap in te stellen. Zie Een groep gebruiken om Standaard Azure AD-roltoewijzingen te beheren. Ondersteunt $filter (eq, ne, NOT).

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-JsonFilePath

Pad van het Json-bestand dat is opgegeven bij de updatebewerking

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-JsonString

Json-tekenreeks die is opgegeven bij de updatebewerking

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-MailEnabled

Hiermee geeft u op of de groep e-mail is ingeschakeld. Standaard geretourneerd. Ondersteunt $filter (eq, ne, NOT).

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-MailNickname

De e-mailalias voor de groep, uniek in de organisatie. Deze eigenschap moet worden opgegeven wanneer een groep wordt gemaakt. Deze tekens kunnen niet worden gebruikt in mailNickName: @()/[];:.<>, SPATIE. Standaard geretourneerd. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-MembershipRule

De regel die leden voor deze groep bepaalt als de groep een dynamische groep is (groupTypes bevat DynamicMembership). Zie de syntaxis van de lidmaatschapsregels voor meer informatie over de syntaxis van de lidmaatschapsregel. Standaard geretourneerd. Ondersteunt $filter (eq, ne, NOT, ge, le, startsWith).

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-MembershipRuleProcessingState

Geeft aan of de dynamische lidmaatschapsverwerking is ingeschakeld of onderbroken. Mogelijke waarden zijn ingeschakeld of onderbroken. Standaard geretourneerd. Ondersteunt $filter (eq, ne, NOT, in).

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ObjectId

sleutel: id van groep

Type:	String
Aliassen:	GroupId
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PassThru

Retourneert waar wanneer de opdracht slaagt

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PermissionGrant

De machtigingen die zijn verleend voor een groep aan een specifieke toepassing. Ondersteunt $expand.

Type:	IMicrosoftGraphResourceSpecificPermissionGrant[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PreferredDataLocation

De voorkeursgegevenslocatie voor de groep. Zie OneDrive Online Multi-Geo voor meer informatie. Standaard geretourneerd.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PreferredLanguage

De voorkeurstaal voor een Microsoft 365-groep. Moet de ISO 639-1-code volgen; bijvoorbeeld 'en-US'. Standaard geretourneerd. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SecurityEnabled

Hiermee geeft u op of de groep een beveiligingsgroep is. Standaard geretourneerd. Ondersteunt $filter (eq, ne, NOT, in).

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SecurityIdentifier

Beveiligings-id van de groep, die wordt gebruikt in Windows-scenario's. Standaard geretourneerd.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Theme

Hiermee geeft u het kleurenthema van een Microsoft 365-groep op. Mogelijke waarden zijn Groen, Paars, Groen, Blauw, Roze, Oranje of Rood. Standaard geretourneerd.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Visibility

Hiermee geeft u het groepsbeleid en de zichtbaarheid van groepsinhoud voor groepen. Mogelijke waarden zijn: Privé, Openbaar of Verborgen leden. Hiddenmembership kan alleen worden ingesteld voor Microsoft 365-groepen wanneer de groepen worden gemaakt. Het kan later niet meer worden bijgewerkt. Andere zichtbaarheidswaarden kunnen worden bijgewerkt nadat de groep is gemaakt. Als de zichtbaarheidswaarde niet is opgegeven tijdens het maken van groepen in Microsoft Graph, wordt standaard een beveiligingsgroep gemaakt als Privé en is de Microsoft 365-groep openbaar. Zie opties voor zichtbaarheid van groepen voor meer informatie. Standaard geretourneerd.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Uitvoerwaarden

Boolean