Find-SCLibraryShare
Applies To: System Center 2012 - Virtual Machine Manager
Find-SCLibraryShare
Finds all of the shares on the specified 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 System Center Virtual Machine Manager (VMM) library shares.
For more information about Find-SCLibraryShare, type: "Get-Help Find-SCLibraryShare -online".
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, or 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.
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
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 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"
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"