Register-Smis
Provider
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.
Required Parameters
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 |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
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 |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
Optional Parameters
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 |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Forces the command to run without asking for user confirmation.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |