Update-SCOMRunAsAccount

  • Referencia
Módulo:
OperationsManager

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

Sintaxis

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 destinadas a equipos específicos según sea necesario.

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

Ejemplos

Ejemplo 1: Actualización de 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 Run As account denominado Domain Admin y almacena el objeto en la variable $WindowsAccount.

El segundo comando pasa la cuenta de ejecución almacenada en la variable $WindowsAccount a la 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: Actualización de 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 solicita 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 update-SCOMRunAsAccount, que actualiza la cuenta con las credenciales almacenadas en la variable $NewCred.

Ejemplo 3: Actualización de 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 la comunidad para SNMP versión 2. Obtiene la cuenta de cadena de comunidad denominada MyCommunityStringAccount y usa el operador de canalización para pasar la cuenta al cmdlet update-SCOMRunAsAccount de . 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: Actualización de 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 de . 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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ActionAccount

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

Tipo:ActionAccountSecureData
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-BasicAccount

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

Tipo:BasicCredentialSecureData
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-BinaryAccount

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

Tipo:GenericSecureData
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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 cadenas de la comunidad.

Tipo:SecureString
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CommunityStringAccount

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

Tipo:CommunityStringSecureData
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Especifica la cuenta de usuario en la que se ejecuta la conexión del grupo de administración. Especifique un objeto de PSCredential, como el que devuelve el cmdlet get-credential de , 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.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DigestAccount

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

Tipo:DigestCredentialSecureData
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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 ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

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

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsCredential

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

Tipo:PSCredential
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 el computerName de y parámetros de Credential. Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

Tipo:Connection[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SimpleAccount

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

Tipo:SimpleCredentialSecureData
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WindowsAccount

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

Tipo:WindowsCredentialSecureData
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False