Get-SCOMUserRole
ユーザー ロールを取得します。
構文
Get-SCOMUserRole
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMUserRole
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMUserRole
-Id <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMUserRole
-Name <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
説明
Get-SCOMUserRole コマンドレットは、ユーザー ロールを取得します。 ユーザー ロールは、次の 2 つの要素を組み合わせたものになります。
- プロフィール。 ユーザー ロールがアクセスできる操作のコレクションを定義します。
- スコープ。 プロファイル操作の境界を定義します。たとえば、タスクやグループなどです。
例
例 1: ロールのユーザー ロール情報を取得する
PS C:\>Get-SCOMUserRole -Name "OperationsManagerReadOnlyOperators"
このコマンドは、OperationsManagerReadOnlyOperators という名前のユーザー ロールの情報を取得します。
パラメーター
-ComputerName
コンピューターの名前の配列を指定します。 コマンドレットは、これらのコンピューターの管理グループとの一時的な接続を確立します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。
コンピューターは System Center Data Access サービスを実行する必要があります。
このパラメーターを指定しない場合、既定値は現在の管理グループ接続のコンピューターです。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Credential
管理グループ接続を実行するユーザー アカウントを指定します。
Get-Credential コマンドレットから返されるオブジェクトなど、PSCredential オブジェクトをこのパラメーターに指定します。
資格情報オブジェクトの詳細については、「Get-Help Get-Credential
」と入力します。
ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。
型: | PSCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisplayName
ユーザー ロール オブジェクトの表示名を含む配列を指定します。 このコマンドレットは、配列内の各文字列を受け取り、このコマンドレットが使用するユーザー ロール オブジェクトの表示名の一致を検索します。 このパラメーターの値は、Windows PowerShell を実行するユーザーの管理グループとロケールにインポートされるローカライズされた管理パックによって異なります。
型: | String[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
ユーザー ロール オブジェクトの ID の配列を指定します。 このコマンドレットは、配列内の各グローバル一意識別子 (GUID) を受け取り、コマンドレットが取得するユーザー ロール オブジェクトの ID プロパティとの一致を検索します。
型: | Guid[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
ユーザー ロール オブジェクトの名前を含む配列を指定します。 このコマンドレットは、配列内の各文字列を受け取り、コマンドレットが取得するユーザー ロール オブジェクトの Name プロパティとの一致を検索します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SCSession
Connection オブジェクトの配列
このパラメーターの値を指定しない場合、コマンドレットは管理グループへのアクティブな永続的な接続を使用します。
SCSession パラメーターを使用して、別の永続的な接続を指定します。
ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。
詳細については、「Get-Help about_OpsMgr_Connections
」と入力します。
型: | Connection[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |