Condividi tramite

Remove-CMObjectSecurityScope

  • Riferimento
Modulo:
ConfigurationManager

Rimuovere un ambito di sicurezza da un oggetto Configuration Manager.

Sintassi

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>]

Descrizione

Utilizzare questo cmdlet per rimuovere uno o più ambiti di sicurezza da un oggetto Configuration Manager.

Per altre informazioni sugli ambiti di sicurezza, vedere Nozioni fondamentali sull'amministrazione basata su ruoli in Configuration Manager.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Rimuovere un ambito di sicurezza da un'applicazione

Il primo comando ottiene l'ambito di sicurezza denominato Scope1 e archivia l'oggetto nella variabile $Scope .

Il secondo comando ottiene tutti gli oggetti applicazione il cui nome inizia con "Central". Usa quindi l'operatore della pipeline per passare gli oggetti a Remove-CMObjectSecurityScope.

L'ultimo comando rimuove l'ambito di sicurezza da ogni oggetto applicazione. Il parametro Force indica che non viene richiesto prima dell'esecuzione del cmdlet.

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

Esempio 3: Aggiungere un nuovo ambito di sicurezza e quindi rimuovere tutti gli altri dall'oggetto applicazione

Il primo comando ottiene un ambito di sicurezza nella variabile TeamABCScope. Il secondo comando ottiene un oggetto app per Edge Enterprise Stable. Il terzo comando aggiunge il nuovo TeamABCScope all'app. L'ultimo comando ottiene gli ambiti dall'app che non sono TeamABCScope e quindi li rimuove tutti.

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

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Forza l'esecuzione del comando senza richiedere la conferma dell'utente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specificare l'ID di un ambito di sicurezza associato a un oggetto Configuration Manager. Questo valore è la CategoryID proprietà , ad esempio SMS00UNA per l'ambito Predefinito .

Tipo:String
Alias:SecurityScopeId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare una matrice di oggetti Configuration Manager associati a un ambito di sicurezza. Per ottenere questo oggetto, usare il cmdlet Get per il tipo di oggetto. Ad esempio, Get-CMApplication per gli oggetti app.

Tipo:IResultObject[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specificare il nome di un ambito di sicurezza associato a un oggetto Configuration Manager.

Tipo:String
Alias:SecurityScopeName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Scope

Specificare una matrice di oggetti ambito di sicurezza da rimuovere. Per ottenere questo oggetto, usare il cmdlet Get-CMSecurityScope .

Tipo:IResultObject[]
Alias:SecurityScope, SecuredCategory, Scopes, SecurityScopes, SecuredCategories
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Output

System.Object