Get-CMSecurityRole

  • 參考
模組:
ConfigurationManager

取得安全性角色。

Syntax

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結合。

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

-ForceWildcardHandling

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

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

-Id

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

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

-Name

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

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

輸入

None

輸出

IResultObject[]

IResultObject

備註

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