Add-SCFabricRoleResource
Adds a fabric role resource.
Syntax
Add-SCFabricRoleResource
[-VMMServer <ServerConnection>]
[-FabricRole] <FabricRole>
-VirtualMachine <VM>
-RunAsAccount <RunAsAccount>
[-IPv4Subnet \<SubnetVLan\>]
[-BackEndSwitchName <String>]
[-FrontEndSwitchName <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Add-SCFabricRoleResource
[-VMMServer <ServerConnection>]
[-FabricRole] <FabricRole>
-ServiceInstance <Service>
-RunAsAccount <RunAsAccount>
[-IPv4Subnet \<SubnetVLan\>]
[-BackEndSwitchName <String>]
[-FrontEndSwitchName <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
Note
A new parameter [-IPv6Subnet <SubnetVLan>] is included in VMM 2019 UR2 and later. For more information, see Parameters.
The Add-SCFabricRoleResource cmdlet adds a fabric role resource.
Examples
Example 1: Add fabric role resource to a fabric role
PS C:\> $NetworkService = Get-SCNetworkService -Name "ns"
PS C:\> $FabricRole = Get-SCFabricRole -NetworkService $NetworkService -Name "fr"
PS C:\> $VirtualMachine = Get-SCVirtualMachine -Name "VM01"
PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "ContosoAccount"
PS C:\> $SubnetVlanIPv4 = New-SCSubnetVLan -Subnet "10.185.108.0/23" -VLanID "564"
PS C:\> Add-SCFabricRoleResource -FabricRole $FabricRole -VirtualMachine $VirtualMachine -IPv4Subnet $SubnetVlanIPv4 -RunAsAccount $RunAsAccount"The first command gets a network service by using the Get-SCNetworkService cmdlet, and then stores it in the $NetworkService variable.
The second command gets a fabric role for the service in $NetworkService by using the Get-SCFabricRole cmdlet, and then stores it in the $FabricRole variable.
The third command gets a virtual machine named VM01 by using the Get-SCVirtualMachine cmdlet, and then stores it in the $VirtualMachine variable.
The fourth command gets the run as account named ContosoAccount by using the Get-SCRunAsAccount cmdlet, and then stores it in the $RunAsAccount variable.
The fifth command creates a virtual LAN by using the New-SCSubnetVLan cmdlet, and then stores it in the $SubnetVlanIPv4 variable.
The final command adds the new fabric role resource to the fabric role in $FabricRole. The command specifies the values created by previous commands in the example.
Parameters
-BackEndSwitchName
Specifies the name of a back-end switch.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FabricRole
Specifies a fabric role.
| Type: | FabricRole |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FrontEndSwitchName
Specifies the name of a front-end switch.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPv4Subnet
Specifies an IPv4 subnet.
| Type: | SubnetVLan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPv6Subnet
Specifies an IPv6 subnet.
Note
This parameter is applicable for VMM 2019 UR2 and later.
| Type: | SubnetVLan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Specifies that job progress is tracked and stored in the variable named by this parameter.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Specifies a user name. This cmdlet operates on behalf of the user that this parameter specifies.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Specifies a user role. To obtain a user role, use the Get-SCUserRole cmdlet. This cmdlet operates on behalf of the user role that this parameter specifies.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsAccount
Specifies a Run As account that contains credentials with permission to perform this action.
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ServiceInstance
Specifies a service object.
| Type: | Service |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualMachine
Specifies a virtual machine object.
| Type: | VM |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Specifies a VMM server object.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |