Compartir a través de

Remove-CMObjectSecurityScope

  • Referencia
Módulo:
ConfigurationManager

Quite un ámbito de seguridad de un objeto de Configuration Manager.

Sintaxis

Remove-CMObjectSecurityScope
      [-Force]
      -InputObject <IResultObject[]>
      [-Scope] <IResultObject[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMObjectSecurityScope
      [-Force]
      -Id <String>
      -InputObject <IResultObject[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMObjectSecurityScope
      [-Force]
      -InputObject <IResultObject[]>
      [-Name] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Use este cmdlet para quitar uno o varios ámbitos de seguridad de un objeto de Configuration Manager.

Para obtener más información sobre los ámbitos de seguridad, consulte Aspectos básicos de la administración basada en roles en Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Eliminación de un ámbito de seguridad de una aplicación

El primer comando obtiene el ámbito de seguridad denominado Scope1 y almacena el objeto en la variable $Scope .

El segundo comando obtiene todos los objetos de aplicación cuyo nombre comienza por "Central". A continuación, usa el operador de canalización para pasar los objetos a Remove-CMObjectSecurityScope.

El último comando quita el ámbito de seguridad de cada uno de los objetos de aplicación. El parámetro Force indica que no se le pedirá antes de que se ejecute el cmdlet.

$Scope = Get-CMSecurityScope -Name "Scope1"
$apps = Get-CMApplication -Name "Central*"
$app | Remove-CMObjectSecurityScope -Scope $Scope -Force

Ejemplo 3: Agregar un nuevo ámbito de seguridad y, a continuación, quitar todos los demás del objeto de aplicación

El primer comando obtiene un ámbito de seguridad en la variable TeamABCScope. El segundo comando obtiene un objeto de aplicación para Edge Enterprise Stable. El tercer comando agrega el nuevo TeamABCScope a la aplicación. El último comando obtiene ámbitos de la aplicación que no son TeamABCScope y, a continuación, los quita todos.

$ScopeName = "Team ABC"
$TeamABCScope = Get-CMSecurityScope | Where-Object {$_.CategoryName -eq $ScopeName}

$app = Get-CMApplication -Name "Edge Enterprise Stable"

Add-CMObjectSecurityScope -InputObject $app -Scope $TeamABCScope

$scopes = Get-CMObjectSecurityScope -InputObject $app | Where-Object {$_.CategoryName -ne $ScopeName}
foreach ( $ExtraScope in $scopes )
  {
  Remove-CMObjectSecurityScope -InputObject $app -Scope $ExtraScope -Force
  }

Parámetros

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Obliga al comando a ejecutarse sin pedir confirmación del usuario.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Especifique el identificador de un ámbito de seguridad asociado a un objeto de Configuration Manager. Este valor es la CategoryID propiedad , por ejemplo SMS00UNA , para el ámbito Predeterminado .

Tipo:String
Alias:SecurityScopeId
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifique una matriz de objetos de Configuration Manager asociados a un ámbito de seguridad. Para obtener este objeto, use el cmdlet Get para el tipo de objeto. Por ejemplo, Get-CMApplication para objetos de aplicación.

Tipo:IResultObject[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifique el nombre de un ámbito de seguridad asociado a un objeto de Configuration Manager.

Tipo:String
Alias:SecurityScopeName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Scope

Especifique una matriz de objetos de ámbito de seguridad que se van a quitar. Para obtener este objeto, use el cmdlet Get-CMSecurityScope .

Tipo:IResultObject[]
Alias:SecurityScope, SecuredCategory, Scopes, SecurityScopes, SecuredCategories
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Salidas

System.Object