Set-SCOMRunAsDistribution

Módulo:

OperationsManager

Establece la directiva de distribución de una cuenta de ejecución para Operations Manager.

Sintaxis

Set-SCOMRunAsDistribution
   [-RunAsAccount] <SecureData>
   [-LessSecure]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMRunAsDistribution
   [-RunAsAccount] <SecureData>
   [-MoreSecure]
   [-SecureDistribution <Object[]>]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMRunAsDistribution
   [-RunAsAccount] <SecureData>
   -Security <String>
   [-SecureDistribution <Object[]>]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-SCOMRunAsDistribution establece la directiva de distribución de una cuenta de ejecución para System Center Operations Manager. Las directivas de distribución determinan qué equipos reciben una credencial para una cuenta de ejecución. De forma predeterminada, las nuevas cuentas tienen la distribución más segura sin sistemas aprobados.

Ejemplos

Ejemplo 1: Especificar una distribución menos segura

PS C:\>Get-SCOMRunAsAccount -Name "Contoso\LowPriv" | Set-SCOMRunAsDistribution -LessSecure

Este comando establece la cuenta Contoso\LowPriv para una distribución menos segura, de modo que Operations Manager distribuya automáticamente la credencial a todos los equipos administrados. El comando usa el cmdlet Get-SCOMRunAsAccount para obtener la cuenta especificada y la pasa al cmdlet set-SCOMRunAsDistribution mediante el operador de canalización. El comando especifica el parámetro LessSecure.

Ejemplo 2: Especificar una distribución más segura sin sistemas aprobados

PS C:\>Get-SCOMRunAsAccount -Name "Contoso\LowPriv" | Set-SCOMRunAsDistribution -MoreSecure

Este comando establece la cuenta Contoso\LowPriv para una distribución más segura, sin sistemas aprobados. El comando usa el cmdlet Get-SCOMRunAsAccount para obtener la cuenta especificada y la pasa al cmdlet set-SCOMRunAsDistribution mediante el operador de canalización. El comando especifica el parámetro MoreSecure.

Ejemplo 3: Especificar una distribución más segura a una colección

PS C:\>$Distribution = (Get-SCOMAgent -Name "*.contoso.com") + (Get-SCOMManagementServer) + (Get-SCOMResourcePool -DisplayName "Contoso Monitoring Pool")
PS C:\> Get-SCOMRunAsAccount "Contoso\LowPriv" | Set-SCOMRunAsDistribution -MoreSecure -SecureDistribution $Distribution

En este ejemplo se establece la cuenta Contoso\LowPriv para una distribución más segura en una colección de grupos, agentes y servidores, de modo que solo los grupos, agentes y servidores especificados obtengan la distribución.

El primer comando obtiene los grupos, agentes y servidores para recibir una distribución más segura y los almacena en la variable $Distribution .

El segundo comando obtiene grupos, agentes y servidores que tienen una distribución menos segura y los pasa al cmdlet Set-SCOMRunAsDistribution mediante el operador de canalización. Ese cmdlet les asigna una distribución más segura.

Ejemplo 4: Especificar una distribución menos segura para una nueva cuenta de ejecución

PS C:\>Add-SCOMRunAsAccount -Windows -Name "NewAccount" -Credential (Get-Credential) | Set-SCOMRunAsDistribution -MoreSecure -SecureDistribution (Get-SCOMAgent)

Este comando crea una cuenta de ejecución para Windows y la aprueba para su distribución a todos los agentes. El comando usa el cmdlet Add-SCOMRunAsAccount para agregar la cuenta NewAccount con la credencial que crea el cmdlet get-credential de . A continuación, pasa el resultado al cmdlet set-SCOMRunAsDistribution mediante el operador de canalización.

Ejemplo 5: Copia de una directiva de distribución más segura en otra cuenta

PS C:\>$MonitoringAcct = Get-SCOMRunAsAccount "Contoso\Monitoring"
PS C:\> Get-SCOMRunAsAccount "Contoso\Administrator" | Get-SCOMRunAsDistribution | Set-SCOMRunAsDistribution -RunAsAccount $MonitoringAccount

En este ejemplo se copia la directiva de distribución segura de la cuenta Contoso\Administrator a la cuenta Contoso\Monitoring.

El primer comando usa el cmdlet Get-SCOMRunAsAccount para obtener la cuenta Contoso\Monitoring y la almacena en la variable $MonitoringAcct.

El segundo comando usa el cmdlet Get-SCOMRunAsAccount para obtener la cuenta Contoso\Administrator y la pasa al cmdlet Get-SCOMRunAsDistribution mediante el operador de canalización. El comando pasa el resultado a la cmdlet Set-SCOMRunAsDistribution para copiar el resultado en la cuenta Contoso\Monitoring.

Parámetros

-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

-LessSecure

Indica que Operations Manager distribuye automáticamente la credencial a todos los equipos administrados.

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

-MoreSecure

Indica que Operations Manager distribuye la credencial solo a los sistemas que especifica el parámetro secureDistribution de .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
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

-RunAsAccount

Especifica una matriz de objetos SecureData que representan cuentas de ejecución. Para obtener un objeto secureData de , use el cmdlet get-SCOMRunAsAccount de . Esta cuenta no puede formar parte de un perfil de ejecución.

Tipo:	SecureData
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
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

-SecureDistribution

Especifica una matriz de objetos que representan sistemas que el cmdlet autoriza para la distribución.

Esta lista de parámetros solo puede contener los siguientes tipos de elementos:

• Agentes. Objetos que devuelve el cmdlet Get-SCOMAgent. El cmdlet autoriza esta cuenta al agente para su distribución.
• Servidores de administración. Objetos que devuelve el cmdlet Get-SCOMManagementServer. El cmdlet autoriza esta cuenta al agente para su distribución.
• Piscinas. Objetos que devuelve el cmdlet Get-SCOMResourcePool. El cmdlet autoriza esta cuenta al agente para su distribución.
• Instancias del servicio de mantenimiento. Objetos que devuelve el cmdlet Get-SCOMClassInstance y que tienen un tipo administrado de HealthService. El cmdlet autoriza este servicio de mantenimiento al agente para su distribución.

Pasar la salida del cmdlet Get-SCOMRunAsDistribution como entrada a set-SCOMRunAsDistribution mediante el operador de canalización rellena automáticamente este parámetro.

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

-Security

Especifica el nivel de seguridad. Los valores aceptables para este parámetro son:

• MoreSecure
• LessSecure

Pasar la salida del cmdlet Get-SCOMRunAsDistribution como entrada a set-SCOMRunAsDistribution mediante el operador de canalización rellena automáticamente este parámetro.

Tipo:	String
Posición:	Named
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

Vínculos relacionados

• Get-SCOMAgent
• Get-SCOMClassInstance
• Get-SCOMManagementServer
• Get-SCOMResourcePool
• Get-SCOMRunAsAccount
• Get-SCOMRunAsDistribution