New-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 New-OrganizationSegment per creare segmenti di organizzazione da usare con i criteri di barriera delle informazioni 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

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

Descrizione

Per altre informazioni sugli attributi filtrabili che è possibile usare per definire i segmenti, vedere Attributi per i criteri di barriera delle informazioni.

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

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

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

Esempio 2

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

In questo esempio è stato definito un segmento denominato NotSales che include tutti gli utenti non inclusi in Sales. 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 è stato definito un segmento denominato LocalFTE che include persone che si trovano in locale e le cui posizioni non sono elencate come temporanee.

Parametri

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Name

Il parametro Name 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 (").

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
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 .

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

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:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-WhatIf

L'opzione WhatIf non funziona in PowerShell per la conformità alla sicurezza & .

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