Remove-SCServiceConfiguration

VMM ライブラリからサービス構成オブジェクトを削除します。

構文

Remove-SCServiceConfiguration
      [-VMMServer <ServerConnection>]
      [-ServiceConfiguration] <ServiceConfiguration>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

説明

Remove-SCServiceConfiguration コマンドレットは、Virtual Machine Manager (VMM) ライブラリから 1 つ以上のサービス構成オブジェクトを削除します。

例 1: ライブラリから特定のサービス構成オブジェクトを削除する

PS C:\> $SvcConfig = Get-SCServiceConfiguration -VMMServer "VMMServer01.Contoso.com" -Name "Service01"
PS C:\> Remove-SCServiceConfiguration -ServiceConfiguration $SvcConfig -Confirm

最初のコマンドは、Service01 という名前のサービス構成オブジェクトを取得し、そのオブジェクトを $SvcConfig 変数に格納します。

2 番目のコマンドは、$SVCCONFIGに格納されているサービス構成オブジェクトを VMM データベースから削除し、対応するサービス構成オブジェクトとライブラリ内の他のすべての関連オブジェクトを削除します。 サービス構成オブジェクトが削除される前に、確認プロンプトが表示されます。

例 2: すべてのサービス構成オブジェクトを削除する

PS C:\> $SvcConfigs = Get-SCServiceConfiguration -VMMServer "VMMServer01.Contoso.com"
PS C:\> $SvcConfigs | Remove-SCServiceConfiguration -Confirm

最初のコマンドは、VMMServer01 上のすべてのサービス構成オブジェクトを取得し、そのオブジェクトを $SvcConfigs 変数に格納します。

2 番目のコマンドは、$SvcConfigsに格納されているすべてのサービス構成オブジェクトを削除し、ライブラリ内の他のすべての関連オブジェクトを削除します。 サービス構成オブジェクトが削除される前に、確認プロンプトが表示されます。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-OnBehalfOfUser

ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーに代わって動作します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。

Type:UserRole
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

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceConfiguration

サービス構成オブジェクトを指定します。

Type:ServiceConfiguration
Position:0
Default value:None
Required:True
Accept pipeline input:True
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