共用方式為

Get-CMSecurityRole

  • 參考
模組:
ConfigurationManager

取得安全性角色。

語法

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

Description

使用此 Cmdlet 從 Configuration Manager 月臺取得一或多個安全性角色。 如需安全性角色和許可權的詳細資訊，請參閱 Configuration Manager 中以角色為基礎的系統管理基本概念。

如果您的帳戶沒有許可權可檢視站台中的安全性角色，此 Cmdlet 不會傳回任何結果。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：取得所有安全性角色

此範例會列出網站的所有角色和標識符。

Get-CMSecurityRole | Select-Object RoleID, RoleName

範例 2：使用通配符取得安全性角色

此命令會取得名稱開頭為App的所有安全性角色。

Get-CMSecurityRole -Name "App*"

範例 3：列出所有自定義安全性角色

此命令會傳回並非內建的所有安全性角色。

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

參數

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定要取得的安全性角色識別碼。 此值是 RoleID 屬性，例如 SMS000AROS部署管理員 角色。

類型:String
別名:RoleId
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Name

指定要取得的安全性角色名稱。

類型:String
別名:RoleName
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

輸入

None

輸出

IResultObject[]

IResultObject

備註

如需這個傳回物件及其屬性的詳細資訊，請 參閱SMS_Role伺服器 WMI 類別。