Compartir a través de

New-ManagementScope

Módulo:
Exchange PowerShell

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser exclusivos de un entorno u otro.

Utilice el cmdlet New-ManagementScope para crear un ámbito de administración normal o exclusivo.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

DatabaseList 

New-ManagementScope
    [-Name] <String>
    -DatabaseList <DatabaseIdParameter[]>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Exclusive]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

DatabaseFilter 

New-ManagementScope
    [-Name] <String>
    -DatabaseRestrictionFilter <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Exclusive]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

RecipientFilter 

New-ManagementScope
    [-Name] <String>
    -RecipientRestrictionFilter <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Exclusive]
    [-Force]
    [-RecipientRoot <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

ServerList 

New-ManagementScope
    [-Name] <String>
    -ServerList <ServerIdParameter[]>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Exclusive]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

ServerFilter 

New-ManagementScope
    [-Name] <String>
    -ServerRestrictionFilter <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Exclusive]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

Description

Después de crear un ámbito regular o exclusivo, deberá asociar el ámbito con una asignación de roles de roles. Para asociar un ámbito con una asignación de roles, utilice el cmdlet New-ManagementRoleAssignment. Para obtener más información sobre cómo agregar nuevos ámbitos de administración, consulte Creación de un ámbito normal o exclusivo.

Para obtener más información sobre los ámbitos regulares y exclusivos, consulte Descripción de los ámbitos de rol de administración.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

New-ManagementScope -Name "Mailbox Servers 1 through 3" -ServerList MailboxServer1, MailboxServer2, MailboxServer3

Este ejemplo crea un ámbito que incluye solo los servidores MailboxServer1, MailboxServer2 y MailboxServer3. Las funciones asignadas a los usuarios mediante las asignaciones de funciones de administración que tengan el ámbito en este ejemplo sólo pueden realizarse en los servidores incluidos en el ámbito.

Ejemplo 2

New-ManagementScope -Name "Redmond Site Scope" -ServerRestrictionFilter "ServerSite -eq 'CN=Redmond,CN=Sites,CN=Configuration,DC=contoso,DC=com'"

En este ejemplo se crea el ámbito denominado Ámbito de sitio de Redmond y se establece un filtro de restricción de servidor que solo coincide con los servidores ubicados en el sitio "CN=Redmond,CN=Sites,CN=Configuration,DC=contoso,DC=com" Servicios de dominio de Active Directory (AD DS).

Ejemplo 3

New-ManagementScope -Name "Executive Mailboxes" -RecipientRoot "contoso.com/Executives" -RecipientRestrictionFilter "RecipientType -eq 'UserMailbox'"

En este ejemplo se crea el ámbito de buzones ejecutivos. Sólo los buzones ubicados dentro de la unidad organizativa Ejecutivos en el dominio contoso.com coinciden con el filtro de restricción de destinatarios.

Ejemplo 4

New-ManagementScope -Name "Protected Exec Users" -RecipientRestrictionFilter "Title -like 'VP*'" -Exclusive

New-ManagementRoleAssignment -SecurityGroup "Executive Administrators" -Role "Mail Recipients" -CustomRecipientWriteScope "Protected Exec Users"

En este ejemplo se crea el ámbito exclusivo de usuarios ejecutivos protegidos. Los usuarios que contienen la cadena "VP" en el título coinciden con el filtro de destinatarios para el ámbito. Cuando se crea el ámbito exclusivo, inmediatamente se impide la modificación de los destinatarios que coinciden con el ámbito exclusivo hasta que el ámbito se asocia a una asignación de roles de administración. Si otras asignaciones de roles están asociadas a otros ámbitos exclusivos que coinciden con los mismos destinatarios, las asignaciones aún pueden modificar a los destinatarios.

El ámbito exclusivo está asociado a una asignación de roles de administración que asigna la función de administración de destinatarios de correo al grupo de roles de administradores ejecutivos. Este grupo de funciones incluye administradores autorizados para modificar los buzones de ejecutivos de alto perfil. Sólo los administradores del grupo de roles de administradores ejecutivos pueden modificar a los usuarios con la cadena "VP" en su título.

Ejemplo 5

New-ManagementScope -Name "Seattle Databases" -DatabaseRestrictionFilter "Name -Like 'SEA*'"

En este ejemplo, se crea el ámbito Bases de datos de Seattle y se establece un filtro de restricciones de base de datos que sólo coincide con las bases de datos que empiezan con la cadena "SEA".

Parámetros

-Confirm

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, complemento de seguridad integrado para el entorno local Buzones

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DatabaseList

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro solo está disponible en Exchange local.

El parámetro DatabaseList especifica una lista de bases de datos a las que se debe aplicar el ámbito. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID

Puede especificar distintos valores separados por comas. Si los valores contienen espacios, use la sintaxis siguiente: "Value1","Value2",..."ValueN".

No puede usar este parámetro con los parámetros DatabaseRestrictionFilter, ServerList, RecipientRestrictionFilter, RecipientRoot o ServerRestrictionFilter.

Propiedades de parámetro

Tipo:

DatabaseIdParameter[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DatabaseList
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DatabaseRestrictionFilter

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro solo está disponible en Exchange local.

El parámetro DatabaseRestrictionFilter usa la sintaxis de filtro de OPATH para especificar las bases de datos que se incluyen en el ámbito. La sintaxis es "Property -ComparisonOperator 'Value'".

  • Incluya todo el filtro de OPATH entre comillas dobles " ". Si el filtro contiene valores del sistema (por ejemplo, , $true$falseo $null), use comillas simples ' ' en su lugar. Aunque este parámetro es una cadena (no un bloque del sistema), también puede usar llaves { }, pero solo si el filtro no contiene variables.
  • La propiedad es una propiedad filtrable. Para obtener una lista de las propiedades de base de datos filtrables, consulte Descripción de los ámbitos de rol de administración.
  • ComparisonOperator es un operador de comparación de OPATH (por ejemplo -eq , para igual y -like para la comparación de cadenas). Para obtener más información sobre los operadores de comparación, consulte about_Comparison_Operators.
  • Value es el valor de propiedad que se va a buscar. Incluya valores de texto y variables entre comillas simples ('Value' o '$Variable'). Si un valor de variable contiene comillas simples, debe identificar (escape) las comillas simples para expandir la variable correctamente. Por ejemplo, en lugar de '$User', use '$($User -Replace "'","''")'. No incluya enteros ni valores del sistema entre comillas (por ejemplo, use 500, $true, $falseo $null en su lugar).

Puede encadenar varios criterios de búsqueda mediante los operadores lógicos -and y -or. Por ejemplo, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".

Para obtener información detallada sobre los filtros de OPATH en Exchange, consulte Información adicional de la sintaxis de OPATH.

No puede usar este parámetro con los parámetros RecipientRestrictionFilter, ServerRestrictionFilter, RecipientRoot, DatabaseList o ServerList.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DatabaseFilter
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DomainController

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Propiedades de parámetro

Tipo:Fqdn
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Exclusive

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, complemento de seguridad integrado para el entorno local Buzones

El modificador Exclusive especifica que la función debe ser un ámbito exclusivo. No es necesario especificar un valor con este modificador.

Cuando crea ámbitos de administración exclusivos, sólo los ámbitos exclusivos asignados a los usuarios o grupos de seguridad universal (USG) que contienen objetos que se van a modificar pueden tener acceso a esos objetos. Los usuarios o USG a los que no se asigna un ámbito exclusivo que contiene los objetos pierden inmediatamente el acceso a esos objetos.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DatabaseList
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
DatabaseFilter
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
RecipientFilter
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ServerList
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ServerFilter
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Force

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, complemento de seguridad integrado para el entorno local Buzones

El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.

Use este modificador para crear un ámbito exclusivo sin mostrar la advertencia de que el ámbito exclusivo surte efecto inmediatamente.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DatabaseList
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
DatabaseFilter
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
RecipientFilter
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ServerList
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ServerFilter
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, complemento de seguridad integrado para el entorno local Buzones

El parámetro Name especifica el nombre del ámbito de administración. El nombre puede tener hasta 64 caracteres. Si el nombre incluye espacios, escríbalo entre comillas (").

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RecipientRestrictionFilter

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, complemento de seguridad integrado para el entorno local Buzones

El parámetro RecipientRestrictionFilter usa la sintaxis de filtro OPATH para especificar los destinatarios que se incluyen en el ámbito. La sintaxis es "Property -ComparisonOperator 'Value'".

  • Incluya todo el filtro de OPATH entre comillas dobles " ". Si el filtro contiene valores del sistema (por ejemplo, , $true$falseo $null), use comillas simples ' ' en su lugar. Aunque este parámetro es una cadena (no un bloque del sistema), también puede usar llaves { }, pero solo si el filtro no contiene variables.
  • La propiedad es una propiedad filtrable. Para ver las propiedades de destinatario filtrables, vea Propiedades filtrables para el parámetro RecipientFilter.
  • ComparisonOperator es un operador de comparación de OPATH (por ejemplo -eq , para igual y -like para la comparación de cadenas). Para obtener más información sobre los operadores de comparación, consulte about_Comparison_Operators.
  • Value es el valor de propiedad que se va a buscar. Incluya valores de texto y variables entre comillas simples ('Value' o '$Variable'). Si un valor de variable contiene comillas simples, debe identificar (escape) las comillas simples para expandir la variable correctamente. Por ejemplo, en lugar de '$User', use '$($User -Replace "'","''")'. No incluya enteros ni valores del sistema entre comillas (por ejemplo, use 500, $true, $falseo $null en su lugar).

Puede encadenar varios criterios de búsqueda mediante los operadores lógicos -and y -or. Por ejemplo, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".

Para obtener información detallada sobre los filtros de OPATH en Exchange, consulte Información adicional de la sintaxis de OPATH.

No se puede usar este parámetro con los parámetros DatabaseRestrictionFilter, DatabaseList, ServerList o ServerRestrictionFilter.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

RecipientFilter
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RecipientRoot

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, complemento de seguridad integrado para el entorno local Buzones

El parámetro RecipientRoot especifica la unidad organizativa (OU) bajo la que el filtro especificado con el parámetro RecipientRestrictionFilter se debe aplicar. La entrada válida para este parámetro es una unidad organizativa o dominio devuelta por el cmdlet Get-OrganizationalUnit. Puede usar cualquier valor que identifique la OU o el dominio de forma exclusiva. Por ejemplo:

  • Nombre
  • Nombre
  • Nombre completo (DN)
  • GUID

No puede usar este parámetro con los parámetros ServerRestrictionFilter o DatabaseRestrictionFilter.

Propiedades de parámetro

Tipo:OrganizationalUnitIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

RecipientFilter
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServerList

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro solo está disponible en Exchange local.

El parámetro ServerList especifica una lista de servidores al que se debe aplicar el ámbito. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:

  • Name
  • FQDN
  • Distinguished name (DN)
  • Nombre distintivo (DN) heredado de Exchange

Puede especificar distintos valores separados por comas. Si los valores contienen espacios o requieren comillas, use la sintaxis siguiente: "Value1","Value2",..."ValueN".

No se puede usar este parámetro con los parámetros RecipientRestrictionFilter, RecipientRoot, DatabaseRestrictionFilter, DatabaseList o ServerRestrictionFilter.

Propiedades de parámetro

Tipo:

ServerIdParameter[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ServerList
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServerRestrictionFilter

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro solo está disponible en Exchange local.

El parámetro ServerRestrictionFilter usa la sintaxis de filtro OPATH para especificar los servidores que se incluyen en el ámbito. La sintaxis es "Property -ComparisonOperator 'Value'".

  • Incluya todo el filtro de OPATH entre comillas dobles " ". Si el filtro contiene valores del sistema (por ejemplo, , $true$falseo $null), use comillas simples ' ' en su lugar. Aunque este parámetro es una cadena (no un bloque del sistema), también puede usar llaves { }, pero solo si el filtro no contiene variables.
  • La propiedad es una propiedad filtrable. Para obtener una lista de las propiedades de servidor filtrables, consulte Descripción de los ámbitos de rol de administración.
  • ComparisonOperator es un operador de comparación de OPATH (por ejemplo -eq , para igual y -like para la comparación de cadenas). Para obtener más información sobre los operadores de comparación, consulte about_Comparison_Operators.
  • Value es el valor de propiedad que se va a buscar. Incluya valores de texto y variables entre comillas simples ('Value' o '$Variable'). Si un valor de variable contiene comillas simples, debe identificar (escape) las comillas simples para expandir la variable correctamente. Por ejemplo, en lugar de '$User', use '$($User -Replace "'","''")'. No incluya enteros ni valores del sistema entre comillas (por ejemplo, use 500, $true, $falseo $null en su lugar).

Puede encadenar varios criterios de búsqueda mediante los operadores lógicos -and y -or. Por ejemplo, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".

Para obtener información detallada sobre los filtros de OPATH en Exchange, consulte Información adicional de la sintaxis de OPATH.

No puede usar este parámetro con los parámetros RecipientRestrictionFilter, RecipientRoot, DatabaseRestrictionFilter, DatabaseList o ServerList.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ServerFilter
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, complemento de seguridad integrado para el entorno local Buzones

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.

Notas

Use códigos de país de dos letras (ISO 3166-1 alfa-2) en lugar del nombre completo del país en los filtros. Por ejemplo, use -RecipientRestrictionFilter "UsageLocation -eq 'FR'" para Francia.