Remove-CMObjectSecurityScope

  • Referencia
Módulo:
ConfigurationManager

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

Syntax

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 Configuration Manager.

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

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:String
Aliases:SecurityScopeId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique una matriz de Configuration Manager objetos 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.

Type:IResultObject[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Aliases:SecurityScopeName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 .

Type:IResultObject[]
Aliases:SecurityScope, SecuredCategory, Scopes, SecurityScopes, SecuredCategories
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Salidas

System.Object