Register-SmisProvider

Register-SmisProvider

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

Syntax

Parameter Set: Default
Register-SmisProvider [-ConnectionUri] <Uri> [-Credential] <PSCredential> [[-AdditionalUsers] <String[]> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed 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.

Parameters

-AdditionalUsers<String[]>

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

-ConnectionUri<Uri>

Specifies the URI of the SMI-S provider to register. For CIMXML-based providers, the format must include the protocol specifier (HTTPS and HTTP are supported). The port number for such providers should also be specified, but can be omitted if the default SMI-S ports are used (5989 for HTTPS and 5988 for HTTP). The ConnectionUri is just the server name for SMI-S providers implemented as WMI providers.

-Credential<PSCredential>

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

-Force

Performs the action without a confirmation message.

-Confirm

Prompts you for confirmation before running the cmdlet.

-WhatIf

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

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

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.

Examples

Example 1: Register an SMI-S provider

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

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

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

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.

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

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

PS C:\> $password = ConvertTo-SecureString "p@ssword" -AsPlainText -Force 


PS C:\>$cred = New-Object System.Management.Automation.PSCredential "admin", $password


PS C:\>Register-SmisProvider -ConnectionUri ContosoServer1 -Credential $cred

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

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

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

Related topics

Search-SmisProvider

Unregister-SmisProvider

Get-StorageProvider

Update-StorageProviderCache