Condividi tramite


Get-CMSecurityRole

Ottenere i ruoli di sicurezza.

Sintassi

Get-CMSecurityRole
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSecurityRole
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per ottenere uno o più ruoli di sicurezza dal sito di Configuration Manager. Per altre informazioni sui ruoli di sicurezza e sulle autorizzazioni, vedere Nozioni fondamentali sull'amministrazione basata su ruoli in Configuration Manager.

Se l'account non dispone delle autorizzazioni per visualizzare i ruoli di sicurezza nel sito, questo cmdlet non restituisce alcun risultato.

Nota

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

Esempio

Esempio 1: Ottenere tutti i ruoli di sicurezza

Questo esempio elenca tutti i ruoli e gli ID per il sito.

Get-CMSecurityRole | Select-Object RoleID, RoleName

Esempio 2: Ottenere un ruolo di sicurezza usando un carattere jolly

Questo comando ottiene tutti i ruoli di sicurezza con un nome che inizia con App.

Get-CMSecurityRole -Name "App*"

Esempio 3: Elencare tutti i ruoli di sicurezza personalizzati

Questo comando restituisce tutti i ruoli di sicurezza non predefiniti.

Get-CMSecurityRole | Where-Object { $_.IsBuiltIn -eq $false }

Parametri

-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

-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 del ruolo di sicurezza da ottenere. Questo valore è la RoleID proprietà , ad esempio SMS000AR per il ruolo Gestione distribuzione del sistema operativo.

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

-Name

Specificare il nome del ruolo di sicurezza da ottenere.

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

Input

None

Output

IResultObject[]

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_Role classe WMI del server.