Set-ManagementScope

Modulo:: Exchange PowerShell

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi di un ambiente o dell'altro.

Utilizzare il cmdlet Set-ManagementScope per modificare un ambito di gestione esistente.

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

Sintassi

DatabaseFilter

Set-ManagementScope
    [-Identity] <ManagementScopeIdParameter>
    -DatabaseRestrictionFilter <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

ServerFilter

Set-ManagementScope
    [-Identity] <ManagementScopeIdParameter>
    -ServerRestrictionFilter <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

RecipientFilter

Set-ManagementScope
    [-Identity] <ManagementScopeIdParameter>
    [-RecipientRestrictionFilter <String>]
    [-RecipientRoot <OrganizationalUnitIdParameter>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Se si modifica un ambito associato alle assegnazioni di ruoli di gestione usando il cmdlet New-ManagementRoleAssignment, l'ambito aggiornato si applica a tutte le assegnazioni di ruolo associate. Per ulteriori informazioni sulla modifica degli ambiti, vedere Modificare un ambito di ruolo.

Per ulteriori informazioni sugli ambiti regolari ed esclusivi, vedere Informazioni sugli ambiti dei ruoli di gestione.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-ManagementScope "Seattle Mailboxes" -RecipientRestrictionFilter "City -eq 'Seattle' -and RecipientType -eq 'UserMailbox'"

In questo esempio viene modificato il filtro delle restrizioni destinatario nell'ambito di gestione delle cassette postali di Seattle per associare tutte le cassette postali contenenti Seattle nella proprietà cassetta postale City.

Esempio 2

Set-ManagementScope "Sales Recipients" -RecipientRoot contoso.com/Sales

In questo esempio viene modificata la radice destinatario per l'ambito di gestione dei destinatari di vendite per associare solo gli oggetti destinatario contenuti in contoso.com/Sales OU.

Esempio 3

Set-ManagementScope "Vancouver Servers" -ServerRestrictionFilter "ServerSite -eq 'NA-CDN-Vancouver,CN=Sites,CN=Configuration,DC=contoso,DC=com"}'"

In questo esempio il sito di Active Directory usato nel filtro per le restrizioni server per l'ambito di gestione dei server Vancouver viene modificato in "NA-CDN-Vancouver,CN=Sites,CN=Configuration,DC=contoso,DC=com".

Parametri

-Confirm

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

-DatabaseRestrictionFilter

Questo parametro è disponibile solo in Exchange locale.

Il parametro DatabaseRestrictionFilter utilizza la sintassi del filtro OPATH per specificare i database inclusi nell'ambito. La sintassi è "Property -ComparisonOperator 'Value'".

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 un elenco delle proprietà del database filtrabili, vedere Informazioni sugli ambiti dei ruoli di gestione.
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.

È possibile concatenare più criteri di ricerca usando gli operatori -and logici e -or. Ad esempio, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".

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

Non è possibile utilizzare questo parametro con i parametri RecipientRestrictionFilter, ServerRestrictionFilter, RecipientRoot, DatabaseList o ServerList.

Proprietà dei parametri

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

Set di parametri

DatabaseFilter

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Proprietà dei parametri

Tipo:	Fqdn
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

-Force

Questo parametro è disponibile solamente nel servizio basato su cloud.

L'interruttore di forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.

È possibile utilizzare questa opzione per eseguire attività a livello di programmazione, se la richiesta di un input amministrativo è inappropriata.

Proprietà dei parametri

Tipo:	SwitchParameter
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

-Identity

Il parametro Identity consente di specificare il nome dell'ambito di gestione da modificare. Se il nome contiene spazi, è necessario racchiuderlo tra virgolette.

Proprietà dei parametri

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

Set di parametri

(All)

Posizione:	1
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	True
Valore dagli argomenti rimanenti:	False

-Name

Il parametro Name consente di specificare il nome dell'ambito di gestione. Il nome dell'ambito di gestione può contenere un massimo di 64 caratteri. Se il nome contiene 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:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-RecipientRestrictionFilter

Il parametro RecipientRestrictionFilter utilizza la sintassi del filtro OPATH per specificare i destinatari inclusi nell'ambito. La sintassi è "Property -ComparisonOperator 'Value'".

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à del destinatario filtrabile. Per le proprietà dei destinatari filtrabili, vedere Proprietà filtrabili per il parametro RecipientFilter.
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.

È possibile concatenare più criteri di ricerca usando gli operatori -and logici e -or. Ad esempio, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".

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

Non è possibile utilizzare questo parametro con i parametri DatabaseRestrictionFilter, DatabaseList, ServerList o ServerRestrictionFilter.

Proprietà dei parametri

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

Set di parametri

RecipientFilter

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-RecipientRoot

Il parametro RecipientRoot consente di specificare l'unità organizzativa (UO) a cui deve essere applicato il filtro specificato con il parametro RecipientRestrictionFilter. L'input valido per questo parametro è un'unità organizzativa o un dominio restituito dal cmdlet Get-OrganizationalUnit. È possibile utilizzare qualsiasi valore che identifichi l'unità organizzativa o il dominio in modo univoco. Ad esempio:

Nome
Nome
Nome distinto (DN)
GUID

Non è possibile utilizzare questo parametro con i parametri ServerRestrictionFilter o DatabaseRestrictionFilter.

Proprietà dei parametri

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

Set di parametri

RecipientFilter

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ServerRestrictionFilter

Questo parametro è disponibile solo in Exchange locale.

Il parametro ServerRestrictionFilter utilizza la sintassi del filtro OPATH per specificare i server inclusi nell'ambito. La sintassi è "Property -ComparisonOperator 'Value'".

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 un elenco delle proprietà del server filtrabili, vedere Informazioni sugli ambiti dei ruoli di gestione.
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.

È possibile concatenare più criteri di ricerca usando gli operatori -and logici e -or. Ad esempio, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".

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

Non è possibile utilizzare questo parametro con i parametri RecipientRestrictionFilter, RecipientRoot, DatabaseRestrictionFilter, DatabaseList o ServerList.

Proprietà dei parametri

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

Set di parametri

ServerFilter

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-WhatIf

L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.

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.

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.

Note

Usa codici paese di due lettere (ISO 3166-1 alfa-2) invece del nome completo del paese nei filtri. Ad esempio, usare -RecipientRestrictionFilter "UsageLocation -eq 'FR'" per la Francia.

Commenti e suggerimenti

Questa pagina è stata utile?