次の方法で共有


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