Share via

Add-SCStorageProvider

  • Reference
Module:
VirtualMachineManager

Adds a storage provider to VMM.

Syntax

Add-SCStorageProvider
   [-Fabric]
   -Name <String>
   [-Description <String>]
   -RunAsAccount <RunAsAccount>
   -NetworkDeviceName <String>
   -TCPPort <UInt32>
   [-Certificate <ClientCertificate>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCStorageProvider
   -Name <String>
   [-Description <String>]
   -RunAsAccount <RunAsAccount>
   -ComputerName <String>
   [-AddSmisWmiProvider]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCStorageProvider
   -Name <String>
   [-Description <String>]
   -RunAsAccount <RunAsAccount>
   -ComputerName <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 2019 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
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AddWindowsNativeWmiProvider

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

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

-Certificate

Specifies a security certificate object.

Type:ClientCertificate
Position:Named
Default value:None
Required:False
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
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specifies a description for the storage provider.

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

-Fabric

Indicates Fibre Channel fabric.

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

-IsNonTrustedDomain

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the name of a VMM object.

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

-NetworkDeviceName

Specifies the name of a network device.

Type:String
Position:Named
Default value:None
Required:True
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
Position:Named
Default value:None
Required:False
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
Position:Named
Default value:None
Required:True
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TCPPort

Specifies a numeric value that represents a TCP port.

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

Outputs

StorageProvider

This cmdlet returns a StorageProvider object.