Set-OrganizationSegment

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Security & Compliance

Questo cmdlet è disponibile solo in PowerShell conformità alla sicurezza & . Per altre informazioni, vedere PowerShell conformità alla sicurezza&.

Usare il cmdlet Set-OrganizationSegment per modificare i segmenti dell'organizzazione nel Portale di conformità di Microsoft Purview. I segmenti dell'organizzazione non sono attivi fino a quando non si applicano i criteri di barriera delle informazioni.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Set-OrganizationSegment
   [-Identity] <PolicyIdParameter>
   [-UserGroupFilter <String>]
   [<CommonParameters>]

Descrizione

I segmenti vengono definiti usando determinati attributi in Azure Active Directory.

Per usare questo cmdlet in Security & Compliance PowerShell, è necessario disporre delle autorizzazioni. Per ulteriori informazioni, vedere Autorizzazioni nel portale di conformità di Microsoft Purview.

Esempio

Esempio 1

Set-OrganizationSegment -Identity c96e0837-c232-4a8a-841e-ef45787d8fcd -UserGroupFilter "Department -eq 'HRDept'"

In questo esempio, per il segmento con GUID c96e0837-c232-4a8a-841e-ef45787d8fcd, il nome del reparto è stato aggiornato su "HRDept".

Parametri

-Identity

Il parametro Identity consente di specificare il segmento dell'organizzazione da modificare. È possibile usare qualsiasi valore che identifichi in modo univoco il segmento. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID
Type:PolicyIdParameter
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-UserGroupFilter

Il parametro UserGroupFilter usa la sintassi del filtro OPATH per specificare i membri del segmento dell'organizzazione. La sintassi è "Property -ComparisonOperator 'Value'" (ad esempio, "MemberOf -eq 'Engineering Department'" o "ExtensionAttribute1 -eq 'DayTrader'").

  • Racchiudere l'intero filtro OPATH tra virgolette doppie " ". Se il filtro contiene valori di sistema (ad esempio, $true, $falseo $null), usare le virgolette singole ''. Sebbene questo parametro sia una stringa (non un blocco di sistema), è anche possibile usare le parentesi graffe { }, ma solo se il filtro non contiene variabili.
  • La proprietà è una proprietà filtrabile. Per altre informazioni, vedere Attributi per i criteri di barriera delle informazioni.
  • ComparisonOperator è un operatore di confronto OPATH, ad esempio -eq per equals e -like per il confronto di stringhe. Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators.
  • Il valore è il valore della proprietà da cercare. Racchiudere valori di testo e variabili tra virgolette singole ('Value' o '$Variable'). Se un valore variabile contiene virgolette singole, è necessario identificare (escape) le virgolette singole per espandere correttamente la variabile. Ad esempio, invece di '$User', usare '$($User -Replace "'","''")'. Non racchiudere valori interi o di sistema tra virgolette, ad esempio usare 500, $true, $falseo $null .

Usare la stessa proprietà per tutti i segmenti e verificare che i segmenti non si sovrappongano (un utente deve essere assegnato a un solo segmento).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance