Remove-SCPXEServer
VMM データベースから PXEServer オブジェクトを削除します。
構文
Remove-SCPXEServer
[-VMMServer <ServerConnection>]
[-PXEServer] <PxeServer>
-Credential <VMMCredential>
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-SCPXEServer コマンドレットは、仮想マシン マネージャー (VMM) データベースから PXEServer オブジェクトを削除し、Windows 展開サービス コンピューターから VMM エージェントをアンインストールします。 このコマンドレットは、コンピューターから Windows 展開サービスの役割を削除しません。
例
例 1: VMM PXE サーバーを削除する
PS C:\> $Credential = Get-SCRunAsAccount "RunAsAcct01"
PS C:\> $PXEServer = Get-SCPXEServer -ComputerName "WDSServer01.Contoso.com"
PS C:\> Remove-SCPXEServer -PXEServer $PXEServer -Credential $Credential -Confirm
最初のコマンドでは 、Get-Credential コマンドレットを使用して、ユーザー名とパスワードの入力を求め、指定された資格情報を $Credential 変数に格納します。 アカウントには、PXE サーバーに対するローカルの管理者アクセス許可が必要です。
2 番目のコマンドは、WDSServer01 という名前の PXE サーバー オブジェクトを作成し、$PXEServer変数にオブジェクトを格納します。
3 番目のコマンドは、$PXEServerに格納されている PXE サーバー オブジェクトを削除します。 このコマンドが処理されると、$Credentialは Remove-SCPXEServer に資格情報を提供し、 Confirm パラメーターは VMM からこの PXE サーバーを削除することを確認するように求められます。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
資格情報オブジェクトを指定するか、一部のコマンドレットでは、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。 または、 Restart-SCJob の場合、再起動されたタスクを完了するためのアクセス許可を持ちます。
PSCredential オブジェクトの詳細については、「.」と入力しますGet-Help Get-Credential
。
実行アカウントの詳細については、「.」と入力します Get-Help New-SCRunAsAccount
。
Type: | VMMCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PXEServer
PXE サーバー オブジェクトを指定します。
Type: | PxeServer |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |