Update-AzADGroup

Modulo:

Az.Resources

aggiornare l'entità nei gruppi

Sintassi

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

Descrizione

aggiornare l'entità nei gruppi

Esempio

Esempio 1: Aggiornare la descrizione per il gruppo

Update-AzADGroup -ObjectId $objectid -Description $description

Aggiornare la descrizione per il gruppo.

Parametri

-AdditionalProperties

Parametri aggiuntivi

Tipo:	Hashtable
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-AppRoleAssignment

Rappresenta i ruoli dell'app a cui è stato concesso un gruppo per un'applicazione. Supporta $expand.

Tipo:	IMicrosoftGraphAppRoleAssignmentAutoGenerated[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Classification

Descrive una classificazione per il gruppo( ad esempio basso, medio o alto impatto aziendale). I valori validi per questa proprietà vengono definiti creando un valore di impostazione ClassificationList, in base alla definizione del modello. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, ge, le, startsWith).

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CreatedOnBehalfOf

Rappresenta un oggetto Azure Active Directory. Il tipo directoryObject è il tipo di base per molti altri tipi di entità di directory.

Tipo:	IMicrosoftGraphDirectoryObject
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

Tipo:	PSObject
Alias:	AzureRMContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DeletedDateTime

.

Tipo:	DateTime
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Description

Descrizione facoltativa per il gruppo. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, ge, le, startsWith) e $search.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DisplayName

Nome visualizzato nella directory

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-GroupType

Specifica il tipo di gruppo e la relativa appartenenza. Se la raccolta contiene Unified, il gruppo è un gruppo di Microsoft 365; in caso contrario, si tratta di un gruppo di sicurezza o di un gruppo di distribuzione. Per informazioni dettagliate, vedere Panoramica dei gruppi. Se la raccolta include DynamicMembership, il gruppo ha appartenenza dinamica; in caso contrario, l'appartenenza è statica. Restituito per impostazione predefinita. Supporta $filter (eq, NOT).

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-HasMembersWithLicenseError

Indica se in questo gruppo sono presenti membri che presentano errori di licenza dall'assegnazione di licenze basata su gruppo. Questa proprietà non viene mai restituita in un'operazione GET. È possibile usarlo come argomento $filter per ottenere gruppi con membri con errori di licenza, ovvero filtrare per questa proprietà in modo che sia true. Supporta $filter (eq).

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-IsArchived

.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-IsAssignableToRole

Indica se questo gruppo può essere assegnato a un ruolo di Azure Active Directory. Questa proprietà può essere impostata solo durante la creazione del gruppo ed è non modificabile. Se impostato su true, la proprietà securityEnabled deve essere impostata anche su true e il gruppo non può essere un gruppo dinamico, ovvero groupTypes non può contenere DynamicMembership. Solo i chiamanti nei ruoli Amministratore globale e Amministratore ruolo con privilegi possono impostare questa proprietà. Al chiamante deve essere assegnata anche l'autorizzazione Directory.AccessAsUser.All per impostare questa proprietà. Per altre informazioni, vedere Uso di un gruppo per gestire le assegnazioni di ruolo di Azure ADReturned per impostazione predefinita. Supporta $filter (eq, ne, NOT).

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-JsonFilePath

Percorso del file JSON fornito all'operazione di aggiornamento

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-JsonString

Stringa JSON fornita all'operazione di aggiornamento

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MailEnabled

Specifica se il gruppo è abilitato alla posta elettronica. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT).

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MailNickname

Alias di posta elettronica per il gruppo, univoco nell'organizzazione. Questa proprietà deve essere specificata quando viene creato un gruppo. Questi caratteri non possono essere usati in mailNickName: @()/[]';:.<>,SPACE. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MembershipRule

Regola che determina i membri per questo gruppo se il gruppo è un gruppo dinamico (groupTypes contiene DynamicMembership). Per altre informazioni sulla sintassi della regola di appartenenza, vedere sintassi delle regole di appartenenza. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, ge, le, startsWith).

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MembershipRuleProcessingState

Indica se l'elaborazione dell'appartenenza dinamica è attiva o sospesa. I valori possibili sono On o Paused. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, in).

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ObjectId

key: ID del gruppo

Tipo:	String
Alias:	GroupId
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PassThru

Restituisce true quando il comando ha esito positivo

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PermissionGrant

Autorizzazioni concesse per un gruppo a un'applicazione specifica. Supporta $expand.

Tipo:	IMicrosoftGraphResourceSpecificPermissionGrant[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PreferredDataLocation

Posizione dei dati preferita per il gruppo. Per altre informazioni, vedere OneDrive Online Multi-Geo. Restituito per impostazione predefinita.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PreferredLanguage

Lingua preferita per un gruppo di Microsoft 365. Deve seguire il codice ISO 639-1; ad esempio 'en-US'. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SecurityEnabled

Specifica se il gruppo è un gruppo di sicurezza. Restituito per impostazione predefinita. Supporta $filter (eq, ne, NOT, in).

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SecurityIdentifier

Identificatore di sicurezza del gruppo, usato negli scenari di Windows. Restituito per impostazione predefinita.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Theme

Specifica il tema colore di un gruppo di Microsoft 365. I valori possibili sono Teal, Purple, Green, Blue, Pink, Orange o Red. Restituito per impostazione predefinita.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Visibility

Specifica i criteri di join di gruppo e la visibilità del contenuto del gruppo per i gruppi. I valori possibili sono: Private, Public o Hiddenmembership. Hiddenmembership può essere impostato solo per i gruppi di Microsoft 365, quando vengono creati i gruppi. Non può essere aggiornato in un secondo momento. È possibile aggiornare altri valori di visibilità dopo la creazione del gruppo. Se il valore di visibilità non viene specificato durante la creazione di gruppi in Microsoft Graph, un gruppo di sicurezza viene creato come Privato per impostazione predefinita e il gruppo di Microsoft 365 è Pubblico. Per altre informazioni, vedere Opzioni di visibilità dei gruppi. Restituito per impostazione predefinita.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Output

Boolean