Share via

Remove-CMSecurityRole

  • Riferimento
Modulo:
ConfigurationManager

Rimuovere un ruolo di sicurezza personalizzato.

Sintassi

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

Descrizione

Usare questo cmdlet per rimuovere un ruolo di sicurezza personalizzato da Configuration Manager. Specificare il nome o l'ID di un ruolo di sicurezza da rimuovere o usare il cmdlet Get-CMSecurityRole per otrne uno.

È possibile usare il cmdlet Remove-CMSecurityRole per rimuovere i ruoli di sicurezza personalizzati obsoleti e non necessari. Non è possibile rimuovere i ruoli di sicurezza predefiniti. Ogni utente amministratore deve avere almeno un ruolo di sicurezza. Prima di rimuovere un ruolo di sicurezza, assicurarsi che ogni utente abbia un ruolo oltre a quello rimosso.

Per altre informazioni sui ruoli di sicurezza e sulle autorizzazioni, 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 ruolo di sicurezza usando un nome

Questo comando rimuove un ruolo di sicurezza denominato MainSecurityRole. Il comando usa il parametro Force , quindi non richiede conferma.

Remove-CMSecurityRole -Name "MainSecurityRole" -Force

Esempio 2: Rimuovere un ruolo di sicurezza usando una variabile

Il primo comando usa il cmdlet Get-CMSecurityRole per ottenere tutti i ruoli di sicurezza che iniziano con Custome li archivia nella variabile $role .

Il secondo comando rimuove il primo ruolo di sicurezza archiviato nella matrice. Poiché non specifica il parametro Force , questo comando richiede la conferma.

$role = Get-CMSecurityRole -Name "Custom*"
Remove-CMSecurityRole -InputObject $role[1]

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-DisableWildcardHandling

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

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

-Force

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

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

-ForceWildcardHandling

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

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

-Id

Specificare l'ID del ruolo di sicurezza da rimuovere. Questo valore è la RoleID proprietà . Poiché questo cmdlet funziona solo con ruoli personalizzati, questo valore deve sempre iniziare con il codice del sito. Gli ID per i ruoli predefiniti iniziano con SMS.

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

-InputObject

Specificare un oggetto ruolo di sicurezza da rimuovere. Per ottenere questo oggetto, usare il cmdlet Get-CMSecurityRole .

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

-Name

Specificare il nome del ruolo di sicurezza da rimuovere.

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

-WhatIf

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

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object