New-AdaptiveScope

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-AdaptiveScope per creare ambiti adattivi nell'organizzazione. Gli ambiti adattivi (o gli ambiti statici) vengono usati nei criteri di conservazione e nei criteri delle etichette di conservazione.

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

Sintassi

New-AdaptiveScope
   -Name <String>
   -FilterConditions <PswsHashtable>
   -LocationType <DynamicBoundaryLocationType>
   [-Comment <String>]
   [<CommonParameters>]

New-AdaptiveScope
   -Name <String>
   -LocationType <DynamicBoundaryLocationType>
   -RawQuery <String>
   [-Comment <String>]
   [<CommonParameters>]

Descrizione

Per altre informazioni sulle proprietà da usare negli ambiti adattivi, vedere Informazioni di configurazione per gli ambiti adattivi.

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-AdaptiveScope -Name "Project X" -LocationType User -FilterConditions @{"Conditions" = @(@{"Conditions" = @(@{"Value" = "US"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}, @{"Value" = "Canada"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}); "Conjunction" = "Or"}, @{"Value" = "Finance"; "Operator" = "Equals"; "Name" = "Department"}); "Conjunction" = "And"}

In questo esempio viene creato un ambito di query adattivo denominato Project X con i dettagli seguenti:

• Ambito: utenti
• Query: "('Country or region' è uguale a 'US' o 'Canada') e 'Department' è uguale a 'Finance'".

Parametri

-Comment

Il parametro Comment consente di specificare un commento facoltativo. Se si specifica un valore che contiene degli spazi, è necessario racchiuderlo tra virgolette ("); ad esempio: "Questa è una nota per amministratori".

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

-FilterConditions

Il parametro FilterConditions consente di specificare le condizioni incluse nel limite dinamico. La sintassi e i valori validi dipendono dal valore del parametro LocationType:

• Utente o gruppo: attributi di Active Directory. Ad esempio, per la condizione "('Paese o area geografica' è uguale a 'US' o 'Canada') e 'Department' uguale a 'Finance'", usare la sintassi seguente: @{"Conditions" = @(@{"Conditions" = @(@{"Value" = "US"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}, @{"Value" = "Canada"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}); "Conjunction" = "Or"}, @{"Value" = "Finance"; "Operator" = "Equals"; "Name" = "Department"}); "Conjunction" = "And"}
• Sito: proprietà personalizzate indicizzate. Ad esempio, per la condizione "'Refinable string 0' equals 'Human Resources', usare la sintassi seguente: @{"Conditions" = @{"Value" = "Human Resources"; "Operator" = "Equals"; "Name" = "RefinableString00"}; "Conjunction" = "And"}

Non è possibile usare questo parametro con il parametro RawQuery.

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

-LocationType

Il parametro LocationType specifica la posizione in cui è definito il filtro dell'ambito adattivo. I valori validi sono:

• Utente
• Gruppo (gruppo di Microsoft 365)
• Sito

Type:	DynamicBoundaryLocationType
Accepted values:	Unknown, User, Group, Site
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Name

Il parametro Name consente di specificare un nome univoco per l'ambito adattivo. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

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

-RawQuery

Il parametro RawQuery consente di impostare l'ambito sulla modalità query avanzata. Si usa la sintassi del filtro OPATH per la modalità query avanzata.

Non è possibile usare questo parametro con il parametro FilterConditions.

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