Set-EntraGroup
Imposta le proprietà per un gruppo di Microsoft Entra ID esistente.
Sintassi
Default (Impostazione predefinita)
Set-EntraGroup
-GroupId <String>
[-DisplayName <String>]
[-GroupTypes <System.Collections.Generic.List`1[System.String]>]
[-SecurityEnabled <Boolean>]
[-Description <String>]
[-MailEnabled <Boolean>]
[-MailNickname <String>]
[-Visibility <String>]
[-IsAssignableToRole <Boolean>]
[<CommonParameters>]
Descrizione
Il Set-EntraGroup cmdlet imposta le proprietà per un gruppo di Microsoft Entra ID esistente. Specificare il GroupId parametro per impostare le proprietà per un gruppo di Microsoft Entra ID esistente.
Esempio
Esempio 1: Aggiornare un nome visualizzato di un gruppo
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "displayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -DisplayName 'Global HelpDesk Team Leaders'
Questo comando aggiorna il nome visualizzato di un gruppo specificato in Microsoft Entra ID.
Esempio 2: Aggiornare una descrizione del gruppo
Connect-Entra -Scopes 'Group.ReadWrite.All'
Get-EntraGroup -Filter "displayName eq 'HelpDesk Team Leaders'" | Set-EntraGroup -Description 'HelpDesk Team Leaders Global'
In questo esempio viene illustrato come aggiornare una descrizione di gruppo.
Esempio 3: Aggiornare un nome alternativo di posta elettronica di un gruppo
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -MailNickName 'newnickname'
Questo comando aggiorna il nome alternativo di posta elettronica di un gruppo specificato in Microsoft Entra ID.
Esempio 4: Aggiornare la sicurezza di un gruppo abilitata
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -SecurityEnabled $True
Questo comando aggiorna la sicurezza abilitata per un gruppo specificato in Microsoft Entra ID.
Esempio 5: Aggiornare un messaggio di posta elettronica di gruppo abilitato
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -MailEnabled $False
In questo esempio viene illustrato come aggiornare un gruppo principale abilitato.
Esempio 6: Aggiornare una proprietà per un gruppo
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -Visibility 'Private' -GroupTypes 'DynamicMembership' -IsAssignableToRole $True
In questo esempio viene illustrato come aggiornare una proprietà per un gruppo di Microsoft Entra ID esistente.
Parametri
-Description
Specifica una descrizione per il gruppo.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DisplayName
Specifica un nome visualizzato per il gruppo.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-GroupId
Specifica l'ID oggetto di un gruppo.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | id |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-GroupTypes
Specifica che il gruppo è un gruppo dinamico. Per creare un gruppo dinamico, specificare il valore DynamicMembership.
Proprietà dei parametri
| Tipo: | System.Collections.Generic.List`1[System.String] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-IsAssignableToRole
Questa proprietà può essere impostata solo al momento della creazione del gruppo e non può essere modificata in un gruppo esistente.
Proprietà dei parametri
| Tipo: | System.Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MailEnabled
Indica se il gruppo è abilitato per la posta elettronica.
Proprietà dei parametri
| Tipo: | System.Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MailNickname
Specifica un nome alternativo di posta elettronica per il gruppo.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SecurityEnabled
Indica se il gruppo è abilitato per la sicurezza.
Proprietà dei parametri
| Tipo: | System.Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Visibility
Specifica la visibilità dell'elenco di contenuto e membri del gruppo. Questo parametro può accettare uno dei valori seguenti:
- "Pubblico": chiunque può visualizzare il contenuto del gruppo.
- "Privato": solo i membri possono visualizzare il contenuto del gruppo.
- "HiddenMembership": solo i membri possono visualizzare il contenuto del gruppo e solo i membri, i proprietari, l'amministratore globale/aziendale, l'amministratore utenti e gli amministratori del supporto tecnico possono visualizzare l'elenco dei membri del gruppo.
Se non viene specificato alcun valore, il valore predefinito è "Pubblico".
Notes:
- Questo parametro è valido solo per i gruppi con groupType impostato su "Unified".
- Se un gruppo ha questo attributo impostato su "HiddenMembership", non può essere modificato in un secondo momento.
- Chiunque può partecipare a un gruppo con questo attributo impostato su "Pubblico". Se l'attributo è impostato su Private o HiddenMembership, solo il proprietario può aggiungere nuovi membri al gruppo e le richieste di partecipare al gruppo necessitano dell'approvazione del proprietario.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.