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 サービスを実行する必要があります。
このパラメーターを指定しない場合、既定値は現在の管理グループ接続のコンピューターです。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
管理グループ接続を実行するユーザー アカウントを指定します。
このパラメーターに対して、Get-Credential コマンドレットから返される PSCredential オブジェクト ( Get-Credential コマンドレットが返すオブジェクトなど) を指定します。
資格情報オブジェクトの詳細については、「.」と入力します Get-Help Get-Credential
。
ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
ユーザー ロール オブジェクトの表示名を含む配列を指定します。 このコマンドレットは、配列内の各文字列を受け取り、このコマンドレットが使用するユーザー ロール オブジェクトの表示名の一致を探します。 このパラメーターの値は、管理グループにインポートされるローカライズされた管理パックと、Windows PowerShellを実行するユーザーのロケールによって異なります。
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
ユーザー ロール オブジェクトの ID の配列を指定します。 このコマンドレットは、配列内の各グローバル一意識別子 (GUID) を受け取り、コマンドレットが取得するユーザー ロール オブジェクトの ID プロパティとの一致を探します。
Type: | Guid[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
ユーザー ロール オブジェクトの名前を含む配列を指定します。 このコマンドレットは、配列内の各文字列を受け取り、コマンドレットが取得するユーザー ロール オブジェクトの Name プロパティとの一致を探します。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SCSession
Connection オブジェクトの配列を指定します。 接続オブジェクトを取得するには、Get-SCOMManagementGroupConnection コマンドレットを指定します。
このパラメーターの値を指定しない場合、コマンドレットは管理グループへのアクティブな永続的な接続を使用します。
SCSession パラメーターを使用して、別の永続接続を指定します。
ComputerName パラメーターと資格情報パラメーターを使用して、管理グループへの一時的な接続を作成できます。
詳細を表示するには「Get-Help about_OpsMgr_Connections
」を入力します。
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |