Remove-CMObjectSecurityScope

  • Référence
Module:
ConfigurationManager

Supprimer une étendue de sécurité d’un objet 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

Utilisez cette applet de commande pour supprimer une ou plusieurs étendues de sécurité d’un objet Configuration Manager.

Pour plus d’informations sur les étendues de sécurité, consultez Principes de base de l’administration basée sur les rôles dans Configuration Manager.

Remarque

Exécutez Configuration Manager applets de commande à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Supprimer une étendue de sécurité d’une application

La première commande obtient l’étendue de sécurité nommée Scope1 et stocke l’objet dans la variable $Scope .

La deuxième commande obtient tous les objets d’application dont le nom commence par « Central ». Il utilise ensuite l’opérateur de pipeline pour passer les objets à Remove-CMObjectSecurityScope.

La dernière commande supprime l’étendue de sécurité de chacun des objets d’application. Le paramètre Force indique que vous n’êtes pas invité avant l’exécution de l’applet de commande.

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

Exemple 3 : Ajouter une nouvelle étendue de sécurité, puis supprimer tous les autres de l’objet d’application

La première commande obtient une étendue de sécurité dans la variable TeamABCScope. La deuxième commande obtient un objet d’application pour Edge Enterprise Stable. La troisième commande ajoute le nouveau TeamABCScope à l’application. La dernière commande obtient des étendues de l’application qui ne sont pas TeamABCScope, puis les supprime toutes.

$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
  }

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-Id

Spécifiez l’ID d’une étendue de sécurité associée à un objet Configuration Manager. Cette valeur est la CategoryID propriété, par exemple SMS00UNA pour l’étendue Par défaut .

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

-InputObject

Spécifiez un tableau d’objets Configuration Manager associés à une étendue de sécurité. Pour obtenir cet objet, utilisez l’applet de commande Get pour le type d’objet . Par exemple, Get-CMApplication pour les objets d’application.

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

-Name

Spécifiez le nom d’une étendue de sécurité associée à un objet Configuration Manager.

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

-Scope

Spécifiez un tableau d’objets d’étendue de sécurité à supprimer. Pour obtenir cet objet, utilisez l’applet de commande 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

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Sorties

System.Object