Get-SmbShare

Get-SmbShare

Retrieves the Server Message Block (SMB) shares on the computer.

Syntax

Parameter Set: Query (cdxml)
Get-SmbShare [[-Name] <String[]> ] [[-ScopeName] <String[]> ] [-AsJob] [-AvailabilityType <AvailabilityType[]> ] [-CachingMode <CachingMode[]> ] [-CaTimeout <UInt32[]> ] [-CimSession <CimSession[]> ] [-ConcurrentUserLimit <UInt32[]> ] [-ContinuouslyAvailable <Boolean[]> ] [-EncryptData <Boolean[]> ] [-FolderEnumerationMode <FolderEnumerationMode[]> ] [-IncludeHidden] [-Scoped <Boolean[]> ] [-ShareState <ShareState[]> ] [-Special <Boolean[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Detaillierte Beschreibung

The Get-SMBShare cmdlet retrieves objects that represent the Server Message Block (SMB) shares being displayed by the computer.

Parameter

-AsJob

-AvailabilityType<AvailabilityType[]>

Specifies the cluster type of the shares being enumerated.

-CachingMode<CachingMode[]>

Specifies the caching mode of the shares being enumerated.

-CaTimeout<UInt32[]>

Specifies the continuous availability timeout of the shares being enumerated.

-CimSession<CimSession[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-ConcurrentUserLimit<UInt32[]>

Specifies the concurrent user limit of the shares being enumerated.

-ContinuouslyAvailable<Boolean[]>

Indicates that the shares being enumerated should be continuously available.

-EncryptData<Boolean[]>

Indicates that the shares being enumerated should be encrypted.

-FolderEnumerationMode<FolderEnumerationMode[]>

Specifies the folder enumeration mode of the shares being enumerated.

-IncludeHidden

Indicates that shares that are created and used internally are also enumerated.

-Name<String[]>

Specifies one or more SMB shares by share name.

-Scoped<Boolean[]>

Indicates that the shares to be numerated should be scoped.

-ScopeName<String[]>

Specifies the scope of the share by name.

-ShareState<ShareState[]>

Specifies the state of the shares being enumerated.

-Special<Boolean[]>

Indicates that the shares to be numerated should be special. Admin share, default shares, IPC$ share are examples of special shares.

-ThrottleLimit<Int32>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

• System.String

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/SMB/MSFT_SmbShare

  Das Microsoft.Management.Infrastructure.CimInstance-Objekt ist eine Wrapperklasse, die Objekte der Windows-Verwaltungsinstrumentation (WMI) anzeigt. Der Pfad nach dem Nummernzeichen (#) stellt den Namespace und den Klassennamen des zugrunde liegenden WMI-Objekts bereit.
  The MSFT_SmbShare object represents the SMB shares on the computer.

Beispiele

EXAMPLE 1

This example retrieves the SMB shares on the computer.

PS C:\> Get-SMBShare

EXAMPLE 2

This example retrieves the SMB shares on the computer named VMS1.

PS C:\> Get-SmbShare –Name VMS1

EXAMPLE 3

This example displays the information about the SMB shares on the computer named VMS1.

PS C:\> Get-SmbShare –Name VMS1 | Format-List

EXAMPLE 4

This example displays all of the information about the SMB shares on the computer named VMS1.

PS C:\> Get-SmbShare –Name VMS1 | Format-List –Property *

EXAMPLE 5

This example retrieves the SMB shares on the computer with scaled out availability.

PS C:\> Get-SmbShare | Where-Object -Property AvailabilityType -Eq ScaleOut

EXAMPLE 6

This example retrieves the SMB shares on the computer that are connect to the SMB server named Contoso-FS.

PS C:\> Get-SmbShare -ScopeName Contoso-FS

Verwandte Themen

New-SmbShare

Remove-SmbShare

Set-SmbShare