Freigeben über

Set-SCLibraryServer

  • Referenz
Modul:
VirtualMachineManager

Legt die Eigenschaften eines VMM-Bibliotheksservers fest.

Syntax

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>]

Beschreibung

Das cmdlet Set-SCLibraryServer legt die Eigenschaften eines VMM-Bibliotheksservers (Virtual Machine Manager) fest. Sie können dieses Cmdlet auch als Teil einer Auftragsgruppe verwenden, wenn sie mit dem Cmdlet Add-SCLibraryShare verwendet wird, um eine Reihe von Bibliotheksfreigaben hinzuzufügen.

Beispiele

Beispiel 1: Ändern der Beschreibung eines Bibliotheksservers

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

Der erste Befehl ruft das Bibliotheksserverobjekt "LibraryServer01" auf VMMServer01 ab und speichert es in der $LibServer Variablen.

Der zweite Befehl ändert die Beschreibung für FileServer01 in "Bibliotheksserver für Produktion".

Beispiel 2: Aktualisieren der Beschreibung für einen Bibliotheksserver

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."

Der erste Befehl ruft das Bibliotheksserverobjekt "LibraryServer01" auf VMMServer01 ab und speichert es in der $LibServer Variablen.

Der zweite Befehl aktualisiert die Beschreibung des Bibliotheksserverobjekts, das in der variablen $LibServer gespeichert ist.

Beispiel 3: Hinzufügen eines VM-Netzwerks zu einem Bibliotheksserver

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

Der erste Befehl ruft das VM-Netzwerkobjekt mit dem Namen VMNetwork01 ab und speichert das Objekt in der $VMNetwork Variablen.

Der zweite Befehl ruft das Bibliotheksserverobjekt mit dem Namen LibraryServer01 ab und verwendet den Pipelineoperator, um das Objekt an das Set-SCLibraryServer Cmdlet zu übergeben, das VMNetwork01 dem Bibliotheksserver hinzufügt.

Parameter

-AddVMNetwork

Gibt an, dass mindestens ein VM-Netzwerk eine Netzwerkkonnektivität mit dem angegebenen Bibliotheksserver aufweist, wenn er in Verbindung mit Set-SCLibrarySerververwendet wird.

Typ:VMNetwork[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClearVMHostGroup

Setzt die Hostgruppenzuordnung für den Bibliotheksserver zurück.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für den Bibliotheksserver an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableUnencryptedFileTransfer

Gibt an, dass bei Festlegung auf "True" keine Verschlüsselung von Netzwerkdateiübertragungen erforderlich ist. Das Zulassen unverschlüsselter Netzwerkdateiübertragungen kann die Leistung verbessern, wenn weder der Quellhost noch der Zielhost Verschlüsselung erfordert.

Verwenden Sie diesen Parameter, um:

  • Aktivieren Sie unverschlüsselte Dateiübertragungen in oder aus der Bibliothek.
  • Aktivieren Sie unverschlüsselte Dateiübertragungen in, außerhalb oder innerhalb einer Hostgruppe.
Typ:Boolean
Aliase:AllowUnencryptedTransfers
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LibraryServer

Gibt ein VMM-Bibliotheksserverobjekt an.

Typ:LibraryServer
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LibraryServerManagementCredential

Gibt ein Run As-Konto für die VMM-Bibliothek an.

Typ:RunAsAccount
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveVMNetwork

Entfernt die Netzwerkkonnektivität für mindestens ein VM-Netzwerk vom angegebenen Bibliotheksserver, wenn er in Verbindung mit Set-SCVMLibrarySerververwendet wird.

Typ:VMNetwork[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMHostGroup

Gibt ein Hostgruppenobjekt eines virtuellen Computers oder ein Array von Hostgruppenobjekten an.

Typ:HostGroup
Aliase:LibraryGroup
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMNetworks

Gibt an, dass mindestens ein VM-Netzwerk eine Netzwerkkonnektivität mit dem angegebenen Bibliotheksserver aufweist, wenn er in Verbindung mit Set-SCVMLibrarySerververwendet wird.

Typ:VMNetwork[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

LibraryServer

Dieses Cmdlet gibt ein LibraryServer-Objekt zurück.

Hinweise

  • Erfordert ein VMM-Bibliotheksserverobjekt, das mithilfe des cmdlets Get-SCLibraryServer abgerufen werden kann.