New-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 New-OrganizationSegment per creare segmenti dell'organizzazione da utilizzare con i criteri di barriera informativa 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) 

New-OrganizationSegment
    [-Name] <String>
    -UserGroupFilter <String>
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Per ulteriori informazioni sugli attributi filtrabili che è possibile utilizzare per definire i segmenti, vedere Attributi per i criteri di barriera informativa.

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

New-OrganizationSegment -Name "HR" -UserGroupFilter "Department -eq 'HR'"

In questo esempio, un segmento denominato HR viene definito utilizzando HR, un valore nell'attributo Department.

Esempio 2

New-OrganizationSegment -Name "NotSales" -UserGroupFilter "Department -ne 'Sales'"

In questo esempio, abbiamo definito un segmento chiamato NotSales che include tutti coloro che non sono nelle vendite. La parte "-ne" del cmdlet fa riferimento a "non uguale".

Esempio 3

New-OrganizationSegment -Name "LocalFTE" -UserGroupFilter "Location -eq 'Local' -and Position -ne 'Temporary'"

In questo esempio, abbiamo definito un segmento chiamato LocalFTE che include le persone che si trovano localmente e le cui posizioni non sono elencate come temporanee.

Parametri

-Confirm

Applicabile: Sicurezza & conformità

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

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

-Name

Applicabile: Sicurezza & conformità

Il parametro Nome consente di specificare il nome univoco per il segmento dell'organizzazione. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Proprietà dei parametri

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

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
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.

Per informazioni dettagliate sui filtri OPATH in Exchange, vedere Ulteriori informazioni sulla sintassi OPATH.

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:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Sicurezza & conformità

Il parametro WhatIf non funziona in PowerShell per sicurezza e conformità.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

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.