Remove-SCServicingWindowSubscription

  • リファレンス
モジュール:
VirtualMachineManager

仮想マシン、ホスト、またはサービスからサービス ウィンドウを削除します。

構文

Remove-SCServicingWindowSubscription
      [-ServicingWindow] <ServicingWindow>
      -VM <VM>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCServicingWindowSubscription
      [-ServicingWindow] <ServicingWindow>
      -VMHost <Host>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCServicingWindowSubscription
      [-ServicingWindow] <ServicingWindow>
      -Service <Service>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-SCServicingWindowSubscription コマンドレットは、仮想マシン、ホスト、またはサービスからサービス ウィンドウを削除します。

例

例 1: 指定したユーザーが所有するすべての仮想マシンからサービス ウィンドウ サブスクリプションを削除する

PS C:\> $SvcWindow = Get-SCServicingWindow -Name "Backup Staging A"
PS C:\> Get-SCVirtualMachine | where {$_.Owner -eq "Contoso\ReneeLo"} | Remove-SCServicingWindowSubscription -ServicingWindow $SvcWindow

最初のコマンドは、Backup Staging A という名前のサービス ウィンドウ オブジェクトを取得し、そのオブジェクトを $SvcWindow 変数に格納します。

2 番目のコマンドは、すべての仮想マシン オブジェクトを取得し、Contoso\ReneeLo が所有する仮想マシンのみを選択し、パイプライン オペレーターを使用して仮想マシンを Remove-SCServicingWindowSubscription コマンドレットに渡します。これにより、$SvcWindowに格納されているサービス ウィンドウのすべてのサブスクリプションが、渡される各仮想マシンから削除されます。

パラメーター

-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

-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

-Service

Virtual Machine Manager (VMM) サービス オブジェクトを指定します。

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

-ServicingWindow

サービス ウィンドウ オブジェクトを指定します。

Type:ServicingWindow
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

仮想マシン オブジェクトを指定します。

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

-VMHost

仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされます。

各種類のホストの詳細については、 Add-SCVMHost コマンドレットを参照してください。

Type:Host
Position:Named
Default value:None
Required:True
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

メモ

  • Get-SCServicingWindow コマンドレットで取得できる VMM サービス ウィンドウ サブスクリプション オブジェクトが必要です。