Add-SilVMHost

Add-SilVMHost

Adds and updates host information in the Software Inventory Logging Aggregator database.

Sintassi

Parameter Set: DataCenterName
Add-SilVMHost [[-VMHostName] <String[]> ] -HostCredential <PSCredential> [-Force] [-SCVMMTargetName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMHostName
Add-SilVMHost -HostCredential <PSCredential> -VMHostName <String[]> [-Force] [-HostType <String> ] [-HypervisorType <System.String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMWareTarget
Add-SilVMHost [[-VMHostName] <String[]> ] -HostCredential <PSCredential> [-Force] [-VMWareTargetName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descrizione dettagliata

The Add-SilVMHost cmdlet adds and updates host information in the Software Inventory Logging Aggregator database. This information includes fully qualified domain name (FQDN), hypervisor manufacturer, and credentials. When a host name already exists in the database, the cmdlet updates the host type and hypervisor for that host, and logs existing host names in Event Viewer.

This cmdlet can get the host information from a management server and store that information in the Software Inventory Logging Aggregator database. This cmdlet supports SCVMM and VMWare management servers.

Parametri

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

Alias	none
Obbligatorio?	false
Posizione?	named
Valore predefinito	none
Accettare l'input della pipeline?	false
Accetta caratteri jolly?	false

-HostCredential<PSCredential>

Specifies the credentials that allow this cmdlet to connect to the host. To obtain a PSCredential object, use the Get-Credential cmdlet. For more information, type Get-Help Get-Credential.

Alias	none
Obbligatorio?	true
Posizione?	named
Valore predefinito	none
Accettare l'input della pipeline?	false
Accetta caratteri jolly?	false

-HostType<String>

Specifies the type of the host. I valori accettabili per questo parametro sono: 

--Windows
-- VMware
-- Ubuntu
-- OpenSuse
-- Centos
-- Citrix

This cmdlet automatically detects host type, therefore, this parameter is not necessary.

Alias	none
Obbligatorio?	false
Posizione?	named
Valore predefinito	none
Accettare l'input della pipeline?	false
Accetta caratteri jolly?	false

-HypervisorType<System.String>

Specifies the type of the hypervisor. I valori accettabili per questo parametro sono: 

-- HyperV
-- Esxi
-- Xen
--XenServer
-- KVM

This cmdlet automatically detects hypervisor, therefore, this parameter is not necessary.

Alias	none
Obbligatorio?	false
Posizione?	named
Valore predefinito	none
Accettare l'input della pipeline?	false
Accetta caratteri jolly?	false

-SCVMMTargetName<String>

Specifies the name of an SCVMM management server.

Alias	none
Obbligatorio?	false
Posizione?	named
Valore predefinito	none
Accettare l'input della pipeline?	false
Accetta caratteri jolly?	false

-VMHostName<String[]>

Specifies an array of virtual machine host names to add or update.

Alias	none
Obbligatorio?	true
Posizione?	named
Valore predefinito	none
Accettare l'input della pipeline?	true(ByValue)
Accetta caratteri jolly?	false

-VMWareTargetName<String>

Specifies the name of a VMWare management or vCenter server.

Alias	none
Obbligatorio?	false
Posizione?	named
Valore predefinito	none
Accettare l'input della pipeline?	false
Accetta caratteri jolly?	false

-Confirm

Richiede una conferma prima dell'esecuzione del cmdlet.

Obbligatorio?	false
Posizione?	named
Valore predefinito	false
Accettare l'input della pipeline?	false
Accetta caratteri jolly?	false

-WhatIf

Mostra che cosa succede se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Obbligatorio?	false
Posizione?	named
Valore predefinito	false
Accettare l'input della pipeline?	false
Accetta caratteri jolly?	false

<CommonParameters>

Questo cmdlet supporta i parametri comuni: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per altre informazioni, vedere  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Input

Il tipo di input è il tipo di oggetti che è possibile inviare al cmdlet.

Output

Il tipo di output corrisponde al tipo di oggetti emesso dal cmdlet.

Esempi

Example 1: Add host names to the database with credentials

The first command creates a credential by using the Get-Credential cmdlet. That cmdlet prompts you for user name and password. The command stores those credentials in the $Credentials variable. For more information, type Get-Help Get-Credential.

The second command identifies host type and hypervisor type. The command stores host names, host type, hypervisor type in the database. The command also updates host credentials in Credential Manager.

PS C:\> $Credential = Get-Credential
PS C:\> Add-SilVMHost -VMHostName "Host01","Host02","Host03" -HostCredential $Credential

Example 2: Get information for hosts managed by an SCVMM management server

This command gets the host information for hosts managed by an SCVMM management server. This command stores that host information in the database, and updates host credentials in Credential Manager.

PS C:\> Add-SilVMHost -HostCredential $Credential -SCVMMTargetName "ManagementServer.tsqa.contoso.com"

Example 3: Get information for hosts managed by a VMWare management server

This command gets the host information for hosts managed by a VMWare management or vCenter server. This command stores that host information in the database, and updates host credentials in Credential Manager.

PS C:\> Add-SilVMHost -HostCredential $Credential -VMWareTargetName "ManagementServer.tsqa.contoso.com"

Argomenti correlati

Get-SilVMHost

Remove-SilVMHost

Software Inventory Logging Cmdlets in Windows PowerShell