Add-SCStorageProvider

Adds a storage provider to VMM.

Syntax

Add-SCStorageProvider [-AddSmisWmiProvider] -ComputerName <String> [-Description <String>]
 [-JobVariable <String>] -Name <String> [-PROTipID <Guid>] -RunAsAccount <RunAsAccount> [-RunAsynchronously]
 [<CommonParameters>]
Add-SCStorageProvider [-AddWindowsNativeWmiProvider] -ComputerName <String> [-Description <String>]
 [-IsNonTrustedDomain] [-JobVariable <String>] -Name <String> [-PROTipID <Guid>] -RunAsAccount <RunAsAccount>
 [-RunAsynchronously] [<CommonParameters>]
Add-SCStorageProvider [-Certificate <ClientCertificate>] [-Description <String>] [-Fabric]
 [-JobVariable <String>] -Name <String> -NetworkDeviceName <String> [-PROTipID <Guid>]
 -RunAsAccount <RunAsAccount> [-RunAsynchronously] -TCPPort <UInt32> [<CommonParameters>]

Description

The Add-SCStorageProvider cmdlet adds a storage provider to Virtual Machine Manager (VMM) by providing the connection information required to access the provider over the network.

VMM in System Center 2016 allows you to add a WMI SMI-S provider by using the AddSmisWmiProvider parameter.

Examples

Example 1: Add a storage provider by its Fully Qualified Domain Name (FQDN)

PS C:\> $RunAsAcct = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> Add-SCStorageProvider -NetworkDeviceName "http://StorProv01.Contoso.com" -TCPPort 5988 -Name "StorProv01.Contoso.com" -RunAsAccount $RunAsAcct

The first command gets the RunAs account named RunAsAccount01 and stores it in the $RunAsAcct variable.

The second command adds the storage provider named StorProv01.Contoso.com using the RunAs account stored in $RunAsAcct.

Example 2: Add a storage provider by its IP address

PS C:\> $RunAsAcct = Get-SCRunAsAccount -Name "RunAsAccount02"
PS C:\> Add-SCStorageProvider -NetworkDeviceName "http://10.10.12.23" -TCPPort 5988 -Name "StorProv02.Contoso.com" -RunAsAccount $RunAsAcct02

The first command gets the RunAs account named RunAsAccount02 and stores it in the $RunAsAcct variable.

The second command adds the storage provider with an IP address of 10.10.12.23 using the RunAsAccount stored in $RunAsAcct.

Example 3: Add a WMI SMI-S storage provider

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "AdminRAA"
PS C:\> Add-SCStorageProvider -SmisWmi -Name "StorageProvider01" -RunAsAccount $RunAsAccount -ComputerName "StorageHost01.Contoso.com"

The first command gets the Run As account object named AdminRAA and stores the object in the $RunAsAccount variable.

The second command adds the storage provider with the name StorageProvider01 using the Run Account stored in $RunAsAccount. The SmisWmi parameter indicates that this is an SMI-S storage provider.

Parameters

-AddSmisWmiProvider

Indicates that the cmdlet adds an SMIS-based WMI provider.

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

Indicates that the cmdlet adds a Windows native WMI provider implementation.

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

Specifies a security certificate object.

Type:ClientCertificate
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ComputerName

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

- FQDN (fully qualified domain name)

  • IPv4 or IPv6 address
  • NetBIOS name

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

Specifies a description for the storage provider.

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

Indicates Fibre Channel fabric.

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

Indicates that the domain is not a trusted Active Directory domain.

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

Specifies that job progress is tracked and stored in the variable named by this parameter.

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

Specifies the name of a VMM object.

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

Specifies the name of a network device.

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

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

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

Specifies a Run As account that contains credentials with permission to perform this action.

Type:RunAsAccount
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

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

Specifies a numeric value that represents a TCP port.

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

Outputs

StorageProvider

This cmdlet returns a **StorageProvider** object.