Update-SCOMRunAsAccount

Referencia

Módulo:: OperationsManager

Novedades las credenciales de una cuenta de ejecución de Operations Manager.

Syntax

Update-SCOMRunAsAccount
      [-WindowsAccount] <WindowsCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-SCOMRunAsAccount
      [-BasicAccount] <BasicCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-SCOMRunAsAccount
      [-SimpleAccount] <SimpleCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-SCOMRunAsAccount
      [-DigestAccount] <DigestCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-SCOMRunAsAccount
      [-ActionAccount] <ActionAccountSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-SCOMRunAsAccount
      [-CommunityStringAccount] <CommunityStringSecureData>
      [-CommunityString] <SecureString>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-SCOMRunAsAccount
      [-BinaryAccount] <GenericSecureData>
      [-Path] <String>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Update-SCOMRunAsAccount actualiza las credenciales de una cuenta de ejecución de System Center Operations Manager. Una cuenta de ejecución ofrece a los usuarios la capacidad de especificar los permisos necesarios para su uso con reglas, tareas, monitores y detecciones destinados a equipos específicos según sea necesario.

Este cmdlet no admite cuentas SCX (multiplataforma) ni cuentas del Protocolo de administración de red simple versión 3 (SNMPv3). En su lugar, use Get-SCOMRunAsAccount para actualizar las cuentas de SCX.

Ejemplos

Ejemplo 1: Actualizar una cuenta de ejecución de Windows

PS C:\>$WindowsAccount = Get-SCOMRunAsAccount -Name "Domain Admin"
PS C:\>$WindowsAccount | Update-SCOMRunAsAccount -RunAsCredential (Get-Credential)

En este ejemplo se actualiza una cuenta de ejecución de Windows.

El primer comando obtiene el objeto de cuenta de ejecución denominado Domain Administración y almacena el objeto en la variable $WindowsAccount.

El segundo comando pasa la cuenta de ejecución almacenada en la variable $WindowsAccount al cmdlet Update-SCOMRunAsAccount mediante el operador de canalización. Ese cmdlet actualiza las credenciales de la cuenta al nombre de usuario y la contraseña que proporciona el usuario respondiendo al mensaje del cmdlet Get-Credential .

Ejemplo 2: Actualizar una cuenta de ejecución de acción

PS C:\>$UserName = "Contoso\SCOMActionAccount"
PS C:\>$Password = Read-Host -AsSecureString
PS C:\>$NewCred = new-object System.Management.Automation.PsCredential $UserName,$Password
PS C:\>Get-SCOMRunAsAccount -Name "SCOM Action Account" | Update-SCOMRunAsAccount -RunAsCredential $newCred

En este ejemplo se actualizan las credenciales de una cuenta de ejecución de acción.

El primer comando crea una cadena que contiene un nombre de cuenta de acción y almacena la cadena en la variable $UserName.

El segundo comando pide al usuario que escriba una cadena que represente la contraseña. A continuación, almacena la entrada del usuario como una cadena segura en la variable $Password.

El tercer comando crea un objeto PSCredential mediante el nombre almacenado en la variable $UserName y la contraseña almacenada en $Password. A continuación, almacena el objeto PSCredential en la variable $NewCred.

El último comando obtiene la cuenta de acción denominada Cuenta de acción de SCOM. A continuación, usa el operador de canalización para pasar la cuenta al cmdlet Update-SCOMRunAsAccount , que actualiza la cuenta con las credenciales almacenadas en la variable $NewCred.

Ejemplo 3: Actualizar una cuenta de cadena de comunidad

PS C:\>Get-SCOMRunAsAccount -Name "MyCommunityStringAccount" | Update-SCOMRunAsAccount -CommunityString (Read-Host -AsSecureString)

Este comando actualiza las credenciales de una cuenta de ejecución que usa la autenticación de cadena de comunidad para SNMP versión 2. Obtiene la cuenta de cadena de la comunidad denominada MyCommunityStringAccount y usa el operador de canalización para pasar la cuenta al cmdlet Update-SCOMRunAsAccount . Este cmdlet actualiza la cadena de la comunidad con el valor que el usuario escribe en respuesta a las solicitudes del cmdlet Read-Host . Para obtener más información, escriba Get-Help Read-Host.

Ejemplo 4: Actualizar una cuenta de autenticación binaria

PS C:\>Get-SCOMRunAsAccount -Name "MyBinaryAccount" | Update-SCOMRunAsAccount -Path ".\data.txt"

En este ejemplo se obtiene el objeto de cuenta binaria denominado MyBinaryAccount y se usa el operador de canalización para pasar el objeto al cmdlet Update-SCOMRunAsAccount . Este cmdlet usa el parámetro Path para indicar que obtiene los nuevos datos de la cuenta del archivo denominado data.txt.

Parámetros

-AccountType

Especifica el tipo de la cuenta de ejecución. La canalización normalmente rellena este valor automáticamente.

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

-ActionAccount

Especifica una cuenta de acción como una cuenta de ejecución.

Type:	ActionAccountSecureData
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-BasicAccount

Especifica una cuenta de ejecución que usa la autenticación básica.

Type:	BasicCredentialSecureData
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-BinaryAccount

Especifica una cuenta de ejecución que usa la autenticación binaria.

Type:	GenericSecureData
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CommunityString

Especifica la nueva cadena de comunidad para una cuenta de ejecución de SNMP versión 2 que usa la autenticación de cadena de la comunidad.

Type:	SecureString
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CommunityStringAccount

Especifica una cuenta de ejecución de SNMP versión 2 que usa la autenticación de cadena de comunidad.

Type:	CommunityStringSecureData
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres netBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).

El servicio de acceso a datos de System Center debe iniciarse en el equipo. Si no especifica un equipo, el cmdlet usa el equipo para la conexión del grupo de administración actual.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Credential

Especifica la cuenta de usuario con la que se ejecuta la conexión del grupo de administración. Especifique un objeto PSCredential , como el que devuelve el cmdlet Get-Credential , para este parámetro. Para obtener más información sobre los objetos de credenciales, escriba Get-Help Get-Credential.

Si especifica un equipo en el parámetro ComputerName , use una cuenta que tenga acceso a ese equipo. El valor predeterminado es el usuario actual.

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

-DigestAccount

Especifica una cuenta de ejecución que usa la autenticación web implícita estándar.

Type:	DigestCredentialSecureData
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

Indica que el cmdlet crea o modifica un objeto que un comando puede usar en la canalización. De forma predeterminada, este cmdlet no genera ningún resultado.

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

-Path

Especifica la ruta de acceso a un archivo que contiene nuevos datos de credenciales para cuentas de ejecución que usan la autenticación binaria.

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

-RunAsCredential

Especifica nuevas credenciales para los tipos de cuenta que usan un nombre de usuario y una contraseña.

Type:	PSCredential
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SCSession

Especifica una matriz de objetos Connection . Para obtener objetos Connection , use el cmdlet Get-SCOMManagementGroupConnection .

Si no se especifica este parámetro, el cmdlet usa la conexión persistente activa a un grupo de administración. Use el parámetro SCSession para especificar una conexión persistente diferente. Puede crear una conexión temporal a un grupo de administración mediante los parámetros ComputerName y Credential . Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SimpleAccount

Especifica una cuenta de ejecución que usa la autenticación web sencilla.

Type:	SimpleCredentialSecureData
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

-WindowsAccount

Especifica una cuenta de ejecución que usa autenticación de Windows.

Type:	WindowsCredentialSecureData
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False