Compartir a través de

Update-SCOMRunAsAccount

Módulo:
OperationsManager Module

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

Sintaxis

WindowsAccount 

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

BasicAccount 

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

SimpleAccount 

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

DigestAccount 

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

ActionAccount 

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

CommunityStringAccount 

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

BinaryAccount 

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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ActionAccount

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

Propiedades del parámetro

Tipo:ActionAccountSecureData
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ActionAccount
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-BasicAccount

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

Propiedades del parámetro

Tipo:BasicCredentialSecureData
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BasicAccount
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-BinaryAccount

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

Propiedades del parámetro

Tipo:GenericSecureData
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BinaryAccount
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:SecureString
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

CommunityStringAccount
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CommunityStringAccount

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

Propiedades del parámetro

Tipo:CommunityStringSecureData
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

CommunityStringAccount
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DigestAccount

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

Propiedades del parámetro

Tipo:DigestCredentialSecureData
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

DigestAccount
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BinaryAccount
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RunAsCredential

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

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

WindowsAccount
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BasicAccount
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
SimpleAccount
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
DigestAccount
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ActionAccount
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:

Connection[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SimpleAccount

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

Propiedades del parámetro

Tipo:SimpleCredentialSecureData
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

SimpleAccount
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WindowsAccount

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

Propiedades del parámetro

Tipo:WindowsCredentialSecureData
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

WindowsAccount
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.