Edit

Register-SmisProvider

  • Reference
Module:
SMISConfig

Registers an SMI-S provider and stores the configuration in the SMI-S service.

Syntax

Register-SmisProvider
        [-ConnectionUri] <Uri>
        [-Credential] <PSCredential>
        [[-AdditionalUsers] <String[]>]
        [[-CimSession] <CimSession>]
        [-Force]
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]

Description

The Register-SmisProvider cmdlet registers a Storage Management Initiative - Specification (SMI-S) provider. The cmdlet registers a provider identified by a Uniform Resource Identifier (URI), and stores the configuration and credentials for later use. In order to use a provider, you must register the provider with the SMI-S service.

When you register the provider, the credentials are stored for your use only. You can also specify other users to manage the registered provider.

To search for a list of SMI-S providers on the same subnet as your server, use the Search-SmisProvider cmdlet.

If the provider is using the HTTPS protocol, you may be prompted to accept the certificate if it has not been previously seen by your server.

Examples

Example 1: Register an SMI-S provider

PS C:\> Register-SmisProvider -ConnectionUri https://smis.contoso.com:5989

This command registers an SMI-S provider by using a URI.

Example 2: Register an SMI-S WMI provider in an automated script

PS C:\> $Password = ConvertTo-SecureString "password" -AsPlainText -Force
PS C:\> $Credential = New-Object System.Management.Automation.PSCredential "admin", $Password
PS C:\> Register-SmisProvider -ConnectionUri ContosoServer17 -Credential $Credential

This example registers an SMI-S WMI provider.

The first command converts a string to a secure string and assigns the result to the variable $Password. For more information, type Get-Help ConvertTo-SecureString.

The second command creates a new credential object by using the $Password variable and assigns the result to the variable $Credential.

The third command registers an SMI-S provider by using the variable $Credential.

Example 3: Discover the storage objects managed by a registered provider

PS C:\> Update-StorageProviderCache -Name "smis.contoso.com" -DiscoveryLevel Level3

This command discovers the managed objects under a registered SMI-S provider.

Parameters

-AdditionalUsers

Specifies an array of other users who can manage the SMI-S provider. The cmdlet stores the credentials, specified by the Credentials parameter, for the users that you specify.

Type:String[]
Aliases:Users
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Type:CimSession
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-ConnectionUri

Specifies the URI of the SMI-S provider to register. For CIMXML-based providers, the format must include the protocol specifier. The parameter supports HTTPS and HTTP. The port number for such providers should also be specified. You can omit default SMI-S ports, which are 5989 for HTTPS and 5988 for HTTP. The ConnectionUri is the server name for SMI-S providers implemented as WMI providers.

Type:Uri
Aliases:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Specifies the credentials used to for authentication with the SMI-S provider. The cmdlet stores the credentials for subsequent use.

Type:PSCredential
Aliases:Creds
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Force

Forces the command to run without asking for user confirmation.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Inputs

Uri

PSCredential

String[]

Outputs

Object