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"