Unregister-SCStorageFileShare

Modul:
VirtualMachineManager Module

Hebt die Registrierung einer Speicherdateifreigabe bei einem VM-Host, Cluster oder Bibliothekserver auf.

Syntax

UnregisterFromHost (Standardwert) 

Unregister-SCStorageFileShare
    [-StorageFileShare] <StorageFileShare>
    -VMHost <Host>
    [-RemovePermissionsFromShare]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

UnregisterFromLibrary 

Unregister-SCStorageFileShare
    [-StorageFileShare] <StorageFileShare>
    -LibraryServer <LibraryServer>
    [-RemovePermissionsFromShare]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

UnregisterFromCluster 

Unregister-SCStorageFileShare
    [-StorageFileShare] <StorageFileShare>
    -VMHostCluster <HostCluster>
    [-RemovePermissionsFromShare]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Unregister-SCStorageFileShare wird die Registrierung einer Speicherdateifreigabe bei einem Host, Cluster oder Bibliothekserver eines virtuellen Computers aufgehoben.

Beispiele

Beispiel 1: Aufheben der Registrierung einer Speicherdateifreigabe bei einem Bibliothekserver

PS C:\> $FileShare = Get-SCStorageFileShare -Name "FileShare01"
PS C:\> $LibServer = Get-SCLibraryServer -ComputerName "LibraryServer01.Contoso.com"
PS C:\> Unregister-SCStorageFileShare -StorageFileShare $FileShare -LibraryServer $LibServer

Der erste Befehl ruft das Speicherdateifreigabeobjekt mit dem Namen FileShare01 ab und speichert das Objekt in der Variablen $FileShare.

Mit dem zweiten Befehl wird das VMM-Bibliothekserverobjekt mit dem Namen LibraryServer01 abgerufen und in der Variablen $LibServer gespeichert.

Mit dem letzten Befehl wird die Registrierung von FileShare01 bei LibraryServer01 aufgehoben.

Parameter

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz ausgeführt werden, kurz bevor der letzte Befehl ausgeführt wird, der denselben Auftragsgruppenbezeichner enthält.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-LibraryServer

Gibt ein Virtual Machine Manager (VMM)-Bibliothekserverobjekt an.

Parametereigenschaften

Typ:LibraryServer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

UnregisterFromLibrary
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RemovePermissionsFromShare

Gibt an, dass Berechtigungen aus der Dateifreigabe entfernt wurden.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StorageFileShare

Gibt eine Speicherdateifreigabe an.

Parametereigenschaften

Typ:StorageFileShare
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMHost

Gibt ein Hostobjekt für eine virtuelle Maschine an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu den einzelnen Hosttypen finden Sie unter dem Cmdlet Add-SCVMHost .

Parametereigenschaften

Typ:Host
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

UnregisterFromHost
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMHostCluster

Gibt ein VMM-Hostclusterobjekt an.

Parametereigenschaften

Typ:HostCluster
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

UnregisterFromCluster
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.