Share via

Add-SCStorageProvider

Module:
VirtualMachineManager Module

Adds a storage provider to VMM.

Syntax

AddSmisCimXmlProvider (Default) 

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

AddSmisWmiProvider 

Add-SCStorageProvider
    -Name <String>
    -RunAsAccount <RunAsAccount>
    -ComputerName <String>
    [-Description <String>]
    [-AddSmisWmiProvider]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

AddWindowsNativeWmiProvider 

Add-SCStorageProvider
    -Name <String>
    -RunAsAccount <RunAsAccount>
    -ComputerName <String>
    [-Description <String>]
    [-IsNonTrustedDomain]
    [-AddWindowsNativeWmiProvider]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddSmisWmiProvider
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AddWindowsNativeWmiProvider

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddWindowsNativeWmiProvider
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Certificate

Specifies a security certificate object.

Parameter properties

Type:ClientCertificate
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddSmisCimXmlProvider
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddSmisWmiProvider
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
AddWindowsNativeWmiProvider
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Description

Specifies a description for the storage provider.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Fabric

Indicates Fibre Channel fabric.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddSmisCimXmlProvider
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-IsNonTrustedDomain

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddWindowsNativeWmiProvider
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-JobVariable

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the name of a VMM object.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NetworkDeviceName

Specifies the name of a network device.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddSmisCimXmlProvider
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RunAsAccount

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

Parameter properties

Type:RunAsAccount
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RunAsynchronously

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-TCPPort

Specifies a numeric value that represents a TCP port.

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddSmisCimXmlProvider
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

StorageProvider

This cmdlet returns a StorageProvider object.