Set-ManagementScope
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
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
Set-ManagementScope
[-Identity] <ManagementScopeIdParameter>
-DatabaseRestrictionFilter <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Set-ManagementScope
[-Identity] <ManagementScopeIdParameter>
-ServerRestrictionFilter <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
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 dei ruoli di gestione utilizzando il cmdlet New-ManagementRoleAssignment, l'ambito aggiornato verrà applicato a tutte le assegnazioni di ruolo associate. Per altre informazioni sulla modifica degli ambiti, vedere Modificare un ambito di ruolo.
Per altre informazioni sugli ambiti regolari ed esclusivi, vedere Informazioni sugli ambiti del ruolo di gestione.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano 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 di restrizione del 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. 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: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DatabaseRestrictionFilter
Questo parametro è disponibile solo in Exchange locale.
Il parametro DatabaseRestrictionFilter usa 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 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 un elenco delle proprietà del database filtrabili, vedere Informazioni sugli ambiti del ruolo di gestione.
- 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 usare500
,$true
,$false
o$null
.
È 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 Informazioni aggiuntive sulla sintassi OPATH.
Non è possibile usare questo parametro con i parametri RecipientRestrictionFilter, ServerRestrictionFilter, RecipientRoot, DatabaseList o ServerList.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Identity
Il parametro Identity consente di specificare il nome dell'ambito di gestione da modificare. Se il nome contiene spazi, è necessario racchiuderlo tra virgolette.
Type: | ManagementScopeIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-RecipientRestrictionFilter
Il parametro RecipientRestrictionFilter usa 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 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à del destinatario filtrabile. Per le proprietà del destinatario filtrabili, vedere Proprietà filtrabili per il parametro RecipientFilter.
- 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 usare500
,$true
,$false
o$null
.
È 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 Informazioni aggiuntive sulla sintassi OPATH.
Non è possibile usare questo parametro con i parametri DatabaseRestrictionFilter, DatabaseList, ServerList o ServerRestrictionFilter.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-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 che è un dominio visibor restituito dal cmdlet bylUnit. È 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 usare questo parametro con i parametri ServerRestrictionFilter o DatabaseRestrictionFilter.
Type: | OrganizationalUnitIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ServerRestrictionFilter
Questo parametro è disponibile solo in Exchange locale.
Il parametro ServerRestrictionFilter usa 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 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 un elenco delle proprietà del server filtrabili, vedere Informazioni sugli ambiti del ruolo di gestione.
- 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 usare500
,$true
,$false
o$null
.
È 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 Informazioni aggiuntive sulla sintassi OPATH.
Non è possibile usare questo parametro con i parametri RecipientRestrictionFilter, RecipientRoot, DatabaseRestrictionFilter, DatabaseList o ServerList.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
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.