Set-SCLibraryServer

モジュール:

VirtualMachineManager

VMM ライブラリ サーバーのプロパティを設定します。

構文

Set-SCLibraryServer
   [-LibraryServerManagementCredential <RunAsAccount>]
   [-LibraryServer] <LibraryServer>
   [-Description <String>]
   [-VMHostGroup <HostGroup>]
   [-ClearVMHostGroup]
   [-JobGroup <Guid>]
   [-EnableUnencryptedFileTransfer <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCLibraryServer
   [-LibraryServerManagementCredential <RunAsAccount>]
   [-LibraryServer] <LibraryServer>
   [-Description <String>]
   [-VMHostGroup <HostGroup>]
   [-ClearVMHostGroup]
   [-JobGroup <Guid>]
   -VMNetworks <VMNetwork[]>
   [-EnableUnencryptedFileTransfer <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCLibraryServer
   [-LibraryServerManagementCredential <RunAsAccount>]
   [-LibraryServer] <LibraryServer>
   [-Description <String>]
   [-VMHostGroup <HostGroup>]
   [-ClearVMHostGroup]
   [-JobGroup <Guid>]
   -AddVMNetwork <VMNetwork[]>
   [-EnableUnencryptedFileTransfer <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCLibraryServer
   [-LibraryServerManagementCredential <RunAsAccount>]
   [-LibraryServer] <LibraryServer>
   [-Description <String>]
   [-VMHostGroup <HostGroup>]
   [-ClearVMHostGroup]
   [-JobGroup <Guid>]
   -RemoveVMNetwork <VMNetwork[]>
   [-EnableUnencryptedFileTransfer <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

Set-SCLibraryServer コマンドレットは、Virtual Machine Manager (VMM) ライブラリ サーバーのプロパティを設定します。 このコマンドレットは、 Add-SCLibraryShare コマンドレットと共に使用するジョブ グループの一部として使用して、ライブラリ共有のセットを追加することもできます。

例

例 1: ライブラリー・サーバーの説明を変更する

PS C:\> $LibServer = Get-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" -ComputerName "LibraryServer01.Contoso.com"
PS C:\> Set-SCLibraryServer -LibraryServer $LibServer -Description "Library server for Production"

最初のコマンドは、VMMServer01 上の LibraryServer01 という名前のライブラリ サーバー オブジェクトを取得し、$LibServer変数に格納します。

2 番目のコマンドは、FileServer01 の説明を "Library server for Production" に変更します。

例 2: ライブラリ サーバーの説明を更新する

PS C:\> $LibServer = Get-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" -ComputerName "LibraryServer01.Contoso.com"
PS C:\> Set-SCLibraryServer -LibraryServer $LibServer -Description "The library server is used by the Seattle office."

最初のコマンドは、VMMServer01 上の LibraryServer01 という名前のライブラリ サーバー オブジェクトを取得し、$LibServer変数に格納します。

2 番目のコマンドは、$LibServer変数に格納されているライブラリ サーバー オブジェクトの説明を更新します。

例 3: ライブラリ サーバーに VM ネットワークを追加する

PS C:\> $VMNetwork = Get-SCVMNetwork -Name "VMNetwork01"
PS C:\> Get-SCLibraryServer -ComputerName "LibraryServer01.Contoso.com" | Set-SCLibraryServer -AddVMNetwork $VMNetwork

最初のコマンドは、VMNetwork01 という名前の VM ネットワーク オブジェクトを取得し、そのオブジェクトを $VMNetwork 変数に格納します。

2 番目のコマンドは、LibraryServer01 という名前のライブラリ サーバー オブジェクトを取得し、パイプライン演算子を使用してオブジェクトを Set-SCLibraryServer コマンドレットに渡します。このコマンドレットは、VMNetwork01 をライブラリ サーバーに追加します。

パラメーター

-AddVMNetwork

Set-SCLibraryServer と組み合わせて使用する場合に、1 つ以上の VM ネットワークが指定されたライブラリ サーバーにネットワーク接続されていることを指定します。

Type:	VMNetwork[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearVMHostGroup

ライブラリ サーバーのホスト グループの関連付けをリセットします。

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

-Description

ライブラリ サーバーの説明を指定します。

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

-EnableUnencryptedFileTransfer

True に設定すると、ネットワーク ファイル転送で暗号化が不要であることを示します。 暗号化されていないネットワーク ファイル転送を許可すると、ソース ホストと宛先ホストのどちらも暗号化が必要なければ、パフォーマンスが向上します。

次の場合は、このパラメーターを使用します。

• ライブラリとの間で暗号化されていないファイル転送を有効にします。
• ホスト グループとの間、またはホスト グループ内での暗号化されていないファイル転送を有効にします。

Type:	Boolean
Aliases:	AllowUnencryptedTransfers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobGroup

同じジョブ グループ識別子を含む最後のコマンドが実行される直前に一括して実行される、一連のコマンドの識別子を指定します。

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

-LibraryServer

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

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

-LibraryServerManagementCredential

VMM ライブラリの実行アカウントを指定します。

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

-RemoveVMNetwork

Set-SCVMLibraryServer と組み合わせて使用すると、指定したライブラリ サーバーから 1 つ以上の VM ネットワークのネットワーク接続を削除します。

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

-VMHostGroup

仮想マシン ホスト グループ オブジェクトまたはホスト グループ オブジェクトの配列を指定します。

Type:	HostGroup
Aliases:	LibraryGroup
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMNetworks

Set-SCVMLibraryServer と組み合わせて使用する場合、1 つ以上の VM ネットワークが、指定されたライブラリ サーバーにネットワーク接続可能であることを指定します。

Type:	VMNetwork[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

出力

LibraryServer

このコマンドレットは LibraryServer オブジェクトを返します。

メモ

• Get-SCLibraryServer コマンドレットを使用して取得できる VMM ライブラリ サーバー オブジェクトが必要です。

関連リンク

• Add-SCLibraryServer
• Get-SCLibraryServer
• Remove-SCLibraryServer