Get-CMSecurityRole

  • リファレンス
モジュール:
ConfigurationManager

セキュリティ ロールを取得します。

構文

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

説明

Configuration Manager サイトから 1 つ以上のセキュリティ ロールを取得するには、このコマンドレットを使用します。 セキュリティ ロールとアクセス許可の詳細については、「Configuration Manager の役割ベースの管理の基本」 を参照してください。

アカウントにサイト内のセキュリティ ロールを表示するアクセス許可がない場合、このコマンドレットは結果を返します。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: すべてのセキュリティ ロールを取得する

次の使用例は、サイトのすべての役割と ID を一覧表示します。

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
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

取得するセキュリティ ロールの ID を指定します。 この値は、OS Deployment Manager の役割など、 RoleID SMS000AR プロパティ です。

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

取得するセキュリティ ロールの名前を指定します。

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

入力

なし

出力

IResultObject[]

IResultObject

メモ

この戻り値オブジェクトとそのプロパティの詳細については、「SMS_Role WMI クラス」を参照してください。