Find-SCLibraryShare

Find-SCLibraryShare

Finds shares on a computer or library server that can be added as library shares.

Syntax

Parameter Set: New
Find-SCLibraryShare [-ComputerName] <String> -Credential <VMMCredential> [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: Existing
Find-SCLibraryShare -LibraryServer <LibraryServer> [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed Description

The Find-SCLibraryShare cmdlet finds all of the shares on the specified computer or library server that can be added as library shares. For library servers, this command also returns shares that are already Virtual Machine Manager (VMM) library shares.

Parameters

-ComputerName<String>

Specifies the name of a computer that VMM can uniquely identify on your network. Valid formats are:

-- FQDN
-- IPv4 or IPv6 address
-- NetBIOS name

Note: See the examples for a specific cmdlet to determine how that cmdlet specifies the computer name.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Credential<VMMCredential>

Specifies a credential object or, for some cmdlets, a Run As account object that contains the user name and password of an account that has permission to perform this action. Or, in the case of Restart-SCJob, has permission to complete a restarted task.

For more information about the PSCredential object, type Get-Help Get-Credential.

For more information about Run As accounts, type Get-Help New-SCRunAsAccount.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-LibraryServer<LibraryServer>

Specifies a VMM library server object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a VMM server object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • DiscoveredShare[]

Examples

Example 1: Find Windows shares on a computer that is not yet a VMM library server

The first command uses Get-Credential to prompt you to supply a user name and password with permissions to access Windows shares on Server01, and then stores your credentials in the $Credential variable.

The second command confirms that you have valid credentials for this operation, and then displays all existing Windows shares capable of becoming VMM library shares.

PS C:\> $Credential = Get-Credential
PS C:\> Find-SCLibraryShare -Credential $Credential -ComputerName "Server01.Contoso.com"

Example 2: Find shares on a VMM library server

This command displays all Windows shares capable of becoming library shares that exist on LibraryServer01 as well as all shares that are already VMM library shares.

PS C:\> Find-SCLibraryShare -LibraryServer "LibraryServer01.Contoso.com"

Add-SCLibraryServer

Add-SCLibraryShare