Test-SCDomainCredential

モジュール:

VirtualMachineManager

資格情報またはユーザー名をテストして、ドメインで認証されることを確認します。

構文

Test-SCDomainCredential
    [-VMMServer <ServerConnection>]
    [-Credential] <VMMCredential>
    [<CommonParameters>]

Test-SCDomainCredential
    [-VMMServer <ServerConnection>]
    [-UserName] <String>
    [<CommonParameters>]

説明

Test-SCDomainCredential コマンドレットは、資格情報オブジェクトまたはユーザー名をテストして、ドメインで認証されることを確認します。

例

例 1: 資格情報オブジェクトの有効性をテストする

PS C:\> $Creds = Get-Credential
PS C:\> Test-SCDomainCredential -Credential $Creds

最初のコマンドは、ユーザー名とパスワードの入力を求め、PSCredential オブジェクトを作成し、そのオブジェクトを $Creds 変数に格納します。

2 番目のコマンドは、$Credsの資格情報オブジェクトを検証し、True または False を返します。

例 2: ユーザー名の有効性をテストする

PS C:\> Test-SCDomainCredential -UserName "PattiFuller"

このコマンドは、ユーザー名 PattiFuller の有効性をテストし、True または False を返します。

パラメーター

-Credential

資格情報オブジェクトを指定するか、一部のコマンドレットに対して、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。 または、Restart-SCJobの場合は、再起動されたタスクを完了するアクセス許可を持ちます。

PSCredential オブジェクトの詳細については、「Get-Help Get-Credential」と入力します。

実行アカウントの詳細については、「Get-Help New-SCRunAsAccount」と入力します。

型:	VMMCredential
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-UserName

ユーザーの名前を指定します。 Domain\User という形式のユーザー名を入力します。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-VMMServer

VMM サーバー オブジェクトを指定します。

型:	ServerConnection
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

出力

Boolean

このコマンドレットはブール値の結果を返します。