New-SCStorageFileShare

Modul:

VirtualMachineManager

Erstellt eine Speicherdateifreigabe in VMM.

Syntax

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -LocalPath <String>
   [-ContinuouslyAvailable <Boolean>]
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -StoragePool <StoragePool>
   [-FileSystem <String>]
   [-DedupMode <DedupMode>]
   [-AllocationUnitSizeKB <UInt32>]
   [-StorageClassification <StorageClassification>]
   [-ReadCacheSizeMB <UInt64>]
   -JobGroup <Guid>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -StoragePool <StoragePool>
   [-FileSystem <String>]
   [-ResiliencySettingName <String>]
   [-NumberOfColumns <UInt16>]
   [-PhysicalDiskRedundancy <UInt16>]
   [-DedupMode <DedupMode>]
   [-AllocationUnitSizeKB <UInt32>]
   -SizeMB <UInt64>
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -StoragePool <StoragePool>
   [-FileSystem <String>]
   [-ResiliencySettingName <String>]
   [-NumberOfColumns <UInt16>]
   [-PhysicalDiskRedundancy <UInt16>]
   [-DedupMode <DedupMode>]
   [-AllocationUnitSizeKB <UInt32>]
   [-StorageClassification <StorageClassification>]
   -MediaType <StoragePhysicalDiskMediaType[]>
   -StorageTierSizeMB <UInt64[]>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -StorageVolume <StorageVolume>
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -HostedStoragePool <String>
   -SizeMB <UInt64>
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCStorageFileShare erstellt eine Speicherdateifreigabe in Virtual Machine Manager (VMM).

Beispiele

Beispiel 1: Erstellen einer Speicherdateifreigabe

PS C:\> $FileServer = Get-SCStorageFileServer -Name "FileServer01.Contoso.com"
PS C:\> New-SCStorageFileShare -Name "FileShare02" -StorageFileServer $FileServer -LocalPath "C:\FileShare02"

Der erste Befehl ruft das Speicherdateiserverobjekt namens FileServer01 ab und speichert das Objekt in der $FileServer Variable.

Der zweite Befehl erstellt eine Speicherdateifreigabe namens FileShare02 auf FileServer01.

Beispiel 2: Erstellen einer freigegebenen Speicherdateifreigabe auf einem freigegebenen SOFS

PS C:\> $FileServer = Get-SCStorageFileServer -Name "FileServer01.Contoso.com"
PS C:\> $StoragePool = Get-SCStoragePool -Name "Pool01"
PS C:\> New-SCStorageTier -MediaType "SSD" -SizeMB 1024  -PhysicalDiskRedundancy "2" -ResiliencySettingName "Mirror" -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e6-64a54012dce3"
PS C:\> New-SCStorageTier -MediaType "HDD" -SizeMB 1024  -PhysicalDiskRedundancy "2" -ResiliencySettingName "Parity" -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e6-64a54012dce3"
PS C:\> $StorageClassification = Get-SCStorageClassification -Name "Gold"
PS C:\> $StorageFileShare = New-SCStorageFileShare -StorageFileServer $FileServer -StoragePool $StoragePool -Name "FileShare01" -Description "shared SOSF" -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e664a54012dce3" -FileSystem "CSVFS_ReFS" -StorageClassification $StorageClassification

Der erste Befehl ruft das Speicherdateiserverobjekt namens FileServer01 ab, und speichert sie dann in der $FileServer Variablen.

Der zweite Befehl ruft den Speicherpool namens Pool01 ab und speichert ihn dann in der $StoragePool Variablen.

Die dritten und vierten Befehle erstellen Speicherebenen.

Der fünfte Befehl ruft die Speicherklassifizierung mit dem Namen Gold ab und speichert sie dann in der $StorageClassification Variablen.

Der letzte Befehl erstellt dateifreigabe mit dem Namen FileShare01. Der Befehl verwendet Werte, die in früheren Befehlen erstellt wurden.

Beispiel 3: Erstellen einer Dateifreigabe auf einem S2D-System

PS C:\> $FileServer = Get-SCStorageFileServer -Name "FileServer01.Contoso.com"
PS C:\> $StoragePool = Get-SCStoragePool -Name "S2DPool01"
PS C:\> New-SCStorageTier -StorageTierFriendlyName "Performance" -StorageTierSizeInMB 1024 -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e6-64a54012dce3"
PS C:\> New-SCStorageTier -StorageTierFriendlyName "Capacity" -StorageTierSizeInMB 1024 -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e6-64a54012dce3"
PS C:\> $StorageClassification = Get-SCStorageClassification -Name "Gold"
PS C:\> $StorageFileShare = New-SCStorageFileShare -StorageFileServer $FileServer -StoragePool $StoragePool -Name "FileShare01" -Description "storage spaces direct config" -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e664a54012dce3" -FileSystem "CSVFS_ReFS" -StorageClassification $StorageClassification"

Der erste Befehl ruft das Speicherdateiserverobjekt namens FileServer01 ab, und speichert sie dann in der $FileServer Variablen.

Der zweite Befehl ruft den Speicherpool namens S2DPool01 ab, und speichert ihn dann in der $StoragePool Variablen. Dies ist ein direktes Speicherpool.

Die dritten und vierten Befehle erstellen Speicherebenen.

Der fünfte Befehl ruft die Speicherklassifizierung mit dem Namen Gold ab und speichert sie dann in der $StorageClassification Variablen.

Der letzte Befehl erstellt dateifreigabe mit dem Namen FileShare01. Der Befehl verwendet Werte, die in früheren Befehlen erstellt wurden.

Parameter

-AllocationUnitSizeKB

Gibt die Zuordnungsgröße eines Volumens in Kilobyte an.

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

-ContinuouslyAvailable

Gibt an, ob die Dateifreigabe kontinuierlich verfügbar ist.

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

-DedupMode

Anwenden der Deduplizierung auf der Volume- oder Dateifreigabe basierend auf der Arbeitslast. Zulässige Werte für diesen Parameter:

• 0 – Deaktiviert
• 1 - GeneralPurpose
• 2 – Hyper-V
• 3 – Sicherung

Type:	DedupMode
Accepted values:	Disabled, GeneralPurpose, HyperV, Backup, NotAvailable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Gibt eine Beschreibung für die Speicherdateifreigabe an.

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

-FileSystem

Gibt das Dateisystem eines Speichervolumens an. Zulässige Werte für diesen Parameter:

• CSVFS_NTFS
• CSVFS_ReFS

Type:	String
Accepted values:	CSVFS_NTFS, CSVFS_ReFS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostedStoragePool

Gibt einen gehosteten Speicherpool an.

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-LocalPath

Gibt einen lokalen Pfad für eine Speicherdateifreigabe an.

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

-MediaType

Gibt ein Array physischer Datenträgermedientypenobjekte an.

Type:	StoragePhysicalDiskMediaType[]
Accepted values:	Unknown, HDD, SSD
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Gibt den Namen eines VMM-Objekts an.

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

-NumberOfColumns

Gibt die Anzahl der Spalten für einen virtuellen Datenträger an.

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

-PhysicalDiskRedundancy

Gibt die Anzahl physischer Datenträgerfehler an, die ein virtueller Datenträger erhalten kann.

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

-PROTipID

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

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

-ReadCacheSizeMB

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

-ResiliencySettingName

Gibt die Resilienzeinstellung für einen virtuellen Datenträger an. Zulässige Werte für diesen Parameter:

• Einfach
• Spiegel
• Parität

Type:	String
Accepted values:	Simple, Mirror, Parity
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-SizeMB

Gibt die Größe eines Speicherdateifreigabes in Megabytes an.

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

-StorageClassification

Gibt ein Speicherklassifizierungsobjekt an.

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

-StorageFileServer

Gibt ein Speicherdateiserverobjekt an.

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

-StoragePool

Gibt ein Speicherpoolobjekt an.

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

-StorageTierSizeMB

Gibt die Größe der Speicherebene in MB an.

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

-StorageVolume

Gibt ein Speichervolumenobjekt auf einem bestimmten virtuellen Computerhost an.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

Ähnliche Themen

• Get-SCStorageFileShare
• Register-SCStorageFileShare
• Remove-SCStorageFileShare
• Repair-SCStorageFileShare
• Set-SCStorageFileShare
• Unregister-SCStorageFileShare