Set-OrganizationSegment

Modulo:
Exchange PowerShell

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

Utilizzare il cmdlet Set-OrganizationSegment per modificare i segmenti dell'organizzazione nel Portale di conformità di Microsoft Purview. I segmenti dell'organizzazione non sono attivi finché non si applicano i criteri di barriera informativa.

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

Sintassi

Default (Impostazione predefinita) 

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

Descrizione

I segmenti sono definiti utilizzando determinati attributi in Microsoft Entra ID.

Per usare questo cmdlet in PowerShell per sicurezza e conformità, è 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 il GUID c96e0837-c232-4a8a-841e-ef45787d8fcd, il nome del reparto è stato aggiornato in "HRDept".

Parametri

-Identity

Applicabile: Sicurezza & conformità

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

  • Nome
  • Nome distinto (DN)
  • GUID

Proprietà dei parametri

Tipo:PolicyIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-UserGroupFilter

Applicabile: Sicurezza & conformità

Il parametro UserGroupFilter utilizza 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, $false, o $null), usare invece le virgolette singole ' '. Anche se questo parametro è una stringa (non un blocco di sistema), puoi anche usare le parentesi graffe { }, ma solo se il filtro non contiene variabili.
  • La proprietà è una proprietà filtrabile. Per ulteriori informazioni, vedere Attributi per i criteri di barriera informativa.
  • ComparisonOperator è un operatore di confronto OPATH (ad esempio -eq per gli uguali e -like per il confronto di stringhe). Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators.
  • Valore è il valore della proprietà da cercare. Racchiudere i valori di testo e le variabili tra virgolette singole ('Value' o '$Variable'). Se un valore di variabile contiene virgolette singole, sarà necessario identificarle (eseguire l'escape) per espandere correttamente la variabile. Ad esempio, al posto di '$User', usare '$($User -Replace "'","''")'. Non racchiudere interi o valori di sistema tra virgolette, ad esempio usare 500, $true, $false, o $null viceversa.

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

Proprietà dei parametri

Tipo: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, vedere about_CommonParameters.